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

Para fazer upload de arquivos no Strings, siga estas etapas:

A partir de qualquer página do projeto, Selecionar Uploads no menu Mais 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 Todos os estados para filtrar uploads por estado (Sucesso, Falha e/ou Em progresso). Para localizar um upload específico, use 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 de Download com abas para Geral, Avançado e Codificação.

Selecionar diferentes formatos de arquivo 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í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 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 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. Chaves podem carregar múltiplos códigos e ser incluídas em múltiplos arquivos, garantindo reuso 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 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 cada contexto. Alguns frameworks permitem o uso de chaves não únicas em múltiplos arquivos. Alguns formatos, como Symfony, suportam domínios de mensagem. Esses domínios são detectados pelo nome do arquivo. Chaves não são automaticamente escopadas 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 de 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 do texto original. Por exemplo: accounts.en.yml, emails.en.yml etc. Esses nomes semânticos são gerenciados por meio de códigos.

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

Parâmetros de código também podem ser usados na seção push em vez de usar o marcador de posição <tag>.

A configuração cria chaves com códigos com base no arquivo de origem 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 seus códigos.

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 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, então 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.

Quando configurada, 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.