Projetos são onde os principais componentes de um projeto de tradução (trabalhos, memórias de tradução e bases de termos) são mantidos juntos. Antes que os arquivos possam ser atribuídos para tradução como um trabalho, eles devem ser atribuídos a e contidos dentro de um projeto.
Projetos atribuídos são listados na aba na página de perfil e podem ser filtrados por espaço.
Dependendo da estrutura da Team, os projetos podem ser definidos por produto ou por plataforma. Usar um único projeto se todos os membros da Team precisarem de acesso.
Abrir um projeto apresenta-o em uma página de projeto.
A partir da página do projeto, todos os detalhes do projeto podem ser visualizados e editados. Todos os comentários, tags, chaves e uploads também são apresentados.
Para criar um projeto, siga estas etapas:
-
Na página , clique em Novo projeto.
A janela é aberta.
-
Forneça um nome para o projeto.
-
Nas listas suspensas, selecione um e uma nas listas suspensas.
-
Forneça um na lista suspensa.
-
Clique em Gravar.
O projeto é adicionado ao perfil.
Estas configurações (ou seja, o nome do projeto, formato principal ou ponto de contato) podem ser alteradas na aba das acessadas a partir do menu .
Projetos existentes podem ser duplicados selecionando Duplicar projeto no menu na página . O projeto duplicado usa o formato principal do original. Se esse formato não oferecer suporte a pluralização por padrão, a pluralização estará indisponível. Se nenhum formato principal for definido, o formato .CSV é usado por padrão, com a pluralização desativada.
A definição mínima para um projeto são o texto original e a tradução idiomas. Estes são o idioma original dos textos e os idiomas para os quais ele será traduzido e são inicialmente definidos na configuração do projeto.
Para configurar outros idiomas, siga estas etapas:
-
Passe o mouse sobre um projeto e clique em idioma.
A aba abre.
-
Clique em adicionar idioma. A janela abre.
-
Na aba , forneça um nome de idioma e código do idioma (local).
-
Na aba , Selecionar um texto original idioma da lista suspensa.
-
Na aba , Selecionar opções de revisão.
-
Clique em Gravar.
O idioma é adicionado a esse projeto.
Mais idiomas podem ser adicionados clicando em adicionar idioma na aba , e podem ser editados a partir do menu Mais opções
ao Selecionar
.
Pedaços de informação e sinalizadores podem ser armazenados em variáveis de projeto. As variáveis são definidas e podem ser gerenciadas via Central de tradução e API. Integrações podem usar variáveis de projeto para configurar fluxos de trabalho de comportamento especificado.
Variáveis são normalmente acessadas em scripts via API. Como variáveis de ambiente, o valor de uma variável de projeto é representado como uma string, portanto, o tipo deve ser especificado (por exemplo, booleano, inteiro).
Exemplo 1
-
Um cliente tem diferentes tipos de projeto (marketing e produto). Eles definem a variável
content_type: marketing. -
O script de integração lê a variável para decidir como prosseguir com esse projeto (por exemplo, enviá-lo por diferentes verificações de Controle de qualidade).
Exemplo 2
-
Um cliente trabalha com Phrase Strings e um CMS. Eles adicionam a variável
template_id: 8734-ABCD. -
O script de integração lê a variável e busca o modelo correto no CMS ao publicar conteúdo localizado.
Variáveis só podem ser definidas por Administradores e são definidas na aba da janela de .
Para definir uma variável, siga estas etapas:
-
A partir de uma página de projeto, abra a janela de na lista suspensa .
-
Abra a aba .
-
Forneça um nome para a variável e um valor.
Idealmente, os nomes devem ser semelhantes a variáveis de ambiente, como
MY_VAR, e devem ser exclusivos por projeto. -
Clique em Add variable para adicionar mais variáveis e clique no ícone
para removê-las.
-
Clique em Gravar.
A janela fecha e as variáveis são salvas.
À medida que os projetos de software crescem e se tornam mais complexos, ajuda dividi-los em módulos para manter as coisas gerenciáveis. Limitar o escopo dos projetos dividindo as Strings em categorias menores, como frontend e backend, pode ajudar nessa gestão.
Exemplo de fluxo de trabalho de manutenção
-
Criar projetos de Strings. Conforme o exemplo, projeto Frontend e projeto Backend.
-
Criar arquivos de texto original de local correspondentes aos projetos de Strings.
-
Criar um arquivo de configuração que inclua os locais dos arquivos de texto original de local no projeto e faça a correspondência deles com os projetos de Strings correspondentes:
phrase: access_token: "3d7e6598d955bfcabaf1b9459df5692ac4c28a17793" file_format: yml push: sources: # frontend - file: ./path/to/locales/frontend/en.yml project_id: "5c05692a2a995c0c45c0c3cbfcab1" params: locale_id: "159d48e76802f789d9b8fb6d368e61bc" # backend - file: ./path/to/locales/backend/en.yml project_id: "0c45c0c3cbfcab15c05692a2a995c" params: locale_id: "fb6d368e61bc159d48e76802f789d9b8" pull: targets: # frontend - file: ./path/to/locales/frontend/<locale_name>.yml project_id: "5c05692a2a995c0c45c0c3cbfcab1" # backend - file: ./path/to/locales/backend/<locale_name>.yml project_id: "0c45c0c3cbfcab15c05692a2a995c"
Fornecendo uma configuração via flag --config
Por padrão, a CLI tentará usar um arquivo chamado .phrase.yml no mesmo nível em que o Phrase é executado. Para oferecer suporte a fluxos de trabalho mais complexos, use vários arquivos de configuração para finalidades diferentes.
Para forçar a CLI a usar um arquivo de configuração para determinados comandos, forneça o arquivo .yml correspondente via flag --config:
$ phrase push --config ./path/to/config.yml