Gettext

Traduce los valores de destino de PO sin perder el contexto del mensaje ni la identidad del texto de origen, y teniendo en cuenta los límites de la reconstrucción de plurales.

Gettext mantiene el texto de origen y su traducción en una misma entrada. El controlador de archivos po lee msgid y escribe la traducción en msgstr, sin alterar el texto de origen. También usa msgctxt para distinguir palabras idénticas que se usan en situaciones diferentes.

El contexto distingue los mensajes #

Por ejemplo, estas entradas pueden recibir distintas traducciones de “Back”:

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

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

Estas entradas son unidades independientes, aunque tengan el mismo msgid. El contexto también se proporciona como una orientación para la traducción. Las líneas de comentarios e indicadores se conservan junto con las entradas, pero esto no implica que cada comentario se interprete como una instrucción ni que se actualicen los indicadores de revisión.

El analizador especializado procesa los campos PO entre comillas que admite y las líneas de continuación. Usa archivos de entrada en UTF-8; el analizador no convierte codificaciones heredadas arbitrarias. La detección automática de .pot queda fuera del alcance del contrato de inferencia de .po de la CLI.

La reconstrucción de plurales tiene límites #

En una entrada plural, msgid y msgid_plural se convierten en dos unidades de texto independientes: una singular y otra plural. El controlador genera al menos dos posiciones de destino. Si el destino existente tiene más posiciones, las entradas sin cambios conservan sus formas aceptadas. Cuando cambia cualquiera de las dos primeras formas de destino, las posiciones adicionales reciben el nuevo valor plural, en lugar de formas generadas de manera independiente.

Revisa la salida de plurales antes de compilarla. Un idioma que requiere varias formas distintas necesita el texto correcto en cada posición y un encabezado Plural-Forms que corresponda a esas formas. Se da preferencia a los encabezados de destino existentes; en la primera salida, se conserva el encabezado de origen y se cambia Language al idioma de destino. El controlador no reescribe Plural-Forms para el idioma de destino.

Actualizaciones y serialización #

La versión anterior del texto de origen permite identificar los cambios por contexto, identidad del mensaje y unidad singular o plural. Las entradas de destino existentes proporcionan los valores de msgstr que se conservan. Cambiar la identidad del texto de origen puede hacer que un mensaje se considere nuevo, incluso si su traducción aceptada todavía sería útil.

La reconstrucción conserva los campos de origen, las líneas de comentarios y la disposición de las entradas y su entorno, mientras reemplaza los valores de msgstr y el encabezado correspondiente. El formato de los valores de traducción entre comillas puede cambiar. Además de analizar el archivo, valida el recuento de mensajes y los metadatos de plurales.

Configura y compila el catálogo #

La CLI infiere po a partir de .po. Selecciona los catálogos de origen mediante la configuración de la CLI o GitHub.

Compila o importa la salida con las herramientas de Gettext de la aplicación y luego prueba distintas cantidades para verificar los plurales y las búsquedas específicas por contexto. Revisa los valores plurales repetidos y los encabezados, incluso si el análisis se completa correctamente: estos determinan lo que la aplicación muestra para cada cantidad.