
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 ИМЕ

Locale::Po4a::AsciiDoc - двосмерна конверзија AsciiDoc докумената и PO
фајлова

=head1 ОПИС

Циљ po4a (PO for anything – PO за било шта) пројекта је да поједностави
превођење (и што је још интересантније, одржавање превода) употребом gettext
алата на деловима на којима се не очекује њихова употреба, као што је
документација.

Locale::Po4a::AsciiDoc је модул који помаже превођење докумената у AsciiDoc
формату.

=head1 ОПЦИЈЕ КОЈЕ ПРИХВАТА ОВАЈ МОДУЛ

Ово су опције везане само за овај модул:

=over

=item B<definitions>

Име фајла који садржи дефиниције за po4a, као што је дефинисано у одељку
B<ПРИЛАГОЂАВАЊЕ ИЗ САМОГ ФАЈЛА>. Ову опцију можете користити у случају да
није могуће постављање дефиниција у документ који се преводи.

У фајлу дефиниција, линије не смеју да почну са две косе линије, већ
директно са B<po4a:>.

=item B<entry>

Листа ставки атрибута раздвојених размацима које желите да
преведете. Подразумевано је да ниједна ставка атрибута не може да се
преведе.

=item B<macro>

Листа макро дефиниција раздвојених размацима.

=item B<style>

Листа дефиниција стилова раздвојених размацима.

=item B<forcewrap>

Укључује аутоматско обавијање линија за блокове који се не наводе дословно,
чак и ако би AsciiDoc форматери могли погрешно да интерпретирају резултат.

Програм po4a подразумевано неће да обавија направљене AsciiDoc фајлове јер
је обавезна ручна провера како би се обезбедило да обавијање не промени
форматирање. Узмите на пример следећу ставку листе:

 * a long sentence that is ending with a number 1. A second sentence.

Ако обавијање доведе до оваквог представљања, ставка се дели у нумерисану
подлисту. Да ствар буде још гора, ситуацију може да испита само особа која
говори језик коришћен у преводу.

 * a long sentence that is ending with a number
   1. A second sentence.

Приметите да необавијање фајлова које производи програм po4a не би требало
да представља проблем, јер су ти фајлови намењени аутоматској обради. Они
свакако не би требало да се посматрају као изворни фајлови.

Помоћу ове опције програм po4a ће направити AsciiDoc фајлове који изгледају
лепше, али који потенцијално могу да доведу до погрешно форматирних излазних
докумената.

=item B<noimagetargets>

Подразумевано је могуће да се циљеви блок слика преводе како би се омогућило
да садржај показује на преведене слике. То може да се заустави постављањем
ове опције.

=item B<tablecells>

Ова опција је заставица која омогућава сегментацију подтабела у садржај
ћелије. Сегментација је ограничена само на садржај ћелије, без било каквог
парсирања унутар ње.

=item B<compat>

Укључује компатибилност парсирања правила са различитим алатима. Доступне
опције су "asciidoc" или "asciidoctor". Asciidoctor има строжија правила
парсирања, као што је једнакост дужина отварајућих и затварајућих ограда
блока.

=item B<nolinting>

Искључује линтинг поруке. Када изворни кôд не може да се поправи тако да се
добије чистија структура документа, ове поруке су бескорисне.

=item B<cleanspaces>

Уклања вишак размака из изворних сегмената у no-wrap режиму. Ово је корисно
када су алати за превођење осетљиви на број размака.

=item B<yfm_keys>

Листа кључева раздвојених запетама који треба да се обраде за превод у YAML
Front Matter одељку. Сви остали кључеви се прескачу. При подударању кључева
се води рачуна о разлици малих и великих слова. Ако се B<yfm_paths> и
B<yfm_keys> употребе заједно, вредности се укључују ако се подударају са
барем једном од њих. Вредности низа се увек преводе, осим у случају када је
постављена опција B<yfm_skip_array>.

=item B<yfm_skip_array>

Вредности типа низ у YAML Front Matter одељку се не преводе.

=item B<yfm_paths>

Листа хеш путања раздвојених запетама који треба да се обраде за издвајање у
YAML Front Matter одељку, све остале путање се прескачу. При подударању
путања се води рачуна о разлици малих и великих слова. Ако се B<yfm_paths> и
B<yfm_keys> употребе заједно, вредности се укључују ако се подударају са
барем једном од опција. Вредности низова се увек враћају, осим у случају
када је постављена опција B<yfm_skip_array>.

=back

=head1 ПРИЛАГОЂАВАЊЕ ИЗ САМОГ ФАЈЛА

AsciiDoc модул може да се прилагоди линијама које почињу са B<//po4a:>. Ове
линије се интерпретирају као команде парсера. Препознају се следеће команде:

=over 4

=item B<//po4a: macro >I<име>B<[>I<листа атрибута>B<]>

Ово детаљно описује параметре за B<макро>; I<име> мора да буде важеће име
макроа, и да се завршава доњом цртом у случају да циљ мора да се преведе.

Аргумент I<листа атрибута> је листа раздвојена зарезима која садржи
информације о аргументима који могу да се преведу. Ова листа садржи или
бројеве, који дефинишу позиционе параметре, или именоване атрибуте.

Ако се испред аргумента I<name> стави знак плус (B<+>), онда се макро и
његови аргументи преводе као целина. У овом случају нема потребе да се
дефинише листа аргумената, али је потребно да постоје угласте заграде.

=item B<//po4a: style >B<[>I<листа атрибута>B<]>

Ово детаљно описује који атрибути стила морају да се преведу.

Аргумент I<листа атрибута> је листа раздвојена зарезима која садржи
информације о аргументима који могу да се преведу. Ова листа садржи или
бројеве, којима се дефинишу позициони параметри, или именоване
атрибуте. Први атрибут је име стила, и он неће да се преводи.

У случају да се испред имена стила стави знак плус (B<+>), листа атрибута се
преводи као целина. Нама потребе да се дефинишу атрибути који могу да се
преводе.

У случају да се испред имена стила стави знак минус (B<->), тај атрибут се
не преводи.

If a percent signe (B<%>) is appended to the style name, then the style is
processed as verbatim. The lines in paragraph or block of such style are
preserved in the po files and the corresponding entries are marked as
no-wrap.

=item B<//po4a: entry >I<име>

Ово наводи да ставка атрибута може да се преводи. Подразумева се да оне не
могу да се преводе.

=back

=head1 СТАТУС ОВОГ МОДУЛА

Успешно је тестиран на једноставним AsciiDoc фајловима.

=head1 АУТОРИ

 Nicolas François <nicolas.francois@centraliens.net>
 Denis Barbier <barbier@linuxfr.org>

=head1 ПРАВА УМНОЖАВАЊА И ЛИЦЕНЦА

 Copyright © 2005-2008 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>.
 Copyright © 2012 Denis BARBIER <barbier@linuxfr.org>.
 Copyright © 2017 Martin Quinson <mquinson#debian.org>.

Овај програм је слободан софтвер; можете да га редистрибуирате и/или мењате
под условима GPL v2.0 или новије (погледајте фајл COPYING).
