Fazendo upload e download de arquivos de localização (Strings)

Para upload de arquivos em Strings, siga estas etapas:

A partir de qualquer página de projeto, Selecionar Uploads no menu More para acessar o arquivo de upload.

O arquivo de upload lista todos os uploads históricos em todos os estados possíveis. Clique no menu suspenso All statuses para filtrar uploads por estado (Success, Failed e/ou In progress). Para localizar um upload específico, usar a caixa de pesquisa na parte superior para pesquisar por nome.

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.

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

Selecionar diferentes formato de arquivos apresenta diferentes opções. 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-o em branco para gerar um nome definido pelo sistema.

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

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

Manter 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 mais robustos. As traduções são mantidas organizadas em projetos, portanto, arquivos pequenos separados não são necessários.

Se for necessário manter arquivos de localização em arquivos separados, um fluxo de trabalho baseado em arquivo pode ser usado marcando as chaves durante o upload e usando os códigos como referência ao baixar chaves traduzidas de volta para os arquivos de texto original. As chaves podem carregar múltiplos códigos e ser incluídas em múltiplos arquivos, garantindo reutilização e consistência. Um fluxo de trabalho baseado em código é flexível e permite a reorganização de recursos de tradução sem precisar ser enviado para projetos.

Dê às chaves nomes exclusivos em todos os arquivos para garantir um fluxo de trabalho tranquilo. 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 exclusivas em múltiplos arquivos. Alguns formatos, como Symfony, suportam domínios de mensagem. Esses domínios são detectados pelo nome do arquivo. As chaves não são automaticamente delimitadas 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 de CLI

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

Para o exemplo, um projeto tem vários arquivos de tradução nomeados semanticamente para o local de texto original. Por exemplo: accounts.en.yml, emails.en.yml etc. Esses nomes semânticos são gerenciados por meio de códigos.

Configurar o .phrase.yml para refletir a organização dos arquivos no projeto de localização e vinculá-los a códigos no projeto Phrase Strings incluindo o marcador de posição de código no caminho do arquivo:

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

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

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

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 versões diferentes dentro de um mesmo idioma.

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

Localizando um produto estático

Se um produto estiver totalmente desenvolvido e raramente for 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 vários projetos e mantê-los sincronizados é difícil. Usar 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 exclusivos, portanto, muitas versões do mesmo idioma podem ser criar dentro de um projeto. Distinga entre regiões, clientes ou públicos usando um nome de idioma exclusivo.

Após a configuração, qualquer chave recém-introduzida no local padrão apareceria como não traduzido nos outros idiomas e seria localizada adequadamente. Se estiver trabalhando com um cliente e seu(s) próprio(s) tradutor(es), atribua-os especificamente para que possam apenas Editar suas versões de idioma, atualizando o acesso ao idioma em seu perfil de usuário ou no gerenciamento de usuário do projeto.

Configurar processos de localização paralelos com trabalhos e fluxos de trabalho 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.