'\" t
.\" Title: po4a-build
.\" Author: [see the "AUTOR" section]
.\" Generator: DocBook XSL Stylesheets v1.79.1
.\" Date: 02/06/2018
.\" Manual: PO4A
.\" Source: PO4A
.\" Language: Portuguese
.\"
.TH "PO4A\-BUILD" "1" "02/06/2018" "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 \- Documenta\(,c\(~ao traduzida de constru\(,c\(~ao
.SH "SINOPSE"
.HP \w'\fBpo4a\-build\fR\ 'u
\fBpo4a\-build\fR [\fB\-f\fR | \fB\-\-ficheiro\fR\fI
FICHEIRO\fR] [\fB\-\-pot\-apenas\fR]
.HP \w'\fBpo4a\-build\fR\ 'u
\fBpo4a\-build\fR [\fB\-?\fR | \fB\-h\fR | \fB\-\-Ajuda\fR | \fB\-\-vers\(~ao\fR]
.SH "DESCRI\(,C\(~AO"
.PP
\fBpo4a\-build\fR
tem a inten\(,c\(~ao de tornar muito f\('acil de exibir como pode ser documenta\(,c\(~ao traduzida para produzir o conte\('udo atual sem tradu\(,c\(~ao\&.
.PP
Quando
\fBpo4a\fR
prepara o conte\('udo traduzido como POD ouDocBook XML, a documenta\(,c\(~ao final pode ent\(~ao ser constru\('ida usando\fBpo4a\-build\fR\&.Tanto o conte\('udo sem tradu\(,c\(~ao e traduzido\('e constru\('ido como um \('unico processo, atualizando os arquivos POT ao mesmo tempo\&.
.PP
Instru\(,c\(~oes de constru\(,c\(~ao existentes s\(~ao substitu\('idas por uma \('unica chamada para
\fBpo4a\-build\fR
e um ficheiro de configura\(,c\(~ao simples \('e usado para dizer
\fBpo4a\-build\fR
como formar cada elemento e que pacotes bin\('arios ir\('a incluir o conte\('udo traduzido e sem tradu\(,c\(~ao\&.
.PP
Uma vez constru\('ido, o conte\('udo estar\('a no pacote de diret\('orios espec\('ificos sob o
\fBBASEDIR\fR
especificado no arquivo de configura\(,c\(~ao\&. Para um pacote bin\('ario foo, com tradu\(,c\(~oes para o 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
Isto torna mais f\('acil para incluir todo o conte\('udo gerado no 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
Esta regra n\(~ao precisa de ser atualizada quando novas tradu\(,c\(~oes s\(~ao adicionadas e adicionando um segundo pacote bin\('ario (bar) permite que o conte\('udo para esse pacote seja mantido separado\&.
.SS "Formatos Suportados"
.PP
Atualmente,
\fBpo4a\-build\fR
suporta as seguintes combina\(,c\(~oes:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 1." 4.2
.\}
DocBook XML para a parte 1\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 2." 4.2
.\}
DocBook XML para a parte 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 a parte 1\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 5.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 5." 4.2
.\}
POD para a parte 3\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 6.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 6." 4.2
.\}
POD para a parte 5\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 7.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 7." 4.2
.\}
POD para a parte 7\&.
.RE
.PP
Todos os formatos suportados, em todas as combina\(,c\(~oes suportadas, podem ser tratados em uma simples
po4a build\&.conf\-file
configura\(,c\(~ao e em uma \('unica chamada para
\fBpo4a\-build\fR\&. Veja
\fBpo4a-build.conf\fR(5)\&.
.SH "CONFIGURA\(,C\(~AO"
.PP
\fBpo4a\-build\fR
usa um arquivo de configura\(,c\(~ao padr\(~ao,
po4a\-build\&.conf
que deve estar no diret\('orio de n\('ivel mais alto do seu pacote VCS\&. (Use a
\fB\-f\fR
op\(,c\(~aopara especificar um ficheiro diferente\&.) Ver
\fBpo4a-build.conf\fR(5)\&.
.PP
\fBExemplo 1. exemplo de um ficheiro de configura\(,c\(~ao\fR
.PP
Um exemplo de um ficheiro 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 "Apresenta\(,c\(~ao de um ficheiro de configura\(,c\(~ao"
.PP
O ficheiro de configura\(,c\(~ao \('e composto, em geral, por v\('arias sec\(,c\(~oes, suporte XML/XSL para apoio, POD e HTML\&.
.PP
Geralmente inclui o nome e a localiza\(,c\(~ao do ficheiro de configura\(,c\(~ao po4a (provavelmente o melhor \('e deixar isso como
po4a\&.config), o diret\('orio
po
contendo a documenta\(,c\(~ao dos ficheiros PO (muitas vezes
doc/po), o nome completo do ficheiro POT usado para criar as tradu\(,c\(~oes, o BASEDIR para a sa\('ida gerada, se o pacote cont\('em p\('aginas do manual na sec\(,c\(~ao 3 em vez de apenas a sec\(,c\(~ao 1 e os nomes dos pacotes bin\('arios que devem conter a sa\('ida gerada\&.
.PP
O suporte XML/XSL inclui a especifica\(,c\(~ao de que os pacotes bin\('arios usam suporte XSL na vari\('avel
\fBXMLPACKAGES\fR
, o ficheiro de n\('ivel superior DocBook para passar
\fBxsltproc\fR
e da localiza\(,c\(~ao dos ficheiros XML ou DocBook\&. O
\fBXSLFILE\fR
pode ser substitu\('ido, se necess\('ario\&.
.PP
O suporte POD inclui a especifica\(,c\(~ao de que os pacotes bin\('arios usam o suporte POD na vari\('avel PODPACKAGES e o nome completo do ficheiro POD\&.
.PP
O suporte HTML especifica o subdiret\('orio para criar abaixo do BASEDIR para o conte\('udo HTML sem tradu\(,c\(~ao e traduzido e o ficheiro DocBook para gerar o HTML\&.O ficheiro HTMLXSL pode ser substitu\('ido, se necess\('ario\&.
.SH "COMANDOS"
.PP
\fB\-\-pot\-only\fR
.RS 4
As atualiza\(,c\(~oes apenas do ficheiro(s) POT\&.
\fB\-\-pot\-only\fR
destinam\-se a suportar pacotes, incluindo todos os ficheiros POT do pacote de origem\&. Pacotes usando Autotools podem facilmente adicionar ficheiro(s) POT via
\fBEXTRA_DIST\fR
mas os pacotes que usam apenas um Makefile ou certos ajudantes de constru\(,c\(~ao VCS podem achar que \('e estranho adicionar o ficheiro POT (que \('e um ficheiro gerado), sem colocarem o ficheiro POT na VCS\&. Para evitar esse trabalho feio e desnecess\('ario,
\fBpo4a\-build\fR
pode atualizar o ficheiro(s) POT no in\('icio da constru\(,c\(~ao, para que
\fBdpkg\-source\fR
os inclua na fonte tarball\&.
.PP
\fBExemplo 2. exemplo de svn\-buildpackage\fR
.PP
\fBsvn\-buildpackage\fR
tem suporte expl\('icito para esse tipo de adi\(,c\(~ao, usando a
\fBuseNativeDist\fR
propriedade SVN e tornar o destino\fBnativo\-dist\fR\&.
.sp
.if n \{\
.RS 4
.\}
.nf
# Adiciona o ficheiro POT para a fonte tarball
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
imprimir a mensagem de uso e sair\&.
.RE
.PP
\fB\-\-vers\(~ao\fR
.RS 4
print the script version and exit\&.
.RE
.SH "OP\(,C\(~OES"
.PP
\fB\-f\fR|\fB\-\-file\fR\fI FILE\fR
.RS 4
Substituir o
\fBpo4a\-build\fR
ficheiro de configura\(,c\(~ao padr\(~ao (po4a\-build\&.conf) e fornecer o seu pr\('oprio\&.
.RE
.SH "AUTOR"
.PP
\fBpo4a\-build\fR
foi escrito por Neil Williams
\&.
.PP
Esta p\('agina do manual foi escrita por Neil Williams