DESCRIPCIÓN¶

INTRODUCCIÓN¶

SINTAXIS DEL FICHERO DE CONFIGURACIÓN¶

Especificar las plantillas de idiomas

Especificar las rutas a las entradas del traductor

Detección automática de las rutas e idiomas

Especificar los documentos a traducir

Especificar las opciones para los módulos

Especificar un alias

Modo dividido

OPCIONES¶

EJEMPLO¶

DEFICIENCIAS¶

VÉASE TAMBIÉN¶

AUTORES¶

DERECHO DE COPIA Y LICENCIA¶

Especificar las plantillas de idiomas¶

Nota: Recomendamos usar [po_directory] en lugar de [po4a_langs] y [po4a_paths]. Consulte la sección Detección automática de las rutas e idiomas.

Ésta es una orden opcional que puede simplificar todo el fichero de configuración, y lo hará más escalable. Debe especificar una lista de los idiomas a los que desee traducir los documentos. Es así de simple:

 [po4a_langs] fr de

Esto le permitirá expandir $lang a todos los idiomas especificados en el resto del fichero de configuración.

Especificar las rutas a las entradas del traductor¶

Nota: Recomendamos usar [po_directory] en lugar de [po4a_langs] y [po4a_paths]. Consulte la sección Detección automática de las rutas e idiomas.

Primero debe especificar la ubicación de los ficheros de entrada del traductor (es decir, los ficheros que utilizan los traductores para hacer su trabajo). Puede hacer esto con la siguiente línea:

 [po4a_paths] doc/l10n/project.doc.pot \
              fr:doc/l10n/fr.po de:doc/l10n/de.po

Por ello, la orden es [po4a_paths]. El primer argumento es la ruta del fichero POT a usar. Todos los argumentos posteriores tienen la siguiente forma, que se explica por si sola:

    <idioma>:<ruta al fichero PO de este idioma>

Si ha definido la plantilla de idiomas, puede reescribir la linea anterior de la siguiente forma:

 [po4a_paths] doc/l10n/proyecto.doc.pot $lang:doc/l10n/$lang.po

También puede usar $master para referirse al nombre base del documento. En este caso po4a usará un modo dividido: se creará un POT y un PO (por cada idioma) por cada documento especificado en el fichero de configuración de po4a. Consulte la sección Modo dividido («Split Mode»).

 [po4a_paths] doc/$master/$master.pot $lang:doc/$master/$lang.po

Detección automática de las rutas e idiomas¶

Puede usar otra orden para especificar el nombre del directorio donde se ubican los ficheros POT y PO. Si se usa, po4a detectará el fichero POT como el único fichero *.pot en el directorio especificado. po4a usará también la lista de ficheros *.po para definir la lista de idiomas (eliminando la extensión). Estos idiomas se usarán como sustitución de la variable $lang en el resto del fichero de configuración.

No debería usar esta orden en combinación con las órdenes [po4a_langs] o [po4a_paths].

Al usar esta orden, tiene que crear un fichero POT vacío al ejecutar po4a por primera vez para así dar a conocer el nombre del fichero POT.

 [po_directory] po4a/po/

Especificar los documentos a traducir¶

Naturalmente, debe especificar qué documentos están traducidos, su formato, y dónde guardar sus traducciones. Se puede hacer con líneas como las siguientes:

 [type: sgml] doc/my_stuff.sgml fr:doc/fr/mon_truc.sgml \
              de:doc/de/mein_kram.sgml
 [type: pod] script fr:doc/fr/script.1 de:doc/de/script.1 \
             add_fr:doc/l10n/script.fr.add

Esto también se debería explicar por si mismo. Tenga en cuenta que en el segundo caso, doc/l10n/script.fr.add es un apéndice a («addenda») añadir a la versión francesa del documento. Consulte po4a(7) para más información sobre los apéndices.

Más formalmente, el formato es:

 [type: <formato>] <doc_original> (<idioma>:<doc_traducido>)*\
                   (add_<idioma>:<argumento>*<ruta_al_apéndice>)*

De no existir argumentos, ruta_al_apéndice es la ruta a un apéndice. Los argumentos son

?

Incluye ruta_al_apéndice si el fichero sí existe, y no hace nada de lo contrario.

@

ruta_al_apéndice no es un apéndice normal, sino un fichero que contiene una lista de apéndices, uno por línea. Cada apéndice puede ir precedido de argumentos.

!

Si ruta_al_apéndice se descarta, no se cargará, independientemente de cualquier especificación adicional referida al apéndice.

Si ha definido la plantilla de idiomas, puede reescribir la linea anterior de la siguiente forma:

 [type: pod] script $lang:doc/$lang/script.1 \
             add_fr:doc/l10n/script.fr.add

Si todos los idiomas tuviesen apéndices con rutas similares, también podría escribir algo así.

 [type: pod] script $lang:doc/$lang/script.1 \
             add_$lang:doc/l10n/script.$lang.add

Especificar las opciones para los módulos¶

po4a acepta opciones que se introducirán al módulo. Estas opciones son específicas a cada módulo y se definen con la opción -o.

Si precisa de una opción en particular para uno de los documentos que desea traducir, también puede especificarla en el fichero de configuración. Las opciones se introducen con la palabra clave opt. Debe entrecomillar el argumento de la palabra clave opt si éste contiene un espacio (por ejemplo, si especifica varias opciones, o una opción con un argumento). Puede también especificar opciones qué solo afectarán a un idioma en particular mediante la palabra clave opt_lang.

Este es un ejemplo:
[type:man] data-05/test2_man.1 $lang:tmp/test2_man.$lang.1 \
opt:"-k 75" opt_it:"-L UTF-8" opt_fr:-v Los argumentos pueden contener espacios si usa comillas simples o unas comillas dobles con un escape:
[po4a_alias:man] man opt:"-o \"mdoc=NAME,SEE ALSO\" -k 20"

Si desea especificar las mismas opciones para varios documentos, puede que quiera usar un alias (consulte a continuación la sección Especificar un alias).

También puede configurar opciones para todos los documentos especificados en el fichero de configuración:
[options] opt:"..." opt_fr:"..."

Especificar un alias¶

Si tiene que especificar las mismas opciones para varios ficheros, puede que le interese definir un alias de módulo. Puede hacer esto de la siguiente forma:

[po4a_alias:test] man opt:"-k 21" opt_es:"-o debug=splitargs"

Esto define un alias de módulo llamado test, basado en el módulo man, y en el que -k 21 afecta a todos los idiomas, con -o debug=splitargs afectando sólo a la traducción en español.

Este alias de módulo se puede usar como un módulo normal:

[type:test] data-05/test2_man.1 $lang:tmp/test2_man.$lang.1 \
opt_it:"-L UTF-8" opt_fr:-v

Tenga en cuenta que puede especificar opciones adicionales para cada fichero.

Modo dividido¶

El modo dividido («split mode») se usa cuando $master aparece en la línea de [po4a_paths].

Cuando se usa el modo dividido, se usarán unos grandes ficheros POT y PO temporales. Esto permite compartir las traducciones entre todos los PO.

Si dos PO tienen diferentes traducciones de la misma cadena, po4a marcará esta cadena como difusa («fuzzy») y mandará ambas traducciones a todos los PO que contengan está cadena. Entonces, cuando un traductor actualice la traducción y elimine la etiqueta de cadena difusa en un sólo PO, se actualizará automáticamente la traducción de esta cadena en cada PO.

OPCIONES DE MODIFICACIÓN DE CABECERA DE POT¶

porefs tipo[,wrap|nowrap]

Define el formato de referencia. El argumento tipo puede ser una de las siguientes opciones: none, para no generar ninguna referencia, noline Para no especificar el número de línea (todos los números de línea se sustituyen con 1), counter para sustituir el número de línea con recuento ascendente, o full para incluir las referencias completas.

El argumento puede preceder a una coma y a la palabra clave wrap o nowrap. Las referencias se escriben en una sola línea por omisión. La opción wrap justifica las referencias en varias líneas, para imitar a las herramientas gettext (xgettext y msgmerge). Esta opción será el comportamiento predefinido en el futuro, ya que es más inteligente. La opción nowrap está disponible para aquellos usuarios que deseen mantener el comportamiento antiguo.

--msgid-bugs-address email@address

Define el destinatario de los informes de fallo en los msgid. Por omisión, los ficheros POT creados no tienen el campo «Report-Msgid-Bugs-To».

--copyright-holder string

Define el propietario del copyright en la cabecera del POT. El valor predefinido es «Free Software Foundation, Inc».

--package-name string

Define el nombre del paquete en la cabecera del POT. El valor por omisión es «PACKAGE».

--package-version string

Define la versión del paquete en la cabecera del POT. El valor por omisión es «VERSION».

OPCIONES DE MODIFICACIÓN DE FICHEROS PO¶

--msgmerge-opt opciones

Opciones adicionales para msgmerge.

Nota: $lang se expandirá al idioma actual.

--no-previous

Esta opción añade --previous a las opciones introducidas a msgmerge. Esto permite la compatibilidad con versiones de gettext anteriores a 0.16.

--previous

Esta opción añade --previous a las opciones introducidas a msgmerge. Requiere gettext 0.16 o posterior, y está activada por omisión.

EJEMPLO¶

Supongamos que es el responsable de un programa llamado foo, que tiene una página de manual man/foo.1 que naturalmente sólo se mantiene en inglés. Ahora, al ser el mantenedor o encargado, desea crear y gestionar la traducción. Primero, cree el fichero POT, necesario para su envío a los traductores, usando po4a-gettextize(1).

En nuestro caso, invocaríamos:

 cd man && po4a-gettextize -f man -m foo.1 -p foo.pot

Ahora puede enviar este fichero a las listas de idioma adecuados u ofrecerlo para su descarga en su página web.

Supongamos ahora que ha recibido tres traducciones antes de su siguiente publicación: de.po (incluyendo el apéndice, «addendum», de.add), sv.po y pt.po. Ya que no desea modificar el o los ficheros Makefile cada vez que recibe una traducción nueva, puede usar po4a dentro de su Makefile creando un fichero de configuración adecuado. Le llamaremos po4a.cfg. En nuestro ejemplo, presentaría el siguiente aspecto:

 [po_directory] man/po4a/po/
 [type: man] man/foo.1 $lang:man/translated/$lang/foo.1 \
            add_$lang:?man/po4a/add_$lang/$lang.add opt:"-k 80"

En este ejemplo suponemos que sus páginas de manual generadas (y todos los ficheros PO y de apéndice) se guardan en man/translated/$lang, (respectivamente en man/po4a/po/ y man/po4a/add_$lang/) bajo el directorio actual. En nuestro ejemplo, este directorio incluiría de.po, de.add, pt.po y sv.po, y el directorio man/po4a/add_de/ incluiría de.add.

Note el uso del modificador ?, ya que sólo la traducción al alemán (de.po) viene acompañado de un apéndice.

Para generar realmente las páginas de manual tendría que añadir (¡una sola vez!) la siguiente línea en el «target» de construcción del fichero Makefile adecuado:

        po4a po4a.cfg

Una vez que configure esto, no tendrá que tocar el Makefile cada vez que reciba una traducción nueva. Por ejemplo, si el equipo francés envía fr.po y fr.add simplemente tendría que guardarlo en man/, y la siguiente vez que construya el programa la traducción al francés se generará automáticamente.

Tenga en cuenta que es aún necesario un destino adecuado dónde instalar las páginas de manual traducidas con las páginas en inglés.

Por último, si no guarda los ficheros generados en su sistema de control de versiones, necesitara también una línea en su target clean:
-rm -rf man/translated