po4a-build - Online în cloud

PROGRAM:

NUME

po4a-build - construiți documentația tradusă

REZUMAT

po4a-construire [-f | --fişier FILE] [--oală-doar]

po4a-construire [-? | -h | --Ajutor | --versiune]

DESCRIERE

po4a-construire este destinat să faciliteze producția de documentație tradusă
pentru a produce conținutul curent netradus.

Cand po4a pregătește conținutul tradus ca POD sau DocBook XML, documentația finală
poate fi apoi construit folosind po4a-construire. Este construit atât conținutul netradus, cât și cel tradus
ca un singur proces, actualizarea fișierelor POT în același timp.

Instrucțiunile de construire existente sunt înlocuite cu un singur apel către po4a-construire și un simplu
fișierul de configurare este folosit pentru a spune po4a-construire cum să construiți fiecare element și care binar
pachetele vor include conținutul tradus și netradus.

Odată construit, conținutul va fi în directoare specifice pachetului de sub BASEDIR
specificate în fișierul de configurare. Pentru un pachet binar foo, cu traduceri în
germană și franceză, aceasta ar avea ca rezultat:

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

Acest lucru facilitează includerea întregului conținut generat în pachetul binar cu a
locație unică de instalare:

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

Această regulă nu va trebui actualizată atunci când se adaugă traduceri noi și se adaugă o a doua
pachetul binar (bara) permite păstrarea separată a conținutului pachetului respectiv.

Suportat Formate
În prezent, po4a-construire acceptă următoarele combinații:

1. DocBook XML pentru secțiunea 1.

2. DocBook XML pentru secțiunea 3.

3. DocBook XML pentru HTML.

4. POD pentru secțiunea 1.

5. POD pentru secțiunea 3.

6. POD pentru secțiunea 5.

7. POD pentru secțiunea 7.

Toate formatele acceptate, în toate combinațiile acceptate, pot fi gestionate într-un singur
po4a-build.conf și într-un singur apel către po4a-construire. Vedea po4a-
construi.conf(5).

CONFIGURARE

po4a-construire folosește un fișier de configurare implicit, po4a-build.conf, care ar trebui să fie în partea de sus
directorul de nivel al pachetului dumneavoastră VCS. (Folosește -f opțiunea de a specifica un fișier diferit.) Vezi
po4a-build.conf(5).

Exemplu 1. exemplu configuraţie fişier

Un exemplu de fișier de configurare este disponibil la:

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

configuraţie fişier aspect
Fișierul de configurare este format din mai multe secțiuni, general, suport XML/XSL, suport POD
și suport HTML.

General include numele și locația fișierului de configurare po4a (probabil cel mai bine să părăsești
aceasta ca po4a.config), directorul po care conține fișierele PO de documentație (adesea
doc/po), numele complet al fișierului POT folosit pentru a crea traducerile, BASEDIR pentru
rezultatul generat, dacă pachetul conține pagini de manual în secțiunea 3 și nu doar
secțiunea 1 și numele pachetelor binare care trebuie să conțină rezultatul generat.

Suportul XML/XSL include specificarea care dintre pachetele binare utilizează suportul XSL în
Variabila XMLPACKAGES, fișierul DocBook de nivel superior la care se trece xsltproc si locatia
fișierele XML sau DocBook. XSLFILE poate fi suprascris, dacă este necesar.

Suportul POD include specificarea care dintre pachetele binare utilizează suportul POD în
variabila PODPACKAGES și numele complet al fișierului POD.

Suportul HTML specifică subdirectorul de creat sub BASEDIR pentru cele netraduse și
conținut HTML tradus și fișierul DocBook pentru a genera codul HTML. Fișierul HTMLXSL poate fi
anulat, dacă este necesar.

COMANDE

--oală-doar
Actualizează doar fișierele POT. --oală-doar este destinat să susțină pachete inclusiv
toate fișierele POT din sursa pachetului. Pachetele care folosesc Autotools pot adăuga cu ușurință POT
fișier prin EXTRA_DIST, dar pachetele care folosesc doar un Makefile sau anumiți ajutoare de construcție VCS
poate considera incomod să adăugați fișierul POT (care este un fișier generat) fără a pune
fișierul POT în VCS. Pentru a evita această muncă urâtă și inutilă, po4a-construire poate să
actualizați fișierele POT la începutul build-ului, astfel încât dpkg-source le include
în tarball-ul sursă.

Exemplu 2. svn-buildpackage exemplu

svn-buildpackage are suport explicit pentru acest tip de adăugare, folosind
useNativeDist proprietatea SVN și nativ-dist Faceți țintă.

# adaugă fișierul POT la tarball-ul sursă
native-dist: Makefile
po4a-build --oală-doar

$ svn propset useNativeDist 1 debian

-h|--Ajutor
tipăriți mesajul de utilizare și ieșiți.

--versiune
tipăriți mesajul de utilizare și ieșiți.

OPŢIUNI

-f|--fişier FILE
Ignorați po4a-construire fișierul de configurare implicit (po4a-build.conf) și furnizați dvs
proprie.

Utilizați po4a-build online folosind serviciile onworks.net