'\" t
.\" Title: po4a-build
.\" Author: [see the "Autor" section]
.\" Generator: DocBook XSL Stylesheets v1.78.1
.\" Date: 05/01/2016
.\" Manual: PO4A
.\" Source: PO4A
.\" Language: Portuguese (Brazil)
.\"
.TH "PO4A\-BUILD" "1" "05/01/2016" "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 "NOME"
po4a-build \- compila documenta\(,c\(~oes traduzidas
.SH "SINOPSE"
.HP \w'\fBpo4a\-build\fR\ 'u
\fBpo4a\-build\fR [\fB\-f\fR | \fB\-\-file\fR\fI
ARQUIVO\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 "DESCRI\(,C\(~AO"
.PP
\fBpo4a\-build\fR
tem a inten\(,c\(~ao de tornar t\(~ao f\('acil a produ\(,c\(~ao de documenta\(,c\(~ao traduzida quanto \('e produzir conte\('udo traduzido\&.
.PP
Quando
\fBpo4a\fR
prepara o conte\('udo traduzido como POD ou XML de DocBook, a documenta\(,c\(~ao final pode ser compilada usando
\fBpo4a\-build\fR\&. Ambos conte\('udos traduzido e n\(~ao traduzido s\(~ao compilados como um \('unico processo, atualizando os arquivos POT ao mesmo tempo\&.
.PP
Instru\(,c\(~oes da compila\(,c\(~ao existente s\(~ao substitu\('idas por uma \('unica chamada ao
\fBpo4a\-build\fR
e um simples arquivo de configura\(,c\(~ao \('e usado para dizer ao
\fBpo4a\-build\fR
como construir cada elemento e quais pacotes de execut\('aveis v\(~ao incluir o conte\('udo traduzido e n\(~ao traduzido\&.
.PP
Uma vez compilado, o conte\('udo vai estar em diret\('orios espec\('ificos do pacote dentro do
\fBBASEDIR\fR
especificado no arquivo de configura\(,c\(~ao\&. Para um pacote bin\('ario foo, com tradu\(,c\(~oes para alem\(~ao e franc\(^es, isso resultaria em:
.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
Isso torna mais f\('acil incluir todo o conte\('udo gerado em um pacote bin\('ario com um \('unico local de instala\(,c\(~ao:
.sp
.if n \{\
.RS 4
.\}
.nf
doc/foo/man/* \&./usr/share/man/
doc/foo/html/* \&./usr/share/doc/foo/
.fi
.if n \{\
.RE
.\}
.PP
Essa regra n\(~ao vai precisar ser atualizada quando novas tradu\(,c\(~oes forem adicionadas e ao adicionar um segundo pacote bin\('ario (bar) permite\-se que o conte\('udo daquele pacote seja mantido separado\&.
.SS "Formatos suportados"
.PP
Atualmente,
\fBpo4a\-build\fR
fornece suporte \(`as seguintes combina\(,c\(~oes:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 1." 4.2
.\}
XML do DocBook para se\(,c\(~ao 1\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 2." 4.2
.\}
XML do DocBook para se\(,c\(~ao 3\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 3." 4.2
.\}
XML do DocBook para HTML\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 4." 4.2
.\}
POD para se\(,c\(~ao 1\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 5.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 5." 4.2
.\}
POD para se\(,c\(~ao 3\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 6.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 6." 4.2
.\}
POD para se\(,c\(~ao 5\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 7.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 7." 4.2
.\}
POD para se\(,c\(~ao 7\&.
.RE
.PP
Todos os formatos suportados, em todas combina\(,c\(~oes suportadas, podem ser manipuladas em um \('unico arquivo de configura\(,c\(~ao
po4a\-build\&.conf
e em uma \('unica chamada ao
\fBpo4a\-build\fR\&. Veja
\fBpo4a-build.conf\fR(5)\&.
.SH "CONFIGURA\(,C\(~AO"
.PP
\fBpo4a\-build\fR
usa uma configura\(,c\(~ao padr\(~ao,
po4a\-build\&.conf, a qual deveria estar no diret\('orio de n\('ivel de topo do VCS do seu pacote\&. (Use a op\(,c\(~ao
\fB\-f\fR
para especificar um arquivo diferente\&.) Veja
\fBpo4a-build.conf\fR(5)\&.
.PP
\fBExemplo 1. exemplo de arquivo de configura\(,c\(~ao\fR
.PP
Um exemplo de arquivo de configura\(,c\(~ao est\('a dispon\('ivel em:
.sp
.if n \{\
.RS 4
.\}
.nf
/usr/share/doc/po4a/examples/po4a\-build\&.conf\&.example
.fi
.if n \{\
.RE
.\}
.SS "layout do arquivo de configura\(,c\(~ao"
.PP
O arquivo de configura\(,c\(~ao consiste em diversas se\(,c\(~oes, geral, suporte a XML/XSL, suporte a POD e suporte a HTML\&.
.PP
Geral inclui o nome e localiza\(,c\(~ao do arquivo de configura\(,c\(~ao do po4a (provavelmente \('e melhor para deixar \('e
po4a\&.config), o diret\('orio PO cont\('em os arquivos PO de documenta\(,c\(~ao (normalmente
doc/po), o nome completo do arquivo POT usado para criar as tradu\(,c\(~oes, o BASEDIR para a sa\('ida gerada, se o pacote cont\('em p\('aginas de manual na se\(,c\(~ao 3 ao inv\('es de somente a se\(,c\(~ao 1 e os nomes dos pacotes bin\('arios que v\(~ao conter a sa\('ida gerada\&.
.PP
Suporte a XML/XSL inclui especifica\(,c\(~ao de quais dos pacotes bin\('arios usam suporte a XSL na vari\('avel XMLPACKAGES, o n\('ivel de topo do arquivo DocBook para passar para
\fBxsltproc\fR
e a localiza\(,c\(~ao dos arquivos XML ou DocBook\&. O XSLFILE pode ser sobrescrito, se necess\('ario\&.
.PP
Suporte a POD inclui a especifica\(,c\(~ao de quais dos pacotes bin\('arios usam suporte a POD na vari\('avel PODPACKAGES e nome completo do arquivo POD\&.
.PP
Suporte a HTML especifica o subdiret\('orio para criar abaixo BASEDIR para o conte\('udo HTML n\(~ao traduzido e traduzido e o arquivo DocBook para gerar o HTML\&. O arquivo HTMLXSL pode ser sobrescrito, se necess\('ario\&.
.SH "COMANDOS"
.PP
\fB\-\-pot\-only\fR
.RS 4
Apenas atualiza o(s) arquivo(s) POT\&.
\fB\-\-pot\-only\fR
tem a inten\(,c\(~ao de prover suporte a pacotes incluindo todos os arquivos POT no pacote fonte\&. Pacotes usando Autotools podem ser facilmente adicionados ao arquivo POT via EXTRA_DIST, mas pacotes usando apenas um Makefile ou certos auxiliares de compila\(,c\(~ao para VCS podem achar isso estranho adicionar o arquivo POT (o qual \('e um arquivo geral) sem colocar o arquivo POT no VCS\&. Para evitar este trabalho desnecess\('ario e feio,
\fBpo4a\-build\fR
pode atualizar o(s) arquivo(s) POT no in\('icio da compila\(,c\(~ao, de forma que
\fBdpkg\-source\fR
inclui eles no tarball fonte\&.
.PP
\fBExemplo 2. exemplo de svn-buildpackage\fR
.PP
\fBsvn\-buildpackage\fR
possui suporte expl\('icito para este tipo de adi\(,c\(~ao, usando propriedade SVN
\fBuseNativeDist\fR
e o Make target do
\fBnative\-dist\fR\&.
.sp
.if n \{\
.RS 4
.\}
.nf
# adiciona o arquivo POT do tarball fonte
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
imprime a mensagem de uso e sai\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
imprime a mensagem de uso e sai\&.
.RE
.SH "OP\(,C\(~OES"
.PP
\fB\-f\fR|\fB\-\-file\fR\fI ARQUIVO\fR
.RS 4
Sobrescreve o arquivo de configura\(,c\(~ao padr\(~ao de
\fBpo4a\-build\fR
(po4a\-build\&.conf) e fornece seu pr\('oprio\&.
.RE
.SH "AUTOR"
.PP
\fBpo4a\-build\fR
foi escrito por Neil Williams
\&.
.PP
Essa p\('agina de manual foi escrita por Neil Williams