Usando Arquivos de Localização (Strings)

Para enviar arquivos em Strings, siga estas etapas:

De qualquer página de projeto, selecione Uploads no menu Mais para acessar o arquivo de upload.

O arquivo de upload lista todos os uploads históricos em todos os possíveis estados. Clique no dropdown Todas as situações para filtrar uploads por estado (Sucesso, Falhou e/ou Em progresso). Para localizar um upload específico, use a caixa de pesquisa na parte superior para buscar pelo nome.

Acesse resumos detalhados de uploads de recursos afetados clicando em um upload listado. Todos os uploads bem-sucedidos também são apresentados no fluxo de atividade de um projeto.

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

Selecionar diferentes formatos de arquivo apresenta opções diferentes. Para mais detalhes, consulte o artigo relevante sobre o formato de arquivo específico.

Opcionalmente, use o campo Nome do arquivo na aba Geral para especificar um nome de arquivo de exportação personalizado, ou deixe em branco para gerar um nome definido pelo sistema.

Por padrão, 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 estar preso a um formato, além de agrupamento flexível usando tags.

Alguns frameworks ou configurações exigem múltiplos arquivos de origem, também exigindo configuração adicional.

Mantendo arquivos separados

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

Se os arquivos de localização precisarem ser mantidos em arquivos separados, um fluxo de trabalho baseado em arquivos pode ser usado, etiquetando as chaves ao fazer upload e usando as tags como referência ao baixar as chaves traduzidas de volta para os arquivos originais. As chaves podem ter múltiplas 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 dos recursos de tradução sem precisar ser enviado para projetos.

Dê nomes únicos às chaves em todos os arquivos para garantir um fluxo de trabalho suave. Em uma abordagem baseada em chave-valor, uma chave deve ter os mesmos valores atribuídos a ela em todos os contextos. Alguns frameworks permitem o uso de chaves não únicas em vários arquivos. Alguns formatos, como Symfony, suportam domínios de mensagens. Esses domínios são detectados pelo nome do arquivo. As chaves não são automaticamente agrupadas por domínios baseados em nomes de arquivos, mas isso pode ser resolvido usando um prefixo de domínio único para chaves dentro do arquivo.

Exemplo de configuração 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 possui vários arquivos de tradução nomeados semanticamente para o local 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 às tags no projeto Strings incluindo o marcador de posição da tag no caminho do arquivo:

phrase:
  access_token: "3d7e6598d955bfcab104c45c40af1b9459df5692ac4c28a17793"
  project_id: "23485c9c5dfb15d85b32d9c5f3d2hl54"
  file_format: yml
  push:
    sources:
      - file: ./path/to/locales/<tag>.en.yml
        params:
          locale_id: "abcd1234cdef1234abcd1234cdef1234"
  pull:
    targets:
      # contas
      - file: ./path/to/locales/accounts.<locale_name>.yml
        params:
          tags: contas
      # e-mails
      - file: ./path/to/locales/emails.<locale_name>.yml
        params:
          tags: e-mails

Tags de parâmetro também podem ser usadas na seção de push em vez de usar o marcador de posição <tag>.

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 acionar a exportação para o repositório, as chaves são agrupadas em arquivos com base em suas tags.

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

Uma distinção adicional é necessária se:

Localizando um produto estático

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

Localizando um projeto com atualizações contínuas

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

Códigos de idioma seguindo o padrão ISO (por exemplo, en-US) não precisam ser únicos, então muitas versões do mesmo idioma podem ser criadas dentro de um projeto. Distinguir entre regiões, clientes ou públicos usando um nome de idioma único.

Quando configurado, qualquer nova chave introduzida no local padrão apareceria como não traduzida nos outros idiomas e seria localizada de acordo. Se estiver trabalhando com um cliente e seus próprios tradutores, atribua-os especificamente para que possam editar apenas suas versões de idioma, atualizando o acesso ao idioma em seu perfil de usuário ou na gestão de usuários do projeto.

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