Gettext

Traduza os valores de destino em ficheiros PO, preservando o contexto das mensagens e a identidade da origem e respeitando os limites da reconstrução de plurais.

O Gettext mantém o texto de origem e a tradução na mesma entrada. O processador de ficheiros po lê msgid e escreve a tradução em msgstr, sem alterar o texto de origem. Também utiliza msgctxt para distinguir palavras idênticas usadas em situações diferentes.

O contexto distingue as mensagens #

Por exemplo, estas entradas podem receber traduções diferentes de «Back»:

text
msgctxt "checkout navigation"
msgid "Back"
msgstr ""

msgctxt "product surface"
msgid "Back"
msgstr ""

Estas unidades são distintas, apesar de terem o mesmo msgid. O contexto também é fornecido como uma indicação para a tradução. As linhas de comentários e de sinalizadores são mantidas com as entradas, mas isso não significa que todos os comentários sejam interpretados como instruções nem que os sinalizadores de revisão sejam atualizados.

O analisador especializado abrange os campos PO entre aspas suportados e as linhas de continuação. Utilize ficheiros de entrada em UTF-8; o analisador não converte quaisquer codificações antigas. A deteção automática de .pot não está abrangida pelo contrato de inferência de .po da CLI.

A reconstrução de plurais tem limites #

Numa entrada de plural, msgid e msgid_plural passam a ser unidades de texto separadas, uma no singular e outra no plural. O processador cria pelo menos duas posições de destino. Se o destino existente tiver mais posições, as entradas que não sofreram alterações mantêm as formas aceites. Quando uma das duas primeiras formas de destino muda, as posições adicionais recebem o novo valor de plural, em vez de formas geradas de modo independente.

Reveja o resultado dos plurais antes de o compilar. Um idioma que exija várias formas distintas precisa do texto correto em cada posição e de um cabeçalho Plural-Forms correspondente. Os cabeçalhos de destino existentes têm preferência; na primeira geração do resultado, mantém-se o cabeçalho de origem, com Language alterado para o idioma de destino. O processador não reescreve Plural-Forms para o idioma de destino.

Atualizações e serialização #

A versão anterior da origem permite identificar alterações com base no contexto, na identidade da mensagem e na unidade de singular ou plural. As entradas de destino existentes fornecem os valores de msgstr a manter. Alterar a identidade da origem pode fazer com que uma mensagem seja considerada nova, mesmo que a tradução aceite continue a ser útil.

A reconstrução mantém os campos de origem, as linhas de comentários e a disposição em torno das entradas, substituindo os valores de msgstr e o cabeçalho relevante. Os valores de tradução entre aspas podem ser reformatados. Além de analisar o ficheiro, valide a contagem de mensagens e os metadados de plural.

Configure e compile o catálogo #

A CLI infere po a partir de .po. Selecione os catálogos de origem através da configuração da CLI ou do GitHub.

Compile ou importe o resultado com as ferramentas Gettext da aplicação e, em seguida, teste diferentes quantidades no plural e a pesquisa por contexto específico. Verifique os valores de plural repetidos e os cabeçalhos, mesmo quando a análise é bem-sucedida: são eles que determinam o que a aplicação apresenta para cada quantidade.