po4a-build - Online w chmurze

PROGRAM:

IMIĘ

po4a-build - przetłumaczona dokumentacja kompilacji

STRESZCZENIE

kompilacja po4a [-f | --plik FILE] [--tylko garnki]

kompilacja po4a [-? | -h | --help | --wersja]

OPIS

kompilacja po4a ma na celu maksymalne ułatwienie tworzenia przetłumaczonej dokumentacji
do tworzenia bieżących, nieprzetłumaczonych treści.

Kiedy po4a przygotowuje przetłumaczoną treść w formacie POD lub DocBook XML, czyli ostateczną dokumentację
można następnie zbudować za pomocą kompilacja po4a. Tworzona jest zarówno treść nieprzetłumaczona, jak i przetłumaczona
jako pojedynczy proces, aktualizując jednocześnie pliki POT.

Istniejące instrukcje kompilacji są zastępowane pojedynczym wywołaniem metody kompilacja po4a i prosty
plik konfiguracyjny służy do informowania kompilacja po4a jak zbudować każdy element i który plik binarny
pakiety będą zawierać przetłumaczoną i nieprzetłumaczoną treść.

Po zbudowaniu zawartość będzie znajdować się w katalogach specyficznych dla pakietu pod plikiem BASEDIR
określone w pliku konfiguracyjnym. Dla pakietu binarnego foo, z tłumaczeniami na
niemieckim i francuskim, spowodowałoby to:

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

Ułatwia to dołączenie całej wygenerowanej zawartości do pakietu binarnego za pomocą pliku
pojedyncza lokalizacja instalacji:

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

Ta reguła nie będzie wymagała aktualizacji w przypadku dodania nowych tłumaczeń i dodania drugiego
pakiet binarny (pasek) pozwala na oddzielne przechowywanie zawartości tego pakietu.

Utrzymany Formaty
Obecnie kompilacja po4a obsługuje następujące kombinacje:

1. DocBook XML dla sekcji 1.

2. DocBook XML dla sekcji 3.

3. DocBook XML dla HTML.

4. POD dla sekcji 1.

5. POD dla sekcji 3.

6. POD dla sekcji 5.

7. POD dla sekcji 7.

Wszystkie obsługiwane formaty, we wszystkich obsługiwanych kombinacjach, mogą być obsługiwane w jednym
po4a-build.conf plik konfiguracyjny i w jednym wywołaniu kompilacja po4a. Zobaczyć po4a-
build.conf(5).

KONFIGURACJA

kompilacja po4a używa domyślnego pliku konfiguracyjnego po4a-build.conf, który powinien znajdować się na górze
katalog poziomu pakietu VCS. (Użyj -f możliwość określenia innego pliku.) Zobacz
po4a-build.conf(5).

Przykład 1. przykład konfiguracja filet

Przykładowy plik konfiguracyjny dostępny jest pod adresem:

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

konfiguracja filet układ
Plik konfiguracyjny składa się z kilku sekcji: ogólnej, obsługi XML/XSL i obsługi POD
i obsługa HTML.

Ogólne zawiera nazwę i lokalizację pliku konfiguracyjnego po4a (prawdopodobnie najlepiej zostawić
to jako po4a.config), katalog po zawierający pliki dokumentacji PO (często
doc/po), pełna nazwa pliku POT użytego do utworzenia tłumaczeń, BASEDIR dla
wygenerowane wyjście, czy pakiet zawiera strony podręcznika z sekcji 3, a nie tylko
sekcja 1 oraz nazwy pakietów binarnych, które mają zawierać wygenerowane wyjście.

Obsługa XML/XSL obejmuje określenie, który z pakietów binarnych korzysta z obsługi XSL w pliku
Zmienna XMLPACKAGES, plik DocBook najwyższego poziomu, do którego należy przekazać xsltproc i lokalizacja
pliki XML lub DocBook. Jeśli to konieczne, plik XSLFILE można zastąpić.

Obsługa POD obejmuje określenie, który z pakietów binarnych korzysta z obsługi POD w pliku
PODPACKAGES i pełną nazwę pliku POD.

Obsługa HTML określa podkatalog, który należy utworzyć poniżej BASEDIR dla nieprzetłumaczonych plików i
przetłumaczoną treść HTML i plik DocBook w celu wygenerowania kodu HTML. Plik HTMLXSL może być
przesłonięte, jeśli to konieczne.

POLECENIA

--tylko garnki
Aktualizuje tylko pliki POT. --tylko garnki przeznaczony jest do obsługi pakietów m.in
wszystkie pliki POT w źródle pakietu. Pakiety korzystające z Autotools mogą z łatwością dodać POT
plik przez EXTRA_DIST, ale pakiety używają tylko pliku Makefile lub niektórych pomocników kompilacji VCS
dodanie pliku POT (który jest plikiem wygenerowanym) bez umieszczania może być niewygodne
plik POT do VCS. Aby uniknąć tej brzydkiej i niepotrzebnej pracy, kompilacja po4a mogą
zaktualizuj plik(i) POT na początku kompilacji, tak aby dpkg-źródło zawiera je
do źródłowego archiwum tar.

Przykład 2. pakiet kompilacji svn przykład

pakiet kompilacji svn ma wyraźną obsługę tego rodzaju dodawania, używając metody
użyjOdległościNatywnej Własność SVN i natywna odległ Ustaw cel.

# dodaje plik POT do źródłowego archiwum tar
natywny-dist: Makefile
po4a-build --tylko pot

$ svn propset useNativeDist 1 debian

-h|--help
wydrukuj komunikat o użyciu i wyjdź.

--wersja
wydrukuj komunikat o użyciu i wyjdź.

OPCJE

-f|--plik FILE
Zastąp kompilacja po4a domyślny plik konfiguracyjny (po4a-build.conf) i podaj swój
posiadać.

Użyj po4a-build online, korzystając z usług onworks.net