Todos os formatos suportados, em todas as combinações suportadas, podem ser tratados num simples ficheiro de configuração po4a-build.conf e numa única invocação para "po4a-build". No entanto, você também pode optar por separar os diretórios po/ e ter um ficheiro de configuração para cada arranque. (Invocar "po4a-build-f FILE" para cada um.)
Note-se que embora po4a-build inclua suporte para adição de suporte gettextpara a tradução do script de mensagens de saída, po4a-build.conf em si não tem relação com tais traduções. po4a-build.conf refere-se apenas a tradução de conteúdo estático como páginas de manual.
Para suporte po4a-build de tradução de mensagens em tempo de execução, consulte po4a-runtime(7).
Páginas de manual são geradas usando o suporte padrão em docbook-xsl - o estilo utilizado pode ser substituído usando a configuração "XSLFILE" no ficheiro de configuração "po4a-build".
Use "PODFILE" para a secção 1, "PODMODULES" para a secção 3, "POD5FILES" para a secção 5 e "POD7FILES" para a secção 7.
Para o conteúdo nas secções 5 ou 7 (o que tende a precisar de um nome de ficheiro que é também utilizado para o conteúdo da secção 1), se o nome do ficheiro inclui a 5 ou 7 como parte do nome do ficheiro, este (e qualquer extensão do ficheiro) será automaticamente despojado.
por exemplo para preparar F </ usr/share/man/man7/po4a.7.gz>:
# Ficheiros POD para a secção 7 POD7FILES="doc/po4a.7.pod"
Qualquer conteúdo depois de um '#' é ignorado.
Qualquer valor que seria sempre vazio pode ser eliminado do ficheiro.
São necessárias algumas configurações de campos - po4a-build pode acabar sem nada a fazer se os campos obrigatórios estiverem vazios.
Nome e localização do ficheiro de configuração (temporária) "po4a" que "po4a-build" irá gerar e manter. Este ficheiro não precisa de viver no seu sistema de controle de versão e pode ser seguramente limpo durante a construção do pacote.
# nome e localização do ficheiro de configuração CONFIG="_build/po4a.config"
Diretório contendo os ficheiros PO para todas as traduções manipuladas por este ficheiro de configuração. Todas as sequências serão fundidas num ficheiro POT neste diretório e todos os ficheiros PO fundirão com esse ficheiro POT. Qualquer limite GUARDADO (veja abaixo) será aplicado em todas as sequências de todos os ficheiros de entrada especificado neste ficheiro e todos os ficheiros PO neste diretório. O diretório não precisa de ser chamado 'po'. Observe, porém, que algumas ferramentas de estatística esperam que o nome seja 'po', pelo que é recomendado para manter este nome.
# Diretório po para páginas do manual/docs PODIR="po/pod"
Caminho para o ficheiro POT (em relação à localização do ficheiro de configuração) que será gerado, mantido e atualizado por "po4a-build" para estas traduções.
# Caminho do ficheiro POT POTFILE="po/pod/po4a-pod.pot"
Diretório base para escrever o conteúdo traduzido.
# Diretório base para os ficheiros gerados, por exemplo, doc BASEDIR="_build"
Mesmo se é construído apenas um pacote, um valor é necessário aqui, pelo menos.
A sequência é em si arbitrária, mas geralmente consiste no nome do pacote. O conteúdo gerado irá aparecer em subdiretórios do BASEDIR/BINARIES:
_build/po4a/man/man1/foo.1
Se o pacote constrói mais do que um pacote binário (ou seja, um pacote de origem e múltiplos ficheiros .deb ou .rpm), este campo pode ajudar a isolar o conteúdo destinado para cada ponto, tornando mais fácil para automatizar o processo de criação.
Sequências separadas por um espaço.
# Pacotes binários que irão conter páginas de manual geradas BINARIES="po4a"
Para o controlo total sobre o comportamento, analise com cuidado quais os ficheiros que são atribuídos a cada ficheiro de configuração po4a-build.conf.
Note-se que ter muitos ficheiros num ficheiro POT pode ser mais conveniente para tradutores, especialmente se os ficheiros têm sequências em comum. Inversamente ficheiros POT com milhares de longas sequências são assustadores para tradutores, levando à paragem da sequência longa.
# Limiar mínimo para a percentagem de tradução a manter KEEP=
É prática comum envolver múltiplos ficheiros XML num livro, a fim de fornecer uma tabela de conteúdo, etc. Se o livro contém ficheiros também especificados em XMLMAN3, especificar apenas aqui os ficheiros XML para a secção 1, não o livro em si. Se o livro contém apenas conteúdo para esta secção, especificar apenas o ficheiro do livro.
# Ficheiros DocBook XML para a secção 1 XMLMAN1="po4a-build.xml po4aman-display-po.xml po4apod-display-po.xml"
É prática comum envolver múltiplos ficheiros XML num livro, a fim de fornecer uma tabela de conteúdo, etc. Se o livro contém ficheiros também especificados em XMLMAN1, especificar apenas aqui os ficheiros XML para a secção 3, não o livro em si. Se o livro contém apenas conteúdo para esta secção, especificar apenas o ficheiro do livro.
# Ficheiros DocBook XML para a secção 3 XMLMAN3=""
Deve ser especificado se são usados XMLMAN1 ou XMLMAN3. Caminhos são relativos à localização do ficheiro de configuração.
# localização de ficheiros XML XMLDIR="share/doc/"
Se quaisquer valores são dados em XMLMAN1 ou XMLMAN3, um valor deve ser dado aqui também.
# pacotes binários usando DocBook XML & xsltproc XMLPACKAGES="po4a"
# Padrão para encontrar ficheiros .docbook DOCBOOKDIR=""
# Ficheiro XSL para usar DocBook XML XSLFILE="http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl"
# Ficheiros POD para a secção 1 PODFILE="po4a po4a-gettextize po4a-normalize scripts/msguntypot"
# Ficheiros POD para a secção 3 - Nomes de módulo regenerados a partir do caminho PODMODULES="lib/Locale/Po4a/*.pm"
Para o conteúdo nas secções 5 ou 7 (o que tende a precisar de um nome de ficheiro que é também utilizado para o conteúdo da secção 1), se o nome do ficheiro inclui a 5 ou 7 como parte do nome do ficheiro, este (e qualquer extensão do ficheiro) será automaticamente despojado.
# Ficheiros POD para a secção 5 POD5FILES="doc/po4a-build.conf.5.pod"
Para o conteúdo nas secções 5 ou 7 (o que tende a precisar de um nome de ficheiro que é também utilizado para o conteúdo da secção 1), se o nome do ficheiro inclui a 5 ou 7 como parte do nome do ficheiro, este (e qualquer extensão do ficheiro) será automaticamente despojado.
# Ficheiros POD para a secção 7 POD7FILES="doc/po4a.7.pod"
# pacotes binários usando POD PODPACKAGES="po4a"
# saída HTML (subdiretório de BASEDIR) HTMLDIR=""
# ficheiro HTML DocBook HTMLFILE=""
# ficheiro XSL a utilizar para HTML HTMLXSL="http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl"
Neil Williams <linux@codehelp.co.uk>