PO4A-TRANSLATE(1p)

NOMBRE
po4a-translate - convierte un archivo po al formato de documentacion

SINOPSIS
po4a-translate -f <formato> -m <principal.doc> -p <XX.po> -l <XX.doc>

(XX.doc es la salida, todos los otros son entrada)

DESCRIPCION
El objetivo del proyecto po4a (po para todo) es facilitar la traduccion (y mas interesante, el mantenimiento de las traducciones) usando las herramientas de gettext en areas donde no eran de esperar, como en la documentacion.

El script "po4a-translate" se encarga de convertir la traduccion (que se se hizo en un archivo po) de vuelta al formato de documentacion. El archivo "po" proporcionado debe ser la traduccion del archivo "pot" que de produjo con po4a-gettextize(1).

OPCIONES

-f, --format
    Tipo de formato de la documentacion que quieres tratar. Usa la opcion --help-format para ver la lista de los formatos disponibles.

-a, --addendum
    An~ade un archivo al archivo resultante (para poner el nombre del traductor o una seccion "Acerca de esta traduccion", por ejemplo). La primera linea del archivo a insertar debe ser la cabecera PO4A indicando donde se debe insertar (ver seccion Como an~adir cosas que no son traducciones en po4a(7)).

-A, --addendum-charset
    Juego de caracteres del apendice. Todos los apendices deben estar en el mismo juego de caracteres.

-m, --master
    Archivo que contiene el documento principal a traducir.

-M, --master-charset
    Juego de caracteres del archivo que contiene el documento principal a traducir.

-l, --localized
    Archivo donde se debe escribir el documento localizado (traducido).

-L, --localized-charset
    Juego de caracteres del archivo que contiene la version localizada del documento.

-p, --po
    Archivo del que se debe leer el catalogo de mensajes.

-o, --option
    Extra option(s) to pass to the format plugin. Specify each option in the 'name=value' format. See the documentation of each plugin for more information about the valid options and their meanings.

-k, --keep
    Umbral minimo del porcentaje de traduccion para mantener (es decir, escribir) el archivo resultante (defecto: 80). Es decir, por defecto, los ficheros deben estar traducidos como minimo en un 80% para que se escriba el resultado.

-w, --width
    Columna a la que se debe justificar el archivo resultante.

-h, --help
    Muestra un mensaje corto de ayuda.

--help-format
    Lista los formatos de documentos reconocidos por po4a.

-V, --version
    Muestra la version del script y termina.

-v, --verbose
    Aumenta la cantidad de mensajes informativos del programa.

-d, --debug
    Muestra informacion de depuracion.

An~adiendo contenido (a parte de las traducciones) a los archivos generados
Para an~adir algun contenido extra al documento generado a parte de lo traducido (como el nombre del traductor, o una seccion "Sobre esta traduccion"), debes usar la opcion "--addendum".

La primera linea de un apendice debe ser una cabecera indicando en que parte del documento se debe insertar (puede ser antes o despues de una parte del documento). El resto del archivo va a ser insertado tal cual al archivo resultante sin ningun proceso.

Tenga en cuenta que si po4a-translate no puede an~adir uno de los archivos dados, descarta la traduccion entera (porque el archivo que falta puede ser el que contenia los datos del autor, lo que impediria a los usuarios que contactaran con el para informarle de errores en la traduccion).

La cabecera tiene una sintaxis bastante rigida. Para mas informacion sobre como usar esta caracteristica y como funciona, mira la pagina de manual de po4a(7).

VER TAMBIEN
po4a(7), po4a-gettextize(1), po4a-updatepo(1), po4a-normalize(1).

AUTORES
 Denis Barbier <barbier@linuxfr.org>
 Martin Quinson (mquinson#debian.org)

TRADUCCION
 Jordi Vilalta <jvprat@gmail.com>

DERECHO DE COPIA Y LICENCIA
Copyright 2002, 2003, 2004 por SPI, inc.

Esto es software libre; puedes redistribuirlo y/o modificarlo bajo las condiciones de la GPL (ver el archivo COPYING).