Texto simples

Traduza um arquivo de texto linha por linha, mantendo cada linha da tradução na mesma posição do original.

Arquivos de texto simples, como descrições de aplicativos em lojas e notas de versão, não têm marcação nem chaves. O processador de arquivos txt traduz cada linha separadamente e grava a tradução no mesmo lugar, para que o arquivo de destino tenha o mesmo número de linhas que o original.

Linhas e unidades #

Por exemplo:

text
Plan your trips offline.

  • Download maps for any region
  • Share routes with friends

Cada linha com texto se torna uma unidade de tradução, identificada pelo número da linha. Neste exemplo, as linhas 1, 3 e 4 são traduzidas. Uma linha vazia ou que contenha apenas espaços ou tabulações não é uma unidade e é copiada sem alterações.

Os espaços e as tabulações no início e no fim de cada linha ficam fora da unidade, preservando o recuo e os espaços finais na tradução. Apenas o texto entre eles é traduzido.

Saída reconstruída #

A saída substitui o texto de cada linha do arquivo de origem atual e preserva todo o restante, byte por byte: linhas vazias, recuos, a terminação de cada linha (LF ou CRLF, mesmo quando os dois tipos aparecem no arquivo) e a presença ou ausência de uma quebra de linha no fim do arquivo. Assim, o arquivo de destino tem o mesmo número de linhas que o original.

Espaços e quebras de linha no início e no fim de uma tradução são removidos, e cada quebra de linha dentro dela é substituída por um único espaço. Assim, a tradução nunca acrescenta uma linha. Uma tradução vazia impede a montagem da saída para esse idioma.

O reaproveitamento se baseia no texto inalterado de cada linha e na posição dela no arquivo, assim como nos blocos de legenda SubRip. Alterar o recuo de uma linha não exige uma nova tradução. Quando linhas são adicionadas ou removidas, uma linha cujo texto aparece uma única vez no arquivo mantém sua tradução, enquanto uma linha cujo texto aparece mais de uma vez é traduzida novamente. Um arquivo de destino com um número de linhas diferente do arquivo de origem anterior não fornece texto reaproveitável. Por isso, mantenha o arquivo de origem anterior junto da tradução aceita correspondente.

Configure e confira o texto #

A CLI e o GitHub App inferem txt a partir de .txt. Um arquivo .txt só corresponde a uma entrada de arquivos cujo padrão termine em .txt, como metadata/en/*.txt, ou que defina "format": "txt". Já uma entrada com "format": "txt" seleciona apenas arquivos .txt. Um padrão abrangente como docs/en/**/* ignora arquivos .txt. Por isso, arquivos como LICENSE.txt ou requirements.txt não são traduzidos, mas uma entrada posterior que especifique .txt ainda pode selecioná-los. Da mesma forma, uma entrada abrangente com "format": "txt" ignora imagens e outros arquivos que não sejam de texto. Use Configuração da CLI ou GitHub para selecionar arquivos. O escopo de chaves da CLI não está disponível, pois os números de linha indicam posições, não chaves estáveis.

Cada linha é traduzida como uma unidade separada. Por isso, um parágrafo distribuído em várias linhas é traduzido linha por linha. Mantenha cada parágrafo em uma única linha quando o idioma de destino exigir uma mudança na ordem dos elementos de uma frase. Confira a tradução no local em que o texto será usado: uma página de aplicativo em uma loja ou um campo com limite de tamanho pode rejeitar uma tradução mais longa que o original.