Documentación / Traducir / gettext .po
Traducir archivos .po de gettext
Rellena las entradas vacías y difusas en archivos .po de Django, WordPress, PHP y Python, con espacios msgstr[n] de Plural-Forms de cada idioma y msgctxt y comentarios del traductor como contexto.
Cómo funciona
En gettext, cada archivo .po de un idioma contiene su propia copia del texto fuente, por lo que localize-dev translate trata cada archivo como un catálogo: rellena las entradas cuyo msgstr está vacío o marcado como difuso y deja las traducidas sin tocar. Las entradas obsoletas #~ se omiten.
Los comentarios del traductor (#.) y msgctxt van al modelo como contexto, por lo que "Archive" en un botón se traduce como un verbo. Un nuevo idioma (--locales pl) obtiene su propio archivo junto a uno existente, con su encabezado Language y Plural-Forms. Compile como de costumbre después: python manage.py compilemessages para Django, msgfmt en otros lugares.
Antes y después
Salida real de localize-dev translate --locales de,pl en el primer archivo. El archivo alemán tenía dos entradas vacías y una difusa. Con --locales de,pl se rellenaron, y el archivo polaco de abajo se creó con tres espacios para plurales.
msgid ""
msgstr ""
"Language: de\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
#. Heading on the account page
msgid "Your account"
msgstr ""
#, fuzzy
msgid "Signed in as %(email)s"
msgstr "Angemeldet als"
msgctxt "verb, on a button"
msgid "Archive"
msgstr ""
msgid "%(count)s file uploaded"
msgid_plural "%(count)s files uploaded"
msgstr[0] ""
msgstr[1] ""msgid ""
msgstr ""
"Language: pl\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);\n"
#. Heading on the account page
msgid "Your account"
msgstr "Twoje konto"
msgid "Signed in as %(email)s"
msgstr "Zalogowano jako %(email)s"
msgctxt "verb, on a button"
msgid "Archive"
msgstr "Archiwizuj"
msgid "%(count)s file uploaded"
msgid_plural "%(count)s files uploaded"
msgstr[0] "%(count)s plik przesłany"
msgstr[1] "%(count)s pliki przesłane"
msgstr[2] "%(count)s plików przesłanych"Lo que se mantiene intacto
- Marcadores de posición
%(name)s,{name}y printf, comprobados - Un
msgstr[n]por espacio de Plural-Forms del idioma: 3 para polaco, 6 para árabe - La cabecera, los comentarios del traductor y el orden de las entradas
msgctxt, por lo que el mismo msgid se puede traducir de manera diferente según el contexto
Errores comunes y cómo se evitan
Entradas difusas olvidadas
gettext omite las entradas difusas al compilar, por lo que una traducción obsoleta recurre silenciosamente al texto de origen. Las entradas difusas se traducen de nuevo y se borra la marca.
El número incorrecto de espacios para plurales
Un archivo copiado del alemán tiene dos espacios msgstr[n]; el polaco necesita tres. El Plural-Forms del nuevo archivo se establece para su idioma, y cada espacio recibe la forma para los números que caen en él.
Marcadores de posición reordenados
Los marcadores de posición sin nombre %s significan algo por su posición. Se rechaza una traducción que los reordena. Los nombrados como %(email)s pueden moverse donde la oración los necesite.
Ejecutar
En la carpeta que contiene tus archivos de localización. Los idiomas que aún no tienen archivo obtienen uno. --dry-run muestra qué cambiaría primero.
npx localize-dev login
# Preview, then write the missing translations
npx localize-dev translate --dry-run -l es,fr,de
npx localize-dev translate -l es,fr,deLuego mantenlo completo en CI. Esto no necesita una clave API y falla cuando a un idioma le faltan traducciones:
npx localize-dev check --only translationsGratis para 1000 cadenas al mes. Una cadena cuenta una vez sin importar en cuántos idiomas se incluya. Crea una cuenta gratuita
Guías para aplicaciones que usan este formato
Cuando el texto todavía está codificado en tu código, localize-dev run lo mueve a este formato primero.