'\" t
.\" Title: po4a-build
.\" Author: [see the "АВТОР" section]
.\" Generator: DocBook XSL Stylesheets v1.79.1
.\" Date: 07/06/2018
.\" Manual: PO4A
.\" Source: PO4A
.\" Language: Ukrainian
.\"
.TH "po4a\-build" "1" "07/06/2018" "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 "НАЗВА"
po4a-build \- збирання перекладеної документації
.SH "КОРОТКИЙ ОГЛЯД"
.HP \w'\fBpo4a\-build\fR\ 'u
\fBpo4a\-build\fR [\fB\-f\fR | \fB\-\-file\fR\fI
ФАЙЛ\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 "ОПИС"
.PP
\fBpo4a\-build\fR
призначено для спрощення створення перекладеної документації таким чином, щоб це було не складнішим за створення поточних неперекладених даних\&.
.PP
Якщо
\fBpo4a\fR
готує перекладені дані у форматі POD або XML DocBook, остаточну документацію можна зібрати за допомогою
\fBpo4a\-build\fR\&. Неперекладені і перекладені дані збираються у межах одного процесу із одночасним оновленням файлів POT\&.
.PP
Наявні інструкції зі збирання замінюються на один виклик
\fBpo4a\-build\fR, а для збирання кожного елемента та визначення, до якого з бінарних пакунків слід включити перекладені і неперекладені дані, використовується простий файл налаштувань
\fBpo4a\-build\fR\&.
.PP
Після збирання дані опиняться у специфічних для пакунка каталогах у каталозі
\fBBASEDIR\fR, який вказано у файлі налаштувань\&. Для бінарного пакунка foo із перекладами німецькою та французькою це виглядатиме десь так:
.sp
.if n \{\
.RS 4
.\}
.nf
BASEDIR/foo/man/man1/foo\&.1
BASEDIR/foo/man/de/man1/foo\&.1
BASEDIR/foo/man/fr/man1/foo\&.1
.fi
.if n \{\
.RE
.\}
.PP
Це полегшує включення усіх створених даних до бінарного пакунка із єдиним місцем встановлення:
.sp
.if n \{\
.RS 4
.\}
.nf
doc/foo/man/* \&./usr/share/man/
doc/foo/html/* \&./usr/share/doc/foo/
.fi
.if n \{\
.RE
.\}
.PP
Це правило не потребуватиме оновлення при додаванні нових перекладів, а додавання другого бінарного пакунка (bar) уможливить окреме розташування даних для нового пакунка\&.
.SS "Підтримувані формати"
.PP
У поточній версії у
\fBpo4a\-build\fR
передбачено підтримку таких комбінацій:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 1." 4.2
.\}
XML DocBook для розділу 1\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 2." 4.2
.\}
XML DocBook для розділу 3\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 3." 4.2
.\}
XML DocBook для HTML\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 4." 4.2
.\}
POD для розділу 1\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 5.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 5." 4.2
.\}
POD для розділу 3\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 6.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 6." 4.2
.\}
POD для розділу 5\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 7.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 7." 4.2
.\}
POD для розділу 7\&.
.RE
.PP
Усі підтримувані формати, у всіх їхніх підтримуваних комбінаціях можна вказати у одному файлі налаштувань
po4a\-build\&.conf
і у єдиному виклику
\fBpo4a\-build\fR\&. Див\&.
\fBpo4a-build.conf\fR(5)\&.
.SH "НАЛАШТОВУВАННЯ"
.PP
\fBpo4a\-build\fR
використовує типовий файл налаштувань,
po4a\-build\&.conf, який має зберігатися у каталозі верхнього рівня системи керування версіями вашого пакунка\&. (Скористайтеся параметром
\fB\-f\fR, щоб вказати інший файл\&.) Див\&.
\fBpo4a-build.conf\fR(5)\&.
.PP
\fBПриклад 1. приклад файла налаштувань\fR
.PP
Приклад файла налаштувань доступний тут:
.sp
.if n \{\
.RS 4
.\}
.nf
/usr/share/doc/po4a/examples/po4a\-build\&.conf\&.example
.fi
.if n \{\
.RE
.\}
.SS "компонування файла налаштувань"
.PP
Файл налаштувань складається із декількох розділів, загального розділу, розділу підтримки XML/XSL, розділу підтримки POD та розділу підтримки HTML\&.
.PP
До загального розділу включається назва і розташування файла налаштувань po4a (ймовірно, варто залишити назву
po4a\&.config), каталог
po, у якому містяться файли PO документації (часто
doc/po), повна назва файла POT, який використовується для створення перекладів, базовий каталог BASEDIR для виведених даних, дані про те, чи містяться у пакунку сторінки підручника (man) у розділі 3, а не лише у розділі 1, та назви бінарних пакунків, у яких міститимуться створені у результаті перекладу дані\&.
.PP
До розділу підтримки XML/XSL включають визначення того, які бінарні пакунки використовують підтримку XSL, у змінній
\fBXMLPACKAGES\fR, файл DocBook верхнього рівня, який слід передати
\fBxsltproc\fR, та розташування файлів XML або DocBook\&. Параметр
\fBXSLFILE\fR, якщо потрібно, можна перевизначити\&.
.PP
До розділу підтримки POD включають визначення того, у яких бінарних пакунках використовується підтримка POD, у змінній PODPACKAGES та повна назва файла POD\&.
.PP
У розділі підтримки HTML вказують підкаталог, який слід створити у BASEDIR для неперекладених і перекладених даних HTML, та файл DocBook, призначений для створення HTML\&. Файл HTMLXSL можна, якщо потрібно, перевизначити\&.
.SH "КОМАНДИ"
.PP
\fB\-\-pot\-only\fR
.RS 4
Лише оновити файли POT\&.
\fB\-\-pot\-only\fR
призначено для підтримки пакунків, де усі файли POT включаються до пакунку з кодом\&. До пакунків, де використовується Autotools, файл POT можна додати доволі просто, за допомогою
\fBEXTRA_DIST\fR, але у пакунках, де використовується лише Makefile або певні допоміжні засоби збирання системи керування версіями, додавання файла POT (який є створеним файлом) є некрасивим без записування цього файла POT до системи керування версіями\&. Щоб уникнути марудної і непотрібної роботи, можна скористатися програмою
\fBpo4a\-build\fR, яка може оновити файли POT на початку процесу збирання, щоб згодом програма
\fBdpkg\-source\fR
включила ці файли до архіву tar із початковим кодом\&.
.PP
\fBПриклад 2. Приклад svn\-buildpackage\fR
.PP
У
\fBsvn\-buildpackage\fR
передбачено явну підтримку цього типу додавання за допомогою властивості SVN
\fBuseNativeDist\fR
та цілі Make
\fBnative\-dist\fR\&.
.sp
.if n \{\
.RS 4
.\}
.nf
# додає файл POT до архіву tar з кодом
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
вивести повідомлення щодо використання і завершити роботу\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
вивести дані щодо версії скрипту і завершити роботу\&.
.RE
.SH "ПАРАМЕТРИ"
.PP
\fB\-f\fR|\fB\-\-file\fR\fI ФАЙЛ\fR
.RS 4
Перевизначити типовий файл налаштувань
\fBpo4a\-build\fR
(po4a\-build\&.conf) і вказати власний\&.
.RE
.SH "АВТОР"
.PP
\fBpo4a\-build\fR
написано Neil Williams
\&.
.PP
Цю сторінку підручника написано Neil Williams