Projetos são onde os principais componentes de um projeto de tradução (trabalhos, memórias de tradução e bases de termo) são mantidos juntos. Antes que 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, projetos podem ser definidos por produto ou por plataforma. Usar um único projeto se todos os membros da Team precisarem acessar.
Abrir um projeto apresenta-o em uma página do 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 abre.
-
Forneça um nome para o projeto.
-
Nas listas suspensas, Selecionar um e 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 ao Selecionar 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 será usado por padrão, com a pluralização desativada.
A definição mínima para um projeto são o texto original e os idiomas de tradução. Esses são o idioma original dos textos e os idiomas para os quais ele será traduzido e são definidos inicialmente 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 , selecione as 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
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. As integrações podem usar variáveis de projeto para configurar fluxos de trabalho de comportamento especificado.
As 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 proceder 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.
As 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 adicionar variável 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 de projetos dividindo as traduções em categorias menores, como frontend e backend, pode ajudar com esse gerenciamento.
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 para os projetos de Strings correspondentes.
-
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