Gettext
Traduza os valores de destino dos arquivos PO, preservando o contexto das mensagens e a identidade do texto de 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 manipulador de arquivos po lê msgid e grava a tradução em msgstr, sem alterar o texto de origem. Ele também usa msgctxt para distinguir palavras idênticas usadas em situações diferentes.
O contexto diferencia as mensagens #
Por exemplo, estas entradas podem receber traduções diferentes para “Back”:
msgctxt "checkout navigation"
msgid "Back"
msgstr ""
msgctxt "product surface"
msgid "Back"
msgstr ""Essas unidades são separadas, embora tenham o mesmo msgid. O contexto também é fornecido como dica de tradução. As linhas de comentários e sinalizadores são mantidas junto às entradas, mas isso não garante que todo comentário seja interpretado como uma instrução nem que os sinalizadores de revisão sejam atualizados.
O analisador tem escopo restrito: abrange os campos PO entre aspas e as linhas de continuação compatíveis. Use arquivos de entrada em UTF-8; ele não converte codificações legadas arbitrárias. A descoberta automática de .pot não faz parte do contrato de inferência de .po da CLI.
A reconstrução de plurais tem limites #
Em uma entrada de plural, msgid e msgid_plural se tornam unidades de texto separadas para o singular e o plural. O manipulador gera pelo menos duas posições de destino. Se o destino existente tiver mais posições, as entradas que não sofrerem alterações mantêm suas formas aceitas. Quando qualquer uma das duas primeiras formas de destino muda, as posições extras recebem o novo valor de plural, em vez de formas geradas de modo independente.
Revise a saída de plurais antes de compilá-la. Um idioma que exige 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 prioridade; na primeira saída, o cabeçalho de origem é mantido, com Language alterado para o idioma de destino. O manipulador não reescreve Plural-Forms para o idioma de destino.
Atualizações e serialização #
A versão anterior do texto de origem permite identificar alterações pelo contexto, pela identidade da mensagem e pela unidade de singular ou plural. As entradas de destino existentes fornecem os valores de msgstr a serem mantidos. Alterar a identidade do texto de origem pode fazer uma mensagem ser considerada nova, mesmo que a tradução já aceita ainda seja útil.
A reconstrução mantém os campos de origem, as linhas de comentários e a disposição ao redor das entradas, substituindo os valores de msgstr e o cabeçalho correspondente. Os valores de tradução entre aspas podem ser reformatados. Além de analisar o arquivo, 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 pela configuração da CLI ou pelo GitHub.
Compile ou importe a saída usando as ferramentas Gettext do aplicativo. Em seguida, teste quantidades no plural e consultas específicas por contexto. Confira os valores de plural repetidos e os cabeçalhos mesmo quando a análise for bem-sucedida: eles determinam o que o aplicativo exibe para cada quantidade.