'\" t
.\" Title: po4a-build
.\" Author: [see the "Autor" section]
.\" Generator: DocBook XSL Stylesheets v1.78.1
.\" Date: 21/08/2013
.\" Manual: PO4A
.\" Source: PO4A
.\" Language: Spanish
.\"
.TH "PO4A\-BUILD" "1" "21/08/2013" "PO4A" "PO4A"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NOMBRE"
po4a-build \- Construye documentaci\('on traducida
.SH "SINOPSIS"
.HP \w'\fBpo4a\-build\fR\ 'u
\fBpo4a\-build\fR [\fB\-f\fR | \fB\-\-file\fR\fI
fichero\fR] [\fB\-\-pot\-only\fR]
.HP \w'\fBpo4a\-build\fR\ 'u
\fBpo4a\-build\fR [\fB\-?\fR | \fB\-h\fR | \fB\-\-help\fR | \fB\-\-version\fR]
.SH "DESCRIPCI\('ON"
.PP
La meta de
\fBpo4a\-build\fR
es facilitar la generaci\('on de documentaci\('on traducida tanto como lo es generar el contenido sin traducir\&.
.PP
Cuando
\fBpo4a\fR
prepara el contenido traducido bien como POD o DocBook XML, puede usar la orden
\fBpo4a\-build\fR
para generar la documentaci\('on final\&. El contenido traducido y sin traducir se generan en un s\('olo proceso, actualizando los ficheros POT a la vez\&.
.PP
Puede reemplazar las instrucciones de construcci\('on existentes con una sola invocaci\('on a
\fBpo4a\-build\fR
y un sencillo fichero de configuraci\('on usado para decir a
\fBpo4a\-build\fR
c\('omo construir cada elemento y qu\('e paquetes binarios incluir\('an el contenido traducido y sin traducir\&.
.PP
Una vez generado, el contenido estar\('a en los directorios espec\('ificos a cada paquete bajo el
\fBBASEDIR\fR
(directorio padre) definido en el fichero de configuraci\('on\&. Para un paquete binario \(Fofoo\(Fc, con traducciones al alem\('an y al franc\('es, el resultado ser\('ia el siguiente:
.sp
.if n \{\
.RS 4
.\}
.nf
BASEDIR/foo/man/man1/foo\&.1
BASEDIR/foo/man/de/man1/foo\&.1
BASEDIR/foo/man/fr/man1/foo\&.1
.fi
.if n \{\
.RE
.\}
.PP
Esto facilita incluir todo el contenido generado dentro de los paquetes binarios, con una sola ubicaci\('on de instalaci\('on\&.
.sp
.if n \{\
.RS 4
.\}
.nf
doc/foo/man/* \&./usr/share/man/
doc/foo/html/* \&./usr/share/doc/foo/
.fi
.if n \{\
.RE
.\}
.PP
Esta regla no se tendr\('a que actualizar al a\(~nadir traducciones nuevas, y permite a\(~nadir un segundo paquete binario (\(Fobar\(Fc) manteniendo el contenido de \('este separado\&.
.SS "Formatos compatibles"
.PP
A d\('ia de hoy,
\fBpo4a\-build\fR
es compatible con las siguientes combinaciones:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 1." 4.2
.\}
DocBook XML para la secci\('on 1\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 2." 4.2
.\}
DocBook XML para la secci\('on 3\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 3." 4.2
.\}
DocBook XML para HTML
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 4." 4.2
.\}
POD para la secci\('on 1\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 5.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 5." 4.2
.\}
POD para la secci\('on 3\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 6.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 6." 4.2
.\}
POD para la secci\('on 5\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 7.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 7." 4.2
.\}
POD para la secci\('on 7\&.
.RE
.PP
Puede gestionar todos los formatos compatibles y combinaciones posibles con un solo fichero de configuraci\('on,
po4a\-build\&.conf, y una sola invocaci\('on a
\fBpo4a\-build\fR\&. Consulte
\fBpo4a-build.conf\fR(5)\&.
.SH "CONFIGURACI\('ON"
.PP
Por omisi\('on,
\fBpo4a\-build\fR
usa un fichero de configuraci\('on,
po4a\-build\&.conf, el cual deber\('ia estar en el directorio superior del sistema de control de versiones de su paquete\&. (Use la opci\('on
\fB\-f\fR
para especificar un fichero diferente\&.) Consulte
\fBpo4a-build.conf\fR(5)\&.
.PP
\fBEjemplo 1. Ejemplo de fichero de configuraci\('on\fR
.PP
Dispone de un ejemplo de fichero de configuraci\('on en:
.sp
.if n \{\
.RS 4
.\}
.nf
/usr/share/doc/po4a/examples/po4a\-build\&.conf\&.example
.fi
.if n \{\
.RE
.\}
.SS "Dise\(~no del fichero de configuraci\('on"
.PP
El fichero de configuraci\('on consiste de varias secciones: general, compatibilidad con XML/XSL, POD y HTML\&.
.PP
La secci\('on general incluye el nombre y la ubicaci\('on del fichero de configuraci\('on de po4a (quiz\('a sea mejor nombrarlo
po4a\&.config), el directorio \(Fopo/\(Fc que contiene la documentaci\('on en formatoPO, (a menudo
doc/po), el nombre completo del fichero POT empleado para generar las traducciones, el \(FoBASEDIR\(Fc para la salida generada, si el paquete contiene p\('aginas de manual en la secci\('on 3 en lugar de s\('olo en la secci\('on 1, y los nombres de los paquetes binarios que contendr\('an la salida generada\&.
.PP
La compatibilidad con XML/XSL incluye especificar qu\('e paquetes binarios usan la compatibilidad con XSL a trav\('es de la variable \(FoXMLPACKAGES\(Fc, el el fichero de DocBook en el nivel superior a introducir a
\fBxsltproc\fR, y la ubicaci\('on de los ficheros XML o DocBook\&. Puede anular \(FoXSLFILE\(Fc si es necesario\&.
.PP
La compatibilidad con POD incluye especificar qu\('e paquetes binarios usan la compatibilidad con POD a trav\('es de la variable \(FoPODPACKAGES\(Fc y el nombre completo del fichero POD\&.
.PP
La compatibilidad con HTML especifica el subdirectorio a crear bajo \(FoBASEDIR\(Fc que contendr\('a el contenido HTML traducido y sin traducir, y el fichero DocBook usado para generar HTML\&. Puede anular el fichero \(FoHTMLXSL\(Fc si es necesario\&.
.SH "\('ORDENES"
.PP
\fB\-\-pot\-only\fR
.RS 4
S\('olo actualiza uno o varios ficheros POT\&. La opci\('on
\fB\-\-pot\-only\fR
est\('a dise\(~nada para ofrecer la compatibilidad con paquetes que incluyen todos los ficheros POT en el paquete de fuentes\&. Aquellos paquetes que usan Autotools pueden a\(~nadir f\('acilmente el fichero POT a trav\('es de \(FoEXTRA_DIST\(Fc, pero aquellos paquetes que emplean un \(FoMakefile\(Fc o algunos asistentes de compilaci\('on de sistemas de control de versiones encontrar\('an extra\(~no a\(~nadir 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,
\fBpo4a\-build\fR
puede actualizar el o los ficheros POT al principio de la construcci\('on, de forma que
\fBdpkg\-source\fR
los incluya en el archivo tar de fuentes\&.
.PP
\fBEjemplo 2. Ejemplo de svn-buildpackage\fR
.PP
\fBsvn\-buildpackage\fR
tiene compatibilidad expl\('icita para esta clase de a\(~nadidos, usando la propiedad
\fBuseNativeDist\fR
de SVN y el \(Fotarget\(Fc de Make
\fBnative\-dist\fR\&.
.sp
.if n \{\
.RS 4
.\}
.nf
# A\(~nade el fichero POT al archivo tar de fuentes
native\-dist: Makefile
po4a\-build \-\-pot\-only
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
$ svn propset useNativeDist 1 debian
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB\-h\fR|\fB\-\-help\fR
.RS 4
Muestra el mensaje de uso y cierra
.RE
.PP
\fB\-\-version\fR
.RS 4
Muestra el mensaje de uso y cierra
.RE
.SH "OPCIONES"
.PP
\fB\-f\fR|\fB\-\-file\fR\fI fichero\fR
.RS 4
Anula el fichero de configuraci\('on predefinido de
\fBpoa\-build\fR
(po4a\-build\&.conf) e introduce el suyo\&.
.RE
.SH "AUTOR"
.PP
\fBpo4a\-build\fR
fue creado por Neil Williams
\&.
.PP
Neil Williams escribi\('o esta p\('agina de manual\&.