'\" t
.\" Title: po4a-build
.\" Author: [see the "Autor" section]
.\" Generator: DocBook XSL Stylesheets v1.78.1
.\" Date: 01/05/2016
.\" Manual: PO4A
.\" Source: PO4A
.\" Language: Polish
.\"
.TH "PO4A\-BUILD" "1" "01/05/2016" "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 "NAZWA"
po4a-build \- buduje przet\(/lumaczoną dokumentację
.SH "STRESZCZENIE"
.HP \w'\fBpo4a\-build\fR\ 'u
\fBpo4a\-build\fR [\fB\-f\fR | \fB\-\-file\fR\fI
PLIK\fR] [\fB\-\-pot\-only\fR]
.HP \w'\fBpo4a\-build\fR\ 'u
\fBpo4a\-build\fR [\fB\-?\fR | \fB\-h\fR | \fB\-\-help\fR | \fB\-\-version\fR]
.SH "OPIS"
.PP
\fBpo4a\-build\fR
ma sprawiać, że tworzenie przet\(/lumaczonej dokumentacji będzie tak samo \(/latwe jak tworzenie treści nieprzet\(/lumaczonej\&.
.PP
Kiedy
\fBpo4a\fR
utworzy przet\(/lumaczoną zawartość jako pliki POD lub DocBook XML,
\fBpo4a\-build\fR
może zbudować końcową dokumentację\&. Zar\('owno przet\(/lumaczona, jak i nieprzet\(/lumaczona zawartość jest budowana przez pojedynczy proces, aktualizujący jednocześnie pliki POT\&.
.PP
Istniejące instrukcje budowania są zastępowane przez pojedyncze wywo\(/lanie
\fBpo4a\-build\fR
i prosty plik konfiguracyjny używany przez
\fBpo4a\-build\fR
do określenia, jak zbudować każdy element i kt\('ore pakiety binarne mają zawierać treści przet\(/lumaczone i nieprzet\(/lumaczone\&.
.PP
Po zbudowaniu zawartość będzie się znajdować w odpowiednich dla pakiet\('ow podkatalogach katalogu podanego w opcji
\fBBASEDIR\fR
pliku konfiguracyjnego\&. Dla pakietu binarnego o nazwie bla, zawierającego francuskie i niemieckie t\(/lumaczenia, wynikiem będzie:
.sp
.if n \{\
.RS 4
.\}
.nf
BASEDIR/bla/man/man1/bla\&.1
BASEDIR/bla/man/de/man1/bla\&.1
BASEDIR/bla/man/fr/man1/bla\&.1
.fi
.if n \{\
.RE
.\}
.PP
U\(/latwia to w\(/lączanie wszystkich wygenerowanych treści do pakietu binarnego:
.sp
.if n \{\
.RS 4
.\}
.nf
doc/bla/man/* \&./usr/share/man/
doc/bla/html/* \&./usr/share/doc/foo/
.fi
.if n \{\
.RE
.\}
.PP
Nie będzie trzeba aktualizować powyższej regu\(/ly po dodaniu nowych t\(/lumaczeń, a dodanie kolejnego pakietu binarnego (ble) pozwoli na rozdzielenie zawartości tych pakiet\('ow\&.
.SS "Obs\(/lugiwane formaty"
.PP
Obecnie
\fBpo4a\-build\fR
obs\(/luguje następujące kombinacje:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 1." 4.2
.\}
DocBook XML dla sekcji 1\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 2." 4.2
.\}
DocBook XML dla sekcji 3\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 3." 4.2
.\}
DocBook XML dla HTML\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 4." 4.2
.\}
POD dla sekcji 1\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 5.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 5." 4.2
.\}
POD dla sekcji 3\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 6.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 6." 4.2
.\}
POD dla sekcji 5\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 7.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 7." 4.2
.\}
POD dla sekcji 7\&.
.RE
.PP
Wszystkie dostępne formaty i wszystkie dostępne kombinacje można zawrzeć w pojedynczym pliku konfiguracyjnym
po4a\-build\&.conf
i w pojedynczym wywo\(/laniu programu
\fBpo4a\-build\fR\&. Szczeg\('o\(/ly można znaleźć w
\fBpo4a-build.conf\fR(5)\&.
.SH "KONFIGURACJA"
.PP
\fBpo4a\-build\fR
używa domyślnego pliku konfiguracyjnego,
po4a\-build\&.conf, kt\('ory powinien być umieszczony w g\(/l\('ownym katalogu źr\('ode\(/l pakietu (Proszę użyć opcji\fB\-f\fR, aby podać inny plik)\&. Zobacz także
\fBpo4a-build.conf\fR(5)\&.
.PP
\fBPrzyk\(/lad 1. przyk\(/ladowy plik konfiguracji\fR
.PP
Przyk\(/ladowy plik konfiguracji jest dostępny w:
.sp
.if n \{\
.RS 4
.\}
.nf
/usr/share/doc/po4a/examples/po4a\-build\&.conf\&.example
.fi
.if n \{\
.RE
.\}
.SS "Uk\(/lad pliku konfiguracji"
.PP
Plik konfiguracyjny sk\(/lada się z kilku sekcji: og\('olna, wsparcie dla XML/XSL, wsparcie dla POD oraz wsparcie dla HTML\-a\&.
.PP
Sekcja og\('olna zawiera nazwę i lokalizację pliku konfiguracyjnego po4a (najprawdopodobniej najlepiej by\(/loby go zostawić jako
po4a\&.config), nazwę katalogu po zwierającego pliki PO dokumentacji (często
doc/po), pe\(/lną nazwę pliku POT używanego do wygenerowania t\(/lumaczeń, katalog bazowy generowanej dokumentacji (BASEDIR), informacje o tym, czy pakiet zawiera strony podręcznika w sekcji 3 zamiast tylko w sekcji 1 oraz nazwy pakiet\('ow binarnych zawierających wygenerowane wyjście\&.
.PP
Sekcja wsparcia dla XML/XSL, określa kt\('ore z pakiet\('ow binarnych używają wsparcia dla XSL (w zmiennej XMLPACKAGES), g\(/l\('owny plik DocBook przekazywany do
\fBxsltproc\fR
oraz lokalizacje plik\('ow XML lub DocBook\&. XSLFILE może zostać nadpisane, jeśli jest to potrzebne\&.
.PP
Sekcja wsparcia dla POD określa, kt\('ore z pakiet\('ow binarnych używają wsparcia dla POD w zmiennej PODPACKAGES oraz pe\(/lną nazwę pliku POD\&.
.PP
Sekcja wsparcia dla HTML\-a podaje podkatalog katalogu BASEDIR zawierający nieprzet\(/lumaczone i przet\(/lumaczone dokumenty HTML oraz plik DocBook do wygenerowania HTML\-a\&. Plik HTMLXSL może zostać nadpisany, jeśli jest to potrzebne\&.
.SH "POLECENIA"
.PP
\fB\-\-pot\-only\fR
.RS 4
Aktualizuje tylko plik(i) POT\&.
\fB\-\-pot\-only\fR
jest przeznaczona dla pakiet\('ow, kt\('orych źr\('od\(/la zawierają wszystkie pliki POT\&. Pakiety używające Autotools mogą w prosty spos\('ob dodać plik POT do pakietu źr\('od\(/lowego, używając EXTRA_DIST, jednakże w przypadku pakiet\('ow używających zwyk\(/lych Makefile\*(Aqi lub pewnych narzędzi pomocniczych z systemu kontroli wersji umieszczenie pliku POT (kt\('ory jest plikiem generowanym) w pakiecie źr\('od\(/lowym może okazać się niemożliwe bez jednoczesnego dodania go do systemu kontroli wersji\&. Aby uniknąć tej paskudnej i niepotrzebnej roboty,
\fBpo4a\-build\fR
potrafi zaktualizować plik(i) POT na początku budowania pakietu, tak żeby
\fBdpkg\-source\fR
mog\(/lo w\(/lączyć go do pakietu źr\('od\(/lowego\&.
.PP
\fBPrzyk\(/lad 2. Przyk\(/lad svn-buildpackage.\fR
.PP
\fBsvn\-buildpackage\fR
otwarcie wspiera taki dodatek, za pomocą w\(/laściwości SVN
\fBuseNativeDist\fR
oraz celu
\fBnative\-dist\fR
programu make\&.
.sp
.if n \{\
.RS 4
.\}
.nf
# dodaje plik POT do archiwum źr\('ode\(/l
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
Wyświetla komunikat pomocy i kończy dzia\(/lanie\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
Wyświetla komunikat pomocy i kończy dzia\(/lanie\&.
.RE
.SH "OPCJE"
.PP
\fB\-f\fR|\fB\-\-file\fR\fI PLIK\fR
.RS 4
Nadpisuje domyślny plik konfiguracyjny polecenia
\fBpo4a\-build\fR
(tj\&. plik
po4a\-build\&.conf)\&.
.RE
.SH "AUTOR"
.PP
\fBpo4a\-build\fR
napisa\(/l Neil Williams
\&.
.PP
Tę stronę podręcznika napisa\(/l Neil Williams