Provided by:
po4a_0.41-1ubuntu1_all 
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