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

Para realizar o upload de arquivos no 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 no topo para pesquisar por nome.

Acessar 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 atividade de um projeto.

Opções de download são apresentadas ao baixar um arquivo na janela Download com abas para General, Advanced e Encoding.

Selecionar diferentes File formats apresenta diferentes opções. Para mais detalhes, consulte o artigo relevante sobre o specific file format.

Opcionalmente, usar o campo File name na aba General para especificar um nome de arquivo de exportar 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 original do arquivo. Isso permite formatos de arquivo intercambiáveis sem ficar bloqueado em um formato, bem como agrupamento flexível usando códigos.

Alguns frameworks ou configurações exigem múltiplos arquivos de texto original, também exigindo 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, 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 originais. As chaves podem conter múltiplos códigos e ser incluídas em múltiplos arquivos, garantindo a reutilização e a 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 feito o upload para projetos.

Dê nomes únicos às chaves 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 únicas em múltiplos arquivos. Alguns formatos, como o 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 ú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 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ódigo.

Configure o .phrase.yml para refletir a organização dos arquivos no projeto de localização e vincule-os a código no projeto 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/<tag>.en.yml
        params:
          locale_id: "abcd1234cdef1234abcd1234cdef1234"
  pull:
    targets:
      # accounts
      - file: ./path/to/locales/accounts.<locale_name>.yml
        params:
          tags: accounts
      # emails
      - file: ./path/to/locales/emails.<locale_name>.yml
        params:
          tags: emails

Parâmetro tags também pode ser usado na seção push em vez de usar o marcador de posição <tag>.

A configuração cria chaves com tags 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 tags.

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 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. 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 únicos, portanto, muitas versões do mesmo idioma podem ser criadas dentro de um projeto. Distinga entre regiões, clientes ou públicos usando um nome de idioma único.

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.