.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "Locale::Po4a::Docbook 3pm"
.TH Locale::Po4a::Docbook 3pm "2020-08-19" "Інструменти Po4a" "Інструменти Po4a"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "НАЗВА"
.IX Header "НАЗВА"
Locale::Po4a::Docbook — перетворення документів \s-1XML\s0 DocBook на файли \s-1PO,\s0 і
навпаки
.SH "ОПИС"
.IX Header "ОПИС"
Метою проекту po4a (\s-1PO\s0 для усього) є спрощення перекладу (та, що ще
цікавіше, супровід перекладів) за допомогою інструментів gettext у областях,
де такий переклад спочатку не передбачався, зокрема у документації.
.PP
Locale::Po4a::Docbook — модуль, який допомагає у перекладі документів \s-1XML\s0
DocBook іншими мовами (якими розмовляють люди).
.SH "СТАН ЦЬОГО МОДУЛЯ"
.IX Header "СТАН ЦЬОГО МОДУЛЯ"
Цей модуль є повнофункціональним, оскільки він використовує модуль
Locale::Po4a::Xml. Сам модуль лише визначає придатні до перекладу теґи і
атрибути.
.PP
Єдиною відомою вадою є те, що модуль ще не може працювати із замінниками
(entities), зокрема із замінниками включення файлів. Втім, ви можете
перекладати більшу частину включених файлів окремо (окрім файлів типових
замінників), і, зазвичай, такі файли все одно краще супроводжувати окремо.
.SH "ПЕРЕВИЗНАЧЕННЯ ТИПОВОЇ ПОВЕДІНКИ ЗА ДОПОМОГОЮ ПАРАМЕТРІВ КОМАНДНОГО РЯДКА"
.IX Header "ПЕРЕВИЗНАЧЕННЯ ТИПОВОЇ ПОВЕДІНКИ ЗА ДОПОМОГОЮ ПАРАМЕТРІВ КОМАНДНОГО РЯДКА"
Типовою поведінкою наданих системою модулів є безпечна поведінка.
.PP
Наприклад, типовий теґ \fB<author>\fR розташовано у тезі \fB<para>\fR. Але
використовувати його можна лише у тезі \fB<bookinfo>\fR. У цьому випадку
раціонально було б перекладати його окремо для кожного з авторів.
.PP
Якщо вам не до вподоби типова поведінка модуля xml та похідних від нього
модулів, ви можете змінити її за допомогою параметрів командного
рядка. Наприклад, ви можете додати таке до файла налаштувань po4a:
.PP
.Vb 4
\&  opt:"\-k 0 \-o nodefault=\e"<bookinfo> <author>\e" \e
\&            \-o break=\e"<bookinfo> <author>\e" \e
\&            \-o untranslated=\e"<bookinfo>\e" \e
\&            \-o translated=\e"<author>\e""
.Ve
.PP
Ці параметри перевизначать типову поведінку для \fB<bookinfo>\fR і \fB<author>\fR, встановивши, що вхідний потік даних слід розривати на теґах \fB<bookinfo>\fR і \fB<author>\fR, не слід перекладати дані з теґами у \fB<bookinfo>\fR і слід переклади дані з теґами \fB<author>\fR.
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
.IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
\&\fBLocale::Po4a::TransTractor\fR\|(3pm), \fBLocale::Po4a::Xml\fR\|(3pm),
\&\fBpo4a\fR\|(7)
.SH "АВТОРИ"
.IX Header "АВТОРИ"
.Vb 1
\& Jordi Vilalta <jvprat@gmail.com>
.Ve
.SH "АВТОРСЬКІ ПРАВА ТА ЛІЦЕНЗУВАННЯ"
.IX Header "АВТОРСЬКІ ПРАВА ТА ЛІЦЕНЗУВАННЯ"
.Vb 2
\& © Jordi Vilalta  <jvprat@gmail.com>, 2004
\& © Nicolas François <nicolas.francois@centraliens.net>, 2007—2009
.Ve
.PP
Ця програма є вільним програмним забезпеченням; ви можете поширювати її
і/або вносити до неї зміни за умов дотримання \s-1GPL\s0 (див. файл \s-1COPYING\s0).