Provided by: po4a_0.41-1_all bug

NOMBRE DE REFERENCIA

       po4a-build - Construye documentacion traducida

SINOPSIS

       po4a-build [-f | --file fichero] [--pot-only]

       po4a-build [-? | -h | --help | --version]

DESCRIPCI'ON

       La meta de po4a-build es facilitar la generacion de documentacion
       traducida tanto como lo es generar el contenido sin traducir.

       Cuando po4a prepara el contenido traducido bien como POD o DocBook XML,
       puede usar la orden po4a-build para generar la documentacion final. El
       contenido traducido y sin traducir se generan en un solo proceso,
       actualizando los ficheros POT a la vez.

       Puede reemplazar las instrucciones de construccion existentes con una
       sola invocacion a po4a-build y un sencillo fichero de configuracion
       usado para decir a po4a-build como construir cada elemento y que
       paquetes binarios incluiran el contenido traducido y sin traducir.

       Una vez generado, el contenido estara en los directorios especificos a
       cada paquete bajo el BASEDIR (directorio padre) definido en el fichero
       de configuracion. Para un paquete binario <<foo>>, con traducciones al
       aleman y al frances, el resultado seria el siguiente:

           BASEDIR/foo/man/man1/foo.1
           BASEDIR/foo/man/de/man1/foo.1
           BASEDIR/foo/man/fr/man1/foo.1

       Esto facilita incluir todo el contenido generado dentro de los paquetes
       binarios, con una sola ubicacion de instalacion.

           doc/foo/man/* ./usr/share/man/
           doc/foo/html/* ./usr/share/doc/foo/

       Esta regla no se tendra que actualizar al anadir traducciones nuevas, y
       permite anadir un segundo paquete binario (<<bar>>) manteniendo el
       contenido de este separado.

   Formatos compatibles
       A dia de hoy, po4a-build es compatible con las siguientes
       combinaciones:

        1. DocBook XML para la seccion 1.

        2. DocBook XML para la seccion 3.

        3. DocBook XML para HTML

        4. POD para la seccion 1.

        5. POD para la seccion 3.

        6. POD para la seccion 5.

        7. POD para la seccion 7.

       Puede gestionar todos los formatos compatibles y combinaciones posibles
       con un solo fichero de configuracion, po4a-build.conf, y una sola
       invocacion a po4a-build. Consulte po4a-build.conf(5).

CONFIGURACI'ON

       Por omision, po4a-build usa un fichero de configuracion,
       po4a-build.conf, el cual deberia estar en el directorio superior del
       sistema de control de versiones de su paquete. (Use la opcion -f para
       especificar un fichero diferente.) Consulte po4a-build.conf(5).

       Ejemplo 1. Ejemplo de fichero de configuraci'on

       Dispone de un ejemplo de fichero de configuracion en:

           /usr/share/doc/po4a/examples/po4a-build.conf.example

   Dise~no del fichero de configuraci'on
       El fichero de configuracion consiste de varias secciones: general,
       compatibilidad con XML/XSL, POD y HTML.

       La seccion general incluye el nombre y la ubicacion del fichero de
       configuracion de po4a (quiza sea mejor nombrarlo po4a.config), el
       directorio <<po/>> que contiene la documentacion en formatoPO, (a
       menudo doc/po), el nombre completo del fichero POT empleado para
       generar las traducciones, el <<BASEDIR>> para la salida generada, si el
       paquete contiene paginas de manual en la seccion 3 en lugar de solo en
       la seccion 1, y los nombres de los paquetes binarios que contendran la
       salida generada.

       La compatibilidad con XML/XSL incluye especificar que paquetes binarios
       usan la compatibilidad con XSL a traves de la variable <<XMLPACKAGES>>,
       el el fichero de DocBook en el nivel superior a introducir a xsltproc,
       y la ubicacion de los ficheros XML o DocBook. Puede anular <<XSLFILE>>
       si es necesario.

       La compatibilidad con POD incluye especificar que paquetes binarios
       usan la compatibilidad con POD a traves de la variable <<PODPACKAGES>>
       y el nombre completo del fichero POD.

       La compatibilidad con HTML especifica el subdirectorio a crear bajo
       <<BASEDIR>> que contendra el contenido HTML traducido y sin traducir, y
       el fichero DocBook usado para generar HTML. Puede anular el fichero
       <<HTMLXSL>> si es necesario.

'ORDENES

       --pot-only
           Solo actualiza uno o varios ficheros POT. La opcion --pot-only esta
           disenada para ofrecer la compatibilidad con paquetes que incluyen
           todos los ficheros POT en el paquete de fuentes. Aquellos paquetes
           que usan Autotools pueden anadir facilmente el fichero POT a traves
           de <<EXTRA_DIST>>, pero aquellos paquetes que emplean un
           <<Makefile>> o algunos asistentes de compilacion de sistemas de
           control de versiones encontraran extrano anadir el fichero POT (que
           es un fichero generado) sin poner el fichero POT en el sistema de
           control de versiones. Para evitar este trabajo feo e innecesario,
           po4a-build puede actualizar el o los ficheros POT al principio de
           la construccion, de forma que dpkg-source los incluya en el archivo
           tar de fuentes.

           Ejemplo 2. Ejemplo de svn-buildpackage

           svn-buildpackage tiene compatibilidad explicita para esta clase de
           anadidos, usando la propiedad useNativeDist de SVN y el <<target>>
           de Make native-dist.

               # Anade el fichero POT al archivo tar de fuentes
               native-dist: Makefile
                    po4a-build --pot-only

               $ svn propset useNativeDist 1 debian

       -h|--help
           Muestra el mensaje de uso y cierra

       --version
           Muestra el mensaje de uso y cierra

OPCIONES

       -f|--file fichero
           Anula el fichero de configuracion predefinido de poa-build
           (po4a-build.conf) e introduce el suyo.

AUTOR

       po4a-build fue creado por Neil Williams codehelp@debian.org.

       Neil Williams escribio esta pagina de manual.  codehelp@debian.org