Comprender la estructura de archivos.po
A .po file (Objeto portátil) es el formato estándar utilizado por los flujos de trabajo de localización basados en gettext. Combina cadenas de origen originales ( msgid) con cadenas traducidas ( msgstr) y lleva metadatos como texto simple. Más allá de los pares visibles, dos elementos juegan un papel decisivo para traductores y desarrolladores: comentarios y contexto. Comentarios comunican la intención, las limitaciones o los detalles de la implementación, mientras que el contexto (el msgctxt campo) desambigua cadenas idénticas utilizadas en diferentes lugares.
Saber la anatomía del archivo le ayuda a crear comentarios y contexto útiles. Una entrada típica contiene comentarios opcionales de desarrollador y traductor, líneas de referencia opcionales que apuntan a ubicaciones de código fuente, banderas que indican formas plurales o formato, y el msgctxt cuando sea necesario. Trate de como ciudadanos de primera clase—son ligeros, legibles por humanos y pueden prevenir errores costosos de traducción.
Diferentes tipos de comentarios en archivos. po
.po archivos soportan varios formularios de comentario, cada uno con un propósito específico. Usando el tipo correcto de comentario hace que pare predecible para herramientas y más claro para los humanos. A continuación se presenta una explicación concisa de los tipos comunes y cuándo utilizarlos.
La tabla que sigue reanudar los tipos de comentarios, lo que significan, y ejemplos de uso práctico.
| Eritrea | Significado | Cuándo utilizar |
|---|---|---|
| #. | Comentario extraído automático (nota del traductor) | Uso de indicios semánticos producidos por herramientas de extracción, como parámetro significado |
| #: | Referencia a la ubicación de la fuente (file:line) | Incluya al señalar traductores a donde aparece la cadena en código |
| #, | Banderas (por ejemplo, borrosas, forma de pecado) | Populado por herramientas para indicar estado o manejo especial |
| # | Comentario de traductor (forma libre) | Notas humanas de traductores o breves sugerencias de desarrolladores |
| #| | anterior cadena no traducida (obsoleta) | Al guardar la historia después de los cambios rara vez es necesario |
Uso líneas de referencia ( #: path/file:line) cuando la ubicación importa para significado. Uso #. para insinuaciones cortas, extraídas programáticamente y simples # para instrucciones específicas que los traductores necesitan leer. Evite duplicar información en varios tipos de comentarios; prefiera un comentario autorizado por entrada.
Contexto (msgctxt) para traducciones precisas
El msgctxt campo existe para desambiguar cadenas de fuentes idénticas utilizadas en diferentes contextos semánticos. Por ejemplo, la palabra inglesa "Cerrar" puede significar "cerrar" o "cerrar". Sin contexto, los traductores deben adivinar, lo que puede conducir a errores en idiomas donde esos significados usan palabras diferentes.
Mejores usos de msgctxt:
- Cuando la misma cadena fuente aparece en elementos de interfaz de usuario con diferentes funciones (por ejemplo, la etiqueta de botón vs texto descriptivo).
- Cuando la pluralización o el género gramatical depende de cómo se utiliza la cadena.
- Cuando el formato externo tokens o marcado cambia significado y ser necesita preservado exactamente.
Ejemplo práctico (descrito): preferir añadir msgctxt como "button:close" y "label:distance-close" en lugar de confiar en comentarios solo. Esto garantiza herramientas de traducción y traductores ver una distinción legible por máquina. Evitar valores de contexto demasiado verbosos; mantenerlos cortos, consistentes y estables a través de las liberaciones.
Las mejores prácticas para escribir y mantener comentarios
Las buenas observaciones son concisas, pertinentes y estables. Deben explicar por qué existe una cadena, a describir los propietarios de puestos y señalar cualquier limitación gramática. No repita lo que ya es obvio de la cadena fuente; en cambio, agregue información que prevenga errores.
Prácticas que pueden aplicar inmediatamente:
- Explicar los titulares de puestos y formatear — Si una cadena contiene titulares como "%s" o "{name}", su orden describir y si pueden omitirse o repetirse.
- Dar un ejemplo de uso corto — Ejemplos de una línea aclaran la intención. Por ejemplo: #. Aparece en la página de configuración de la cuenta como una etiqueta de botón
- Marcar piezas no transitables — Si una marca o término técnico debe permanecer inalterable, indíquelo claramente en el comentario.
- Mantenga los comentarios estables y versionados — Cuando cambie el comportamiento de la UI, actualice el comentario con el nuevo contexto e incluya una referencia de fecha o ticket si es útil.
- Evite la jerga del desarrollador solo — Mantenga el lenguaje accesible a los traductores profesionales; use frases sencillas y evite siglas internas a menos que se explique.
Al comentarios entre versiones, eyecute un pase rápido para eliminar notas obsoletas y referencias correctas. Si una cadena se elimina o cambia significativamente, actualice o elimine comentarios relacionados para evitar confusos traductores.
Consejos de colaboración entre desarrolladores y traductores
Los mejores resultados de localización resultan de una colaboración ligera y continua. Los comentarios y el contexto son el canal de comunicación integrado directamente en el flujo de trabajo de traducción. Hacer que sean eficaces aceptando convenciones compartidas y comportamientos de herramientas.
Prácticas de colaboración viables:
- Establecer una guía de estilo de comentarios — Decidir sobre prefijos, duración mínima del contexto y si incluir números de tickets. Documente la guía donde ambos equipos pueden acceder a ella.
- Uso de convenciones de msgctxt consistentes — Por ejemplo, contextos prefijos con "botón:", "menu:", o "error:" para que los traductores puedan explorarr e inferir el uso rápidamente.
- Ejecute una revisión a bordo para traductores — Compartir un corto paseo de los patrones de localización de su base de código y los propietarios de lugares comunes.
- Alentar comentarios bidireccionales — Permitir a los traductores añadir comentarios de traductores (#) con preguntas o notas. Revise estos comentarios mensuales y responda o actualice las fuentes para reflejar las aclaraciones.
- Controles automáticos — Integrar el revestimiento que advierte sobre las tendencias de los propietarios de lugares desaparecidos, msgctxt vacío donde existe ambigüedad, o referencias inconsistentes.
Por último, los comentarios de los traductores de valor. Un comentario conciso del traductor señalando la ambigüedad genuino es la información que debe incorporar en la fuente para evitar problemas recurrentes. El objetivo es un bucle de mejora continua en el que los comentarios y el contexto evolucionan con el producto en lugar de convertirse en anotaciones definitivas.
