Provided by:
po4a_0.40-1_all 
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