.\" 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::AsciiDoc 3pm" .TH Locale::Po4a::AsciiDoc 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::AsciiDoc — перетворення документів AsciiDoc на файли \s-1PO,\s0 і навпаки .SH "ОПИС" .IX Header "ОПИС" Метою проекту po4a (\s-1PO\s0 для усього) є спрощення перекладу (та, що ще цікавіше, супровід перекладів) за допомогою інструментів gettext у областях, де такий переклад спочатку не передбачався, зокрема у документації. .PP Locale::Po4a::AsciiDoc — модуль, який допомагає у перекладі документації у форматі AsciiDoc. .SH "ПАРАМЕТРИ, ЯКІ МОЖНА ПЕРЕДАВАТИ ЦЬОМУ МОДУЛЮ" .IX Header "ПАРАМЕТРИ, ЯКІ МОЖНА ПЕРЕДАВАТИ ЦЬОМУ МОДУЛЮ" Ось параметри, які можна передавати цьому модулю: .IP "\fBdefinitions\fR" 4 .IX Item "definitions" Назва файла, що містить визначення для po4a, як це визначено у розділі \&\fBНАЛАШТОВУВАННЯ НА МІСЦІ\fR. Ви можете скористатися цим параметром, якщо вставляння визначень до документа, який ви перекладаєте, є неможливим. .Sp У файлі визначень рядки мають починатися не з двох символів похилої риски, а безпосередньо із \fBpo4a:\fR. .IP "\fBentry\fR" 4 .IX Item "entry" Список відокремлених пробілами записів атрибутів, вміст яких ви хочете перекладати. Типово, атрибути не перекладаються. .IP "\fBmacro\fR" 4 .IX Item "macro" Список відокремлених пробілами визначень макросів. .IP "\fBstyle\fR" 4 .IX Item "style" Список відокремлених пробілами визначень стилів. .IP "\fBnoimagetargets\fR" 4 .IX Item "noimagetargets" Типово, записи блоків зображень можна перекладати, щоб надати можливість перекладачеві вказати зображення із перекладеними повідомленнями. Вимкнути переклад цих блоків можна за допомогою цього параметра. .IP "\fBtablecells\fR" 4 .IX Item "tablecells" Цей параметр є прапорцем, який вмикає поділ за підтаблицями у вмісті комірки. Поділ обмежено вмістом комірки, без обробки даних всередині. .IP "\fBcompat\fR" 4 .IX Item "compat" Перемикає правила обробки для сумісності із різними інструментами. Доступними значеннями є «asciidoc» і «asciidoctor». Asciidoctor має строгіші правила обробки, зокрема вимагає збереження довжини початкових і завершальних обв'язок блоків. .SH "НАЛАШТОВУВАННЯ НА МІСЦІ" .IX Header "НАЛАШТОВУВАННЯ НА МІСЦІ" Налаштувати модуль AsciiDoc можна рядками, які починаються з \&\fB//po4a:\fR. Такі рядки вважатимуться командами, які віддаються засобу обробки. Передбачено такі команди: .IP "\fB//po4a: macro \fR\fIназва\fR\fB[\fR\fIсписок атрибутів\fR\fB]\fR" 4 .IX Item "//po4a: macro назва[список атрибутів]" Цей рядок надає змогу докладно описати параметри \fBмакроса\fR; \fIназва\fR має бути коректною назвою макроса і має завершуватися символом підкреслювання, якщо ціль має бути перекладено. .Sp Аргумент \fIсписок атрибутів\fR є списком відокремлених комами значень, які містять дані щодо придатних до перекладу аргументів. У цьому списку містяться або номери, для визначення позиційних параметрів, або іменовані атрибути. .Sp Якщо перед назвою стоятиме символ «плюс» (\fB+\fR), макрос і його аргументи перекладатимуться як ціле. У цьому випадку немає потреби у визначенні списку атрибутів, але квадратні дужки все ж доведеться дописати. .IP "\fB//po4a: style \fR\fB[\fR\fIсписок атрибутів\fR\fB]\fR" 4 .IX Item "//po4a: style [список атрибутів]" Цей рядок надає змогу докладно описати атрибути стилю, які слід перекласти. .Sp Аргумент \fIсписок атрибутів\fR є списком відокремлених комами значень, які містять дані щодо придатних до перекладу аргументів. У цьому списку містяться або номери, для визначення позиційних параметрів, або іменовані атрибути. Перший атрибут є назвою стилю, його не буде перекладено. .Sp Якщо перед назвою стилю вказано символ «плюс» (\fB+\fR), список атрибутів перекладається як ціле. У такому випадку немає потреби у визначенні атрибутів, які слід перекладати. .Sp Якщо перед назвою стилю вказано символ «мінус» (\fB\-\fR), список атрибутів не перекладається. .IP "\fB//po4a: entry \fR\fIназва\fR" 4 .IX Item "//po4a: entry назва" Ця команда оголошує запис атрибута як придатний до перекладу. Типово, записи атрибутів не перекладаються. .SH "СТАН ЦЬОГО МОДУЛЯ" .IX Header "СТАН ЦЬОГО МОДУЛЯ" Успішно перевірено на простих файлах AsciiDoc. .SH "АВТОРИ" .IX Header "АВТОРИ" .Vb 2 \& Nicolas François \& Denis Barbier .Ve .SH "АВТОРСЬКІ ПРАВА ТА ЛІЦЕНЗУВАННЯ" .IX Header "АВТОРСЬКІ ПРАВА ТА ЛІЦЕНЗУВАННЯ" .Vb 3 \& © Nicolas FRANÇOIS , 2005–2008. \& © Denis BARBIER , 2012. \& © Martin Quinson , 2017. .Ve .PP Ця програма є вільним програмним забезпеченням; ви можете поширювати її і/або вносити до неї зміни за умов дотримання \s-1GPL\s0 (див. файл \s-1COPYING\s0).