Gerenciamento de tradução

Usando arquivos de localização (cadeias de caracteres)

O conteúdo de toda a Central de Ajuda é traduzido automaticamente de inglês pelo Phrase Language AI.

Carregando arquivos de localização

Ao carregar um arquivo em um projeto todos os novos recursos são extraídos desse arquivo e armazenados em um projeto. O formato do arquivo carregado não precisa ser o formato inicial configurado para o projeto. Se as tags forem fornecidas para agrupar recursos, novas chaves terão essas tags aplicadas.

Alguns formatos, como Gettext, fornecem informações meta valiosas adicionais, como comentários, descrições ou informações sobre formulários plurais. Essas informações são extraídas quando e sempre que possível e são armazenadas junto com os recursos atribuídos, permitindo que todas as informações valiosas fornecidas nos arquivos de localização sejam salvas para uso posterior.

Existem vários métodos para carregar arquivos:

  • No aplicativo , ao criar um novo projeto ou selecionando Carregar arquivo em uma página de projeto

  • via API

  • via CLI

Opções de upload

  • Atualizar traduções

    Por padrão, somente o novo conteúdo é extraído e as chaves existentes em um projeto de localização não são excluídas ou atualizadas; Nenhum dado pode ser perdido carregando arquivos. Se for necessário substituir dados existentes, substitua os recursos do projeto pelo conteúdo do arquivo de localização selecionando a opção Atualizar traduções. As traduções existentes serão substituídas pelo conteúdo do arquivo de localização carregado.

    Essa opção também está disponível na API.

    Nota

    Para evitar a perda de dados, certifique-se de baixar as alterações mais recentes no arquivo de localização do Phrase antes de alterá-lo e carregá-lo novamente com a opção Atualizar traduções.

  • Descrições de atualização

    Selecione essa opção se for necessário atualizar todas as descrições das chaves do arquivo carregado. As descrições vazias substituirão as existentes. As descrições podem conter qualquer informação adicional para tradutores e ajudar a identificar chaves individuais no editor.

  • Ignorar tags de upload tags

    Para manter as traduções organizadas, adicione várias tags às teclas com rótulos significativos. Selecione essa opção para impedir que novas chaves sejam marcadas automaticamente com uma tag de upload.

  • Chaves de código de traduções novas e atualizadas

    Selecione esta opção para marcar novas chaves e chaves com traduções atualizadas automaticamente após o upload. Isso ajudará na distinção entre cadeias de caracteres de tradução novas, atualizadas e antigas, garantindo que apenas as chaves relevantes sejam processadas posteriormente.

    Essa opção também está disponível na API.

  • Codificação

    Especifique a codificação (por exemplo, UTF-8) do arquivo ou selecione-a automaticamente (a codificação selecionada automaticamente pode resultar em codificação incorreta e pode ser revertida desfazendo o upload).

  • Revisão

    Ignorar a desverificação evita a necessidade de verificar traduções de idiomas não principais novamente ao atualizar traduções.

    Marcar traduções como revisadas trata todas as traduções carregadas como revisadas. Essa opção está disponível quando o fluxo foi ativado. Permite a marcação das chaves como estando prontas para serem empurradas para a produção.

Carregar arquivos via interface do usuário

Para carregar arquivos em cadeias de caracteres, execute estas etapas:

  1. Antes de carregar, verifique se o arquivo está formatado corretamente com base no tipo.

  2. Em um projeto, selecione Carregar arquivo no menu Mais .

    A página Carregar arquivo é aberta.

  3. Clique em Escolher arquivo, selecione um arquivo de um diretório.

    O arquivo selecionado é adicionado ao campo Arquivo .

  4. Selecione um formato para o arquivo.

    Os formatos sugeridos são apresentados primeiro com base no tipo de arquivo.

  5. Selecione um idioma para o conteúdo do arquivo na lista suspensa.

    Se essas informações não estiverem no próprio arquivo, crie um novo idioma para o conteúdo ou use um existente.

  6. Opcionalmente, forneça tags a serem atribuídas às novas chaves e quaisquer outras opções.

  7. Clique em Salvar.

    O conteúdo é importado e convertido em chaves.

Carregar Resumo

  • Falha no carregamento

    Se um arquivo não puder ser processado corretamente, os detalhes do erro serão fornecidos para ajudar a atenuar o erro.

  • Upload bem-sucedido

    Após o processamento bem-sucedido de um arquivo de tradução, uma página de resumo é apresentada dando uma visão geral do upload com botões vinculando às próximas etapas.

  • Removendo chaves

    Para evitar a exclusão acidental de chaves ao remover chaves de um arquivo de localização e carregá-lo novamente, essas chaves não são excluídas automaticamente.

    Para remover essas chaves, execute estas etapas:

    1. Carregue o arquivo.

    2. Clique em Excluir e selecione Excluir chaves não mencionadas.

    3. Confirme a seleção.

    Todas as chaves e traduções associadas que não foram incluídas no arquivo carregado são removidas do projeto.

  • Desfazer um carregamento

    Cada upload aciona várias ações e pode modificar muitos dados dentro de projetos e não é possível retirar um upload.

    Para remover chaves que foram (incorretamente) introduzidas por um arquivo carregado, execute estas etapas:

    1. No resumo de carregamento do carregamento afetado, clique em Excluir e selecione Excluir chaves criadas.

    2. Confirme a seleção.

    Todas as chaves e traduções associadas criadas por esse upload são removidas. As traduções de chaves que existiam antes do carregamento não serão removidas. Para remover traduções individuais, use o histórico de versões de cada tradução.

Carregar arquivo

Em qualquer página do projeto, selecione Carregamentos no menu Mais para acessar o arquivo de carregamento.

O arquivo de upload lista todos os uploads históricos. Acesse resumos detalhados de upload de recursos afetados clicando em um upload listado. Todos os uploads bem-sucedidos também são apresentados no fluxo de atividades de um projeto.

Baixando arquivos de localização

Os arquivos de idioma podem ser baixados de um projeto a qualquer momento e para qualquer formato de arquivo suportado.

Os arquivos podem ser baixados do aplicativo, via API ou CLI.

Os arquivos podem ser baixados da guia Idiomas de qualquer projeto clicando em Exportar (vários arquivos) ou no botão Mais/Download de um idioma.

Opções de Download

As opções de download são apresentadas ao baixar um arquivo na janela Download com guias para Geral, Avançado e Codificação.

A seleção de formatos de arquivodiferentes apresenta opções diferentes.

Casos de uso

Mantendo estruturas de arquivos

Por padrão, os recursos traduzíveis são armazenados como chaves e valores em vez de manter a estrutura de arquivo original. Isso permite formatos de arquivo intercambiáveis sem serem bloqueados em um formato, bem como agrupamento flexível usando

Algumas estruturas ou configurações exigem vários arquivos de origem que também exigem configuração adicional.

Mantendo arquivos separados

Em geral, mantenha todas as traduções para cada idioma em um arquivo. Isso torna os downloads de recursos mais rápidos e robustos. As traduções são mantidas organizadas em projetos, portanto, pequenos arquivos separados não são necessários.

Se for necessário manter os arquivos de localização em arquivos separados, um fluxo de trabalho baseado em arquivo poderá ser usado marcando as chaves no momento do carregamento e usando as marcas como referência ao baixar as chaves traduzidas de volta para os arquivos originais. As chaves podem carregar várias tags e ser incluídas em vários arquivos, garantindo reutilização e consistência. Um fluxo de trabalho baseado em tags é flexível e permite a reorganização de recursos de tradução sem precisar ser carregado em projetos.

Dê nomes exclusivos às chaves em todos os arquivos para garantir um fluxo de trabalho tranquilo. Em uma abordagem baseada em valor-chave, uma chave deve ter os mesmos valores atribuídos a ela em todos os contextos. Algumas estruturas permitem o uso de chaves não exclusivas em vários arquivos. Alguns formatos, como o Symfony, suportam domínios de mensagens. Esses domínios são detectados pelo nome do arquivo. O escopo das chaves não é definido automaticamente por domínios baseados em nome de arquivo, mas isso pode ser resolvido usando um prefixo de domínio exclusivo para chaves dentro do arquivo.

Exemplo de configuração da CLI

Se estiver trabalhando com CLI ou conectando um projeto a um repositório (por exemplo, GitHub, GitLab ou Bitbucket), configure um arquivo de configuração para gerenciar uploads e downloads.

Para o exemplo, um projeto tem vários arquivos de tradução semanticamente nomeados para a localidade de origem. Por exemplo: accounts.en.yml, emails.en.yml etc. Esses nomes semânticos são gerenciados por meio de tags.

Configure o .phrase.yml para refletir a organização dos arquivos no projeto de localização e vincule-os a marcas no projeto Strings incluindo o espaço reservado para marcas no caminho do arquivo:

frase:
  access_token: "3d7e6598d955bfcab104c45c40af1b9459df5692ac4c28a17793"
  project_id: "23485c9c5dfb15d85b32d9c5f3d2hl54"
  file_format: yml
  push:
    Fontes:
      - Arquivo: ./path/to/locales/<tag>.en.yml
        params:
          locale_id: "abcd1234cdef1234abcd1234cdef1234"
  pull:
    Alvos:
      # contas
      - arquivo: ./path/to/locales/accounts.<locale_name>.yml
        params:
          Tags: Contas
      # e-mails
      - arquivo: ./path/to/locales/emails.<locale_name>.yml
        params:
          Tags: E-mails

As tags de parâmetro também podem ser usadas na seção push em vez de usar o espaço reservado <tag> espaço-reservado.

A configuração cria chaves com tags com base no arquivo de onde vieram ao executar um push ou acionar a sincronização de um repositório. Ao executar pull ou disparar a exportação para o repositório, ele agrupa chaves em arquivos com base em suas tags.

Localizando um projeto para diferentes regiões, clientes ou públicos

Um produto, site ou aplicativo é traduzido para vários idiomas diferentes, mas, em alguns casos, a localização não é apenas o idioma escolhido, mas diferentes versões dentro de um idioma.

É necessária uma distinção adicional se:

  • Um produto tem uma marca diferente em regiões onde o mesmo idioma é falado.

  • Um produto é usado por diferentes clientes que desejam usar uma solução white label.

  • Variantes linguísticas como simples, formais ou informais são necessárias.

Localizando um produto estático

Se um produto for totalmente desenvolvido e raramente atualizado, uma versão separada do produto poderá existir dentro de um projeto.

  • Se um único resultado ou um projeto de curto prazo:

    Crie uma trabalhe exclusivamente nessa ramificação durante a duração do projeto e exclua a ramificação quando concluída.

  • Se for um projeto de longo prazo:

    Manter uma duplicata do projeto existente. Isso permite convidar e trabalhar com clientes na mesma organização, fornecendo apenas acesso ao(s) seu(s) projeto(s), deixando outros projetos ocultos para eles.

Localizando um projeto com atualizações contínuas

Se um produto é constantemente atualizado com novo conteúdo (chaves), aplicar essas atualizações a vários projetos e mantê-los sincronizados é difícil. Use idiomas dedicados em um projeto para mantê-los.

Os códigos de idioma que seguem o padrão ISO (por exemplo, en-US) não precisam ser exclusivos, portanto, muitas versões do mesmo idioma podem ser criado dentro de um projeto. Diferencie entre regiões, clientes ou públicos usando um nome de idioma exclusivo.

Durante a instalação, qualquer chave recém-introduzida na localidade padrão apareceria como não traduzida nos outros idiomas e seria localizada de acordo. Se estiver trabalhando com um cliente e seu(s) próprio(s) tradutor(es), atribua-lhes especificamente para que só possam editar suas versões de idioma atualizando o acesso ao idioma em seu perfil de usuário ou no gerenciamento de usuários do projeto.

Configure processos de localização paralelos com jobs e no mesmo projeto. Essa flexibilidade também se estende ao upload e download de arquivos de idioma ou processos automatizados via API.

Esse artigo foi útil?

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.