Texto simples

Traduza um ficheiro de texto linha a linha, mantendo cada linha da tradução na posição correspondente à do original.

Os ficheiros de texto simples, como descrições de aplicações em lojas e notas de versão, não têm marcação nem chaves. O processador de ficheiros txt traduz cada linha individualmente e substitui o texto original pela tradução, para que o ficheiro de destino tenha o mesmo número de linhas que o de origem.

Linhas e unidades #

Por exemplo:

text
Plan your trips offline.

  • Download maps for any region
  • Share routes with friends

Cada linha com texto corresponde a uma unidade de tradução, cuja chave é o respetivo número de linha. Neste exemplo, são traduzidas as linhas 1, 3 e 4. Uma linha em branco ou que contenha apenas espaços ou tabulações não constitui uma unidade e é copiada tal como está.

Os espaços e as tabulações no início e no fim de cada linha ficam fora da unidade, pelo que a indentação e os espaços finais são preservados na tradução. Só é traduzido o texto entre eles.

Resultado reconstruído #

O resultado substitui o texto de cada linha do ficheiro de origem atual e preserva tudo o resto, byte a byte: linhas em branco, indentação, a terminação de cada linha (LF ou CRLF, mesmo quando coexistem no mesmo ficheiro) e a presença ou ausência de uma quebra de linha no fim do ficheiro. Assim, o ficheiro de destino tem tantas linhas como o de origem.

Os espaços e as quebras de linha no início e no fim de uma tradução são removidos, e qualquer quebra de linha no seu interior é substituída por um único espaço. Assim, a tradução nunca acrescenta linhas. Uma tradução vazia impede a geração do resultado para esse idioma.

A reutilização baseia-se no texto inalterado de cada linha e na sua posição no ficheiro, tal como acontece com os segmentos de SubRip. Alterar a indentação de uma linha não exige uma nova tradução. Quando se adicionam ou removem linhas, uma linha cujo texto aparece uma única vez no ficheiro mantém a tradução, enquanto uma linha cujo texto aparece mais de uma vez é traduzida novamente. Um ficheiro de destino com um número de linhas diferente do ficheiro de origem anterior não fornece texto reutilizável. Por isso, mantenha o ficheiro de origem anterior associado ao respetivo ficheiro de destino aceite.

Configurar e verificar o texto #

A CLI e a GitHub App inferem txt a partir de .txt. Um ficheiro .txt só é abrangido por uma entrada de ficheiros cujo padrão termine em .txt, como metadata/en/*.txt, ou que defina "format": "txt". Uma entrada com "format": "txt" seleciona apenas ficheiros .txt. Um padrão abrangente como docs/en/**/* ignora ficheiros .txt, pelo que ficheiros como LICENSE.txt ou requirements.txt não são traduzidos; uma entrada posterior que indique .txt pode, ainda assim, selecioná-los. Da mesma forma, uma entrada abrangente com "format": "txt" ignora imagens e outros ficheiros que não sejam de texto. Consulte a configuração da CLI ou o GitHub para selecionar ficheiros. A seleção por chave não está disponível na CLI, porque os números de linha representam posições, não chaves estáveis.

Cada linha é traduzida como uma unidade separada, pelo que um parágrafo dividido em várias linhas é traduzido linha a linha. Mantenha cada parágrafo numa única linha quando o idioma de destino exigir a reordenação de uma frase. Verifique a tradução no local onde o texto é utilizado: uma página de apresentação numa loja ou um campo com limite de comprimento pode rejeitar uma tradução mais longa do que o original.