po4a-build - En ligne dans le Cloud

PROGRAMME:

Nom

po4a-build - construire la documentation traduite

SYNOPSIS

po4a-build [-f | --déposer DOSSIER] [--pot-seulement]

po4a-build [-? | -h | --Aidez-moi | --version]

DESCRIPTION

po4a-build vise à rendre la production de documentation traduite aussi simple que possible
pour produire le contenu actuel non traduit.

Lorsque po4a prépare le contenu traduit en POD ou DocBook XML, la documentation finale
peut alors être construit en utilisant po4a-build. Le contenu non traduit et traduit est construit
en tant que processus unique, mettant à jour les fichiers POT en même temps.

Les instructions de construction existantes sont remplacées par un seul appel à po4a-build et un simple
fichier de configuration est utilisé pour dire po4a-build comment construire chaque élément et quel binaire
les packages incluront le contenu traduit et non traduit.

Une fois construit, le contenu sera dans des répertoires spécifiques au package sous le REPBASE
spécifié dans le fichier de configuration. Pour un paquet binaire foo, avec des traductions en
allemand et français, cela donnerait :

BASEDIR/foo/man/man1/foo.1
BASEDIR/foo/man/de/man1/foo.1
BASEDIR/foo/man/fr/man1/foo.1

Cela permet d'inclure facilement tout le contenu généré dans le package binaire avec un
emplacement d'installation unique :

doc/foo/man/* ./ usr / share / man /
doc/foo/html/* ./usr/share/doc/foo/

Cette règle n'aura pas besoin d'être mise à jour lors de l'ajout de nouvelles traductions et de l'ajout d'une seconde
package binaire (barre) permet au contenu de ce package de rester séparé.

Appareils formats
À l’heure actuelle, po4a-build prend en charge les combinaisons suivantes :

1. DocBook XML pour la section 1.

2. DocBook XML pour la section 3.

3. DocBook XML pour HTML.

4. POD pour la section 1.

5. POD pour la section 3.

6. POD pour la section 5.

7. POD pour la section 7.

Tous les formats pris en charge, dans toutes les combinaisons prises en charge, peuvent être gérés en un seul
fichier de configuration po4a-build.conf et en un seul appel à po4a-build. Voir po4a-
build.conf (5).

CONFIGURATION

po4a-build utilise un fichier de configuration par défaut, po4a-build.conf qui devrait être en haut
niveau du répertoire de votre package VCS. (Utilisez le -f option pour spécifier un fichier différent.) Voir
po4a-build.conf (5).

Exemple 1. (ici) paramétrage filet

Un exemple de fichier de configuration est disponible sur :

/usr/share/doc/po4a/examples/po4a-build.conf.example

paramétrage filet disposition
Le fichier de configuration se compose de plusieurs sections, général, support XML/XSL, support POD
et prise en charge HTML.

General inclut le nom et l'emplacement du fichier de configuration po4a (il vaut probablement mieux laisser
ceci comme po4a.config), le répertoire po contenant les fichiers de documentation PO (souvent
doc/po), le nom complet du fichier POT utilisé pour créer les traductions, le BASEDIR pour
la sortie générée, si le paquet contient des pages de manuel dans la section 3 plutôt que juste
section 1 et les noms des packages binaires qui doivent contenir la sortie générée.

La prise en charge XML/XSL inclut la spécification des packages binaires qui utilisent la prise en charge XSL dans le
Variable XMLPACKAGES, le fichier DocBook de niveau supérieur à transmettre xsltproc et l'emplacement de
les fichiers XML ou DocBook. Le XSLFILE peut être remplacé, si nécessaire.

La prise en charge POD inclut la spécification des packages binaires qui utilisent la prise en charge POD dans le
variable PODPACKAGES et le nom complet du fichier POD.

Le support HTML spécifie le sous-répertoire à créer sous BASEDIR pour les fichiers non traduits et
le contenu HTML traduit et le fichier DocBook pour générer le HTML. Le fichier HTMLXSL peut être
annulé, si nécessaire.

COMMANDES

--pot-seulement
Ne met à jour que le(s) fichier(s) POT. --pot-seulement est destiné à prendre en charge les packages, y compris
tous les fichiers POT dans la source du package. Les packages utilisant Autotools peuvent facilement ajouter le POT
via EXTRA_DIST mais des packages utilisant simplement un Makefile ou certains assistants de construction VCS
peut trouver gênant d'ajouter le fichier POT (qui est un fichier généré) sans mettre
le fichier POT dans le VCS. Pour éviter ce travail laid et inutile, po4a-build vous
mettre à jour le(s) fichier(s) POT au début de la construction, afin que dpkg-source les inclut
dans l'archive source.

Exemple 2. svn-buildpackage (ici)

svn-buildpackage a un soutien explicite pour ce type d'ajout, en utilisant le
utiliserNativeDist propriété SVN et le natif-dist Faire la cible.

# ajoute le fichier POT à l'archive source
native-dist : Makefile
po4a-build --pot-only

$ svn propset useNativeDist 1 debian

-h|--Aidez-moi
imprimer le message d'utilisation et quitter.

--version
imprimer le message d'utilisation et quitter.

OPTIONS

-f|--déposer DOSSIER
Remplacer le po4a-build fichier de configuration par défaut (po4a-build.conf) et fournissez votre
posséder.

Utilisez po4a-build en ligne en utilisant les services onworks.net