Gettext
Traduce los valores de destino de PO respetando el contexto de los mensajes, la identidad del texto de origen y los límites de la reconstrucción de plurales.
Gettext mantiene el texto de origen y su traducción en la misma entrada. El gestor de archivos po lee msgid y escribe la traducción en msgstr, sin modificar el texto de origen. También utiliza msgctxt para distinguir palabras idénticas usadas en contextos diferentes.
El contexto distingue los mensajes #
Por ejemplo, estas entradas pueden recibir distintas traducciones de «Back»:
msgctxt "checkout navigation"
msgid "Back"
msgstr ""
msgctxt "product surface"
msgid "Back"
msgstr ""Son unidades independientes, aunque su msgid sea idéntico. El contexto también se proporciona como orientación para la traducción. Las líneas de comentarios y marcas se conservan junto con las entradas, pero eso no implica que todos los comentarios se interpreten como instrucciones ni que se actualicen las marcas de revisión.
El analizador está diseñado para procesar los campos PO entre comillas y las líneas de continuación compatibles. Utiliza archivos de entrada en UTF-8; no convierte cualquier codificación antigua. La detección automática de .pot queda fuera del alcance definido para la inferencia de .po de la CLI.
La reconstrucción de plurales tiene límites #
En una entrada de plural, msgid y msgid_plural se convierten en dos unidades de texto independientes: una en singular y otra en plural. El gestor 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 de plural, en lugar de formas generadas de manera independiente.
Revisa el resultado de los plurales antes de compilarlo. Un idioma que requiera varias formas distintas necesita el texto correcto en cada posición y una cabecera Plural-Forms acorde con esas formas. Se da preferencia a las cabeceras de destino existentes; al generar la primera salida, se conserva la cabecera de origen y se cambia Language al idioma de destino. El gestor no reescribe Plural-Forms para el idioma de destino.
Actualizaciones y serialización #
La versión anterior del origen permite identificar los cambios por contexto, identidad del mensaje y unidad de singular o plural. Las entradas de destino existentes aportan los valores de msgstr que se conservan. Cambiar la identidad del texto de origen puede hacer que un mensaje se considere nuevo, aunque su traducción aceptada siga siendo útil.
La reconstrucción conserva los campos de origen, las líneas de comentarios y la disposición del contenido en torno a cada entrada, mientras sustituye los valores de msgstr y la cabecera correspondiente. El formato de los valores de traducción entre comillas puede cambiar. Además de analizar el archivo, valida el número 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, después, prueba los plurales con distintas cantidades y las búsquedas por contexto. Comprueba los valores de plural repetidos y las cabeceras incluso si el archivo se analiza correctamente: determinan lo que muestra la aplicación para cada cantidad.