Provided by: po4a_0.40-1_all bug

NAME

       po4a-build - Construir documentacin traducida.

SYNOPSIS

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

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

DESCRIPCIN

       La meta de po4a-build es facilitar la creacin de documentacin traducida
       tanto como lo es producir el contenido del mismo sin traducir.

       Cuando po4a prepara el contenido traducido bien como POD o DocBookXML
       puede usar la orden po4a-build para generar la documentacin final. El
       contenido ya traducido y sin traducir se genera en un slo proceso,
       actualizando los ficheros pot a la vez.

       Puede reemplazar las instrucciones de construccin existentes con una
       sola invocacin a po4a-build y un sencillo fichero de configuracin usado
       para decir a po4a-build cmo construir cada elemento y qu paquetes
       binarios incluirn el contenido traducido y sin traducir.

       Una vez generado, el contenido estar en los directorios especficos a
       cada paquete incluidos en BASEDIR (directorio padre) especificado en el
       fichero de configuracin. De usar un paquete binario <<foo>>, con
       traducciones en alemn y francs, el resultado sera este:

           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 ubicacin de instalacin.

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

       No precisa actualizar esta regla al aadir traducciones nuevas, y
       permite aadir un segundo paquete binario (<<bar>>) manteniendo su
       contenido separado.

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

        1. DocBook XML para la Seccin 1.

        2. DocBook XML para la Seccin 3.

        3. DocBook XML para HTML

        4. POD para la secciones 1.

        5. POD para la Seccin 3.

        6. POD para la Seccin 5.

        7. POD para la Seccin 7.

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

CONFIGURACIN

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

       Example 1. Ejemplo de fichero de configuracin.

       Dispone de un ejemplo de fichero de configuracin en:

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

   Partes del fichero de configuracin.
       El fichero de configuracin consiste de varias secciones: general,
       compatibilidad con XML/XSL, POD y HTML.

       La seccin general incluye el nombre y la ubicacin del fichero de
       configuracin de po4a (quiz sea mejor nombrarlo po4a.config), el
       directorio de ficheros po que contiene la documentacin en formato po,
       (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 pginas de manual en la seccin 3, en lugar de slo en la
       seccin 1, y los nombres de los paquetes binarios que contendrn la
       salida generada.

       La compatibilidad con XML incluye especificar qu paquetes binarios usan
       la compatibilidad con XSL a travs de la variable <<XMLPACKAGES>>.
       Tambin debe especificar el fichero de DocBook en el nivel superior para
       introducirlo a xsltproc, y la ubicacin de los ficheros XML o DocBook.
       Si es necesario, puede anular <<XSLFILE>>.

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

       Para obtener la compatibilidad con HTML, tendr que especificar el
       subdirectorio a crear, por debajo de <<BASEDIR>> para el contenido HTML
       traducido y sin traducir, y el fichero DocBook para generar el HTML. Si
       es necesario, puede invalidar el fichero <<HTMLXSL>>.

RDENES

       --pot-only
           Slo actualiza uno o varios ficheros POT. La opcin --pot-only est
           diseada para ofrecer la compatibilidad con paquetes que incluyen
           todos los ficheros POT en el paquete de fuentes. Aquellos paquetes
           que usan autotools pueden aadir el fichero POT a travs de
           <<EXTRA_DIST>>, pero aquellos paquetes que emplean un <<makefile>>,
           o algunos asistentes de compilacin de sistemas de control de
           versiones, encontrarn raro aadir 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
           construccin, de forma que dpkg-source los incluye en el archivo tar
           de fuentes.

           Example 2. Ejemplo de svn-buildpackage.

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

               # aade el fichero pot al tarball de fuentes.
               native-dist: Makefile
                    po4a-build --pot-only

               $ svn propset useNativeDist 1 debian

       -h|--help
           Mostrar el mensaje de uso y salir.

       --version
           Mostrar el mensaje de uso y salir.

OPCIONES

       -f|--file fichero
           Invalidar el fichero de configuracin de poa-build
           (po4a-build.conf)e introducir otro.

AUTOR

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

       Neil Williams escribi esta pgina de manual.  codehelp@debian.org