po4a 0.72 - en to sr translation catalogue (1170 entries)

note: type: Attribute 'xml:lang' of: <refentry>
en: en
sr: sr-RS

note: type: Content of: <refentry><refmeta><refmiscinfo>
en: Po4a Tools
sr: Po4a Алати

note: type: Content of: <refentry><refnamediv><refpurpose>
en: display a translated man page according to a PO
sr: приказује преведену man страну у складу са PO

note: type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
en: <command>po4a-display-man</command> <arg choice='plain'><option>-p</option> </arg> <arg choice='plain'><replaceable>PO_FILE</replaceable></arg> <arg choice='opt'><arg choice='plain'><option>-m</option> </arg><arg choice='plain'><replaceable>MASTER_FILE</replaceable></arg></arg> <arg choice='opt'><arg choice='plain'><option>-o</option> </arg><arg choice='plain'><replaceable>PO4A_OPT</replaceable></arg></arg>
sr: <command>po4a-display-man</command> <arg choice='plain'><option>-p</option> </arg> <arg choice='plain'><replaceable>PO_ФАЈЛ</replaceable></arg> <arg choice='opt'><arg choice='plain'><option>-m</option> </arg><arg choice='plain'><replaceable>МАСТЕР_ФАЈЛ</replaceable></arg></arg> <arg choice='opt'><arg choice='plain'><option>-o</option> </arg><arg choice='plain'><replaceable>PO4A_ОПЦ</replaceable></arg></arg>

note: type: =head1
en: DESCRIPTION
sr: ОПИС

note: type: Content of: <refentry><refsect1><para>
en: Translators can use <command>po4a-display-man</command> to see how their translation of a man page will be rendered to the end users, without recompiling and reinstalling the whole project.
sr: Преводиоци могу да употребе <command>po4a-display-man</command> и виде како ће њихов превод man странице бити приказан крајњим корисницима, без потребе да се цео пројекат рекомпајлира и реинсталира.

note: type: Content of: <refentry><refsect1><para>
en: This script only works with man pages written directly in <emphasis remap='I'>nroff</emphasis> and handled by the po4a's <emphasis remap='I'>man</emphasis> module.  Manual pages generated from other formats, like DocBook or POD, are not supported.  See <citerefentry><refentrytitle>po4a-display-pod</refentrytitle><manvolnum>1</manvolnum></citerefentry> for an equivalent supporting <emphasis remap='I'>POD</emphasis> documents.
sr: Овај скрипт функционише само за man странице написане директно у <emphasis remap='I'>nroff</emphasis> и које обрађује модул <emphasis remap='I'>man</emphasis> програма po4a.  Нису подржане странице приручника које су генерисане из осталих формата, ко што су DocBook или POD. Погледајте <citerefentry><refentrytitle>po4a-display-pod</refentrytitle><manvolnum>1</manvolnum></citerefentry> за еквивалентне подржавајуће <emphasis remap='I'>POD</emphasis> документе.

note: type: =head1
en: OPTIONS
sr: ОПЦИЈЕ

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: <option>-p </option><replaceable>PO_FILE</replaceable>
sr: <option>-p </option><replaceable>PO_ФАЈЛ</replaceable>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The PO file containing the translations.
sr: PO фајл у коме се налазе преводи.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: <option>-m </option><replaceable>MASTER_FILE</replaceable>
sr: <option>-m </option><replaceable>МАСТЕР_ФАЈЛ</replaceable>

note: .br type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The original man page.  It can be the absolute or relative path to the original man page (gzipped or not), the name of the man page or the name and section of the man page (using the man.section format).  When the master document is not provided with the <option>-m</option> option, <command>po4a-display-man</command> tries to find the original man page based on the line reference of the first string in the PO.
sr: Оригинална man страница. Може да буде апсолутна или релативна путања до оригиналне man странице (gzippоване или не), име man странице или име и секција man странице (употребљавајући формат man.секција). Када опцијом <option>-m</option> није наведен мастер документ, <command>po4a-display-man</command> команда покушава да пронађе оригиналну man страницу користећи референцу на линију из првог стринга у PO фајлу.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: <option>-o </option><replaceable>PO4A_OPT</replaceable>
sr: <option>-o </option><replaceable>PO4A_ОПЦ</replaceable>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Some options to pass to <citerefentry><refentrytitle>po4a-translate</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
sr: Неке опције које се прослеђују програму <citerefentry><refentrytitle>po4a-translate</refentrytitle><manvolnum>1</manvolnum></citerefentry>.

note: type: =head1
en: SEE ALSO
sr: ПОГЛЕДАЈТЕ ТАКОЂЕ

note: type: Content of: <refentry><refsect1><title>
en: AUTHOR
sr: АУТОР

note: type: Content of: <refentry><refsect1><para>
en: Thomas Huriaux
sr: Томас Урио

note: type: Content of: <refentry><refnamediv><refpurpose>
en: display of a translated POD file according to a PO
sr: приказује преведени POD фајл у складу са PO

note: type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
en: <command>po4a-display-pod</command> <arg choice='plain'><option>-p </option></arg> <arg choice='plain'><replaceable>PO_FILE</replaceable></arg> <arg choice='plain'><option>-m </option></arg> <arg choice='plain'><replaceable>POD_FILE</replaceable></arg> <arg choice='opt'><arg choice='plain'><option>-o </option></arg><arg choice='plain'><replaceable>PO4A_OPT</replaceable></arg></arg>
sr: <command>po4a-display-pod</command> <arg choice='plain'><option>-p </option></arg> <arg choice='plain'><replaceable>PO_ФАЈЛ</replaceable></arg> <arg choice='plain'><option>-m </option></arg> <arg choice='plain'><replaceable>POD_ФАЈЛ</replaceable></arg> <arg choice='opt'><arg choice='plain'><option>-o </option></arg><arg choice='plain'><replaceable>PO4A_ОПЦ</replaceable></arg></arg>

note: type: Content of: <refentry><refsect1><para>
en: Translators can use <command>po4a-display-pod</command> to see how their translation of a man page will be rendered to the end users, without recompiling and reinstalling the whole project.  Most of the time, the POD file is only available in source package or embedded in Perl script.
sr: Преводиоци могу да употребе <command>po4a-display-pod</command> како ће њихова преведена man страница да се прикаже крајњим корисницима, без потребе да се рекомпајлира и реинсталира цео пројекат. Најчешће је POD фајл доступан само у пакету изворног кода или је уграђен у Perl скрипту.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: <option>-m </option><replaceable>POD_FILE</replaceable>
sr: <option>-m </option><replaceable>POD_ФАЈЛ</replaceable>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The original POD file used by po4a to generate PO file.
sr: Оригинални POD фајл који po4a користи за генерисање PO фајла.

note: type: Content of: <refentry><refsect1><para>
en: Florentin Duneau
sr: Флорентин Дуно

note: type: =head1
en: NAME
sr: ИМЕ

note: type: textblock
en: po4a - update both the PO files and translated documents in one shot
sr: po4a - у једном кораку ажурира и PO фајлове и преведене документе

note: type: =head1
en: SYNOPSIS
sr: СИНОПСИС

note: type: textblock
en: B<po4a> [I<options>] I<config_file>
sr: B<po4a> [I<опције>] I<конфиг_фајл>

note: type: textblock
en: po4a (PO for anything) eases the maintenance of documentation translation using the classical gettext tools. The main feature of po4a is that it decouples the translation of content from its document structure.  Please refer to the page L<po4a(7)> for a gentle introduction to this project.
sr: po4a (PO for anything [PO за било шта]) олакшава одржавање превода докумената употребом класичних gettext алата. Главна особина po4a је да раскида везу између садржаја превода и структуре његовог документа. Молимо да погледате страницу L<po4a(7)> у којој је изложен прости увод у овај пројекат.

note: type: textblock
en: Upon execution, B<po4a> parses all documentation files specified in its configuration file. It updates the PO files (containing the translation) to reflect any change to the documentation, and produce a translated documentation by injecting the content's translation (found in the PO files) into the structure of the original master document.
sr: Када сe програм покрене, B<po4a> парсира све фајлове документације наведене у свом конфигурационим фајлу. Он ажурира PO фајлове (у којима се налази превод) тако да се у њима прикажу све измене у документацији, па креира преведени документ уметањем превода садржаја (који се проналази у PO фајловима) у структуру оригиналног мастер документа.

note: type: textblock
en: At first, the PO files only contain the strings to translate from the original documentation. This file format allows the translators to manually provide a translation for each paragraph extracted by B<po4a>. If the documentation is modified after translation, B<po4a> marks the corresponding translations as "fuzzy" in the PO file to request a manual review by the translators. The translators can also provide so-called "addendum", that are extra content stating for example who did the translation and how to report bugs.
sr: У почетку, PO фајлови садрже само стрингове који треба да се преведу из оригиналне документације. Овај фајл формат омогућава да преводиоци ручно доставе превод сваког пасуса који издвоји B<po4a>. Ако се након превођења документација измени, B<po4a> означава одговарајуће преводе у PO фајлу као несигурне („fuzzy”) и тако од преводилаца захтева да их ручно провере. Преводиоци такође могу да наведу такозвани „додатак”, допунски садржај који наводи, на пример, ко је урадио превод и како да се пријаве багови.

note: type: verbatim
en:  master documents ---+---->-------->---------+
      (doc authoring)    |                       |
                         V   (po4a executions)   >-----+--> translated
                         |                       |     |     documents
     existing PO files -->--> updated PO files >-+     |
          ^                            |               |
          |                            V               |
          +----------<---------<-------+               ^
           (manual translation process)                |
                                                       |
     addendum -->--------------------------------------+
sr:  мастер документи ------+-------->-------->---------+
      (писање док)          |                           |
                            V       (po4a извршавања)   >-----+--> преведени
                            |                           |     |     документи
     постојећи PO фајлови -->--> ажурирани PO фајлови >-+     |
          ^                                 |                 |
          |                                 V                 |
          +----------<---------<------------+                 ^
              (ручни процес превођења)                        |
                                                              |
     додатак -->----------------------------------------------+

note: type: textblock
en: The workflow of B<po4a> is asynchronous, as suited to open-source projects. The documentation writers author the master documents at their own pace. The translators review and update the translations in the PO files. The maintainers rerun B<po4a> on need, to reflect any change to the original documentation to the PO files, and to produce updated documentation translations, by injecting the latest translation into the latest document structure.
sr: B<po4a> процес рада је асинхрон, прилагођен пројектима отвореног кода. Писци документације креирају мастер документе сопственим темпом. Преводиоци прегледају и ажурирају преводе у PO фајловима. Одржаваоци по потреби поново покрећу B<po4a>, чиме се измене у оригиналној документацији приказују у PO фајловима, као и да произведу ажуриране преводе документације, уметањем најсвежијих превода у најновију структуру документа.

note: type: textblock
en: By default, a given translated document is produced when at least 80% of its content is translated. The untranslated text is kept in the original language.  The produced documentation thus mixes languages if the translation is not complete. You can change the 80% threshold with the I<--keep> option described below. Note however that discarding translations as soon as they are not 100% may be discouraging for the translators whose work will almost never be shown to the users, while showing "translations" that are too incomplete may be troubling for the end users.
sr: Подразумевано се неки преведени документ израђује онда када је барем 80% његовог садржаја преведено. Непреведени текст се задржава на оригиналном језику. Произведена документација дакле меша језике ако превод није комплетан. Границу од 80% можете да промените опцијом I<--keep> која је описана испод. Међутим, имајте на уму да одбацивање превода чим проценат преведених стрингова није 100% може да буде обесхрабрујуће за преводиоце чији рад корисници скоро никада неће видети, док приказивање „превода” који је далеко од завршеног може представљати проблем за крајње кориснике.

note: type: textblock
en: Storing the translated documentation files in the version control system is probably a bad idea, since they are automatically generated. The precious files are the PO files, that contain the hard work of your fellow translators. Also, some people find it easier to interact with the translators through an online platform such as S<weblate>, but this is naturally fully optional.
sr: Чување фајлова превода документације у систему за контролу верзија је вероватно лоша идеја, јер се они генеришу аутоматски. Драгоцени су PO фајлови који садрже сав тежак рад ваших колега преводилаца. Такође, неким људима је једноставније да комуницирају са преводиоцима посредством онлајн платформе као што је S<веблејт>, али то је наравно потпуно опционално.

note: type: =head2
en: Quick start tutorial
sr: Туторијал за брзи почетак

note: type: textblock
en: Let's assume you maintain a program named B<foo> which has a man page F<man/foo.1> written in English (the bridge language in most open-source projects, but B<po4a> can be used from or to any language). Some times ago, someone provided a German translation named F<man/foo.de.1> and disappeared.  This is a problem because you just got a bug report saying that your documentation contains a gravely misleading information that must be fixed in all languages, but you don't speak German so you can only modify the original, not the translation. Now, another contributor wants to contribute a translation to Japanese, a language that you don't master either.
sr: Претпоставимо да одржавате програм под именом B<foo> који има man страницу F<man/foo.1> написану на енглеском језику (посредним језиком већине пројеката отвореног кода, мада B<po4a> може да се користи за било коју комбинацију изворног и циљног језика). Пре неког времена, неко је доставио немачки превод под именом F<man/foo.de.1> и нестао. Ово представља проблем јер сте управо добили извештај о багу који каже да ваша документација садржи озбиљно погрешну информацију која мора да се исправи у свим језицима, али ви не познајете немачки језик тако да можете изменити само оригинал, а не и превод. Затим, још један сарадник жели да допринесе превод на јапански, још један језик којим не владате.

note: type: textblock
en: It is time to convert your documentation to B<po4a> to solve your documentation maintenance nightmares. You want to update the doc when needed, you want to ease the work of your fellow translators, and you want to ensure that your users never see any outdated and thus misleading documentation.
sr: Време је двоју документацију конвертујете у B<po4a> и тако решите хаос у одржавању документације. Желите да ажурирате документ када је то потребно, желите да колегама преводиоцима олакжате посао и желите обезбедити да ваши кориснии никада не виде застарелу и услед тога нетачну документацију.

note: type: textblock
en: The conversion includes two steps: setup the po4a infrastructure, and convert the previous German translation to salvage the previous work. This latter part is done using S<po4a-gettextize>, as follows. As detailed in the documentation of L<po4a-gettextize(1)>, this process rarely fully automatic, but once it's done, the B<de.po> file containing the German translation can be integrated in your po4a workflow.
sr: Конверзија се састоји из два корака: постављање po4a инфраструктуре и конверзија претходно постојећег немачког превода како би се сачувао ранији рад. Овај други део се ради помоћу скрипте S<po4a-gettextize>, као што следи. Из детаља у документацији скрипте L<po4a-gettextize(1)> се види да је овај процес ретко кад у потпуности аутоматски, али једном када се обави, фајл B<de.po> који садржи немачки превод може да се интегрише у ваш po4a процес рада.

note: type: textblock
en: Let's now configure po4a. With the appropriate file layout, your configuration file could be as simple as this:
sr: Хајде сада конфигуришемо po4a. Уз погодан распоред фајлова, ваша конфигурација може да буде овако једноставна:

note: type: textblock
en: It specifies that all PO files (containing the work of the translators) are in the F<man/po4a/> directory, and that you have only one master file, F<man/foo.1>. If you had several master files, you would have several lines similar to the second one. Each such line also specify where to write the corresponding translation files. Here, the German translation of F<man/foo.1> is in F<man/translated/foo.de.1>.
sr: Она наводи да се сви PO фајлови (који садрже рад преводилаца) налазе у директоријуму F<man/po4a/> и да имате само један мастер фајл, F<man/foo.1>. Ако имате неколико мастер фајлова, морали бисте да наведете неколико линија сличних другој линији. Свака та линија такође наводи и где да се упишу одговарајући фајлови превода. У овом случају, немачки превод фајла F<man/foo.1> је F<man/translated/foo.de.1>.

note: type: textblock
en: The last thing we need to complete the configuration of B<po4a> is a POT file containing the template material that should be used to start a new translation.  Simply create an empty file with the S<.pot> extension in the specified S<po_directory> (e.g. F<man/po4a/foo.pot>), and B<po4a> will fill it with the expected content.
sr: Последња ствар која треба да се уради како би се комплетирала конфигурација B<po4a> је POT фајл који садржи материјал шаблона који треба да се користи када се започиње нови превод. Једноставно креирајте празан фајл са S<.pot> екстензијом у наведеном S<po_directory> (нпр. F<man/po4a/foo.pot>), а B<po4a> ће га испунити са очекиваним садржајем.

note: type: textblock
en: Here is a recap of the files in this setup:
sr: Ево подсетника фајлова који се користе у овом подешавању:

note: type: verbatim
en:   ├── man/
      │   ├── foo.1        <- The original man page, in English
      │   ├── po4a/
      │   │   ├── de.po    <- The German PO translation, from gettextization
      │   │   └── foo.pot  <- The POT template of future translations (empty at first)
      │   └── translated/  <- Directory where the translations will be created
      └── po4a.cfg         <- The configuration file
sr:   ├── man/
      │   ├── foo.1         <- Оригинална man страница, на енглеском језику
      │   ├── po4a/
      │   │   ├── de.po    <- немачки PO превод, добијен gettextизацијом
      │   │   └── foo.pot  <- POT шаблон будућих превода (у почетку празан)
      │   └── translated/  <- Директоријум у који ће се смештати преводи
      └── po4a.cfg         <- Конфигурациони фајл

note: type: textblock
en: Once setup, executing B<po4a> will parse your documentation, update the POT template file, use it to update the PO translation files, and use them to update the documentation translation files. All in one command:
sr: Једном када је подешен, извршавањем програма B<po4a> се парсира ваша документација, ажурира POT фајл шаблона, он се употреби за ажурирање PO фајлова превода, а ти фајлови се употребе за ажурирање фајлова превода документације. Све у једној команди:

note: type: textblock
en: This is it. B<po4a> is now fully configured. Once you've fixed your error in F<man/foo.1>, the offending paragraph in the German translation will be replaced by the fixed text in English. Mixing languages is not optimal, but it's the only way to remove errors in translations that you don't even understand, and ensure that the content presented to the users is never misleading. Updating the German translation is also much easier in the corresponding PO file, so the language mix-up may not last long. Finally, when a Japanese translator wants to contribute a new translation, she should rename the S<foo.pot> into S<ja.po> and complete the translation. Once you have this file, just drop it in F<man/po4a/po/>. A translated page will appear as F<man/translated/foo.ja.1> (provided that enough content is translated) when you run B<po4a> again.
sr: И то је то. B<po4a> је сада у потпуности конфигурисан. Када исправите грешку у F<man/foo.1>, неисправан пасус у немачком преводу ће се заменити исправљеним текстом на енглеском. Мешање језика није баш оптимално, али то је једини начин да се у преводима које чак и не разумете исправе грешке и да се обезбеди да је садржај који се представи корисницима увек тачан. Ажурирање немачког превода је такође много једноставније у одговарајућем PO фајлу, тако да мешавина језика вероватно неће дуго потрајати. Коначно, када преводилац на јапански жели да допринесе нови превод, требало би да преименује S<foo.pot> у S<ja.po> и доврши превод. Када добијете тај фајл, једноставно га убаците у директоријум F<man/po4a/po/>. Када поново покренете B<po4a>, преведена страница ће се појавити као F<man/translated/foo.ja.1> (у случају да је преведена потребна количина текста).

note: type: textblock
en: Minimal threshold for translation percentage to keep (i.e. write) the resulting file (default: 80). I.e. by default, files have to be translated at least at 80% to be written on disk.
sr: Најмањи ниво преведености који је потребан да се фајл резултата задржи (тј. запише) (подразумевано: 80). То значи да је подразумевано потребно да барем 80% неког фајла буде преведено како би се његов превод записао на диск.

note: type: textblock
en: Column at which we should wrap the resulting file if the format supports it (default: 76).  If the provided value is 0 or negative, then the resulting file will not be wraped at all.  This is useful with some formats that could break when rewraped.
sr: Колона на којој би требало да се обавија излазни фајл, у случају да формат то подржава (подразумевана вредност је 76). Ако је наведена вредност 0 или негативна, излазни фајл се уопште неће обавијати. Ово је корисно у случају неких формата који се искваре када се поново изврши обавијање.

note: type: textblock
en: Show a short help message.
sr: Приказује кратку поруку помоћи.

note: type: textblock
en: Charset of the files containing the documents to translate. Note that all master documents must use the same charset.
sr: Скуп карактера којим су записани фајлови који садрже документе за превод. Имајте на уму да сви мастер документи морају да користе исти скуп карактера.

note: type: textblock
en: Charset of the files containing the localized documents. Note that all translated documents will use the same charset.
sr: Скуп карактера који користе фајлови локализованих докумената. Имајте на уму да ће сви преведени документи користити исти скуп карактера.

note: type: textblock
en: Charset of the addenda. Note that all the addenda should be in the same charset.
sr: Скуп карактера додатка. Имајте на уму да би сви додаци требало да буду записани употребом истог скупа карактера.

note: type: textblock
en: Display the version of the script and exit.
sr: Приказује верзију скрипте и завршава извршавање.

note: type: textblock
en: Increase the verbosity of the program.
sr: Увећава детаљност извештавања програма.

note: type: textblock
en: Decrease the verbosity of the program.
sr: Умањује детаљност извештавања програма.

note: type: textblock
en: Output some debugging information.
sr: Исписује неке информације битне за отклањање грешака.

note: type: textblock
en: Extra option(s) to pass to the format plugin. See the documentation of each plugin for more information about the valid options and their meanings. For example, you could pass '-o tablecells' to the AsciiDoc parser, while the text parser would accept '-o tabs=split'.
sr: Додатна опција (или више њих) које се прослеђују додатку формата. Погледајте документацију сваког од додатака да сазнате више информација о важећим опцијама и њиховом значењу. На пример, AsciiDoc парсеру бисте могли да проследите '-o tablecells', док би текст парсер прихватио '-o tabs=split'.

note: type: textblock
en: Always generate the POT and PO files, even if B<po4a> considers it is not necessary.
sr: POT и PO фајлови се увек генеришу, чак и у случају када B<po4a> сматра да то није неопходно.

note: type: textblock
en: The default behavior (when B<--force> is not specified) is the following:
sr: Подразумевано понашање (када није наведено B<--force>) је као што следи:

note: type: textblock
en: If the POT file already exists, it is regenerated if a master document or the configuration file is more recent (unless B<--no-update> is provided).  The POT file is also written in a temporary document and B<po4a> verifies that the changes are really needed.
sr: У случају да POT фајл већ постоји, он се регенерише из мастер документа или ако је конфигурациони фајл новији (само ако није наведено B<--no-update>). POT фајл се такође уписује у привремени документ и B<po4a> проверава да ли су измене заиста неопходне.

note: type: textblock
en: Also, a translation is regenerated only if its master document, the PO file, one of its addenda or the configuration file is more recent.  To avoid trying to regenerate translations which do not pass the threshold test (see B<--keep>), a file with the F<.po4a-stamp> extension can be created (see B<--stamp>).
sr: Такође, превод се регенерише само у случају када је његов мастер документ, PO фајл, један од његових додатака или конфигурациони фајл новији. Како би се спречио покушај регенерације превода који не пролазе тест потребног минималног процента завршетка (погледајте B<--keep>), може да се креира фајл са F<.po4a-stamp> екстензијом (погледајте B<--stamp>).

note: type: textblock
en: If a master document includes files, you should use the B<--force> flag because the modification time of these included files are not taken into account.
sr: У случају да мастер документ укључује фајлове, требало би да користите заставицу B<--force> јер се време модификације ових фајлова не узима обзир.

note: type: textblock
en: The PO files are always re-generated based on the POT with B<msgmerge -U>.
sr: PO фајлови се увек регенеришу сагласно POT фајлу са B<msgmerge -U>.

note: type: textblock
en: Tells B<po4a> to create stamp files when a translation is not generated because it does not reach the threshold. These stamp files are named according to the expected translated document, with the F<.po4a-stamp> extension.
sr: Наводи B<po4a> да креира печат фајлове у случају да се превод не генерише јер проценат завршености није прешао задату границу. Ови печат фајлови се именују сагласно са очекиваним преведеним документом, и имају F<.po4a-stamp> екстензију.

note: type: textblock
en: Note: This only activates the creation of the F<.po4a-stamp> files. The stamp files are always used if they exist, and they are removed with B<--rm-translations> or when the file is finally translated.
sr: Напомена: ово само активира креирање F<.po4a-stamp> фајлова. Печат фајлови се увек користе ако постоје, и могу да се обришу помоћу B<--rm-translations> или када се фајл комплетно преведе.

note: type: textblock
en: Do not generate the translated documents, only update the POT and PO files.
sr: Не генеришу се преведени документи, само се ажурирају POT и PO фајлови.

note: type: textblock
en: Do not change the POT and PO files, only the translation may be updated.
sr: POT и PO фајлови се не мењају, могуће је само да се ажурира превод.

note: type: textblock
en: Keeps the existing translation files even if the translation doesn't meet the threshold specified by B<--keep>.  This option does not create new translation files with few content, but it will save existing translations which decay because of changes to the master files.
sr: Задржава постојеће фајлове превода чак и у случају када превод не задовољава критеријум задат са B<--keep>. Ова опција не креира нове фајлове превода са мало садржаја, али ће да сачува постојеће преводе који постају застарели услед измена над мастер фајловима.

note: type: textblock
en: WARNING: This flag changes the po4a behavior in a rather drastic way: your translated files will not get updated at all until the translation improves. Only use this flag if you prefer shipping an outdated translated documentation rather than only shipping an accurate untranslated documentation.
sr: УПОЗОРЕЊЕ: ова заставица на прилично драстичан начин мења понашање програма po4a: ваши преведени фајлови се уопште неће ажурирати све док се превод не побољша. Користите ову заставицу само у случају да вам више одговара да достављате застарели превод документације него да достављате прецизну али непреведену документацију.

note: type: textblock
en: Remove the translated files (implies B<--no-translations>).
sr: Уклања преведене фајлове (имплицира B<--no-translations>).

note: type: textblock
en: This flag does nothing since 0.41, and may be removed in later releases.
sr: Ова заставица нема никакву функцију почевши од верзије 0.41, и може бити уклоњена у наредним издањима програма.

note: type: =item
en: B<--translate-only> I<translated-file>
sr: B<--translate-only> I<преведени-фајл>

note: type: textblock
en: Translate only the specified file.  It may be useful to speed up processing if a configuration file contains a lot of files.  Note that this option does not update PO and POT files.  This option can be used multiple times.
sr: Преводи само наведени фајл. Може да буде корисно за убрзавање обраде у случају када конфигурациони фајл садржи доста фајлова. Имајте на уму да ова опција не ажурира PO и POT фајлове. Ова опција може да се употреби више пута.

note: type: =item
en: B<--variable> I<var>B<=>I<value>
sr: B<--variable> I<пром>B<=>I<вредност>

note: type: textblock
en: Define a variable that will be expanded in the B<po4a> configuration file.  Every occurrence of I<$(var)> will be replaced by I<value>.  This option can be used multiple times.
sr: Дефинише променљиву која ће да се развије у B<po4a> конфигурационом фајлу. Свако појављивање I<$(пром)> ће да се замени са I<вредност>. Ова опција може да се користи више пута.

note: type: =item
en: B<--target-lang> I<LANG>
sr: B<--target-lang> I<ЈЕЗИК>

note: type: textblock
en: Update PO files and generate translated documents only for the specified language. This option can be used multiple times.
sr: Ажурира PO фајлове и генерише преведене документе само за наведени језик. Ова опција може да се употреби више пута.

note: type: =item
en: B<--srcdir> I<SRCDIR>
sr: B<--srcdir> I<ИЗВОРНИДИР>

note: type: textblock
en: Set the base directory for all input documents specified in the B<po4a> configuration file.
sr: Поставља базни директоријум за све улазне документе наведене у B<po4a> конфигурационом фајлу.

note: type: textblock
en: If both I<destdir> and I<srcdir> are specified, input files are searched in the following directories, in order: I<destdir>, the current directory and I<srcdir>. Output files are written to I<destdir> if specified, or to the current directory.
sr: Ако су наведени и I<циљнидир> и I<изворнидир>, улазни фајлови се траже у следећим директоријумима, према редоследу: I<циљнидир>, текући директоријум и I<изворнидир>. Излазни фајлови се записују у I<циљнидир> ако је наведен, или у текући директоријум.

note: type: =item
en: B<--destdir> I<DESTDIR>
sr: B<--destdir> I<ЦИЉНИДИР>

note: type: textblock
en: Set the base directory for all the output documents specified in the B<po4a> configuration file (see B<--srcdir> above).
sr: Поставља базни директоријум за све излазне документе наведене у B<po4a> конфигурационом фајлу (погледајте B<--srcdir> изнад).

note: type: =head2
en: Options modifying the POT header
sr: Опције које мењају POT заглавље

note: type: =item
en: B<--porefs> I<type>
sr: B<--porefs> I<тип>

note: type: textblock
en: Specify the reference format. Argument I<type> can be one of B<never> to not produce any reference, B<file> to only specify the file without the line number, B<counter> to replace line number by an increasing counter, and B<full> to include complete references (default: full).
sr: Наводи форамт референци. Аргумент I<тип> може да буде једно од: B<never> да се не креирају никакве референце, B<file> да се наведе само фајл без броја линије, B<counter> да се број линије замени растућим бројачем, и B<full> да се креирају комплетне референце (подразумевано: full).

note: type: =item
en: B<--wrap-po> B<no>|B<newlines>|I<number> (default: 76)
sr: B<--wrap-po> B<no>|B<newlines>|I<број> (подразумевано: 76)

note: type: textblock
en: Specify how the po file should be wrapped. This gives the choice between either files that are nicely wrapped but could lead to git conflicts, or files that are easier to handle automatically, but harder to read for humans.
sr: Наводи како би po фајл требало да се обавија. Овим вам се даје избор између фајлова који су лепо обавијени али би могли да доведу до git конфликата, или фајлова који се лакше обрађују аутоматски, али су компликованији за читање.

note: type: textblock
en: Historically, the gettext suite has reformatted the po files at the 77th column for cosmetics. This option specifies the behavior of po4a. If set to a numerical value, po4a will wrap the po file after this column and after newlines in the content. If set to B<newlines>, po4a will only split the msgid and msgstr after newlines in the content. If set to B<no>, po4a will not wrap the po file at all.  The reference comments are always wrapped by the gettext tools that we use internally.
sr: Раније је gettext свита програма реформатирала po фајлове на 77ој колони ради лепшег изгледа. Ова опција одрешује понашање програма po4a. Ако се постави на нумеричку вредност, po4a ће да обавије po након колоне под тим бројем и након прелома линија у садржају. Ако се постави на B<newlines>, po4a ће само да раздели msgid и msgstr након прелома линија у садржају. Ако се постави на B<no>, po4a уопште неће да обавија po фајл. gettext алати које интерно користимо увек обавијају референтне коментаре.

note: type: textblock
en: Note that this option has no impact on how the msgid and msgstr are wrapped, i.e.  on how newlines are added to the content of these strings.
sr: Имајте на уму да ова опција не утиче на то како се msgid и msgstr обавијају, тј. на то како се додају преломи линија у садржај ових стрингова.

note: type: textblock
en: Language of the source files containing the documents to translate. Note that all master documents must use the same language.
sr: Језик изворних фајлова који садрже документе који се преводе. Водите рачуна да сви мастер документи морају да буду написани истим језиком.

note: type: =item
en: B<--msgid-bugs-address> I<email@address>
sr: B<--msgid-bugs-address> I<имејл@адреса>

note: type: textblock
en: Set the report address for msgid bugs. By default, the created POT files have no Report-Msgid-Bugs-To fields.
sr: Поставља адресу за пријаву msgid багова. Подразумевано, креирани POT немају Report-Msgid-Bugs-To поља.

note: type: =item
en: B<--copyright-holder> I<string>
sr: B<--copyright-holder> I<стринг>

note: type: textblock
en: Set the copyright holder in the POT header. The default value is "Free Software Foundation, Inc."
sr: Поставља власника права умножавања у POT заглавље. Подразумевана вредност је "Free Software Foundation, Inc."

note: type: =item
en: B<--package-name> I<string>
sr: B<--package-name> I<стринг>

note: type: textblock
en: Set the package name for the POT header. The default is "PACKAGE".
sr: Поставља име пакета у POT заглавље. Подразумевано је "PACKAGE".

note: type: =item
en: B<--package-version> I<string>
sr: B<--package-version> I<стринг>

note: type: textblock
en: Set the package version for the POT header. The default is "VERSION".
sr: Поставља верзију пакета у POT заглавље. Подразумевано је "VERSION".

note: type: =head2
en: Options to modify the PO files
sr: Опције за измену PO фајлова

note: type: =item
en: B<--msgmerge-opt> I<options>
sr: B<--msgmerge-opt> I<опције>

note: type: textblock
en: Extra options for B<msgmerge>(1).
sr: Додатне опције за B<msgmerge>(1).

note: type: textblock
en: Note: B<$lang> will be extended to the current language.
sr: Напомена: B<$lang> ће да се развије у текући језик.

note: type: textblock
en: This option removes B<--previous> from the options passed to B<msgmerge>.  This is necessary to support versions of B<gettext> earlier than 0.16.
sr: Ова опција уклања B<--previous> из опција које се прослеђују програму B<msgmerge>. Ово је неопходно да би се подржавале верзије програма B<gettext> старије од 0.16.

note: type: textblock
en: This option adds B<--previous> to the options passed to B<msgmerge>.  It requires B<gettext> 0.16 or later, and is activated by default.
sr: Ова опција додаје B<--previous> опцијама које се прослеђују програму B<msgmerge>. Захтева да је верзија програма B<gettext> 0.16 или каснија, и подразумевано је активирана.

note: type: =head1
en: CONFIGURATION FILE
sr: КОНФИГУРАЦИОНИ ФАЈЛ

note: type: textblock
en: po4a expects a configuration file as argument. This file must contain the following elements:
sr: Програм po4a очекује конфигурациони фајл као свој аргумент. Овај фајл мора да садржи следеће елементе:

note: type: =item
en: The path to the PO files and the list of languages existing in the project;
sr: Путању до PO фајлова и листу језика који постоје у пројекту;

note: type: =item
en: Optionally, some global options and so-called configuration aliases that are used as templates to configure individual master files;
sr: Необавезно, неке глобалне опције и такозване конфигурационе алијасе који се користе као шаблони за конфигурисање појединачних мастер фајлова;

note: type: =item
en: The list of each master file to translate, along with specific parameters.
sr: Листу сваког од мастер фајлова који се преводи, заједно са специфичним параметрима.

note: type: textblock
en: All lines contain a command between square braces, followed by its parameters.  Comments begin with the char '#' and run until the end of the line. You can escape the end of line to spread a command over several lines.
sr: Све линије садрже команду унутар великих заграда, иза које следе њени параметри. Коментари почињу карактером '#' и протежу се до краја линије. Можете да означите крај линије како бисте развукли команду на неколико линија.

note: type: textblock
en: Some full examples are presented on this page, while other examples can be found in the C<t/cfg> directory of the source distribution.
sr: На овој страници су приказани неки комплетни примери, док остале можете да пронађете у C<t/cfg> директоријуму дистрибуције изворног кода.

note: type: =head2
en: Finding the PO and POT files
sr: Проналажење PO и POT фајлова

note: type: textblock
en: The simplest solution is to explicitly give the path to POT and PO files, as follows:
sr: Најједноставније решење је да се експлицитно зада путања до POT и PO фајлова, као што следи:

note: type: textblock
en: This specifies the path to the POT file first, and then the paths to the German and French PO files.
sr: Ово најпре наводи путању до POT фајла, а затим путање до немачких и француских PO фајлова.

note: type: textblock
en: The same information can be written as follows to reduce the risk of copy/paste errors:
sr: Да би се умањио ризик грешака приликом копирања/постављања, исте информације могу да се запишу на следећи начин:

note: type: textblock
en: The C<$lang> component is automatically expanded using the provided languages list, reducing the risk of copy/paste error when a new language is added.
sr: C<$lang> компонента се аутоматски развија помоћу наведене листе језика, чиме се смањује ризик грешке при копирању/налепљивању онда када се додаје нови језик.

note: type: textblock
en: You can further compact the same information by only providing the path to the directory containing your translation project, as follows.
sr: Исте информације можете додатно да скратити навођењем само путање директоријума који садржи ваш пројекат превода, као што следи.

note: type: textblock
en: The provided directory must contain a set of PO files, each named F<XX.po> with C<XX> the ISO 639-1 of the language used in this file. The directory must also contain a single POT file, with the C<.pot> file extension. For the first run, this file can be empty but it must exist (po4a cannot guess the name to use before the extension).
sr: Наведени директоријум мора да садржи скуп PO фајлова, сваки назван F<XX.po> где је C<XX> ISO 639-1 језика који се користи у том фајлу. Директоријум такође мора да садржи један POT фајл, са C<.pot> екстензијом фајла. Приликом првог покретања овај фајл може да буде празан, али мора да постоји (po4a не може да погоди име које треба да користи испред екстензије).

note: type: textblock
en: Note that you must choose only one between C<po_directory> and C<po4a_paths>. The first one (C<po_directory>) is more compact, further reduces the risk of copy/paste error, but forces you to use the expected project structure and file names. The second one (C<po4a_paths>), is more explicit, probably more readable, and advised when you setup your first project with po4a.
sr: Имајте на уму да морате изабрати само једно од C<po_directory> и C<po4a_paths>. Прво (C<po_directory>) је компактније, додатно умањује ризик грешака приликом копирања/убацивања, али вас приморава да користите очекивану структуру пројекта, као и имена фајлова. Друго (C<po4a_paths>), је експлициније, вероватно и читљивије, и пожељно да се користи када подешавате свој први пројекат са po4a.

note: type: =head3
en: Centralized or split PO files?
sr: Централизовани или подељени PO фајлови?

note: type: textblock
en: By default, po4a produces one single PO file per target language, containing the whole content of your translation project. As your project grows, the size of these files may become problematic. When using weblate, it is possible to specify priorities for each translation segment (i.e., msgid) so that the important ones get translated first. Still, some translation teams prefer to split the content in several files.
sr: Програм po4a подразумевано креира један јединствени PO фајл за сваки циљни језик, који садржи комплетан садржај вашег пројекта превода. Како ваш пројекат расте, величина ових фајлова може да постане проблематична. Када се користи веблејт, могуће је да се наведу приоритети за сваки сегмент превода (тј. msgid) тако да се прво преведу они битнији. Ипак, неки преводилачки тимови радије деле садржај на неколико фајлова.

note: type: textblock
en: To have one PO file per master file, you simply have to use the string C<$master> in the name of your PO files on the C<[po4a_paths]> line, as follows.
sr: Ако желите да имате један PO фајл за сваки мастер фајл, потребно је само да користите стринг C<$master> у имену ваших PO фајлова у C<[po4a_paths]> линији, као што следи.

note: type: textblock
en: With this line, po4a will produce separate POT and PO files for each document to translate.  For example, if you have 3 documents and 5 languages, this will result in 3 POT files and 15 PO files. These files are named as specified on the C<po4a_paths> template, with C<$master> substituted to the basename of each document to translate. In case of name conflict, you can specify the POT file to use as follows, with the C<pot=> parameter.
sr: Овом линијом ће po4a да произведе одвојене POT и PO фајлове за сваки документ који се преводи. На пример, ако имате 3 документа и 5 језика, добићете 3 POT фајлова и 15 PO фајлова. Они добијају име наведено C<po4a_paths> шаблоном, у којем се C<$master> замењује са базним именом сваког документа који се преводи. У случају да дође до конфликта, на следећи начин можете навести POT фајл који треба да се користи, параметром C<pot=>.

note: type: textblock
en: This feature can also be used to group several translated files into the same POT file. The following example only produces 2 POT files: F<l10n/po/foo.pot> (containing the material from F<foo/gui.xml>) and F<l10n/po/bar.pot> (containing the material from both F<bar/gui.xml> and F<bar/cli.xml>).
sr: Ова могућност такође може да се употреби у циљу груписања неколико преведених фајлова у исти POT фајл. Следећи пример генерише само 2 POT фајла: F<l10n/po/foo.pot> (који садржи материјал из F<foo/gui.xml>) и F<l10n/po/bar.pot> (који садржи материјал и из F<bar/gui.xml> и из F<bar/cli.xml>).

note: type: textblock
en: In split mode, B<po4a> builds a temporary compendium during the PO update, to share the translations between all the PO files. If two PO files have different translations for the same string, B<po4a> will mark this string as fuzzy and will submit both translations in all the PO files containing this string. When unfuzzied by the translator, the translation is automatically used in every PO files.
sr: У подељеном режиму, програм B<po4a> креира привремени компендијум током ажурирања PO фајлова, како би се делили преводи из свих PO фајлова. Ако два PO files фајла имају различите преводе за исти стринг, програм B<po4a> ће да означи стринг као fuzzy и поставиће оба превода у све PO фајлове који садрже тај стринг. Када преводилац уклони fuzzy ознаку и изабере један од превода, тај превод се аутоматски користи у сваком PO фајлу.

note: type: =head2
en: Specifying the documents to translate
sr: Навођење фокумената за превођење

note: type: textblock
en: You must also list the documents that should be translated. For each master file, you must specify the format parser to use, the location of the translated document to produce, and optionally some configuration. File names should be quoted or escaped if they contain spaces. Here is an example:
sr: Такође морате да наведете листу докумената који треба да се преведу. За сваки мастер фајл морате да наведете који парсер формата ће да се користи, локацију произведеног преведеног документа, и необавезно, нека подешавања. Ако садрже размаке, имена фајлова би требало да буду унутар знакова навода или означена. Ево примера:

note: type: textblock
en: But again, these complex lines are difficult to read and modify, e.g. when adding a new language. It is much simpler to reorganize things using the C<$lang> template as follows:
sr: Али опет, читање и измена ових компликованих линија није једноставна, нпр. када се додаје нови језик. Много је једноставније да се ствари реорганизују употребом C<$lang> шаблона као што следи:

note: type: =head2
en: Specifying options
sr: Навођење опција

note: type: textblock
en: There is two types of options: I<po4a options> are default values to the po4a command line options while I<format options> are used to change the behavior of the format parsers. As a I<po4a options>, you could for example specify in your configuration file that the default value of the B<--keep> command line parameter is 50% instead of 80%. I<Format options> are documented on the specific page of each parsing module, e.g. L<Locale::Po4a::Xml(3pm)>. You could for example pass B<nostrip> to the XML parser to not strip the spaces around the extracted strings.
sr: Постоје два типа опција: I<po4a опције> су подразумеване вредности за опције командне линије програма po4a док се I<формат опције> користе за промену понашања парсера формата. Као I<po4a опције> бисте могли на пример да у свом конфигурационом фајлу наведете да је подразумевана вредност параметра командне линије B<--keep> 50% уместо 80%. I<Формат опције> су документоване на одређеној страници сваког модула за парсирање, нпр. L<Locale::Po4a::Xml(3pm)>. На пример, могли бисте да XML парсеру проследите B<nostrip> како не би уклонио размаке око стрингова које пронађе.

note: type: textblock
en: You can pass these options for a specific master file, or even for a specific translation of that file, using C<opt:> and C<opt_XX:> for the C<XX> language.  In the following example, the B<nostrip> option is passed to the XML parser (for all languages), while the threshold will be reduced to 0% for the French translation (that is thus always kept).
sr: Ове опције можете да проследите одређеном мастер фајлу, или чак одређеном преводу тог фајла употребом C<opt:> и C<opt_XX:> за језик C<XX>. У наредном примеру, опција B<nostrip> се прослеђује XML парсеру (за све језике), док се граница за француски превод спушта на 0% (дакле, увек се задржава).

note: type: textblock
en: In any case, these configuration chunks must be located at the end of the line.  The declaration of files must come first, then the addendum if any (see below), and then only the options. The grouping of configuration chunks is not very important, since elements are internally concatenated as strings. The following examples are all equivalent:
sr: У сваком случају, ови сегменти конфигурације морају да се нађу на крају линије. Најпре мора да дође декларација фајлова, затим додатак ако постоји (погледајте испод), па тек онда опције. Груписање сегмената конфигурације није толико битно, јер се интерно елементи спајају као стрингови. Следећи примери су сви еквивалентни међусобно:

note: type: textblock
en: Note that language specific options are not used when building the POT file. It is for example impossible to pass B<nostrip> to the parser only when building the French translation, because the same POT file is used to update every languages. So the only options that can be language-specific are the ones that are used when producing the translation, as the C<--keep> option.
sr: Имајте на уму да се опције специфичне за језик не користе када се изграђује POT фајл. Тако је, на пример, немогуће да се B<nostrip> проследи парсеру само када се изграђује француски превод, јер се исти POT фајл користи за ажурирање сваког језика. Дакле, једине опције које могу да буду специфичне за језик су оне које се користе када се прави превод, као што је опција C<--keep>.

note: type: =head3
en: Configuration aliases
sr: Конфигурациони алијаси

note: type: textblock
en: To pass the same options to several files, the best is to define a type alias as follows. In the next example, C<--keep 0> is passed to every Italian translation using this C<test> type, that is an extension of the C<man> type.
sr: Када желите да се исте опције проследе већем броју фајлова, најбоље је да дефинишете алијас типа, на начин како је објашњено у наставку. У следећем примеру, C<--keep 0> се прослеђује сваком италијанском преводу употребом типа C<test>, који је проширење типа C<man>.

note: type: textblock
en: You can also extend an existing type reusing the same name for the alias as follows. This is not interpreted as as an erroneous recursive definition.
sr: Постојећи тип такође можете да проширите поновним коришћењем истог имена за алијас, као што следи. То се не интерпретира као погрешна рекурзивна дефиниција.

note: type: =head3
en: Global default options
sr: Глобалне подразумеване опције

note: type: textblock
en: You can also use C<[options]> lines to define options that must be used for all files, regardless of their type.
sr: C<[options]> линије можете такође да употребите за дефинисање опција које морају да се користе за све фајлове, без обзира на њихов тип.

note: type: textblock
en: As with the command line options, you can abbreviate the parameters passed in the configuration file:
sr: Као и са опцијама командне линије, и у конфигурационом фајлу можете да скратите параметре који се прослеђују:

note: type: =head3
en: Option priorities
sr: Приоритет опција

note: type: textblock
en: The options of every sources are concatenated, ensuring that the default values can easily be overridden by more specific options. The order is as follows:
sr: Опције свих извора се спајају, чиме се једноставно обезбеђује да детаљније опције могу преиначити подразумеване вредности. Редослед је као што следи:

note: type: =item
en: C<[options]> lines provide default values that can be overridden by any other source.
sr: C<[options]> линије постављају подразумеване вредности које било који други извор може да преиначи.

note: type: =item
en: Type aliases are then used. Language specific settings override the ones applicable to all languages.
sr: Затиме се користе алијаси типа. Подешавања за одређени језик преиначују подешавања која се примењују за све језике.

note: type: =item
en: Settings that are specific to a given master file override both the default ones and the ones coming from the type alias. In this case also, language specific settings override the global ones.
sr: Подешавања која су посебна за дати мастер фајл преиначују и подразумевана и она која долазе од алијаса типа. И у овом случају такође, подешавања специфична за језик преиначују глобална подешавања.

note: type: =item
en: Finally, parameters provided on the B<po4a> command line override any settings from the configuration file.
sr: Коначно, параметри који се задају у командној линији програма B<po4a> преиначују било која подешавања из конфигурационог фајла.

note: type: =head3
en: Example
sr: Пример

note: type: textblock
en: Here is an example showing how to quote the spaces and quotes:
sr: Ево примера који показује на који начин се обележавају размаци и знаци навода:

note: type: verbatim
en:  [po_directory] man/po/
     
     [options] --master-charset UTF-8
     
     [po4a_alias:man] man opt:"-o \"mdoc=NAME,SEE ALSO\""
     [type:man] t-05-config/test02_man.1 $lang:tmp/test02_man.$lang.1 \
                opt:"-k 75" opt_it:"-L UTF-8" opt_fr:--verbose
sr:  [po_directory] man/po/
    
     [options] --master-charset UTF-8
    
     [po4a_alias:man] man opt:"-o \"mdoc=NAME,SEE ALSO\""
     [type:man] t-05-config/test02_man.1 $lang:tmp/test02_man.$lang.1 \
                opt:"-k 75" opt_it:"-L UTF-8" opt_fr:--verbose

note: type: =head2
en: Addendum: Adding extra content in the translation
sr: Додатак: додавање допунског садржаја у превод

note: type: textblock
en: If you want to add an extra section to the translation, for example to give credit to the translator, then you need to define an addendum to the line defining your master file. Please refer to the page L<po4a(7)> for more details on the syntax of addendum files.
sr: Ако желите да превод допуните додатним одељком, не пример, да изјавите захвалност преводиоцу, онда морате да дефинишете додатак линији која дефинише ваш мастер фајл. Молимо вас да погледате страницу L<po4a(7)> како би сазнали више детаља у вези синтаксе фајлова додатака.

note: type: textblock
en: You can also use language templates as follow:
sr: Такође можете да употребите језичке шаблоне на начин који следи:

note: type: textblock
en: If an addendum fails to apply, the translation is discarded.
sr: У случају да додатак не може да се примени превод се одбацује.

note: type: =head3
en: Modifiers for the addendum declaration
sr: Модификатори за декларацију додатка

note: type: textblock
en: Addendum modifiers can simplify the configuration file in the case where not all languages provide an addendum, or when the list of addenda changes from one language to the other. The modifier is a single char located before the file name.
sr: Модификатори додатка могу да поједноставе конфигурациони фајл у случају када сви језици не нуде додатак, или када се листа додатака мења од језика до језика. Модификатор је један карактер који се налази испред имена фајла.

note: type: textblock
en: Include I<addendum_path> if this file does exist, otherwise do nothing.
sr: Укљчује I<addendum_path> у случају да овај фајл постоји, у супротном не ради ништа.

note: type: textblock
en: I<addendum_path> is not a regular addendum but a file containing a list of addenda, one by line.  Each addendum may be preceded by modifiers.
sr: I<addendum_path> није регуларан додатак већ фајл који садржи листу додатака, по један у свакој линији. Испред сваког додатка могу да се наведу модифкатори.

note: type: textblock
en: I<addendum_path> is discarded, it is not loaded and will not be loaded by any further addendum specification.
sr: I<addendum_path> се одбацује, не учитава се и ниједна каснија спецификација додатка га неће учитати.

note: type: textblock
en: The following includes an addendum in any language, but if only it exists. No error is reported if the addendum does not exist.
sr: Оно што следи укључује додатак у било који језик, али само у случају да постоји. Ако додатак не постоји, не пријављује се грешка.

note: type: textblock
en: The following includes a list of addendum for every language:
sr: Оно што следи укључује листу додатака за сваки језик:

note: type: =head2
en: Filtering the translated strings
sr: Филтрирање преведених стрингова

note: type: textblock
en: Sometimes, you want to hide some strings from the translation process. To that extend, you can give a C<pot_in> parameter to your master file to specify the name of the file to use instead of the real master when building the POT file. Here is an example:
sr: Понекад неке стрингове желите да сакријете од процеса превођења. У том циљу, вашем мастер фајлу можете да додате параметар C<pot_in> када се изграђује POT file. Ево примера:

note: type: textblock
en: With this setting, the strings to translate will be extracted from the F<book-filtered.xml> (that must be produced before calling B<po4a>) while the translated files will be built from F<book.xml>. As a result, any string that is part of F<book.xml> but not in F<book-filtered.xml> will not be included in the PO files, preventing the translators from providing a translation for them. So these strings will be left unmodified when producing the translated documents.  This naturally decreases the level of translation, so you may need the C<--keep> option to ensure that the document is produced anyway.
sr: Са овим подешавањем, стрингови који треба да се преведу биће извучени из F<book-filtered.xml> (који мора да се креира пре позивања програма B<po4a>) док ће преведени фајлови да се изграде из F<book.xml>. Као резултат, било који стринг који је део F<book.xml> али се не налази у F<book-filtered.xml> неће постати део PO фајлова, чиме се преводиоци спречавају да их преведу. Тако да ће ови стрингови остати неизмењени када се буде креирали преведени документи. Наравно да ово смањује ниво преведености, тако да ће вам вероватно бити потребна опција C<--keep> како би обезбедили да се документи ипак креирају.

note: type: =head1
en: AUTHORS
sr: АУТОРИ

note: type: verbatim
en:  Denis Barbier <barbier@linuxfr.org>
     Nicolas François <nicolas.francois@centraliens.net>
     Martin Quinson (mquinson#debian.org)
sr:  Дени Барбије <barbier@linuxfr.org>
     Никола Франсоа <nicolas.francois@centraliens.net>
     Мартин Квинсон (mquinson#debian.org)

note: type: =head1
en: COPYRIGHT AND LICENSE
sr: ПРАВА УМНОЖАВАЊА И ЛИЦЕНЦА

note: type: textblock
en: Copyright 2002-2023 by SPI, inc.
sr: Ауторска права 2002-2023 SPI, inc.

note: type: textblock
en: This program is free software; you may redistribute it and/or modify it under the terms of GPL v2.0 or later (see the COPYING file).
sr: Овај програм је слободан софтвер; можете да га редистрибуирате и/или мењате под условима GPL v2.0 или новије (погледајте фајл COPYING).

note: type: textblock
en: po4a-gettextize - convert an original file (and its translation) to a PO file
sr: po4a-gettextize - конверзија оригиналног фајла (и његових превода) у PO фајл

note: type: textblock
en: (I<XX.po> is the output, all others are inputs)
sr: (I<XX.po> је излаз, све остало су улази)

note: type: textblock
en: The B<po4a-gettextize> script helps you converting your previously existing translations into a po4a-based workflow. This is only to be done once to salvage an existing translation while converting to po4a, not on a regular basis after the conversion of your project. This tedious process is explained in details in Section 'Converting a manual translation to po4a' below.
sr: Скрипта B<po4a-gettextize> вам помаже да конвертујете већ постојеће преводе у процес рада заснован на po4a. Потребно је да се ово уради једном током конверзије у po4a како би се искористио постојећи превод, а не редовно након конверзије пројекта. Овај заморан процес је детаљно објашњен у одељку 'Конвертовање ручног превода у po4a пројекат'.

note: type: textblock
en: You must provide both a master file (e.g., the source in English) and an existing translated file (e.g., a previous translation attempt without po4a). If you provide more than one master or translation files, they will be used in sequence, but it may be easier to gettextize each page or chapter separately and then use B<msgmerge> to merge all produced PO files. As you wish.
sr: Морате да наведете и мастер фајл (нпр. изворни фајл на енглеском језику) и постојећи преведени фајл (нпр. ранији покушај превода без употребе po4a). Ако наведете више од једног мастер или преведеног фајла, они ће се употребити сукцесивно, али може да буде једноставније да gettextизујете сваку страницу или поглавље посебно, па да онда употребите B<msgmerge> да спојите све добијене PO фајлове. Како год желите.

note: type: textblock
en: If the master document has non-ASCII characters, the new generated PO file will be in UTF-8. If the master document is completely in ASCII, the generated PO will use the encoding of the translated input document.
sr: Ако мастер документ садржи не-ASCII карактере, ново генерисани PO фајл ће бити кодиран у UTF-8. У случају када је мастер документ потпуно написан ASCII карактерима, генерисани PO ће да употреби кодирање преведеног улазног документа.

note: type: textblock
en: Format of the documentation you want to handle. Use the B<--help-format> option to see the list of available formats.
sr: Формат документације који се обрађује. Да бисте видели списак доступних формата употребите опцију B<--help-format>.

note: type: textblock
en: File containing the master document to translate. You can use this option multiple times if you want to gettextize multiple documents.
sr: Фајл који садржи мастер документ који се преводи. Ову опције можете да употребите више пута ако желите да gettextујете више докумената.

note: type: textblock
en: Charset of the file containing the document to translate.
sr: Скуп карактера фајла који садржи документ који се преводи.

note: type: textblock
en: File containing the localized (translated) document. If you provided multiple master files, you may wish to provide multiple localized file by using this option more than once.
sr: Фајл који садржи локализовани (преведени) документ. Ако сте навели више мастер фајлова, вероватно ћете хтети да употребом ове опције наведете више локализованих фајлова.

note: type: textblock
en: Charset of the file containing the localized document.
sr: Скуп карактера фајла који садржи локализовани документ.

note: type: textblock
en: File where the message catalog should be written. If not given, the message catalog will be written to the standard output.
sr: Фајл у који би требало да се упише каталог порука. Ако није задат, каталог порука ће да се испише на стандардни излаз.

note: type: textblock
en: List the documentation formats understood by po4a.
sr: Списак формата документације које програм po4a разуме.

note: type: textblock
en: Keep the temporary master and localized POT files built before merging.  This can be useful to understand why these files get desynchronized, leading to gettextization problems.
sr: Задржава привремене мастер и локализоване POT фајлове изграђене пре спајања. Ово може бити корисно да се разуме зашто ови фајлови постану десинхронизовани, што доводи до проблема у gettextизацији.

note: type: =head2
en: Converting a manual translation to po4a
sr: Конвертовање ручног превода у po4a пројекат

note: type: textblock
en: B<po4a-gettextize> synchronizes the master and localized files to extract their content into a PO file. The content of the master file gives the B<msgid> while the content of the localized file gives the B<msgstr>. This process is somewhat fragile: the Nth string of the translated file is supposed to be the translation of the Nth string in the original.
sr: B<po4a-gettextize> синхронизује мастер и локализоване фајлове да би се њихов садржај издвојио у PO фајл. Из садржаја мастер фајла се креира B<msgid>, док се из садржаја локализованог фајла креира B<msgstr>. Овај процес је донекле осетљив: Нти стринг преведеног фајла би требало да буде превод Нтог стринга у оригиналу.

note: type: textblock
en: Gettextization works best if you manage to retrieve the exact version of the original document that was used for translation. Even so, you may need to fiddle with both master and localized files to align their structure if it was changed by the original translator, so working on files' copies is advised.
sr: Gettextизација најбоље функционише ако успете да дођете до потпуно исте верзије оригиналног документа која је коришћена за прављење превода. Чак и онда, ако је оригинални преводилац променио структуру превода, може бити неопходно да преправљате и мастер и локализоване фајлове тако да се њихове структуре поравнају. Стога се саветује да радите са копијама оригиналних фајлова.

note: type: textblock
en: Internally, each po4a parser reports the syntactical type of each extracted strings. This is how desynchronization are detected during the gettextization.  In the example depicted below, it is very unlikely that the 4th string in translation (of type 'chapter') is the translation of the 4th string in original (of type 'paragraph'). It is more likely that a new paragraph was added to the original, or that two original paragraphs were merged together in the translation.
sr: Интерно, сваки po4a парсер пријављује синтактични тип сваког издвојеног стринга. На тај начин се откривају десинхронизације током gettextизације. У примеру датом испод, мало је вероватно да је 4ти стринг у преводу (типа 'chapter') превод 4тог стринга у оригиналу (типа 'paragraph'). Вероватније је да је оригиналу додат нови пасус, или да су у преводу два пасуса из оригинала спојена у један.

note: type: verbatim
en:     Original         Translation
    
      chapter            chapter
        paragraph          paragraph
        paragraph          paragraph
        paragraph        chapter
      chapter              paragraph
        paragraph          paragraph
sr:     Оригинал         Превод
    
      поглавље           поглавље
        пасус              пасус
        пасус              пасус
        пасус            поглавље
      поглавље             пасус
        пасус              пасус

note: type: textblock
en: B<po4a-gettextize> will verbosely diagnose any structure desynchronization. When this happens, you should manually edit the files to add fake paragraphs or remove some content here and there until the structure of both files actually match. Some tricks are given below to salvage the most of the existing translation while doing so.
sr: B<po4a-gettextize> ће детаљно да дијагностицира било какву десинхронизацију структуре. Када се то догоди, требало би ручно да уредите фајлове и да додате лажне пасусе или да ту и тамо уклоните неки садржај, све док се структуре оба документа саршено не поклопе. Испод су наведени неки од трикова којима се спашава већина постојећег превода док се ово ради.

note: type: textblock
en: If you are lucky enough to have a perfect match in the file structures out of the box, building a correct PO file is a matter of seconds. Otherwise, you will soon understand why this process has such an ugly name :) Even so, gettextization often remains faster than translating everything again. I gettextized the French translation of the whole Perl documentation in one day despite the I<many> synchronization issues. Given the amount of text (2MB of original text), restarting the translation without first salvaging the old translations would have required several months of work. In addition, this grunt work is the price to pay to get the comfort of po4a. Once converted, the synchronization between master documents and translations will always be fully automatic.
sr: Ако имате довољно среће да вам се структуре фајлова савршено поклапају без било какве интервенције, изградња исправног PO фајла траје неколико секунди. У супротном, врло брзо ћете схватити зашто овај процес има тако ружно име :) Чак и онда, gettextизација је често бржа од поновног превођења свега. Ја сам gettextизовао комплетну Perl документацију у једном дану упркос I<великом броју> проблема са синхронизацијом. Узевши у обзир количину текста (2МB оригиналног текста), поновно превођење без спашавања постојећег превода би захтевало неколико месеци рада. Уз то, овај гломазан посао је цена која мора да се плати како би се дошло до комфора који пружа програм po4a. Једном када се обави конверзија, синхронизација између мастер докумената и превода ће увек бити потпуно аутоматска.

note: type: textblock
en: After a successful gettextization, the produced documents should be manually checked for undetected disparities and silent errors, as explained below.
sr: Након успешне gettextизације, произведене документе би требало ручно прегледати да би се уочили диспаритети и тихе грешке, као што је објашњено испод.

note: type: =head3
en: Hints and tricks for the gettextization process
sr: Савети и трикови за процес gettextизације

note: type: textblock
en: The gettextization stops as soon as a desynchronization is detected. When this happens, you need to edit the files as much as needed to re-align the files' structures. B<po4a-gettextize> is rather verbose when things go wrong. It reports the strings that don't match, their positions in the text, and the type of each of them. Moreover, the PO file generated so far is dumped as F<gettextization.failed.po> for further inspection.
sr: gettextизација се прекида чим се детектује десинхронизација. B<po4a-gettextize> је прилично детаљан када ствари не иду како треба. Он пријављује стрингове који се не подударају, њихове позиције у тексту, и тип сваког од њих. Уз то, PO фајл који је до тада генерисан се избацује као F<gettextization.failed.po> како бисте могли даље да истражујете.

note: type: textblock
en: Here are some tricks to help you in this tedious process and ensure that you salvage the most of the previous translation:
sr: Ево неких трикова који могу да вам помогну у овом заморном процесу и који обезбеђују да спасите већи део преходног превода:

note: type: =item
en: Remove all extra content of the translations, such as the section giving credits to the translators. They should be added separately to B<po4a> as addenda (see L<po4a(7)>).
sr: Уклоните сав додатни садржај превода, као што је одељак у коме се одаје признање преводиоцима. Они би требало да се у B<po4a> уметну одвојено као додаци (погледајте L<po4a(7)>).

note: type: =item
en: When editing the files to align their structures, prefer editing the translation if possible. Indeed, if the changes to the original are too intrusive, the old and new versions will not be matched during the first po4a run after gettextization (see below). Any unmatched translation will be dumped anyway.  That being said, you still want to edit the original document if it's too hard to get the gettextization to proceed otherwise, even if it means that one paragraph of the translation is dumped. The important thing is to get a first PO file to start with.
sr: Када уређујете фајлове како бисте им поравнали структуре, боље је да уређујте превод ако је то могуће. Заиста, ако измене оригинала нису суптилне, стара и нова верзија неће да се подударају приликом првог покретања програма po4a након gettextизације (погледајте испод). Неупарени превед ће свакако да се одбаци. Упркос томе, ипак ћете морати да уређујете оригинални документ ако је сувише компликовано да се омогући наставак gettextизације, чак и ако то значи да се један пасус превода одбацује. Важна ствар је да за почетак добијете први PO фајл.

note: type: =item
en: Do not hesitate to kill any original content that would not exist in the translated version. This content will be automatically reintroduced afterward, when synchronizing the PO file with the document.
sr: Не оклевајте да уконите било какав оригинални садржај који не постоји у преведеној верзији. Тај садржај ће касније аутоматски да се врати, када се PO фајл буде синхронизовао са документом.

note: type: =item
en: You should probably inform the original author of any structural change in the translation that seems justified. Issues in the original document should reported to the author. Fixing them in your translation only fixes them for a part of the community. Plus, it is impossible to do so when using po4a ;) But you probably want to wait until the end of the conversion to B<po4a> before changing the original files.
sr: Вероватно ћете морати да обавестите оригиналног аутора о било каквим променама структуре у превпду које се чине оправданим. Проблеми у оригиналном документу би требало да се пријаве аутору. Ако се поправе у само у вашем преводу, само део заједнице ће знати за то. А и иначе је немогуће да се тако нешто уради када се користи po4a ;) Али највероватније ћете сачекати до краја конверзије у B<po4a> пре него што измените оригиналне фајлове.

note: type: =item
en: Sometimes, the paragraph content does match, but not their types. Fixing it is rather format-dependent. In POD and man, it often comes from the fact that one of them contains a line beginning with a white space while the other does not.  In those formats, such paragraph cannot be wrapped and thus become a different type. Just remove the space and you are fine. It may also be a typo in the tag name in XML.
sr: Понекад се садржаји пасуса подударају, али не и њихови типови. Исправљање овог проблема је углавном зависно од формата. Често се догађа у POD и man због чињенице да један од пасуса садржи линију која почиње празним простором док други не. У тим форматима, такви пасуси не могу да се обавију и стога постају други тип. Једноставно уклоните размак и биће како треба. Узрок такође може да буде и грешка у куцању имена ознаке у XML.

note: type: textblock
en: Likewise, two paragraphs may get merged together in POD when the separating line contains some spaces, or when there is no empty line between the B<=item> line and the content of the item.
sr: Слично, два пасуса могу у POD фајлу да се споје у један када раздвајајућа линија садржи неке размаке, или када нема празне линије између B<=item> линије и садржаја ставке.

note: type: =item
en: Sometimes, the desynchronization message seems odd because the translation is attached to the wrong original paragraph. It is the sign of an undetected issue earlier in the process. Search for the actual desynchronization point by inspecting the file F<gettextization.failed.po> that was produced, and fix the problem where it really is.
sr: Понекад се чини да је порука о десинхронизацији необична јер је превод придружен погрешном оригиналном пасусу. То је знак неоткривеног проблема раније у процесу. Потражите стварну тачку десинхронизације испитивањем генерисаног фајла F<gettextization.failed.po>, и исправите проблем тамо где се он заиста и налази.

note: type: =item
en: Other issues may come from duplicated strings in either the original or translation. Duplicated strings are merged in PO files, with two references.  This constitutes a difficulty for the gettextization algorithm, that is a simple one to one pairing between the B<msgid>s of both the master and the localized files. It is however believed that recent versions of po4a deal properly with duplicated strings, so you should report any remaining issue that you may encounter.
sr: Дуплирани стрингови било у оригиналу или преводу могу да проузрокују и друге проблеме. Дуплирани стрингови се спајају у PO фајлове са две референце. То представља тешкоћу за алгоритам gettextизације, који користи просто један на један упаривање B<msgid> стрингова у мастер и локализованим фајловима. Међутим, сматра се да се скорашње верзије po4a исправно носе са дуплираним стринговима, тако да би требало да пријавите евентуални преостали проблем на који наиђете.

note: type: =head2
en: Reviewing files produced by B<po4a-gettextize>
sr: Преглед фајлова које је генерисала скрипта B<po4a-gettextize>

note: type: textblock
en: Any file produced by B<po4a-gettextize> should be manually reviewed, even when the script terminates successfully. You should skim over the PO file, ensuring that the B<msgid> and B<msgstr> actually match. It is not necessary to ensure that the translation is perfectly correct yet, as all entries are marked as fuzzy translations anyway. You only need to check for obvious matching issues because badly matched translations will be dumped in subsequent steps while you want to salvage them.
sr: Сваки фајл који је генерисала скрипта B<po4a-gettextize> би требало ручно прегледати, чак и када је скрипта успешно завршила извршавање. Требало би да прелетите преко PO фајла и проверите да се B<msgid> и B<msgstr> заиста подударају. Још увек није неопходно да је превод савршен, пошто су све ставке ионако означене као несигурни преводи. Потребно је само да уочите очигледне проблеме са упаривањем јер ће се у наредним корацима лоше упарени преводи одбацити, а ви желите да их сачувате.

note: type: textblock
en: Fortunately, this step does not require to master the target languages as you only want to recognize similar elements in each B<msgid> and its corresponding B<msgstr>. As a speaker of French, English, and some German myself, I can do this for all European languages at least, even if I cannot say one word of most of these languages. I sometimes manage to detect matching issues in non-Latin languages by looking at string length, phrase structures (does the amount of interrogation marks match?) and other clues, but I prefer when someone else can review those languages.
sr: Срећом, овај корак не захтева да владате циљним језицима јер само желите да препознате сличне елементе у сваком B<msgid> и одговарајућем B<msgstr>. Ја као говорник француског, енглеског и помало немачког, ово могу да урадим барем за све европске језике, чак и ако на већини њих не могу да изговорим ни реч. Понекад успем да откријем проблем у упаривању на језицима који нису на латиници тако што посматрам дужину стринга, структуру фразе (да ли се поклапа број знакова питања?) као и остале трагове, али више волим да неко други провери те језике.

note: type: textblock
en: If you detect a mismatch, edit the original and translation files as if B<po4a-gettextize> reported an error, and try again. Once you have a decent PO file for your previous translation, backup it until you get po4a working correctly.
sr: Ако откријете неподударање, уредите фајлове оригинала и превода као да је скрипта B<po4a-gettextize> пријавила грешку, па покушајте поново. Једном када за свој претходни превод добијете солидан PO фајл, направите његову резервну копију све док po4a не почне исправно да функционише.

note: type: =head2
en: Running B<po4a> for the first time
sr: Прво покретање програма B<po4a>

note: type: textblock
en: The easiest way to setup po4a is to write a B<po4a.conf> configuration file, and use the integrated B<po4a> program (B<po4a-updatepo> and B<po4a-translate> are deprecated). Please check the "CONFIGURATION FILE" Section in L<po4a(1)> documentation for more details.
sr: Најједноставнији начин да се подеси po4a систем је да напишете B<po4a.conf> конфигурациони фајл и да користите интегрисани B<po4a> програм (B<po4a-updatepo> и B<po4a-translate> су застарели). За више детаља, молимо вас да погледате одељак „КОНФИГУРАЦИОНИ ФАЈЛ” у L<po4a(1)> документацији.

note: type: textblock
en: When B<po4a> runs for the first time, the current version of the master documents will be used to update the PO files containing the old translations that you salvaged through gettextization. This can take quite a long time, because many of the B<msgid>s of from the gettextization do not exactly match the elements of the POT file built from the recent master files. This forces gettext to search for the closest one using a costly string proximity algorithm.  For example, the first run over the Perl documentation's French translation (5.5 MB PO file) took about 48 hours (yes, two days) while the subsequent ones only take seconds.
sr: Када се B<po4a> покрене по први пут, за ажурирање PO фајлова који садрже старе преводе спашене кроз gettextизацију ће се употребити текућа верзија мастер докумената. Ово може да потраје доста дуго јер се многи B<msgid> стрингови из gettextизације не подударају у потпуности са елементима POT фајла изграђеног из скорашњих мастер фајлова. Због тога програм gettext мора да тражи најближи стринг употребом скупог алгоритма удаљености стрингова. На пример, прво извршавање над француским преводом Perl документације (PO фајл величине 5.5 MB) је трајало око 48 сати (тако је, два цела дана), док накнадна трају само неколико секунди.

note: type: =head2
en: Moving your translations to production
sr: Пренос ваших превода у продукцију

note: type: textblock
en: After this first run, the PO files are ready to be reviewed by translators. All entries were marked as fuzzy in the PO file by B<po4a-gettextization>, forcing their careful review before use. Translators should take each entry to verify that the salvaged translation actually match the current original text, update the translation on need, and remove the fuzzy markers.
sr: Након првог извршавања, преводиоци могу да провере PO фајлове. B<po4a-gettextization> је све ставке у PO фајлу означио као несигурне (fuzzy), чиме се обезбеђује темељна провера пре употребе. Преводиоци би требало да погледају сваку ставку и потврде да се спашени превод заиста подудара са текућим оригиналним текстом, по потреби ажурирају превод, и уклоне маркере несигурног превода.

note: type: textblock
en: Once enough fuzzy markers are removed, B<po4a> will start generating the translation files on disk, and you're ready to move your translation workflow to production. Some projects find it useful to rely on weblate to coordinate between translators and maintainers, but that's beyond B<po4a>' scope.
sr: Онда када се уклони довољно маркера несигурног превода, B<po4a> ће почети да генерише фајлове превода на диск и спремни сте да свој процес превода преместите у продукцију. Неки пројекти сматрају корисним да се ослоне на веблејт за координацију преводилаца и одржаваоца, али то је ван опсега система B<po4a>'.

note: type: textblock
en: po4a-normalize - normalize a documentation file by parsing it in po4a, and writing it back
sr: po4a-normalize - нормализација фајла документације парсирањем са po4a, и уписивањем назад

note: type: textblock
en: B<po4a-normalize> B<-f> I<fmt> I<master.doc>
sr: B<po4a-normalize> B<-f> I<fmt> I<мастер.doc>

note: type: textblock
en: The po4a (PO for anything) project goal is to ease translations (and more interestingly, the maintenance of translations) using gettext tools on areas where they were not expected like documentation.
sr: Циљ po4a (PO for anything – PO за било шта) пројекта је да поједностави превођење (и што је још интересантније, одржавање превода) употребом gettext алата на деловима на којима се не очекује њихова употреба, као што је документација.

note: type: textblock
en: The B<po4a-normalize> script is a debugging tool used to make sure that po4a don't change the document when it's not supposed to. Only use it if you're developing a new module, or if you doubt the sanity of the tools.
sr: Скрипта B<po4a-normalize> је алат за отклањање грешака који се користи с циљем да po4a не измени документ онда када то не би требало да уради. Користите га само ако развијате нови модул, или ако сумњате да се алати не понашају како треба.

note: type: textblock
en: The generated document will be written to F<po4a-normalize.output> while the generated POT file will be written to F<po4a-normalize.po> by default, but you can use the B<--localized> and B<--pot> options to change that.
sr: Подразумевано је да се генерисани документ упише у F<po4a-normalize.output> а да се генерисани POT фајл упише у F<po4a-normalize.po>, али можете да употребите опције B<--localized> и B<--pot> и промените имена ових фајлова.

note: type: textblock
en: Create a blank translated document.  The generated translated document will be generated assuming all messages are translated by a space or new line.
sr: Креира празан преведени документ. То се ради тако што се усваја да су све поруке преведене једним размаком или преломом линије.

note: type: textblock
en: This is useful to check what parts of the document cannot be translated.
sr: Ово је корисно да се провери који делови документа не могу да се преведу.

note: type: textblock
en: Both B<--blank> and B<--capitalize> can't be specified at the same time.
sr: B<--blank> и B<--capitalize> не могу да се наведу истовремено.

note: type: textblock
en: Create a translated document and corresponding po-file with original strings translated as their capitalized versions.
sr: Креира преведени документ и одговарајући po-фајл са оригиналним стринговима чији су преводи исписани свим великим словима.

note: type: textblock
en: This is useful to check what parts of the document cannot be translated and generate test data for po4a.
sr: Ово је корисно да се провери који делови документа не могу да се преведу и да се генеришу тест подаци за po4a.

note: type: textblock
en: Name of the normalized file to produce (I<po4a-normalize.output> by default).
sr: Име нормализованог фајла који се прави (подразумевано је I<po4a-normalize.output>).

note: type: textblock
en: Pot file to produce (I<po4a-normalize.po> by default).
sr: Pot фајл који се прави (подразумевано је I<po4a-normalize.po>).

note: type: textblock
en: po4a-translate - convert a PO file back to documentation format
sr: po4a-translate - конверзија PO фајла назад у формат документације

note: type: textblock
en: B<po4a-translate> B<-f> I<fmt> B<-m> I<master.doc> B<-p> I<XX.po> B<-l> I<XX.doc>
sr: B<po4a-translate> B<-f> I<fmt> B<-m> I<мастер.doc> B<-p> I<XX.po> B<-l> I<XX.doc>

note: type: textblock
en: (I<XX.doc> is the output, all others are inputs)
sr: (I<XX.doc> је излаз, све остало је улаз)

note: type: textblock
en: The B<po4a-translate> script is in charge of converting the translation (which was done in a PO file) back into the documentation format. The provided PO file should be the translation of the POT file which was produced by L<po4a-gettextize(1)>.
sr: Скрипта B<po4a-translate> је задужена за конверзију превода (урађеног у PO фајлу) назад у формат документације. Достављени PO фајл би требало да буде превод POT фајла који креирао алат L<po4a-gettextize(1)>.

note: type: textblock
en: Add a file to the resulting file (to put translator's name or a section "About this translation", for example). The first line of the file to insert should be a PO4A header indicating where it should be added (see section B<HOWTO add extra text to translations> in L<po4a(7)>).
sr: Додаје фајл на крај фајла резултата (како би се на пример поставило име преводиоца или одељак „О овом преводу”). Прва линија фајла који се умеће би требало да буде PO4A заглавље које назначава место додавања фајла (погледајте одељак B<КАКОДА уметнем додатни текст у преводе> у L<po4a(7)>).

note: type: textblock
en: File containing the master document to translate.
sr: Фајл са мастер документом који се преводи.

note: type: textblock
en: File where the localized (translated) document should be written.
sr: Фајл у који би локализован (преведен) документ требало да се упише.

note: type: textblock
en: File from which the message catalog should be read.
sr: Фајл из кога би требало да се чита каталог порука.

note: type: textblock
en: Minimal threshold for translation percentage to keep (i.e. write) the resulting file (default: 80). I.e. by default, files have to be translated at least at 80% to get written.
sr: Најмањи ниво преведености који је потребан да се фајл резултата задржи (тј. запише) (подразумевано: 80). То значи да је подразумевано потребно да барем 80% неког фајла буде преведено како би се његов превод записао.

note: type: =head1
en: Adding content (beside translations) to generated files
sr: Додавање садржаја (осим превода) генерисаним фајловима

note: type: textblock
en: To add some extra content to the generated document beside what you translated (like the name of the translator, or an "About this translation" section), you should use the B<--addendum> option.
sr: Да бисте у генерисани фајл додали нешто више осим онога што сте превели (као што је име преводиоца, или одељак „О овом преводу”), треба да употребите опцију B<--addendum>.

note: type: textblock
en: The first line of the addendum must be a header indicating where to put it in the document (it can be before or after a given part of the document).  The rest of the file will be added verbatim to the resulting file without further processing.
sr: Прва линија додатка мора да буде заглавље које назначава место у документу на које се додатак умеће (то може да буде пре или након датог дела документа). Остатак фајла ће дословно да се дода у излазни фајл, без било какве даље обраде.

note: type: textblock
en: Note that if po4a-translate fails to add one of the given files, it discards the whole translation (because the missing file could be the one indicating the author, what would prevent the users to contact him to report bugs in the translation).
sr: Имајте на уму да ако po4a-translate не успе да дода један од датих фајлова, оне ће да одбаци комплетан превод (јер би недостајуће фајл могао да буде онај који назначава аутора, чиме би се корисници спречили да ступе у контакт како би му пријавили грешке у преводу).

note: type: textblock
en: The header has a pretty rigid syntax. For more information on how to use this feature and how it works, please refer to the L<po4a(7)> man page.
sr: Заглавље има прилично круту синтаксу. За више информација о томе како да користите ову могућност и како она ради, молимо да погледате L<po4a(7)> man страницу.

note: type: textblock
en: po4a-updatepo - update the translation (in PO format) of documentation
sr: po4a-updatepo - освежавање превода (у PO формату) документације

note: type: textblock
en: B<po4a-updatepo> B<-f> I<fmt> (B<-m> I<master.doc>)+ (B<-p> I<XX.po>)+
sr: B<po4a-updatepo> B<-f> I<фор> (B<-m> I<масетр.doc>)+ (B<-p> I<XX.po>)+

note: type: textblock
en: (I<XX.po> are the outputs, all others are inputs)
sr: (I<XX.po> су излази, све остало су улази)

note: type: textblock
en: The B<po4a-updatepo> script is in charge of updating PO files to make them reflect the changes made to the original documentation file. For that, it converts the documentation file to a POT file, and call L<msgmerge(1)> on this new POT and on the provided PO files.
sr: Скрипта B<po4a-updatepo> је задужена за освежавање PO фајлова како би се у њима рефлектовале измене начињене у оригиналном фајлу документације. Она конвертује фајл документације у POT фајл, и позива L<msgmerge(1)> над овим новим POT фајлом, и задатим PO фајловима.

note: type: textblock
en: It is possible to give more than one PO file (if you want to update several languages at once), and several documentation files (if you want to store the translations of several documents in the same PO file).
sr: Могуће је да се зада више од једног PO фајла (ако желите да освежите неколико језика од једном), и неколико фајлова документације (ако желите да чувате преводе неколико докумената у једном PO фајлу).

note: type: textblock
en: If the master document has non-ASCII characters, this script will convert the PO files to UTF-8 (if they weren't already), for a transparent handling of non-standard characters.
sr: Ако мастер документ има карактере ван ASCII скупа, ова скрипта ће да конвертује фајлове у UTF-8 (ако већ нису у том кодирању), да би се обезбедила транспарентна обрада нестандардних карактера.

note: type: textblock
en: File(s) containing the master document to translate.
sr: Фајл(ови) који садрже мастер документ који се преводи.

note: type: textblock
en: Charset of the files containing the document to translate. Note that all files must have the same charset.
sr: Скуп карактера фајлова који садрже документ за превођење. Приметите да сви фајлови морају да имају исти скуп карактера.

note: type: textblock
en: PO file(s) to update. If these files do not exist, they are created by B<po4a-updatepo>.
sr: PO фајл(ови) који треба да се освеже. Ако ови фајлови не постоје, B<po4a-updatepo> их креира.

note: type: textblock
en: This option removes B<--previous> from the options passed to B<msgmerge>.  This helps supporting old versions of B<gettext> (before v0.16).
sr: Ова опција уклања B<--previous> из опција које се прослеђују програму B<msgmerge>. Тиме се омогућава подршка за старе верзије програма B<gettext> (пре v0.16).

note: type: =item
en: B<--porefs> I<type>[,B<wrap>|B<nowrap>]
sr: B<--porefs> I<тип>[,B<wrap>|B<nowrap>]

note: type: textblock
en: Argument can be followed by a comma and either B<wrap> or B<nowrap> keyword.  References are written by default on a single line.  The B<wrap> option wraps references on several lines, to mimic B<gettext> tools (B<xgettext> and B<msgmerge>).  This option will become the default in a future release, because it is more sensible.  The B<nowrap> option is available so that users who want to keep the old behavior can do so.
sr: Иза аргумента може да следи зарез па или B<wrap> или B<nowrap> кључна реч. Подразумевано се референце исписују у једној линији. Опција B<wrap> обавија референце на више линија, чиме се опонашају B<gettext> алати (B<xgettext> и B<msgmerge>). Ова опција ће да постане подразумевана у будућим издањима, јер има више смисла. Доступна је и B<nowrap> опција тако да ако то желе, корисници могу да задрже старо понашање.

note: type: textblock
en: Historically, the gettext suite has reformatted the po files at the 77th column for cosmetics. This option specifies the behavior of po4a. If set to a numerical value, po4a will wrap the po file after this column and after newlines in the content. If set to B<newlines>, po4a will only split the msgid and msgstr after newlines in the content. If set to B<no>, po4a will not wrap the po file at all.  The wrapping of the reference comments is controlled by the B<--porefs> option.
sr: Раније је gettext свита програма реформатирала po фајлове на 77ој колони ради лепшег изгледа. Ова опција одрешује понашање програма po4a. Ако се постави на нумеричку вредност, po4a ће да обавије po након колоне под тим бројем и након прелома линија у садржају. Ако се постави на B<newlines>, po4a ће само да раздели msgid и msgstr након прелома линија у садржају. Ако се постави на B<no>, po4a уопште неће да обавија po фајл. Обавијање коментара-референци се конторлише опцијом B<--porefs>.

note: type: textblock
en: msguntypot - update PO files when a typo is fixed in POT file
sr: msguntypot - освежава PO фајлове када је у POT фајлу исправљена грешка у куцању

note: type: textblock
en: B<msguntypot> B<-o> I<old_pot> B<-n> I<new_pot> I<pofiles> ...
sr: B<msguntypot> B<-o> I<стари_pot> B<-n> I<нови_pot> I<poфајлови> ...

note: type: textblock
en: When you fix a trivial error which surely doesn't affect translations (e.g.  a typo) in a POT file, you should unfuzzy the corresponding msgstr in the translated PO files to avoid so extra work to the translators.
sr: Када у POT фајлу исправите тривијалну грешку која сигурно не утиче на преводе (нпр. словна грешка у куцању), требало би да уклоните fuzzy ознаку са одговарајућег msgstr у преведеним PO фајловима како преводиоци не би имали додатни посао.

note: type: textblock
en: This task is difficult and error prone when done manually, and this tool is there to help doing so correctly. You just need to provide the two versions of the POT file: before the edition and after as marked in the above synopsis, and it all becomes automatic.
sr: Овај задатак је компликован и склон грешкама када се ради ручно, а овај алат постоји како би помогао да се обави коректно. Потребно је само да наведете две верзије POT фајла: пре исправке и након, као што је означено у горњем синопсису и све постаје аутоматско.

note: type: =head1
en: HOW TO USE IT
sr: КАКО ДА СЕ КОРИСТИ

note: type: textblock
en: In short, when you discover a typo in one of your [english] message, do the following:
sr: Укратко, када откријете грешку у куцању у једној од својих (енглеских) порука, урадите следеће:

note: type: =item
en: - Regenerate your POT and PO files.
sr: - Регенеришите ваше POT и PO фајлове.

note: type: verbatim
en:   make -C po/ update-po # for message program translations
      debconf-updatepo      # for debconf translations
      po4a po4a.conf        # for po4a based documentation translations
sr:   make -C po/ update-po # за преводе помоћу програма message
      debconf-updatepo      # за debconf преводе
      po4a po4a.conf        # за po4a базиране преводе документације

note: type: textblock
en: or something else, depending on your project's building settings. You know how to make sure your POT and PO files are uptodate, don't you??
sr: или нешто друго, зависно од поставки изградње вашег пројекта. Знате како да ваши POT и PO фајлови буду ажурни, зар не??

note: type: =item
en: - Make a copy of your POT file.
sr: - Направите копију вашег POT фајла.

note: type: =item
en: - Make a copy of all your PO files.
sr: - Направите копију свих ваших PO фајлова.

note: type: verbatim
en:   mkdir po_fridge; cp *.po po_fridge
sr:   mkdir po_фрижидер; cp *.po po_фрижидер

note: type: =item
en: - Fix your typo.
sr: - Исправите грешку у куцању.

note: type: textblock
en: $EDITOR the_file_in_which_there_is_a_typo
sr: $EDITOR фајл_у_коме_је_грешка_у_куцању

note: type: textblock
en: See above.
sr: Погледајте изнад.

note: type: textblock
en: At this point, the typo fix fuzzied all the translations, and this unfortunate change is the only one between the PO files of your main directory and the one from the fridge. Here is how to solve this.
sr: Сада је исправка грешке рашчупала све преводе, и ова несрећна измена је једина разлика између PO фајлова у вашем главном директоријуму и оних из фрижидера. Ево како да то решите.

note: type: =item
en: - Discard fuzzy translation, restore the ones from the fridge.
sr: - Одбаците fuzzy (чупави) превод, вратите назад оне из фрижидера.

note: type: verbatim
en:   cp po_fridge/*.po .
sr:   cp po_фрижидер/*.po .

note: type: =item
en: - Manually merge the PO files with the new POT file, but taking the useless fuzzy into account.
sr: - Ручно спојите PO фајлове са новим POT фајлом, али узимајући у обзир бескорисни fuzzy.

note: type: verbatim
en:   msguntypot -o myfile.pot.orig -n myfile.pot *.po
sr:   msguntypot -o мојфајл.pot.orig -n мојфајл.pot *.po

note: type: =item
en: - Cleanups.
sr: - Чишћење заосталих ствари.

note: type: verbatim
en:   rm -rf myfile.pot.orig po_fridge
sr:   rm -rf myfile.pot.orig po_фрижидер

note: type: textblock
en: You're done. The typo was eradicated from msgstr of both your POT and PO files, and the PO files were not fuzzyied in the process. Your translators love you already.
sr: Готови сте. Грешка у куцању је елиминисана из msgstr у POT и у PO фајловима, и PO фајлови нису рашчупани у том процесу. Ваши преводиоци вас већ воле.

note: type: textblock
en: Despite its name, this tool is not part of the gettext tool suite. It is instead part of po4a. More precisely, it's a random Perl script using the fine po4a modules. For more information about po4a, please see:
sr: Упркос свом имену, овај алат није део gettext свите алата. Он је уствари део po4a. Прецизније, то је случајна Perl скрипта која користи фине po4a модуле. За више информација у вези po4a, молимо погледајте:

note: type: verbatim
en:  Martin Quinson (mquinson#debian.org)
sr:  Мартин Квинсон (mquinson#debian.org)

note: type: textblock
en: Copyright 2005 by SPI, inc.
sr: Права умножавања 2005 SPI, inc.

note: type: textblock
en: po4a - framework to translate documentation and other materials
sr: po4a - радни оквир за превод документације и осталог материјала

note: type: =head1
en: Introduction
sr: Увод

note: type: textblock
en: po4a (PO for anything) eases the maintenance of documentation translation using the classical gettext tools. The main feature of po4a is that it decouples the translation of content from its document structure.
sr: po4a (PO for anything [PO за било шта]) олакшава одржавање превода докумената употребом класичних gettext алата. Главна особина po4a је да раскида везу између садржаја превода и структуре његовог документа.

note: type: textblock
en: This document serves as an introduction to the po4a project with a focus on potential users considering whether to use this tool and on the curious wanting to understand why things are the way they are.
sr: Овај документ служи као увод у po4a који се обраћа потенцијалним корисницима који разматрају да ли да употребе овај алат и радозналима који желе да разумеју зашто су ствари онакве какве су.

note: type: =head1
en: Why po4a?
sr: Зашто po4a?

note: type: textblock
en: The philosophy of Free Software is to make the technology truly available to everyone. But licensing is not the only consideration: untranslated free software is useless for non-English speakers. Therefore, we still have some work to do to make software available to everybody.
sr: Филозофија Слободног Софтвера је да се технологија заиста учини доступном свима. Али лиценцирање није једина брига: непреведени слободни софтвер је бескористан корисницима који не говоре енглески језик. Стога, имамо да одрадимо још посла како би софтвер био доступан свима.

note: type: textblock
en: This situation is well understood by most projects and everybody is now convinced of the necessity to translate everything. Yet, the actual translations represent a huge effort of many individuals, crippled by small technical difficulties.
sr: Многи пројекти су добро разумели ову ситуацију и сада су сви убеђени у неопходност превођења свега. Ипак, само превођење представља огроман напор многих појединаца, отежан малим техничким потешкоћама.

note: type: textblock
en: Thankfully, Open Source software is actually very well translated using the gettext tool suite. These tools are used to extract the strings to translate from a program and present the strings to translate in a standardized format (called PO files, or translation catalogs). A whole ecosystem of tools has emerged to help the translators actually translate these PO files. The result is then used by gettext at run time to display translated messages to the end users.
sr: На сву срећу, софтвер Отвореног Кода се уствари врло добро преводи употребом gettext свите алата. Они се користе за издвајање стрингова који треба да се преведу и за њихово представљање у стандардизованом формату (који се зове PO фајлови, или каталози превода). Појавио се читав екосистем алата који помажу преводиоцима да заиста преведу ове PO фајлове. gettext у време извршавања користи резултат превођења да крајњим корисницима прикаже преведене поруке.

note: type: textblock
en: Regarding documentation, however, the situation still somewhat disappointing.  At first translating documentation may seem to be easier than translating a program as it would seem that you just have to copy the documentation source file and start translating the content. However, when the original documentation is modified, keeping track of the modifications quickly turns into a nightmare for the translators. If done manually, this task is unpleasant and error-prone.
sr: Што се тиче документације, ситуација је још увек донекле разочаравајућа.  На први поглед превођење документације може да изгледа лакше него превођење програма, јер се чини да је само потребно да ископирате изворни фајл документације и почнете да преводите садржај. Међутим, када се оригинална документација измени, праћење промена се брзо претвара у ноћну мору за преводиоце. Ако се ради ручно, овај задатак је непријатан и склон грешкама.

note: type: textblock
en: Outdated translations are often worse than no translation at all. End-users can be tricked by documentation describing an old behavior of the program.  Furthermore, they cannot interact directly with the maintainers since they don't speak English. Additionally, the maintainer cannot fix the problem as they don't know every language in which their documentation is translated.  These difficulties, often caused by poor tooling, can undermine the motivation of volunteer translators, further aggravating the problem.
sr: Застарели преводи су често гори од ситуације када уопште нема превода. Крајњи корисницу могу да буду заварани документацијом која описује старо понашање програма. Уз то, они не могу да имају директну интеракцију са одржаваоцима јер не говоре енглески језик. А одржаваоци такође не могу да поправе проблем јер не знају сваки језик на који је њихова документација преведена. Ове потешкоће, које су често последица лошег избора алата, могу да поткопају мотивацију преводиоца волонтера, чиме се проблем додатно погоршава.

note: type: textblock
en: B<The goal of the po4a project is to ease the work of documentation translators>.  In particular, it makes documentation translations I<maintainable>.
sr: B<Циљ po4a пројекта је да олакша рад преводиоцима документације>. Тачније, он омогућава I<одржавање> превода документације.

note: type: textblock
en: The idea is to reuse and adapt the gettext approach to this field. As with gettext, texts are extracted from their original locations and presented to translators as PO translation catalogs. The translators can leverage the classical gettext tools to monitor the work to do, collaborate and organize as teams. po4a then injects the translations directly into the documentation structure to produce translated source files that can be processed and distributed just like the English files. Any paragraph that is not translated is left in English in the resulting document, ensuring that the end users never see an outdated translation in the documentation.
sr: Идеја је да се искористи и прилагоди gettext приступ овом пољу. Као са gettext, текстови се издвајају из својих оригиналних локација и представљају преводиоцима као PO каталози превода. Преводиоци могу да искористе класичне gettext алате да прате рад који треба да се уради, сарађују и да се организују у тимове. po4a затим умеће преводе директно у структуру документације и тако прави преведене изворне фајлове који могу да се обраде и дистрибуирају на исти начин као и енглески фајлови. Сваки пасус који није преведен остаје на енглеском у излазном документу, па се на тај начин обезбеђује да крајњи корисници никада не виде застарели превод у документацији.

note: type: textblock
en: This automates most of the grunt work of the translation maintenance.  Discovering the paragraphs needing an update becomes very easy, and the process is completely automated when elements are reordered without further modification. Specific verification can also be used to reduce the chance of formatting errors that would result in a broken document.
sr: Ово аутоматизује већину незгодног посла у одржавању превода. Откривање пасуса које је потребно освежити постаје веома једноставно и процес је потпуно аутоматизован када је редослед елемента преуређен без даљих измена. Такође може да се користи и одређена верификација како би се умањила могућност грешака форматирања због којих би се документ искварио.

note: type: textblock
en: Please also see the B<FAQ> below in this document for a more complete list of the advantages and disadvantages of this approach.
sr: Молимо да такође погледате и B<ЧПП> ниже у овом документу да бисте видели комплетнију листу добрих и лоших страна овог приступа.

note: type: =head2
en: Supported formats
sr: Подржани формати

note: type: textblock
en: Currently, this approach has been successfully implemented to several kinds of text formatting formats:
sr: Тренутно је овај приступ успешно имплементиран на неколико врста формата за форматирање текста:

note: type: =item
en: man (mature parser)
sr: man (стабилни парсер)

note: type: textblock
en: The good old manual pages' format, used by so many programs out there. po4a support is very welcome here since this format is somewhat difficult to use and not really friendly to newbies.
sr: Стари добри формат за стране приручника који користи велики број програма. Овде је po4a подршка веома добродошла јер је овај формат донекле компликован за коришћење и уопште није погодан за почетнике.

note: type: textblock
en: The L<Locale::Po4a::Man(3pm)|Man> module also supports the mdoc format, used by the BSD man pages (they are also quite common on Linux).
sr: Модул L<Locale::Po4a::Man(3pm)|Man> такође подржава и mdoc формат који користе BSD man стране (оне су такође прилично уобичајене и на Linux системима).

note: type: =item
en: AsciiDoc (mature parser)
sr: AsciiDoc (стабилан парсер)

note: type: textblock
en: This format is a lightweight markup format intended to ease the authoring of documentation. It is for example used to document the git system. Those manpages are translated using po4a.
sr: Ово је једноставан формат за обележавање који је намењен за поједностављивање писања документације. На пример, коришћен је за документовање git система. Те man стране су преведене уз помоћ po4a.

note: type: textblock
en: See L<Locale::Po4a::AsciiDoc> for details.
sr: За још детаља, погледајте L<Locale::Po4a::AsciiDoc>.

note: type: =item
en: pod (mature parser)
sr: pod (стабилни парсер)

note: type: textblock
en: This is the Perl Online Documentation format. The language and extensions themselves are documented using this format in addition to most existing Perl scripts. It makes easy to keep the documentation close to the actual code by embedding them both in the same file. It makes programmer's life easier, but unfortunately, not the translator's, until you use po4a.
sr: Ово је Perl Online Documentation формат. Сам језик и његова проширења су документовани употребом овог формата заједно са већином постојећих Perl скрипти. Он олакшава држање документације близу кода који описује уграђујући их заједно у исти фајл. Чини живот програмера једноставнијим, али на несрећу не и преводиочев. Све док не почнете да користите po4a.

note: type: textblock
en: See L<Locale::Po4a::Pod> for details.
sr: За више детаља, погледајте L<Locale::Po4a::Pod>.

note: type: =item
en: sgml (mature parser)
sr: sgml (стабилни парсер)

note: type: textblock
en: Even if superseded by XML nowadays, this format is still used for documents which are more than a few screens long. It can even be used for complete books.  Documents of this length can be very challenging to update. B<diff> often reveals useless when the original text was re-indented after update.  Fortunately, po4a can help you after that process.
sr: Чак и ако је данас превазиђен са XML форматом, овај формат се и даље користи за документе који су дугачки више од неколико екрана. Чак може да се користи и за комплетне књиге. Ажурирање докумената ове дужине може да буде прилично изазовно. B<diff> се често показује бескорисним када је увлачење оригиналног текста поново урађено након ажурирања. На сву срећу, po4a може да вам помогне након тог процеса.

note: type: textblock
en: Currently, only DebianDoc and DocBook DTD are supported, but adding support for a new one is really easy. It is even possible to use po4a on an unknown SGML DTD without changing the code by providing the needed information on the command line. See L<Locale::Po4a::Sgml(3pm)> for details.
sr: Тренутно су подржани само DebianDoc и DocBook DTD описи, али додавање подршке за неки нови је заиста једноставно. Чак је могуће да се употреби po4a на непознатом SGML DTD без измене кода достављајући неопходне информације преко командне линије. Погледајте L<Locale::Po4a::Sgml(3pm)> за више детаља.

note: type: =item
en: TeX / LaTeX (mature parser)
sr: TeX / LaTeX (стабилни парсер)

note: type: textblock
en: The LaTeX format is a major documentation format used in the Free Software world and for publications.
sr: LaTeX формат је главни формат документације који се користи у свету Слободног Софтвера као и за публикације.

note: type: textblock
en: The L<Locale::Po4a::LaTeX(3pm)|LaTeX> module was tested with the Python documentation, a book and some presentations.
sr: Модул L<Locale::Po4a::LaTeX(3pm)|LaTeX> је тестиран са Python документацијом, књигом и неким презентацијама.

note: type: =item
en: text (mature parser)
sr: text (стабилни парсер)

note: type: textblock
en: The Text format is the base format for many formats that include long blocks of text, including Markdown, fortunes, YAML front matter section, debian/changelog, and debian/control.
sr: Text формат је базни формат за многе друге формате који укључују дугачке блокове текста, укључујући Markdown, fortunes, YAML одељак пре главног текста, debian/changelog, и debian/control.

note: type: textblock
en: This supports the common format used in Static Site Generators, READMEs, and other documentation systems. See L<Locale::Po4a::Text(3pm)|Text> for details.
sr: Ово подржава уобичајене формате који се користе за Генераторе Статичког Сајта, ПРОЧИТАЈМЕ, и остале системе документације. Погледајте L<Locale::Po4a::Text(3pm)|Text> за више детаља.

note: type: =item
en: xml and XHMTL (probably mature parser)
sr: xml и XHMTL (вероватно стабилан парсер)

note: type: textblock
en: The XML format is a base format for many documentation formats.
sr: XML формат је базни формат за многе формате документације.

note: type: textblock
en: Currently, the DocBook DTD (see L<Locale::Po4a::Docbook(3pm)> for details) and XHTML are supported by po4a.
sr: po4a тренутно подржава DocBook DTD (погледајте L<Locale::Po4a::Docbook(3pm)> за више детаља) и XHTML.

note: type: =item
en: BibTex (probably mature parser)
sr: BibTex (вероватно стабилан парсер)

note: type: textblock
en: The BibTex format is used alongside LaTex for formatting lists of references (bibliographies).
sr: Формат BibTex се користи уз LaTex за форматирање листи референци (библиографије).

note: type: textblock
en: See L<Locale::Po4a::BibTex> for details.
sr: За више детаља, погледајте L<Locale::Po4a::BibTex>.

note: type: =item
en: Docbook (probably mature parser)
sr: Docbook (вероватно стабилан парсер)

note: type: textblock
en: A XML-based markup language that uses semantic tags to describe documents.
sr: Језик означавања заснован на XML који за описивање докумената користи семантичке ознаке.

note: type: textblock
en: See L<Locale::Po4a:Docbook> for greater details.
sr: За више детаља, погледајте L<Locale::Po4a:Docbook>.

note: type: =item
en: Guide XML (probably mature parser)
sr: Guide XML (вероватно стабилан парсер)

note: type: textblock
en: A XML documentation format. This module was developed specifically to help with supporting and maintaining translations of Gentoo Linux documentation up until at least March 2016 (Based on the Wayback Machine). Gentoo have since moved to the DevBook XML format.
sr: XML формат документације. Овај модул је специјално развијен као помоћ за подршку и одржавање превода Gentoo Linux документације све до барем марта 2016 (како каже Wayback Machine). Од тада се Gentoo пребацио на DevBook XML формат.

note: type: textblock
en: See L<Locale::Po4a:Guide> for greater details.
sr: За више детаља, погледајте L<Locale::Po4a:Guide>.

note: type: =item
en: Wml (probably mature parser)
sr: Wml (вероватно стабилан парсер)

note: type: textblock
en: The Web Markup Language, do not mixup WML with the WAP stuff used on cell phones.  This module relies on the Xhtml module, which itself relies on the XmL module.
sr: Web Markup Language, немојте да помешате WML са WAP протоколом који се користи на мобилним телефонима. Овај модул се ослања на Xhtml модул, који се са своје стране ослања на XmL модул.

note: type: textblock
en: See L<Locale::Po4a::Wml> for greater details.
sr: За више детаља, погледајте L<Locale::Po4a::Wml>.

note: type: =item
en: Yaml (probably mature parser)
sr: Yaml (вероватно стабилан парсер)

note: type: textblock
en: A strict superset of JSON. YAML is often used as systems or configuration projects.  YAML is at the core of Red Hat's Ansible.
sr: Стриктни надскуп JSON. YAML се често користи за пројекте система или конфигурације. YAML је језгро за Ansible компаније Red Hat.

note: type: textblock
en: See L<Locale::Po4a::Yaml> for greater details.
sr: За више детаља, погледајте L<Locale::Po4a::Yaml>.

note: type: =item
en: RubyDoc (probably mature parser)
sr: RubyDoc (вероватно стабилан парсер)

note: type: textblock
en: The Ruby Document (RD) format, originally the default documentation format for Ruby and Ruby projects before converted to RDoc in 2002. Though apparently the Japanese version of the Ruby Reference Manual still use RD.
sr: Формат Ruby Document (RD), у почетку подразумевани формат документације за Ruby и Ruby пројекте пре конверзије у RDoc 2002. године. Мада изгледа да јапанска верзија Ruby референтног приручника још увек користи RD.

note: type: textblock
en: See L<Locale::Po4a::RubyDoc> for greater details.
sr: За више детаља, погледајте L<Locale::Po4a::RubyDoc>.

note: type: =item
en: Halibut (probably experimental parser)
sr: Halibut (вероватно експериментални парсер)

note: type: textblock
en: A documentation production system, with elements similar to TeX, debiandoc-sgml, TeXinfo, and others, developed by Simon Tatham, the developer of PuTTY.
sr: Систем документације са елементима који личе на TeX, debiandoc-sgml, TeXinfo и остале, развио је Сајмон Татам, програмер програма PuTTY.

note: type: textblock
en: See L<Locale::Po4a:Halibut> for greater details.
sr: За више детаља, погледајте L<Locale::Po4a:Halibut>.

note: type: =item
en: Ini (probably experimental parser)
sr: Ini (вероватно експериментални парсер)

note: type: textblock
en: Configuration file format popularized by MS-DOS.
sr: Формат фајла за конфигурацију који је MS-DOS учинио популарим.

note: type: textblock
en: See L<Locale::Po4a::Ini> for greater details.
sr: За више детаља, погледајте L<Locale::Po4a::Ini>.

note: type: =item
en: texinfo (very highly experimental parser)
sr: texinfo (врло експериментални парсер)

note: type: textblock
en: All of the GNU documentation is written in this format (it's even one of the requirements to become an official GNU project). The support for L<Locale::Po4a::Texinfo(3pm)|Texinfo> in po4a is still at the beginning.  Please report bugs and feature requests.
sr: Сва GNU документација је написано у овом формату (то је чак један од захтева да се постане званичан GNU пројекат). Подршка за L<Locale::Po4a::Texinfo(3pm)|Texinfo> у po4a је и даље на почетку. Молимо да пријавите багове и поднесете захтеве за новим могућностима.

note: type: =item
en: gemtext (very highly experimental parser)
sr: gemtext (врло експериментални парсер)

note: type: textblock
en: The native plain text format of the Gemini protocol.  The extension C<.gmi> is commonly used.  Support for this module in po4a is still in its infancy.  If you find anything, please file a bug or feature request.
sr: Природни формат простог текста Gemini протокола. Обично се користи екстензија C<.gmi>. Подршка за овај модул у po4a је још увек у зачетку. Ако пронађете било шта, молимо вас да пријавите баг или захтев за функционалност.

note: type: =item
en: org (very highly experimental parser)
sr: org (врло експериментални парсер)

note: type: textblock
en: The document format used by the Org mode.  Support for this module in po4a is still in its infancy.  If you find anything, please file a bug or feature request.
sr: Формат документа који користи Org режим. Подршка за овај модул у po4a је још увек у зачетку. Ако пронађете било шта, молимо вас да пријавите баг или захтев за функционалност.

note: type: =item
en: vimhelp (very highly experimental parser)
sr: vimhelp (веома експериментални парсер)

note: type: textblock
en: The format used for Vim help files (and some third-party plugin documentation).  Support for this format in po4a is still in its infancy.  If you find anything, please file a bug report or feature request.
sr: Формат документа који се користи за фајлове помоћи едитора Vim (и за документацију неких додатка треће стране). Подршка за овај модул у po4a је још увек у зачетку. Ако пронађете било шта, молимо вас да пријавите баг или захтев за функционалност.

note: type: =item
en: simplepod (very highly experimental parser)
sr: simplepod (веома експериментални парсер)

note: type: textblock
en: Similar to the previously mentioned I<pod>, this one adopts the new L<Pod::Simple> as its parser.  Since it is newly created, some bugs are expected.  If you notice any strange behavior, please let us know.  Eventually, this module will replace I<pod>.
sr: Слично претходно поменутом I<pod>, овај за свој парсер користи нови L<Pod::Simple>. Пошто је нов, могу да се очекују багови. Ако приметите било какво чудно понашање, молимо вас да нас обавестите. Овај модул ће касније заменити I<pod>.

note: type: =item
en: Others supported formats
sr: Остали подржани формати

note: type: textblock
en: Po4a can also handle some more rare or specialized formats, such as the documentation of compilation options for the 2.4+ Linux kernels (L<Locale::Po4a::KernelHelp>) or the diagrams produced by the dia tool (L<Locale::Po4a::Dia>). Adding a new format is often very easy and the main task is to come up with a parser for your target format. See L<Locale::Po4a::TransTractor(3pm)> for more information about this.
sr: Po4a такође може да обради и ређе или специјализоване формате, као што је документација опција компилације 2.4+ Linux кернела (L<Locale::Po4a::KernelHelp>) или дијаграми које производи алат dial (L<Locale::Po4a::Dia>). Додавање нових формата је често веома једноставно и главни задатак је да се изађе са парсером за ваш циљни формат. Погледајте L<Locale::Po4a::TransTractor(3pm)> за више информација у вези овога.

note: type: =item
en: Unsupported formats
sr: Неподржани формати

note: type: textblock
en: Unfortunately, po4a still lacks support for several documentation formats. Many of them would be easy to support in po4a. This includes formats not just used for documentation, such as, package descriptions (deb and rpm), package installation scripts questions, package changelogs, and all the specialized file formats used by programs such as game scenarios or wine resource files.
sr: Нажалост, po4a још нема подршку за неколико формата документације. Подршка за многе од њих би се лако додала у po4a. То укључује формате који се не користе само за документацију, као што су описи пакета (deb и rpm), питања у скриптама за инсталацију пакета, дневници измена пакета, и сво специјализовани фајл формати које користе програми као што су сценарија за игре или wine ресурс фајлови.

note: type: =head1
en: Using po4a
sr: Употреба po4a

note: type: textblock
en: The easiest way to use this tool in your project is to write a configuration file for the B<po4a> program, and only interact with this program. Please refer to its documentation, in L<po4a(1)>. The rest of this section provides more details for the advanced users of po4a wanting to deepen their understanding.
sr: Најједноставнији начин да овај алат употребите у свом пројекту је да напишете конфигурациони фајл за B<po4a> програм и да онда имате интеракцију само за овим програмом. Молимо вас да прочитате његову документацију, налази се у L<po4a(1)>. Остатак овог одељка наводи више детаља битних напредним корисницима програма po4a који желе да продубе своје разумевање.

note: type: =head2
en: Detailed schema of the po4a workflow
sr: Детаљна схема процеса рада са програмом po4a

note: type: textblock
en: Make sure to read L<po4a(1)> before this overly detailed section to get a simplified overview of the po4a workflow. Come back here when you want to get the full scary picture, with almost all details.
sr: Обавезно најпре прочитајте L<po4a(1)> пре овог врло детаљног одељка да бисте имали упрошћени преглед процеса рада са програмом po4a. Вратите се овде када желите да погледате застрашујућу комплетну слику, са скоро свим детаљима.

note: type: textblock
en: In the following schema, F<master.doc> is an example name for the documentation to be translated; F<XX.doc> is the same document translated in the language XX while F<doc.XX.po> is the translation catalog for that document in the XX language. Documentation authors will mostly be concerned with F<master.doc> (which can be a manpage, an XML document, an AsciiDoc file, etc); the translators will be mostly concerned with the PO file, while the end users will only see the F<XX.doc> file.
sr: На схеми која следи даје F<master.doc> име дато као пример документације која треба да се преведе; F<XX.doc> је тај исти документ преведен на језик XX док је F<doc.XX.po> каталог превода за тај документ на језику XX. Аутори документације ће углавном да се баве са F<master.doc> (што може да буде manстрана, XML документ, AsciiDoc фајл, итд.); преводиоци ће углавном да се фокусирају на PO фајл, док ће крајњи корисници да виде само фајл F<XX.doc>.

note: type: textblock
en: Transitions with square brackets such as C<[po4a updates po]> represent the execution of a po4a tool while transitions with curly brackets such as C<{update of master.doc}> represent a manual modification of the project's files.
sr: Прелази са угластим заградама као што је C<[po4a ажурира po]> представљају извршавање po4a алата, док прелази са витичастим заградама као што је C<{ажурирање мастер.doc}> представљају ручну измену фајлова пројекта.

note: type: verbatim
en:                                    master.doc
                                           |
                                           V
         +<-----<----+<-----<-----<--------+------->-------->-------+
         :           |                     |                        :
    {translation}    |          {update of master.doc}              :
         :           |                     |                        :
       XX.doc        |                     V                        V
     (optional)      |                 master.doc ->-------->------>+
         :           |                   (new)                      |
         V           V                     |                        |
      [po4a-gettextize]   doc.XX.po -->+   |                        |
              |            (old)       |   |                        |
              |              ^         V   V                        |
              |              |   [po4a updates po]                  |
              V              |           |                          V
       translation.pot       ^           V                          |
              |              |        doc.XX.po                     |
              |              |         (fuzzy)                      |
        {translation}        |           |                          |
              |              ^           V                          V
              |              |     {manual editing}                 |
              |              |           |                          |
              V              |           V                          V
          doc.XX.po --->---->+<---<-- doc.XX.po    addendum     master.doc
          (initial)                 (up-to-date)  (optional)   (up-to-date)
              :                          |            |             |
              :                          V            |             |
              +----->----->----->------> +            |             |
                                         |            |             |
                                         V            V             V
                                         +------>-----+------<------+
                                                      |
                                                      V
                                         [po4a updates translations]
                                                      |
                                                      V
                                                    XX.doc
                                                 (up-to-date)
sr:                                    master.doc
                                           |
                                           V
         +<-----<----+<-----<-----<--------+------->-------->-------+
         :           |                     |                        :
    {превођење}      |         {ажурирање master.doc}               :
         :           |                     |                        :
       XX.doc        |                     V                        V
    (опционално)    |                  master.doc ->-------->------>+
         :           |                   (нови)                     |
         V           V                     |                        |
      [po4a-gettextize]   doc.XX.po -->+   |                        |
              |           (стари)      |   |                        |
              |              ^         V   V                        |
              |              |    [po4a ажурира po]                 |
              V              |           |                          V
         превод.pot          ^           V                          |
              |              |        doc.XX.po                     |
              |              |         (fuzzy)                      |
         {превођење}         |           |                          |
              |              ^           V                          V
              |              |    {ручно уређивање}                 |
              |              |           |                          |
              V              |           V                          V
          doc.XX.po --->---->+<---<-- doc.XX.po    додатак     master.doc
         (иницијални)                (ажуриран)  (опционално)  (ажуриран)
              :                          |            |             |
              :                          V            |             |
              +----->----->----->------> +            |             |
                                         |            |             |
                                         V            V             V
                                         +------>-----+------<------+
                                                      |
                                                      V
                                            [po4a ажурира преводе]
                                                      |
                                                      V
                                                    XX.doc
                                                  (ажуриран)

note: type: textblock
en: Again, this schema is overly complicated. Check on L<po4a(1)> for a simplified overview.
sr: Да поновимо, ова схема је веома компликована. Погледајте L<po4a(1)> да видите упрошћени преглед.

note: type: textblock
en: The left part depicts how L<po4a-gettextize(1)> can be used to convert an existing translation project to the po4a infrastructure. This script takes an original document and its translated counterpart, and tries to build the corresponding PO file. Such manual conversion is rather cumbersome (see the L<po4a-gettextize(1)> documentation for more details), but it is only needed once to convert your existing translations. If you don't have any translation to convert, you can forget about this and focus on the right part of the schema.
sr: Леви део приказује како L<po4a-gettextize(1)> може да се употреби за конверзију постојећег пројекта превода у po4a инфраструктуру. Ова скрипта узима оригинални документ и његов документ његовог превода, па покушава да изгради одговарајући PO фајл. Таква ручна конверзија је прилично незграпна (за више детаља, погледајте L<po4a-gettextize(1)> документацију), али је неопходно да се обави само једном како би се конвертовали ваши постојећи преводи. Ако немате никакве преводе за конверзију, можете да заборавите на све ово и да се фокусирате на десни део схеме.

note: type: textblock
en: On the top right part, the action of the original author is depicted, updating the documentation.  The middle right part depicts the automatic updates of translation files: the new material is extracted and compared against the exiting translation. The previous translation is used for the parts that didn't change, while partially modified parts are connected to the previous translation with a "fuzzy" marker indicating that the translation must be updated. New or heavily modified material is left untranslated.
sr: У врху десног дела је приказана акција оригиналног аутора, освежавање документације.  Средњи десни део приказује аутоматска ажурирања фајлова превода: нови материјал се издваја и пореди са постојећим преводом. За делове који се нису изменили користиће се претходни превод, док се делимично измењени делови повезују са претходним преводом помоћу „fuzzy” ознаке која означава да превод мора да се ажурира. Нови или доста измењени материјал се оставља непреведен.

note: type: textblock
en: Then, the I<manual editing> block depicts the action of the translators, that modify the PO files to provide translations to every original string and paragraph. This can be done using either a specific editor such as the B<GNOME Translation Editor>, KDE's B<Lokalize> or B<poedit>, or using an online localization platform such as B<weblate> or B<pootle>. The translation result is a set of PO files, one per language. Please refer to the gettext documentation for more details.
sr: Затим, I<ручно уређивање> означава радњу преводилаца,који мењају PO фајлове како би обезбедили преводе за сваки оригинални стринг и пасус. Ово може да се обави било употребом специјализованог едитора као што је B<GNOME Translation Editor>, KDE-ов B<Lokalize> или B<poedit>, било употребом платформе за локализацију на мрежи као што је B<weblate> или B<pootle>. Резултат превода је скуп PO фајлова, по један за сваки језик. За више детаља, молимо вас погледајте gettext документацију.

note: type: textblock
en: The bottom part of the figure shows how B<po4a> creates a translated source document from the F<master.doc> original document and the F<doc.XX.po> translation catalog that was updated by the translators. The structure of the document is reused, while the original content is replaced by its translated counterpart. Optionally, an addendum can be used to add some extra text to the translation. This is often used to add the name of the translator to the final document. See below for details.
sr: Доњи део слике приказује како B<po4a> креира преведени изворни документ из F<master.doc> оригиналног документа и F<doc.XX.po> каталога превода који су преводиоци ажурирали. Поново се искоришћава структура документа, док се оригинални садржај замењује својим одговарајућим преводом. Необавезно, може да се употреби додатак како би се превод допунио неким додатним текстом. Ово се често користи да се дода име преводиоца финалном документу. Погледајте ниже за још детаља.

note: type: textblock
en: Upon invocation, B<po4a> updates both the translation files and the translated documentation files automatically.
sr: Када се покрене, B<po4a> аутоматски ажурира и фајлове превода и преведене фајлове документације.

note: type: =head2
en: Starting a new translation project
sr: Започињање новог пројекта превода

note: type: textblock
en: If you start from scratch, you just have to write a configuration file for po4a, and you are set.  The relevant templates are created for the missing files, allowing your contributors to translate your project to their language. Please refer to L<po4a(1)> for a quick start tutorial and for all details.
sr: Ако почињете од нуле, потребно је само да напишете конфигурациони фајл за po4a и спремни сте.  За фајлове који недостају се аутоматски креирају одговарајући шаблони, тако да сарадници могу почети да преводе ваш пројекат на свој језик. Молимо вас да погледате L<po4a(1)>. Тамо се налази туторијал за брзи почетак, као и сви детаљи.

note: type: textblock
en: If you have an existing translation, i.e. a documentation file that was translated manually, you can integrate its content in your po4a workflow using B<po4a-gettextize>. This task is a bit cumbersome (as described in the tool's manpage), but once your project is converted to po4a workflow, everything will be updated automatically.
sr: Ако имате постојећи превод, нпр, фајл документације који је ручно преведен, алатом B<po4a-gettextize> његов садржај можете да интегришете у po4a процес рада. Овај задатак је донекле напоран (као што је описано у man страници алата), али једном када се ваш пројекат конвертује у po4a процес рада, све ће се ажурирати аутоматски.

note: type: =head2
en: Updating the translations and documents
sr: Ажурирање превода и докумената

note: type: textblock
en: Once setup, invoking B<po4a> is enough to update both the translation PO files and translated documents. You may pass the C<--no-translations> to B<po4a> to not update the translations (thus only updating the PO files) or C<--no-update> to not update the PO files (thus only updating the translations). This roughly corresponds to the individual B<po4a-updatepo> and B<po4a-translate> scripts which are now deprecated (see "Why are the individual scripts deprecated" in the FAQ below).
sr: Једном када се подеси, покретање B<po4a> је довољно да се ажурирају и PO фајлови за превођење и преведени документи. Програму B<po4a> можете да проследите C<--no-translations> ако не желите да се ажурирају преводи (односно да се ажурирају само PO фајлови) или C<--no-update> ако не желите да се ажурирају PO фајлови (односно да се ажурирају само преводи). Ово отприлике одговара појединачним B<po4a-updatepo> и B<po4a-translate> скриптама које су сада застареле (погледајте „Зашто су појединачне скрипте застареле” у ЧПП испод).

note: type: =head2
en: Using addenda to add extra text to translations
sr: Употреба додатака за додавање додатног текста преводима

note: type: textblock
en: Adding new text to the translation is probably the only thing that is easier in the long run when you translate files manually :). This happens when you want to add an extra section to the translated document, not corresponding to any content in the original document. The classical use case is to give credits to the translation team, and to indicate how to report translation-specific issues.
sr: Додавање новог текста преводу је вероватно једина ствар која је једноставнија на дуже стазе у случају када фајлове преводите ручно :). Ове се дешава када желите да додате допунски одељак преведеном документу, који не одговара никаквом садржају оригиналног документа. Класични случај употребе је за одавање признања преводилачком тиму, као и да се наведе начин за пријаву проблема који се тичу превода.

note: type: textblock
en: With po4a, you have to specify B<addendum> files, that can be conceptually viewed as patches applied to the localized document after processing. Each addendum must be provided as a separate file, which format is however very different from the classical patches. The first line is a I<header line>, defining the insertion point of the addendum (with an unfortunately cryptic syntax -- see below) while the rest of the file is added verbatim at the determined position.
sr: Са po4a, морате да наведете B<додатак> фајлове, на које концептуално може да се гледа као на закрпе које се примењују над локализованим документом након обраде. Сваки додатак мора да се достави као посебан фајл, чији формат је међутим, веома различит у односу на класичне закрпе. Прва линија је I<линија заглавља>, која дефинише тачку уметања додатка (нажалост са криптичном синтаксом -- погледајте ниже) док се остатак фајла умеће дословно на одређену позицију.

note: type: textblock
en: The header line must begin with the string B<PO4A-HEADER:>, followed by a semi-colon separated list of I<key>B<=>I<value> fields.
sr: Линија заглавља мора да почне са стрингом B<PO4A-HEADER:>, након чега следи листа I<кључ>B<=>I<вредност> поља раздвојених са тачка запета знацима.

note: type: textblock
en: For example, the following header declares an addendum that must be placed at the very end of the translation.
sr: На пример, следеће заглавље декларише додатак који мора да се постави на сам крај превода.

note: type: textblock
en: Things are more complex when you want to add your extra content in the middle of the document. The following header declares an addendum that must be placed after the XML section containing the string C<About this document> in translation.
sr: Ствари постају компликованије када додатни садржај желите да поставите у средину документа. Наредно заглавље декларише додатак који у превод мора да се постави након XML одељка који садржи стринг C<У вези овог документа>.

note: type: verbatim
en:  PO4A-HEADER: position=About this document; mode=after; endboundary=</section>
sr:  PO4A-HEADER: position=У вези овог документа; mode=after; endboundary=</section>

note: type: textblock
en: In practice, when trying to apply an addendum, po4a searches for the first line matching the C<position> argument (this can be a regexp). Do not forget that po4a considers the B<translated> document here. This documentation is in English, but your line should probably read as follows if you intend your addendum to apply to the French translation of the document.
sr: У пракси, када покушава да примени додатак, програм po4a тражи прву линију која задовољава C<position> аргумент (то може да буде регуларни израз). Не заборавите да po4a овде разматра B<преведени> документ. Ова документација је на српском језику, али ваша линија би вероватно требало да изгледа као што следи, у случају да намеравате да свој додатак уметнете у француски превод.

note: type: textblock
en: Once the C<position> is found in the target document, po4a searches for the next line after the C<position> that matches the provided C<endboundary>. The addendum is added right B<after> that line (because we provided an I<endboundary>, i.e. a boundary ending the current section).
sr: Онда када се у циљном документу пронађе C<position>, програм po4a тражи следећу линију након C<position> која се подудара са наведеним C<endboundary>. Додатак се умеће непосредно B<иза> те линије (јер смо задали I<endboundary>, тј. границу на којој се завршава текући одељак).

note: type: textblock
en: The exact same effect could be obtained with the following header, that is equivalent:
sr: Потпуно исти ефекат би могао да се добије следећим еквивалентним заглављем:

note: type: verbatim
en:  PO4A-HEADER: position=About this document; mode=after; beginboundary=<section>
sr:  PO4A-HEADER: position=У вези овог документа; mode=after; beginboundary=<section>

note: type: textblock
en: Here, po4a searches for the first line matching C<< <section> >> after the line matching C<About this document> in the translation, and add the addendum B<before> that line since we provided a I<beginboundary>, i.e. a boundary marking the beginning of the next section. So this header line requires placing the addendum after the section containing C<About this document>, and instruct po4a that a section starts with a line containing the C<< <section> >> tag. This is equivalent to the previous example because what you really want is to add this addendum either after C<< </section> >> or before C<< <section> >>.
sr: Овде програм po4a тражи у преводу прву линију која се подудара са C<< <section> >> након линије која се подудара са C<У вези овог документа>, и умеће додатак B<испред> те линије, јер смо задали I<beginboundary>, тј. границу која означава почетак наредног одељка. Тако да ова линија заглавља захтева да се додатак постави иза одељка који садржи C<У вези овог документа>, и обавештава програм po4a да одељак започиње линијом која садржи ознаку C<< <section> >>. Ово је еквивалентно са претходним примером јер, у суштини, оно што заиста желите је да уметнете овај додатак иза C<< </section> >> или испред C<< <section> >>.

note: type: textblock
en: You can also set the insertion I<mode> to the value C<before>, with a similar semantic: combining C<mode=before> with an C<endboundary> will put the addendum just B<after> the matched boundary, that is the last potential boundary line before the C<position>. Combining C<mode=before> with an C<beginboundary> will put the addendum just B<before> the matched boundary, that is the last potential boundary line before the C<position>.
sr: Можете такође да поставите режим уметања I<mode> на вредност C<before>, са сличном семантиком: комбиновање C<mode=before> са C<endboundary> ће да постави додатак непосредно B<иза> пронађене границе, то јест последње потенцијалне граничне линије испред C<position>. Комбиновање C<mode=before> са C<beginboundary> ће да постави додатак непосредно B<испред> пронађене границе, то јест последње потенцијалне граничне линије испред C<position>.

note: type: verbatim
en:   Mode   | Boundary kind |     Used boundary      | Insertion point compared to the boundary
     ========|===============|========================|=========================================
     'before'| 'endboundary' | last before 'position' | Right after the selected boundary
     'before'|'beginboundary'| last before 'position' | Right before the selected boundary
     'after' | 'endboundary' | first after 'position' | Right after the selected boundary
     'after' |'beginboundary'| first after 'position' | Right before the selected boundary
     'eof'   |   (none)      |  n/a                   | End of file
sr:   Режим  | Врста границе |     Употребљена граница     | Место уметања гледано у односу на границу
     ========|===============|=============================|===========================================
     'before'| 'endboundary' | последња испред 'position'  | Непосредно иза изабране границе
     'before'|'beginboundary'| последња испред 'position'  | Непосредно испред изабране границе
     'after' | 'endboundary' | прва иза 'position'         | Непосредно иза изабране границе
     'after' |'beginboundary'| прва иза 'position'         | Непосредно испред изабране границе
     'eof'   |   (ништа)     |  нема                       | Крај фајла

note: type: =head3
en: Hint and tricks about addenda
sr: Савети и трикови у вези додатака

note: type: =item
en: Remember that these are regexp. For example, if you want to match the end of a nroff section ending with the line C<.fi>, do not use C<.fi> as B<endboundary>, because it will match with C<the[ fi]le>, which is obviously not what you expect. The correct B<endboundary> in that case is: C<^\.fi$>.
sr: Запамтите да су све ово регуларни изрази. На пример, ако желите да пронађете крај nroff одељка који се завршава са линијом C<.fi>, немојте да користите C<.fi> као B<endboundary>, јер ће то да пронађе C<the[ fi]le>, што очигледно није оно што очекујете. У овом случају, исправна вредност за B<endboundary> је: C<^\.fi$>.

note: type: =item
en: White spaces ARE important in the content of the C<position> and boundaries. So the two following lines B<are different>. The second one will only be found if there is enough trailing spaces in the translated document.
sr: Празни карактери у садржају C<position> и граница СУ БИТНИ. Тако да се наредне две линије B<разликују>. Друга ће да се пронађе само онда када у преведеном документу има довољно празних карактера на крају.

note: type: verbatim
en:  PO4A-HEADER: position=About this document; mode=after; beginboundary=<section>
     PO4A-HEADER: position=About this document ; mode=after; beginboundary=<section>
sr:  PO4A-HEADER: position=У вези овог документа; mode=after; beginboundary=<section>
     PO4A-HEADER: position=У вези овог документа ; mode=after; beginboundary=<section>

note: type: =item
en: Although this context search may be considered to operate roughly on each line of the B<translated> document, it actually operates on the internal data string of the translated document. This internal data string may be a text spanning a paragraph containing multiple lines or may be a XML tag itself alone. The exact I<insertion point> of the addendum must be before or after the internal data string and can not be within the internal data string.
sr: Мада се може помислити да се ова претрага контекста оквирно врши над сваком линијом B<преведеног> документа, она се у ствари врши над интерном стрингу података преведеног документа. Овај интерни стринг података може да буде текст који се протеже над пасусом који садржи више линија, или може да буде само једна XML ознака. Тачно I<место уметања> додатка мора да буде пре или након интерног стринга података и не може да се нађе унутар тог стринга података.

note: type: =item
en: Pass the C<-vv> argument to B<po4a> to understand how the addenda are added to the translation. It may also help to run B<po4a> in debug mode to see the actual internal data string when your addendum does not apply.
sr: Да бисте разумели како се додаци умећу у превод, проследите аргумент C<-vv> програму B<po4a>. Од помоћи је и да покренете програм B<po4a> у дибаг режиму јер тако можете да видите стварне интерне стрингове података у случају када се додатак не примењује.

note: type: =head3
en: Addenda examples
sr: Примери додатака

note: type: =item
en: If you want to add something after the following nroff section:
sr: Ако желите да додате нешто након следећег nroff одељка:

note: type: textblock
en: You should select a two-step approach by setting B<mode=after>. Then you should narrow down search to the line after B<AUTHORS> with the B<position> argument regex. Then, you should match the beginning of the next section (i.e., B<^\.SH>) with the B<beginboundary> argument regex. That is to say:
sr: Требало би да изаберете приступ у два корака постављањем B<mode=after>. Затим би требало да сузите претрагу на линију након B<AUTHORS> регуларним изразом за аргумент B<position>. Затим би требало да пронађете почетак наредног одељка (нпр. B<^\.SH>) помоћу регуларног израза за аргумент B<beginboundary>. Дакле:

note: type: =item
en: If you want to add something right after a given line (e.g. after the line "Copyright Big Dude"), use a B<position> matching this line, B<mode=after> and give a B<beginboundary> matching any line.
sr: Ако желите да додате нешто непосредно иза одређене линије (нпр. након линије „Права умножавања Велики Даса”), искористите B<position> које се подудара са том линијом, B<mode=after> и за B<beginboundary> задајте да се подудара са било којом линијом.

note: type: verbatim
en:  PO4A-HEADER:mode=after;position=Copyright Big Dude, 2004;beginboundary=^
sr:  PO4A-HEADER:mode=after;position=Права умножавања Велики Даса, 2004;beginboundary=^

note: type: =item
en: If you want to add something at the end of the document, give a B<position> matching any line of your document (but only one line. Po4a won't proceed if it's not unique), and give an B<endboundary> matching nothing. Don't use simple strings here like B<"EOF">, but prefer those which have less chance to be in your document.
sr: Ако желите нешто да додате на крај документа, поставите да се B<position> подудара са било којом линијом вашег документа (али само са једном линијом. Програм Po4a неће наставити даље ако није једна линија), и поставите да се B<endboundary> не подудара ни са чим. Овде немојте да користите једноставне стрингове као B<"EOF">, већ радије задајте оне за које је мала вероватноћа да постоје у вашем документу.

note: type: verbatim
en:  PO4A-HEADER:mode=after;position=About this document;beginboundary=FakePo4aBoundary
sr:  PO4A-HEADER:mode=after;position=У вези овог документа;beginboundary=ЛажнаPo4aГраница

note: type: =head3
en: More detailed example
sr: Детаљнији пример

note: type: textblock
en: Original document (POD formatted):
sr: Оригинални документ (POD форматиран):

note: type: verbatim
en:  |=head1 NAME
     |
     |dummy - a dummy program
     |
     |=head1 AUTHOR
     |
     |me
sr:  |=head1 NAME
     |
     |dummy - безвезе програм
     |
     |=head1 AUTHOR
     |
     |ја

note: type: textblock
en: Then, the following addendum will ensure that a section (in French) about the translator is added at the end of the file (in French, "TRADUCTEUR" means "TRANSLATOR", and "moi" means "me").
sr: Затим, следећи додатак ће обезбедити да се одељак (на француском) у вези преводиоца дода на крај фајла (на француском "TRADUCTEUR" значи "TRANSLATOR", а "moi" значи "me").

note: type: textblock
en: To put your addendum before the AUTHOR, use the following header:
sr: Да бисте уметнули свој додатак испред AUTHOR, употребите следеће заглавље:

note: type: textblock
en: This works because the next line matching the B<beginboundary> C</^=head1/> after the section "NAME" (translated to "NOM" in French), is the one declaring the authors. So, the addendum will be put between both sections. Note that if another section is added between NAME and AUTHOR sections later, po4a will wrongfully put the addenda before the new section.
sr: Ово функционише јер је наредна линија која се подудара са B<beginboundary> C</^=head1/> иза одељка "NAME" (преведено на "NOM" у француском), она која наводи ауторе. Дакле, додатак ће да се постави између ова два одељка. Приметите да ако се касније дода још један одељак између NAME и AUTHOR одељака, програм po4a ће погрешно да постави додатак испред тог новог одељка.

note: type: textblock
en: To avoid this you may accomplish the same using B<mode>=I<before>:
sr: Да бисте ово спречили, исти резултат можете да постигнете употребом B<mode>=I<before>:

note: type: =head1
en: How does it work?
sr: На који начин програм функционише?

note: type: textblock
en: This chapter gives you a brief overview of the po4a internals, so that you may feel more confident to help us to maintain and to improve it. It may also help you to understand why it does not do what you expected, and how to solve your problems.
sr: Ово поглавље ће да вам представи кратак преглед унутрашњих процеса у програму po4a, тако да нам можете са више самопоуздања помоћи да га одржавамо и унапређујемо. Такође може да вам помогне да разумете зашто не ради нешто што очекујете, као и да вам представи начине за решавање ваших проблема у раду са програмом.

note: type: =head2
en: TransTractors and project architecture
sr: TransTractor-и и архитектура пројекта

note: type: textblock
en: At the core of the po4a project, the L<Locale::Po4a::TransTractor(3pm)|TransTractor> class is the common ancestor to all po4a parsers. This strange name comes from the fact that it is at the same time in charge of translating document and extracting strings.
sr: У језгру po4a пројекта, класа L<Locale::Po4a::TransTractor(3pm)|TransTractor> је заједнички предак за све po4a парсере. Ово чудно име је последица чињенице да је она у исто време задужена и за превођење документа и за издвајање стрингова.

note: type: textblock
en: More formally, it takes a document to translate plus a PO file containing the translations to use as input while producing two separate outputs: Another PO file (resulting of the extraction of translatable strings from the input document), and a translated document (with the same structure as the input one, but with all translatable strings replaced with content of the input PO). Here is a graphical representation of this:
sr: Формалније речено, она узима документ који треба да се преведе као и PO фајл који садржи преводе који треба да се користе као улаз, а генерише два одвојена излаза: други PO фајл (произашао као резултат издвајања преводивих стрингова из улазног документа), и преведени документ (са истом структуром као и улазни документ, али са свим преводивим стринговима замењеним садржајем улазног PO). Ево графичке представе овога:

note: type: verbatim
en:    Input document --\                             /---> Output document
                         \      TransTractor::       /       (translated)
                          +-->--   parse()  --------+
                         /                           \
       Input PO --------/                             \---> Output PO
                                                           (extracted)
sr:    Улазни документ --\                             /---> Излазни документ
                          \      TransTractor::       /        (преведен)
                           +-->--   parse()  --------+
                          /                           \
       Улазни PO --------/                             \---> Излазни PO
                                                             (издвојен)

note: type: textblock
en: This little bone is the core of all the po4a architecture. If you provide both input and disregard the output PO, you get B<po4a-translate>. If you disregard the output document instead, you get B<po4a-updatepo>. The B<po4a> uses a first TransTractor to get an up-to-date output POT file (disregarding the output documents), calls B<msgmerge -U> to update the translation PO files on disk, and builds a second TransTractor with these updated PO files to update the output documents. In short, B<po4a> provides one-stop solution to update what needs to be, using a single configuration file.
sr: Ова мала кост је срж целе po4a архитектуре. Ако наведете оба улаза и одбаците излазни PO, добијате B<po4a-translate>. Ако уместо тода одбаците излазни документ, добијате B<po4a-updatepo>. Програм B<po4a> користи први TransTractor да добије ажурирани POT фајл (одбацујући излазне документе), затим позива B<msgmerge -U> да ажурира PO фајлове превода на диску и изграђује други TransTractor са овим ажурираним PO фајловима да би ажурирао излазне документе. Укратко, B<po4a> обезбеђује решење које у једном кораку ажурира све што је потребно, уз употребу само једног конфигурационог фајла.

note: type: textblock
en: B<po4a-gettextize> also uses two TransTractors, but another way: It builds one TransTractor per language, and then build a new PO file using the msgids of the original document as msgids, and the msgids of the translated document as msgstrs. Much care is needed to ensure that the strings matched this way actually match, as described in L<po4a-gettextize(1)>.
sr: B<po4a-gettextize> такође користи два TransTractor-а, али на другачији начин: он изграђује по један TransTractor за сваки језик, па онда изграђује нови PO фајл чији су msgid стрингови msgid стрингови оригиналног документа, а msgstr стрингови msgid стрингови преведеног документа. Да би се обезбеило да се стрингови подударени на овакав начин и заиста подударају, потребно је много труда, као што је описано у L<po4a-gettextize(1)>.

note: type: =head2
en: Format-specific parsers
sr: Парсери за одређене формате

note: type: textblock
en: All po4a format parsers are implemented on top of the TransTractor. Some of them are very simple, such as the Text, Markdown and AsciiDoc ones. They load the lines one by one using C<TransTractor::shiftline()>, accumulate the paragraphs' content or whatever. Once a string is completely parsed, the parser uses C<TransTractor::translate()> to (1) add this string to the output PO file and (2) get the translation from the input PO file. The parser then pushes the result to the output file using C<TransTractor::pushline()>.
sr: Сви po4a парсери формата се имплементирају преко TransTractor. Неки од њих су врло једноставни, као што су Text, Markdown и AsciiDoc. Они читају једну по једну линију користећи C<TransTractor::shiftline()>, акумулирају садржаје пасуса или шта већ. Онда када се стринг у потпуности парсира, парсер користи C<TransTractor::translate()> да (1) уметне овај стринг у излазни PO фајл и (2) преузме превод из улазног PO фајла. Парсер затим гура резултат у излазни фајл користећи C<TransTractor::pushline()>.

note: type: textblock
en: Some other parsers are more complex because they rely on an external parser to analyze the input document. The Xml, HTML, SGML and Pod parsers are built on top of SAX parsers. They declare callbacks to events such as "I found a new title which content is the following" to update the output document and output POT files according to the input content using C<TransTractor::translate()> and C<TransTractor::pushline()>. The Yaml parser is similar but different: it serializes a data structure produced by the YAML::Tiny parser. This is why the Yaml module of po4a fails to declare the reference lines: the location of each string in the input file is not kept by the parser, so we can only provide "$filename:1" as a string location. The SAX-oriented parsers use globals and other tricks to save the file name and line numbers of references.
sr: Неки други парсеру су сложенији јер се за анализу улазног документа ослањају на спољни парсер. Xml, HTML, SGML и Pod парсери су изграђени преко SAX парсера. Они декларишу функције повратног позива на догађаје као што је „Пронашао сам нови наслов чији је садржај следеће” којима ажурирају излазни документ и излазне POT фајлове у сагласности са садржајем на улазу користећи C<TransTractor::translate()> и C<TransTractor::pushline()>. Yaml парсер је сличан, али ипак различит: он серијализује структуру података коју прави YAML::Tiny парсер. То је разлог што Yaml модул програма po4a не успева да декларише линије референци: парсер не чува локацију сваког стринга у улазном фајлу, тако да једино можемо навести „$filename:1” као стринг локације. Парсери засновани на SAX користе глобале и остале трикове за чување референци на имена фајлова и бројеве линија.

note: type: textblock
en: One specific issue arises from file encodings and BOM markers. Simple parsers can forget about this issue, that is handled by C<TransTractor::read()> (used internally to get the lines of an input document), but the modules relying on an external parser must ensure that all files are read with an appropriate PerlIO decoding layer. The easiest is to open the file yourself, and provide an filehandle or directly the full string to your external parser. Check on C<Pod::read()> and C<Pod::parse()> for an example. The content read by the TransTractor is ignored, but a fresh filehandle is passed to the external parser. The important part is the C<< "<:encoding($charset)" >> mode that is passed to the B<open()> perl function.
sr: Један посебан проблем настаје услед кодирања фајла и BOM маркера. Прости парсеру могу да забораве на проблем, то се обрађује у C<TransTractor::read()> (користи се интерно за читање линија улазног документа), али модули који се ослањају на спољни парсер морају обезбедити да се сви фајлови читају одговарајућим PerlIO слојем за декодирање. Најједноставнији начин је да сами отворите фајл, па да свом спољном парсеру проследите ручку фајла, или директно комплетни стринг. Погледајте C<Pod::read()> и C<Pod::parse()> на пример. Садржај који чита TransTractor се игнорише, али се спољном парсеру прослеђује свежа ручка фајла. Важан део је C<< "<:encoding($charset)" >> режим који се прослеђује B<open()> perl функцији.

note: type: =head2
en: Po objects
sr: Po објекти

note: type: textblock
en: The L<Locale::Po4a::Po(3pm)|Po> class is in charge of loading and using PO and POT files. Basically, you can read a file, add entries, get translations with the B<gettext()> method, write the PO into a file. More advanced features such as merging a PO file against a POT file or validating a file are delegated to B<msgmerge> and B<msgfmt> respectively.
sr: Класа L<Locale::Po4a::Po(3pm)|Po> је задужена за учитавање и употребу PO и POT фајлова. Тачније, можете да читате фајл, додајете ставке, преузимате преводи B<gettext()> методом, уписујете PO у фајл. Напредније функције као што је спајање PO фајла у односу на POT фајл или потврђивање фајла се делегирају програмима B<msgmerge> и B<msgfmt> редом.

note: type: =head2
en: Contributing to po4a
sr: Давање доприноса пројекту po4a

note: type: textblock
en: Even if you have never contributed to any Open Source project in the past, you are welcome: we are willing to help and mentor you here. po4a is best maintained by its users nowadays. As we lack manpower, we try to make the project welcoming by improving the doc and the automatic tests to make you confident in contributing to the project. Please refer to the CONTRIBUTING.md file for more details.
sr: Чак и ако никада раније нисте дали допринос ниједном пројекту Отвореног кода, добродошли: вољни смо да вам помогнемо и да овде будемо ваш ментор. Данас po4a најбоље одржавају његови корисници. Пошто нам недостаје радне снаге, покушавамо да пројекат учинимо приступачнијим тако што унапређујемо документацију и аутоматске тестове тако да осетите поузданост приликом давања доприноса пројекту. За више детаља, молимо вас да погледате CONTRIBUTING.md фајл.

note: type: =head1
en: Open-source projects using po4a
sr: Пројекти отвореног кода који користе po4a

note: type: textblock
en: Here is a very partial list of projects that use po4a in production for their documentation. If you want to add your project to the list, just drop us an email (or a Merge Request).
sr: Следи веома делимична листа пројеката који за своју документацију у продукцији користе po4a. Ако свој пројекат желите да додате на ову листу, само нам пошаљите мејл (или Merge захтев).

note: type: =item
en: adduser (man): users and groups management tool.
sr: adduser (man): алат за управљање корисницима и групама.

note: type: =item
en: apt (man, docbook): Debian package manager.
sr: apt (man, docbook): Debian менаџер пакета.

note: type: =item
en: aptitude (docbook, svg): terminal-based package manager for Debian
sr: aptitude (docbook, svg): терминалски менаџер пакета за Debian

note: type: =item
en: L<F-Droid website|https://gitlab.com/fdroid/fdroid-website> (markdown): installable catalog of FOSS (Free and Open Source Software) applications for the Android platform.
sr: L<F-Droid вебсајт|https://gitlab.com/fdroid/fdroid-website> (markdown): каталог FOSS (Free and Open Source Software) апликација за Андроид платформу које могу да се инсталирају.

note: type: =item
en: L<git|https://github.com/jnavila/git-manpages-l10n> (asciidoc): distributed version-control system for tracking changes in source code.
sr: L<git|https://github.com/jnavila/git-manpages-l10n> (asciidoc): дистрибуирани систем за контролу верзија који служи за праћење измена у изворном коду.

note: type: =item
en: L<Linux manpages|https://salsa.debian.org/manpages-l10n-team/manpages-l10n> (man)
sr: L<Linux manстране|https://salsa.debian.org/manpages-l10n-team/manpages-l10n> (man)

note: type: textblock
en: This project provides an infrastructure for translating many manpages to different languages, ready for integration into several major distributions (Arch Linux, Debian and derivatives, Fedora).
sr: Овај пројекат обезбеђује инфраструктуру за превођење многих manстраница на различите језике, спремне за интеграцију у неколико главних дистрибуција (Arch Linux, Debian и из њега изведене, Fedora).

note: type: =item
en: L<Stellarium|https://github.com/Stellarium/stellarium> (HTML): a free open source planetarium for your computer. po4a is used to translate the sky culture descriptions.
sr: L<Stellarium|https://github.com/Stellarium/stellarium> (HTML): бесплатан планетаријум отвореног кода за ваш компјутер. po4a се користи за превод описа небеске културе.

note: type: =item
en: L<Jamulus|https://jamulus.io/> (markdown, yaml, HTML): a FOSS application for online jamming in real time. The website documentation is maintained in multiple languages using po4a.
sr: L<Jamulus|https://jamulus.io/> (markdown, yaml, HTML): FOSS апликација за онлајн jamming у реалном времену. Документација веб сајта се одржава на више језика помоћу po4a.

note: type: =item
en: Other item to sort out: L<https://gitlab.com/fdroid/fdroid-website/> L<https://github.com/fsfe/reuse-docs/pull/61>
sr: Још једна ставка која треба да се среди: L<https://gitlab.com/fdroid/fdroid-website/> L<https://github.com/fsfe/reuse-docs/pull/61>

note: type: =head1
en: FAQ
sr: ЧПП

note: type: =head2
en: How do you pronounce po4a?
sr: Како се изговара po4a?

note: type: textblock
en: I personally vocalize it as L<pouah|https://en.wiktionary.org/wiki/pouah>, which is a French onomatopoetic that we use in place of yuck :) I may have a strange sense of humor :)
sr: Ја га лично изговарам као L<pouah|https://en.wiktionary.org/wiki/pouah>, што је француска ономатопејска реч коју користимо уместо бљак :) Вероватно имам чудан смисао за хумор :)

note: type: =head2
en: Why are the individual scripts deprecated?
sr: Зашто су појединачне скрипте застареле?

note: type: textblock
en: Indeed, B<po4a-updatepo> and B<po4a-translate> are deprecated in favor of B<po4a>. The reason is that while B<po4a> can be used as a drop-in replacement to these scripts, there is quite a lot of code duplication here. Individual scripts last around 150 lines of codes while the B<po4a> program lasts 1200 lines, so they do a lot in addition of the common internals. The code duplication results in bugs occurring in both versions and needing two fixes. One example of such duplication are the bugs #1022216 in Debian and the issue #442 in GitHub that had the exact same fix, but one in B<po4a> and the other B<po4a-updatepo>.
sr: Заиста, B<po4a-updatepo> и B<po4a-translate> су застареле, сада се користи само B<po4a>. Разлог је тај што B<po4a> може да се користи као директна замена за ове скритпте, тако да постоји много дуплираног кода. Појединачне скрипте имају око 150 линија кода док програм B<po4a> има 1200 линија, тако да раде много тога додатно, а не само опште интерне ствари. Резултат дуплирања кода су багови који се јављају у ове верзије и за које је потребна исправка на два места. Један пример таквог дупликата су багови #1022216 у Дебијану и проблем #442 на GitHub који су имали потпуно исту исправку, али једну у B<po4a> а другу у B<po4a-updatepo>.

note: type: textblock
en: In the long run, I would like to drop the individual scripts and only maintain one version of this code. The sure thing is that the individual scripts will not get improved anymore, so only B<po4a> will get the new features. That being said, there is no deprecation urgency. I plan to keep the individual scripts as long as possible, and at least until 2030. If your project still use B<po4a-updatepo> and B<po4a-translate> in 2030, you may have a problem.
sr: На дуже стазе, желео бих да укинем појединачне скрипте и да одржавам само једну верзију овог кода. Оно што је сигурно је то да се појединачне скрипте више неће унепређивати, тако да ће само B<po4a> добијати нове функционалности. С друге стране, нема хитности око застаревања. Планирам да појединачне скрипте чувам што је могуће дуже, барем до 2030. године. Ако ваш пројекат у 2030. још увек користи B<po4a-updatepo> и B<po4a-translate> можда ћете наићи на проблем.

note: type: textblock
en: We may also remove the deprecation of these scripts at some point, if a refactoring reduces the code duplication to zero. If you have an idea (or better: a patch), your help is welcome.
sr: Можда у неком тренутки и укинемо застаревање ових скрипти, ако рефакторисање сведе диплирање кода на нулу. Ако имате идеју (или још боље: закрпу), ваша помоћ је добродошла.

note: type: =head2
en: What about the other translation tools for documentation using gettext?
sr: Шта је са осталим алатима за превођење документације помоћу gettext?

note: type: textblock
en: There are a few of them. Here is a possibly incomplete list, and more tools are coming at the horizon.
sr: Има их неколико. Ево вероватно непотпуне листе, са још алата који су близу хоризонта.

note: type: textblock
en: This is the tool developed by KDE people to handle DocBook XML. AFAIK, it was the first program to extract strings to translate from documentation to PO files, and inject them back after translation.
sr: Ово је алат који су развили KDE људи за обраду DocBook XML. Колико ја знам, то је први програм који издваја из документације стрингове за превод у PO фајлове, па их након превођења умеће назад.

note: type: textblock
en: It can only handle XML, and only a particular DTD. I'm quite unhappy with the handling of lists, which end in one big msgid. When the list become big, the chunk becomes harder to swallow.
sr: Он може да ради само са XML форматом, и само са одређеним DTD. Посебно нисам задовољан начином на који обрађује листе, које на крају постају један велики msgid. Када листа постане велика, залогај постаје тежак за гутање.

note: type: textblock
en: This program done by Denis Barbier is a sort of precursor of the po4a SGML module, which more or less deprecates it. As the name says, it handles only the DebianDoc DTD, which is more or less a deprecated DTD.
sr: Овај програм који је урадио Дени Барбије представља неку врсту претече po4a SGML модула, који га мање-више чини застарелим. Као што име говори, он обрађује само DebianDoc DTD, што је такође мање-више застарео DTD.

note: type: textblock
en: Used by the GIMP Documentation Team since 2004, works quite well even if, as the name suggests, only with XML files and needs specially configured makefiles.
sr: Употребљава GIMP Тим за документацију од 2004. године, функционише прилично добро упркос томе што, као што име наговештава, ради само са XML фајловима и захтева специјално конфигурисане makefile фајлове.

note: type: textblock
en: The Sphinx Documentation Project also uses gettext extensively to manage its translations. Unfortunately, it works only for a few text formats, rest and markdown, although it is perhaps the only tool that does this managing the whole translation process.
sr: За управљање својим преводима, Sphinx Documentation Project такође доста користи gettext. Нажалост, функционише само за неколико текст формата, rest и markdown, мада је вероватно једини алат који то ради управљајући комплетним процесом превођења.

note: type: textblock
en: The main advantages of po4a over them are the ease of extra content addition (which is even worse there) and the ability to achieve gettextization.
sr: Главне предности програма po4a над њима је једноставност уметања додатног садржаја (која је тамо још гора) и могућност постизања gettextизације.

note: type: =head2
en: SUMMARY of the advantages of the gettext based approach
sr: РЕЗИМЕ предности приступа базираног на gettext

note: type: =item
en: The translations are not stored along with the original, which makes it possible to detect if translations become out of date.
sr: Преводи се не чувају заједно са оригиналом, чиме је омогућено да се открије застарелост превода.

note: type: =item
en: The translations are stored in separate files from each other, which prevents translators of different languages from interfering, both when submitting their patch and at the file encoding level.
sr: Преводи се чувају засебно у одвојеним фајловима, чиме се спречава међусобно ометање преводиоца различитих језика, како током предаје својих закрпа тако и на нивоу кодирања фајла.

note: type: =item
en: It is based internally on B<gettext> (but B<po4a> offers a very simple interface so that you don't need to understand the internals to use it).  That way, we don't have to re-implement the wheel, and because of their wide use, we can think that these tools are more or less bug free.
sr: Интерно је заснован на B<gettext> (мада B<po4a> нуди веома једноставан интерфејс, тако да не морате разумети унутрашње функционисање да бисте га користили). На тај начин не морамо поново да откријемо рупу на саксији, а из разлога што су ти алати широко распрострањени, можемо претпоставити и да су мање-више ослобођени багова.

note: type: =item
en: Nothing changed for the end-user (beside the fact translations will hopefully be better maintained). The resulting documentation file distributed is exactly the same.
sr: За крајње кориснике ништа није промењено (осим чињенице да ће највероватније боље да одржавају преводе). Резултујући фајл документације који се дистрибуира је потпуно исти.

note: type: =item
en: No need for translators to learn a new file syntax and their favorite PO file editor (like Emacs' PO mode, Lokalize or Gtranslator) will work just fine.
sr: Нема потребе да преводиоци уче нову синтаксу фајлова и њихов омиљени едитор PO фајлова (као што су Емаксов PO режим, Lokalize или Gtranslator) ће сасвим лепо да функционише.

note: type: =item
en: gettext offers a simple way to get statistics about what is done, what should be reviewed and updated, and what is still to do. Some example can be found at those addresses:
sr: gettext обезбеђује једноставан начин за добијање статистика у вези онога што је урађено, онога што треба да се редигује и ажурира, као и онога што је још преостало да се уради. Неки пример може да се пронађе на следећим адресама:

note: type: textblock
en: But everything isn't green, and this approach also has some disadvantages we have to deal with.
sr: Али није све тако сјајно, овај приступ има и неке лоше стране са којима морамо да се носимо.

note: type: =item
en: Addenda are somewhat strange at the first glance.
sr: Додаци су на први поглед донекле чудни.

note: type: =item
en: You can't adapt the translated text to your preferences, like splitting a paragraph here, and joining two other ones there. But in some sense, if there is an issue with the original, it should be reported as a bug anyway.
sr: Преведени текст не можете да прилагодите по свом нахођењу, као на пример, да овде поделите пасус, а онде спојите друга два. Мада у неку руку, ако постоји проблем са оригиналом, то би у сваком случају требало да се пријави као баг.

note: type: =item
en: Even with an easy interface, it remains a new tool people have to learn.
sr: Чак и са једноставним интерфејсом, он је ипак нови алат који људи морају научити како да користе.

note: type: textblock
en: One of my dreams would be to integrate somehow po4a to Gtranslator or Lokalize. When a documentation file is opened, the strings are automatically extracted, and a translated file + po file can be written to disk. If we manage to do an MS Word (TM) module (or at least RTF) professional translators may even use it.
sr: Један од мојих снова би био да некако интегришемо po4a у Gtranslator или Lokalize. Када се фајл документације отвори, стрингови се аутоматски издвоје, и преведени фајл + po фајл могу да се упишу на диск. Ако успемо да урадимо MS Word (TM) модул (или макар RTF) можда би га чак користили и професионални преводиоци.

note: type: =item
en: The documentation of the all-in-one tool that you should use: L<po4a(1)>.
sr: Документација све-у-једном алата који би требало да користите: L<po4a(1)>.

note: type: =item
en: The documentation of the individual po4a scripts: L<po4a-gettextize(1)>, L<po4a-updatepo(1)>, L<po4a-translate(1)>, L<po4a-normalize(1)>.
sr: Документација појединачних po4a скрипти: L<po4a-gettextize(1)>, L<po4a-updatepo(1)>, L<po4a-translate(1)>, L<po4a-normalize(1)>.

note: type: =item
en: The additional helping scripts: L<msguntypot(1)>, L<po4a-display-man(1)>, L<po4a-display-pod(1)>.
sr: Додатне помоћне скрипте: L<msguntypot(1)>, L<po4a-display-man(1)>, L<po4a-display-pod(1)>.

note: type: =item
en: The parsers of each formats, in particular to see the options accepted by each of them: L<Locale::Po4a::AsciiDoc(3pm)> L<Locale::Po4a::Dia(3pm)>, L<Locale::Po4a::Gemtext(3pm)>, L<Locale::Po4a::Guide(3pm)>, L<Locale::Po4a::Ini(3pm)>, L<Locale::Po4a::KernelHelp(3pm)>, L<Locale::Po4a::Man(3pm)>, L<Locale::Po4a::RubyDoc(3pm)>, L<Locale::Po4a::Texinfo(3pm)>, L<Locale::Po4a::Text(3pm)>, L<Locale::Po4a::Xhtml(3pm)>, L<Locale::Po4a::Yaml(3pm)>, L<Locale::Po4a::BibTeX(3pm)>, L<Locale::Po4a::Docbook(3pm)>, L<Locale::Po4a::Halibut(3pm)>, L<Locale::Po4a::LaTeX(3pm)>, L<Locale::Po4a::Org(3pm)>, L<Locale::Po4a::Pod(3pm)>, L<Locale::Po4a::SimplePod(3pm)>, L<Locale::Po4a::Sgml(3pm)>, L<Locale::Po4a::TeX(3pm)>, L<Locale::Po4a::VimHelp>, L<Locale::Po4a::Wml(3pm)>, L<Locale::Po4a::Xml(3pm)>.
sr: Парсери сваког од формата, тачније, да сазнате које опције прихвата сваки од њих: L<Locale::Po4a::AsciiDoc(3pm)> L<Locale::Po4a::Dia(3pm)>, L<Locale::Po4a::Gemtext(3pm)> L<Locale::Po4a::Guide(3pm)>, L<Locale::Po4a::Ini(3pm)>, L<Locale::Po4a::KernelHelp(3pm)>, L<Locale::Po4a::Man(3pm)>, L<Locale::Po4a::RubyDoc(3pm)>, L<Locale::Po4a::Texinfo(3pm)>, L<Locale::Po4a::Text(3pm)>, L<Locale::Po4a::Xhtml(3pm)>, L<Locale::Po4a::Yaml(3pm)>, L<Locale::Po4a::BibTeX(3pm)>, L<Locale::Po4a::Docbook(3pm)>, L<Locale::Po4a::Halibut(3pm)>, L<Locale::Po4a::LaTeX(3pm)>, L<Locale::Po4a::Org(3pm)>, L<Locale::Po4a::Pod(3pm)>, L<Locale::Po4a::SimplePod(3pm)>, L<Locale::Po4a::Sgml(3pm)>, L<Locale::Po4a::TeX(3pm)>, L<Locale::Po4a::VimHelp>, L<Locale::Po4a::Wml(3pm)>, L<Locale::Po4a::Xml(3pm)>.

note: type: =item
en: The implementation of the core infrastructure: L<Locale::Po4a::TransTractor(3pm)> (particularly important to understand the code organization), L<Locale::Po4a::Chooser(3pm)>, L<Locale::Po4a::Po(3pm)>, L<Locale::Po4a::Common(3pm)>. Please also check the F<CONTRIBUTING.md> file in the source tree.
sr: Имплементација основне инфраструктуре: L<Locale::Po4a::TransTractor(3pm)> (од посебне важности за разумевање организације кода), L<Locale::Po4a::Chooser(3pm)>, L<Locale::Po4a::Po(3pm)>, L<Locale::Po4a::Common(3pm)>. Молимо вас да у стаблу изворног кода такође погледате и фајл F<CONTRIBUTING.md>.

note: type: verbatim
en:  Denis Barbier <barbier,linuxfr.org>
     Martin Quinson (mquinson#debian.org)
sr:  Дени Барбије <barbier,linuxfr.org>
     Мартин Квинсон (mquinson#debian.org)

note: type: textblock
en: Locale::Po4a::AsciiDoc - convert AsciiDoc documents from/to PO files
sr: Locale::Po4a::AsciiDoc - двосмерна конверзија AsciiDoc докумената и PO фајлова

note: type: textblock
en: Locale::Po4a::AsciiDoc is a module to help the translation of documentation in the AsciiDoc format.
sr: Locale::Po4a::AsciiDoc је модул који помаже превођење докумената у AsciiDoc формату.

note: type: =head1
en: OPTIONS ACCEPTED BY THIS MODULE
sr: ОПЦИЈЕ КОЈЕ ПРИХВАТА ОВАЈ МОДУЛ

note: type: textblock
en: These are this module's particular options:
sr: Ово су опције везане само за овај модул:

note: type: textblock
en: The name of a file containing definitions for po4a, as defined in the B<INLINE CUSTOMIZATION> section.  You can use this option if it is not possible to put the definitions in the document being translated.
sr: Име фајла који садржи дефиниције за po4a, као што је дефинисано у одељку B<ПРИЛАГОЂАВАЊЕ ИЗ САМОГ ФАЈЛА>. Ову опцију можете користити у случају да није могуће постављање дефиниција у документ који се преводи.

note: type: textblock
en: In a definitions file, lines must not start by two slashes, but directly by B<po4a:>.
sr: У фајлу дефиниција, линије не смеју да почну са две косе линије, већ директно са B<po4a:>.

note: type: textblock
en: Space-separated list of attribute entries you want to translate.  By default, no attribute entries are translatable.
sr: Листа ставки атрибута раздвојених размацима које желите да преведете. Подразумевано је да ниједна ставка атрибута не може да се преведе.

note: type: textblock
en: Space-separated list of macro definitions.
sr: Листа макро дефиниција раздвојених размацима.

note: type: textblock
en: Space-separated list of style definitions.
sr: Листа дефиниција стилова раздвојених размацима.

note: type: textblock
en: Enable automatic line wrapping in non-verbatim blocks, even if the result could be misinterpreted by AsciiDoc formatters.
sr: Укључује аутоматско обавијање линија за блокове који се не наводе дословно, чак и ако би AsciiDoc форматери могли погрешно да интерпретирају резултат.

note: type: textblock
en: By default, po4a will not wrap the produced AsciiDoc files because a manual inspection is mandated to ensure that the wrapping does not change the formatting. Consider for instance the following list item:
sr: Програм po4a подразумевано неће да обавија направљене AsciiDoc фајлове јер је обавезна ручна провера како би се обезбедило да обавијање не промени форматирање. Узмите на пример следећу ставку листе:

note: type: verbatim
en:  * a long sentence that is ending with a number 1. A second sentence.
sr:  * веома дугачка реченица која се завршава бројем 1. Друга реченица.

note: type: textblock
en: If the wrapping leads to the following presentation, the item is split into a numbered sub-list. To make things worse, only the speakers of the language used in the translation can inspect the situation.
sr: Ако обавијање доведе до оваквог представљања, ставка се дели у нумерисану подлисту. Да ствар буде још гора, ситуацију може да испита само особа која говори језик коришћен у преводу.

note: type: verbatim
en:  * a long sentence that is ending with a number
       1. A second sentence.
sr:  * веома дугачка реченица која се завршава бројем
       1. Друга реченица.

note: type: textblock
en: Note that not wrapping the files produced by po4a should not be a problem since those files are meant to be processed automatically.  They should not be regarded as source files anyway.
sr: Приметите да необавијање фајлова које производи програм po4a не би требало да представља проблем, јер су ти фајлови намењени аутоматској обради. Они свакако не би требало да се посматрају као изворни фајлови.

note: type: textblock
en: With this option, po4a will produce better-looking AsciiDoc files, but it may lead to possibly erroneous formatted outputs.
sr: Помоћу ове опције програм po4a ће направити AsciiDoc фајлове који изгледају лепше, али који потенцијално могу да доведу до погрешно форматирних излазних докумената.

note: type: textblock
en: By default, the targets of block images are translatable to give opportunity to make the content point to translated images. This can be stopped by setting this option.
sr: Подразумевано је могуће да се циљеви блок слика преводе како би се омогућило да садржај показује на преведене слике. То може да се заустави постављањем ове опције.

note: type: textblock
en: This option is a flag that enables sub-table segmentation into cell content.  The segmentation is limited to cell content, without any parsing inside of it.
sr: Ова опција је заставица која омогућава сегментацију подтабела у садржај ћелије. Сегментација је ограничена само на садржај ћелије, без било каквог парсирања унутар ње.

note: type: textblock
en: Switch parsing rules to compatibility with different tools. Available options are "asciidoc" or "asciidoctor". Asciidoctor has stricter parsing rules, such as equality of length of opening and closing block fences.
sr: Укључује компатибилност парсирања правила са различитим алатима. Доступне опције су "asciidoc" или "asciidoctor". Asciidoctor има строжија правила парсирања, као што је једнакост дужина отварајућих и затварајућих ограда блока.

note: type: textblock
en: Disable linting messages. When the source code cannot be fixed for clearer document structure, these messages are useless.
sr: Искључује линтинг поруке. Када изворни кôд не може да се поправи тако да се добије чистија структура документа, ове поруке су бескорисне.

note: type: textblock
en: Remove extra spaces from the source segments in no-wrap mode. This is useful when the translation tools are sensitive to the number of spaces.
sr: Уклања вишак размака из изворних сегмената у no-wrap режиму. Ово је корисно када су алати за превођење осетљиви на број размака.

note: type: textblock
en: Comma-separated list of keys to process for translation in the YAML Front Matter section. All other keys are skipped. Keys are matched with a case-sensitive match. If B<yfm_paths> and B<yfm_keys> are used together, values are included if they are matched by at least one of the options. Array values are always translated, unless the B<yfm_skip_array> option is provided.
sr: Листа кључева раздвојених запетама који треба да се обраде за превод у YAML Front Matter одељку. Сви остали кључеви се прескачу. При подударању кључева се води рачуна о разлици малих и великих слова. Ако се B<yfm_paths> и B<yfm_keys> употребе заједно, вредности се укључују ако се подударају са барем једном од њих. Вредности низа се увек преводе, осим у случају када је постављена опција B<yfm_skip_array>.

note: type: textblock
en: Do not translate array values in the YAML Front Matter section.
sr: Вредности типа низ у YAML Front Matter одељку се не преводе.

note: type: textblock
en: Comma-separated list of hash paths to process for extraction in the YAML Front Matter section, all other paths are skipped. Paths are matched with a case-sensitive match. If B<yfm_paths> and B<yfm_keys> are used together, values are included if they are matched by at least one of the options.  Arrays values are always returned unless the B<yfm_skip_array> option is provided.
sr: Листа хеш путања раздвојених запетама који треба да се обраде за издвајање у YAML Front Matter одељку, све остале путање се прескачу. При подударању путања се води рачуна о разлици малих и великих слова. Ако се B<yfm_paths> и B<yfm_keys> употребе заједно, вредности се укључују ако се подударају са барем једном од опција. Вредности низова се увек враћају, осим у случају када је постављена опција B<yfm_skip_array>.

note: type: =head1
en: INLINE CUSTOMIZATION
sr: ПРИЛАГОЂАВАЊЕ ИЗ САМОГ ФАЈЛА

note: type: textblock
en: The AsciiDoc module can be customized with lines starting by B<//po4a:>.  These lines are interpreted as commands to the parser.  The following commands are recognized:
sr: AsciiDoc модул може да се прилагоди линијама које почињу са B<//po4a:>. Ове линије се интерпретирају као команде парсера. Препознају се следеће команде:

note: type: =item
en: B<//po4a: macro >I<name>B<[>I<attribute list>B<]>
sr: B<//po4a: macro >I<име>B<[>I<листа атрибута>B<]>

note: type: textblock
en: This describes in detail the parameters of a B<macro>; I<name> must be a valid macro name, and it ends with an underscore if the target must be translated.
sr: Ово детаљно описује параметре за B<макро>; I<име> мора да буде важеће име макроа, и да се завршава доњом цртом у случају да циљ мора да се преведе.

note: type: textblock
en: The I<attribute list> argument is a comma separated list which contains information about translatable arguments.  This list contains either numbers, to define positional parameters, or named attributes.
sr: Аргумент I<листа атрибута> је листа раздвојена зарезима која садржи информације о аргументима који могу да се преведу. Ова листа садржи или бројеве, који дефинишу позиционе параметре, или именоване атрибуте.

note: type: textblock
en: If a plus sign (B<+>) is prepended to I<name>, then the macro and its arguments are translated as a whole.  There is no need to define attribute list in this case, but brackets must be present.
sr: Ако се испред аргумента I<name> стави знак плус (B<+>), онда се макро и његови аргументи преводе као целина. У овом случају нема потребе да се дефинише листа аргумената, али је потребно да постоје угласте заграде.

note: type: =item
en: B<//po4a: style >B<[>I<attribute list>B<]>
sr: B<//po4a: style >B<[>I<листа атрибута>B<]>

note: type: textblock
en: This describes in detail which attributes of a style must be translated.
sr: Ово детаљно описује који атрибути стила морају да се преведу.

note: type: textblock
en: The I<attribute list> argument is a comma separated list which contains information about translatable arguments.  This list contains either numbers, to define positional parameters, or named attributes.  The first attribute is the style name, it will not be translated.
sr: Аргумент I<листа атрибута> је листа раздвојена зарезима која садржи информације о аргументима који могу да се преведу. Ова листа садржи или бројеве, којима се дефинишу позициони параметри, или именоване атрибуте. Први атрибут је име стила, и он неће да се преводи.

note: type: textblock
en: If a plus sign (B<+>) is prepended to the style name, then the attribute list is translated as a whole.  There is no need to define translatable attributes.
sr: У случају да се испред имена стила стави знак плус (B<+>), листа атрибута се преводи као целина. Нама потребе да се дефинишу атрибути који могу да се преводе.

note: type: textblock
en: If a minus sign (B<->) is prepended to the style name, then this attribute is not translated.
sr: У случају да се испред имена стила стави знак минус (B<->), тај атрибут се не преводи.

note: type: textblock
en: 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.
sr: Ако се на крај имена стила допише знак за проценат (B<%>), онда се стил обрађује дословно онако како је наведен. Линије у пасусу или блокови таквог стила се задржавају у po фајловима и одговарајуће ставке се означавају као no-wrap.

note: type: =item
en: B<//po4a: entry >I<name>
sr: B<//po4a: entry >I<име>

note: type: textblock
en: This declares an attribute entry as being translatable.  By default, they are not translated.
sr: Ово наводи да ставка атрибута може да се преводи. Подразумева се да оне не могу да се преводе.

note: type: =head1
en: STATUS OF THIS MODULE
sr: СТАТУС ОВОГ МОДУЛА

note: type: textblock
en: Tested successfully on simple AsciiDoc files.
sr: Успешно је тестиран на једноставним AsciiDoc фајловима.

note: type: verbatim
en:  Nicolas François <nicolas.francois@centraliens.net>
     Denis Barbier <barbier@linuxfr.org>
sr:  Никола Франсоа <nicolas.francois@centraliens.net>
     Дени Барбије <barbier@linuxfr.org>

note: type: verbatim
en:  Copyright © 2005-2008 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>.
     Copyright © 2012 Denis BARBIER <barbier@linuxfr.org>.
     Copyright © 2017 Martin Quinson <mquinson#debian.org>.
sr:  Права умножавања © 2005-2008 Никола ФРАНСОА <nicolas.francois@centraliens.net>.
     Права умножавања © 2012 Дени БАРБИЈЕ <barbier@linuxfr.org>.
     Права умножавања © 2017 Мартин Квинсон <mquinson#debian.org>.

note: type: textblock
en: Locale::Po4a::BibTeX - convert BibTeX documents from/to PO files
sr: Locale::Po4a::BibTeX - двосмерна конверзија BibTeX докумената и PO фајлова

note: type: textblock
en: Locale::Po4a::BibTeX is a module to help the translation of bibliographies in the BibTeX format into other [human] languages.
sr: Locale::Po4a::BibTeX је модул који помаже превођење библиографија у BibTeX формату на друге [људске] језике.

note: type: textblock
en: Fields values are extracted and proposed for translation.
sr: Издвајају се вредности поља и предлажу за превођење.

note: type: textblock
en: NONE.
sr: НИШТА.

note: type: textblock
en: It is a very simple module, but still young.
sr: Ово је врло једноставан модул, али још увек није зрео.

note: type: verbatim
en:  Nicolas François <nicolas.francois@centraliens.net>
sr:  Никола Франсоа <nicolas.francois@centraliens.net>

note: type: verbatim
en:  Copyright © 2006 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>.
sr:  Права умножавања © 2006 Никола ФРАНСОА <nicolas.francois@centraliens.net>.

note: type: textblock
en: Locale::Po4a::Chooser - manage po4a modules
sr: Locale::Po4a::Chooser - управљање po4a модулима

note: type: textblock
en: Locale::Po4a::Chooser is a module to manage po4a modules. Previously, all po4a binaries used to know all po4a modules (pod, man, sgml, etc). This made the addition of a new module boring, because you had to make sure that the documentation is synchronized in all modules, and that each of them can access the new module.
sr: Locale::Po4a::Chooser је модул за управљање осталим po4a модулима. Раније су сви po4a бинарни фајлови знали све po4a модуле (pod, man, sgml, итд.). Због тога је додавање новог модула био досадан посао, јер сте морали обезбедити да документација буде синхронизована у свим модулима, као и да свако од њих може да приступи новом модулу.

note: type: textblock
en: Now, you just have to call the Locale::Po4a::Chooser::new() function, passing the name of module as argument.
sr: Сада је довољно само да позовете функцију Locale::Po4a::Chooser::new() и да јој проследите име модула као аргумент.

note: type: textblock
en: The function Locale::Po4a::Chooser::list() lists the available formats, and exits with the value passed as argument. So, we call Locale::Po4a::Chooser::list(0) when requested for the list of formats, and Locale::Po4a::Chooser::list(1) when passed an invalid format name.
sr: Фунцкија Locale::Po4a::Chooser::list() излистава доступне формате и завршава извршавање враћајући вредности прослеђену као аргумент. Дакле, узимамо да је Locale::Po4a::Chooser::list(0) када се тражи листа формата, а Locale::Po4a::Chooser::list(1) када је било прослеђено неважеће име формата.

note: type: =item
en: About po4a:
sr: О po4a:

note: type: =item
en: About modules:
sr: О модулима:

note: type: verbatim
en:  Denis Barbier <barbier@linuxfr.org>
     Martin Quinson (mquinson#debian.org)
sr:  Дени Барбије <barbier@linuxfr.org>
     Мартин Квинсон (mquinson#debian.org)

note: type: textblock
en: Copyright © 2002-2005, 2014, 2017 SPI, Inc.
sr: Права умножавања © 2002-2005, 2014, 2017 SPI, Inc.

note: type: textblock
en: Locale::Po4a::Common - common parts of the po4a scripts and utils
sr: Locale::Po4a::Common - заједнички делови за po4a скрипте и помоћне алате

note: type: textblock
en: Locale::Po4a::Common contains common parts of the po4a scripts and some useful functions used along the other modules.
sr: Locale::Po4a::Common садржи заједничке делове po4a скрипти и неке корисне функције које се користе по осталим модулима.

note: type: textblock
en: If needed, you can disable the use of Text::WrapI18N as such:
sr: Ако је потребно, можете да искључите употребу Text::WrapI18N као таквог:

note: type: textblock
en: instead of:
sr: уместо:

note: type: textblock
en: The ordering is important here: as most Locale::Po4a modules load themselves Locale::Po4a::Common, the first time this module is loaded determines whether Text::WrapI18N is used.
sr: Овде је битан редослед: како већина Locale::Po4a модула учитавају сами за себе Locale::Po4a::Common, први пут када се модул учита одређује да ли се Text::WrapI18N користи.

note: type: =head1
en: FUNCTIONS
sr: ФУНКЦИЈЕ

note: type: =head2
en: Showing output messages
sr: Приказивање излазих порука

note: type: textblock
en: Shows the current version of the script, and a short copyright message. It takes the name of the script as an argument.
sr: Приказује текућу верзију скрипте, као и кратку поруку о правима умножавања. Узима име скрипте као аргумент.

note: type: textblock
en: This function displays a message the same way as sprintf() does, but wraps the result so that they look nice on the terminal.
sr: Ова функција приказује поруку на исти начин као што то ради sprintf(), али обавија резултат тако да поруке лепо изгледају на терминалу.

note: type: textblock
en: This function works like wrap_msg(), but it takes a module name as the first argument, and leaves a space at the left of the message.
sr: Ова функција ради као like wrap_msg(), али као први аргумент узима име модула, и оставља празан простор лево од поруке.

note: type: textblock
en: This function works like wrap_msg(), but it takes a file:line reference as the first argument, a module name as the second one, and leaves a space at the left of the message.
sr: Ово функционише као wrap_msg(), али као први аргумент узима референцу фајл:линија, име модула као други, и оставља празан простор лево од поруке.

note: type: =head2
en: Wrappers for other modules
sr: Обвојнице за остале модуле

note: type: textblock
en: When the Locale::Gettext module cannot be loaded, this module provide dummy (empty) implementation of the following functions. In that case, po4a messages won't get translated but the program will continue to work.
sr: Када модул Locale::Gettext не може да се учита, овај модул обезбеђује лажну (тј. празну) имплементацију следећих функција. У том случају, поруке програма po4a неће бити преведене, али ће сам програм наставити да ради.

note: type: textblock
en: If Locale::gettext is present, this wrapper also calls setlocale(LC_MESSAGES, "") so callers don't depend on the POSIX module either.
sr: Ако је Locale::gettext присутан, ова обвојница такође позива setlocale(LC_MESSAGES, "") тако да позиваоци не зависе ни од POSIX модула.

note: type: verbatim
en:  Jordi Vilalta <jvprat@gmail.com>
sr:  Жорди Вијалта <jvprat@gmail.com>

note: type: textblock
en: Copyright © 2005 SPI, Inc.
sr: Права умножавања © 2005 SPI, Inc.

note: type: textblock
en: Locale::Po4a::Dia - convert uncompressed Dia diagrams from/to PO files
sr: Locale::Po4a::Dia - двосмерна конверзија некомпресованих Dia дијаграма и PO фајлова

note: type: textblock
en: Locale::Po4a::Dia is a module to help the translation of diagrams in the uncompressed Dia format into other [human] languages.
sr: Locale::Po4a::Dia је модул који помаже превођење дијаграма из некомпресованог Dia формата у друге [људске] језике.

note: type: verbatim
en: You can get Dia (the graphical editor for these diagrams) from:
      http://www.gnome.org/projects/dia/
sr: Програм Dia (графички едитор ових дијаграма) можете да преузмете са локације:
      http://www.gnome.org/projects/dia/

note: type: =head1
en: TRANSLATING WITH PO4A::DIA
sr: ПРЕВОЂЕЊЕ ПОМОЋУ PO4A::DIA

note: type: textblock
en: This module only translates uncompressed Dia diagrams.  You can save your uncompressed diagrams with Dia itself, unchecking the "Compress diagram files" at the "Save Diagram" dialog.
sr: Овај модул преводи само некомпресоване Dia дијаграме. Своје некомпресоване дијаграма можете да сачувате из самог програма Dia, тако што искључите опцију „Compress diagram files” у дијалогу „Save Diagram”.

note: type: verbatim
en: Another way is to uncompress the dia files from command line with:
      gunzip < original.dia > uncompressed.dia
sr: Други начин је да из командне линије распакујете компресоване dia фајлове:
      gunzip < оригинал.dia > некомпресовани.dia

note: type: textblock
en: This module is fully functional, as it relies in the L<Locale::Po4a::Xml> module. This only defines the translatable tags (E<lt>dia:stringE<gt>), and filters the internal strings (the content of the E<lt>dia:diagramdataE<gt> tag), not interesting for translation.
sr: Овај модул је потпуно функционалан, јер се ослања на модул L<Locale::Po4a::Xml>. Ово само дефинише преводиве ознаке (E<lt>dia:stringE<gt>), и филтрира интерне стрингове (садржај ознаке E<lt>dia:diagramdataE<gt>), који нису интересантни за превођење.

note: type: textblock
en: Copyright © 2004 Jordi Vilalta <jvprat@gmail.com>
sr: Права умножавања © 2004 Жорди Виљалта <jvprat@gmail.com>

note: type: textblock
en: Locale::Po4a::Docbook - convert DocBook XML documents from/to PO files
sr: Locale::Po4a::Docbook - двосмерна конверзија DocBook XML докумената и PO фајлова

note: type: textblock
en: Locale::Po4a::Docbook is a module to help the translation of DocBook XML documents into other [human] languages.
sr: Locale::Po4a::Docbook је модул који помаже превођење DocBook XML докумената на друге [људске] језике.

note: type: textblock
en: This module is fully functional, as it relies in the L<Locale::Po4a::Xml> module. This only defines the translatable tags and attributes.
sr: Овај модул је потпуно функционалан јер се ослања на L<Locale::Po4a::Xml> модул. Ово само дефинише преводиве ознаке и атрибуте.

note: type: textblock
en: The only known issue is that it doesn't handle entities yet, and this includes the file inclusion entities, but you can translate most of those files alone (except the typical entities files), and it's usually better to maintain them separated.
sr: Једини познат проблем је да још не ради са ентитетима, укључујући и ентитете укључивања других фајлова, али већину њих можете да одвојено да преведете (осим типичних фајлова ентитета) и обично је и боље да се одржавају одвојено.

note: type: =head2
en: OVERRIDE THE DEFAULT BEHAVIOR WITH COMMAND LINE OPTIONS
sr: ИЗМЕНА ПОДРАЗУМЕВАНОГ ПОНАШАЊА ОПЦИЈАМА У КОМАНДНОЈ ЛИНИЈИ

note: type: textblock
en: The default behavior of system provided modules is set to be on the safe side.
sr: Подразумевано понашање модула који се испоручују уз систем је постављено тако да буде сигурно.

note: type: textblock
en: For example, the default of B<< <author> >> tag is aiming it to appear under B<< <para> >>.  But you may be using it only under B<< <bookinfo> >>.  For this case, you may want to translate it independently for each author.
sr: На пример, подразумевано се циља се ознака B<< <author> >> појави под ознаком B<< <para> >>.  Али можете да је користите и под B<< <bookinfo> >>. У овом случају бисте могли независно да је преведете за сваког од аутора.

note: type: textblock
en: If you don't like the default behavior of the xml module and its derivative modules, you can provide command line options to change their behavior.  For example, you can add the following to the po4a configuration file:
sr: Ако вам не одговара подразумевано понашање xml модула, можете да задате опције командне линије којима се мења њихово понашање. На пример, можете да у po4a конфигурациони фајл додате следеће:

note: type: textblock
en: This overrides the default behavior for B<< <bookinfo> >> and B<< <author> >>, set B<< <bookinfo> >> and B<< <author> >> to break input data stream on these tags, set B<< <bookinfo> >> not to translate its tagged content, and set B<< <author> >> to translate its tagged content.
sr: Овим се мења подразумевано понашање за B<< <bookinfo> >> и B<< <author> >>, поставља да B<< <bookinfo> >> и B<< <author> >> преламају улазни ток на овим ознакама, поставља да се садржај означен са B<< <bookinfo> >> не преводи, а преводи садржај означен са B<< <author> >>.

note: type: verbatim
en:  Copyright © 2004 Jordi Vilalta  <jvprat@gmail.com>
     Copyright © 2007-2009 Nicolas François <nicolas.francois@centraliens.net>
sr:  Права умножавања © 2004 Жорди Вилалта  <jvprat@gmail.com>
     Права умножавања © 2007-2009 Никола Франсоа <nicolas.francois@centraliens.net>

note: type: textblock
en: Locale::Po4a::Gemtext - convert Gemtext documents from/to PO files.
sr: Locale::Po4a::Gemtext - двосмерна конверзија Gemtext докумената и PO фајлова.

note: type: textblock
en: Locale::Po4a::Gemtext is a module to help the translation of Gemtext documents into other [human] languages.
sr: Locale::Po4a::Gemtext је модул који помаже превођење Gemtext докумената на друге [људске] језике.

note: type: textblock
en: Tested successfully on simple Gemtext files, such as the official Gemtext documentation.
sr: Успешно је тестиран на једноставним Gemtext фајловима, као што је званична Gemtext документација.

note: type: verbatim
en:  Copyright © 2024 gemmaro <gemmaro.dev@gmail.com>.
sr:  Права умножавања © 2024 gemmaro <gemmaro.dev@gmail.com>.

note: type: textblock
en: Locale::Po4a::Guide - convert Guide XML documents from/to PO files
sr: Locale::Po4a::Guide - двосмерна конверзија Guide XML докумената и PO фајлова

note: type: textblock
en: Locale::Po4a::Guide is a module to help in the translation of the Gentoo Linux documentation in the Guide XML format into other [human] languages.
sr: Locale::Po4a::Guide је модул који помаже превођење Gentoo Linux документације у Guide XML формату на друге [људске] језике.

note: type: textblock
en: This format is documented here: http://www.gentoo.org/doc/en/xml-guide.xml
sr: Формат је документован овде: http://www.gentoo.org/doc/en/xml-guide.xml

note: type: textblock
en: The only known issue is that it doesn't include files with the <include href="..."> tag, but you can translate all those files alone, and it's usually better to have them separated.
sr: Једини познати проблем је што не укључује фајлове са ознаком <include href="...">, али њих можете одвојено да преведете, и обично је и боље да остану одвојени.

note: type: textblock
en: Locale::Po4a::Halibut - convert Halibut documents and derivates from/to PO files
sr: Locale::Po4a::Halibut - двосмерна конверзија Halibut документата као и изведених из овог формата и PO фајлова

note: type: textblock
en: Locale::Po4a::Halibut is a module to help the translation of Halibut documents into other [human] languages.
sr: Locale::Po4a::Halibut је модул који помаже превођење Halibut докумената на друге [људске] језике.

note: type: textblock
en: This module contains the definitions of common Halibut commands and environments.
sr: Овај модул садржи дефиниције уобичајених Halibut команди и окружења.

note: type: textblock
en: This module is still beta.  Please send feedback and feature requests.
sr: Овај модул је још у бета фази. Молимо вас да шаљете коментаре и захтеве за нове могућности.

note: type: =head1
en: CAVEAT
sr: УПОЗОРЕЊЕ

note: type: textblock
en: Some constructs are badly supported. The known ones are documented below.
sr: Неке конструкције су лоше подржане. Познате су документоване ниже.

note: type: =head2
en: Verbatim blocks
sr: Дословни блокови

note: type: textblock
en: The verbatim block is not considered as a whole. Each line will be translated separately.
sr: Дословни блок се не третира као целина. Свака линија ће засебно да се преводи.

note: type: textblock
en: Copyright © 2004-2008 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>.
sr: Права умножавања © 2004-2008 Никола ФРАНСОА <nicolas.francois@centraliens.net>.

note: type: textblock
en: Locale::Po4a::Ini - convert INI files from/to PO files
sr: Locale::Po4a::Ini - двосмерна конверзија INI фајлова и PO фајлова

note: type: textblock
en: Locale::Po4a::Ini is a module to help the translation of INI files into other [human] languages.
sr: Locale::Po4a::Ini је модул који помаже у превођењу INI фајлова на друге [људске] језике.

note: type: textblock
en: The module searches for lines of the following format and extracts the quoted text:
sr: Модул тражи линије следећег формата и издваја текст између наводника:

note: type: textblock
en: identificator="text than can be translated"
sr: идентификатор="текст који може да се преведе"

note: type: textblock
en: NOTE: If the text is not quoted, it will be ignored.
sr: НАПОМЕНА: Ако се текст не налази између наводника, игнорисаће се.

note: type: verbatim
en:  Razvan Rusu <rrusu@bitdefender.com>
     Costin Stroie <cstroie@bitdefender.com>
sr:  Разван Русу <rrusu@bitdefender.com>
     Костин Строје <cstroie@bitdefender.com>

note: type: textblock
en: Copyright © 2006 BitDefender
sr: Права умножавања © 2006 BitDefender

note: type: textblock
en: Locale::Po4a::KernelHelp - convert kernel configuration help from/to PO files
sr: Locale::Po4a::KernelHelp - двосмерна конверзија помоћи за конфигурацију кернела и PO фајлова

note: type: textblock
en: Locale::Po4a::KernelHelp is a module to help the translation of documentation for the Linux kernel configuration options into other [human] languages.
sr: Locale::Po4a::KernelHelp је модул који помаже превођење Linux опција за конфигурисање кернела на друге [људске] језике.

note: type: textblock
en: This module is just written, and needs more tests. Most of the needed work will concern the tools used to parse this file (and configure the kernel), so that they accept to read the documentation from another (translated)  file.
sr: Овај модул је тек написан, и потребно је још тестирања. Већина потребног посла ће бити око алата који се користе за парсирање овог фајла (и конфигурисање кернела), тако да буду у могућности да читају документацију из другог (преведеног) фајла.

note: type: textblock
en: Copyright © 2002 SPI, Inc.
sr: Права умножавања © 2002 SPI, Inc.

note: type: textblock
en: Locale::Po4a::LaTeX - convert LaTeX documents and derivates from/to PO files
sr: Locale::Po4a::LaTeX - двосмерна конверзија LaTeX докумената (и сличних) и PO фајлова

note: type: textblock
en: Locale::Po4a::LaTeX is a module to help the translation of LaTeX documents into other [human] languages. It can also be used as a base to build modules for LaTeX-based documents.
sr: Locale::Po4a::LaTeX је модул који помаже превођење LaTeX докумената на друге [људске] језике. Може да се користи као основа за писање модула који ће моћи да обраде остале документе базиране на LaTeX-у.

note: type: textblock
en: This module contains the definitions of common LaTeX commands and environments.
sr: Овај модул садржи дефиниције уобичајених LaTeX команди и окружења.

note: type: textblock
en: See the L<Locale::Po4a::TeX(3pm)|Locale::Po4a::TeX> manpage for the list of recognized options.
sr: See the L<Locale::Po4a::TeX(3pm)|Locale::Po4a::TeX> man страна за листу опција које се препознају.

note: type: textblock
en: Copyright © 2004, 2005 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>.
sr: Права умножавања © 2004, 2005 Никола ФРАНСОА <nicolas.francois@centraliens.net>.

note: type: textblock
en: Locale::Po4a::Man - convert manual pages from/to PO files
sr: Locale::Po4a::Man - двосмерна конверзија страна упутства и PO фајлова

note: type: textblock
en: Locale::Po4a::Man is a module to help the translation of documentation in the nroff format (the language of manual pages) into other [human] languages.
sr: Locale::Po4a::Man је модул који помаже превођење документације у nroff формату (језик страница упутства) на друге [људске] језике.

note: type: =head1
en: TRANSLATING WITH PO4A::MAN
sr: ПРЕВОЂЕЊЕ ПОМОЋУ PO4A::MAN

note: type: textblock
en: This module tries pretty hard to make translator's life easier. For that, the text presented to translators isn't a verbatim copy of the text found in the man page. Indeed, the cruder parts of the nroff format are hidden, so that translators can't mess up with them.
sr: Овај модул се заиста својски труди да олакша живот преводиоцу. Текст који се представља преводиоцима није дословна копија текста који се налази у man страни. Наравно, грубљи делови nroff формата су скривени, тако да преводиоци не могу да се петљају са њима.

note: type: =head2
en: Text wrapping
sr: Обмотавање текста

note: type: textblock
en: Unindented paragraphs are automatically rewrapped for the translator.  This can lead to some minor difference in the generated output, since the rewrapping rules used by groff aren't very clear. For example, two spaces after a parenthesis are sometimes preserved.
sr: Неувучени пасуси се за преводиоца аутоматски поново обавијају. То може довести до ситуације да постоје неке минималне разлике у генерисаном излазу, пошто правила поновног обавијања која користи groff нису баш најјаснија. На пример, два размака након заграда понекад остају очувана.

note: type: textblock
en: Anyway, the difference will only be about the position of the extra spaces in wrapped paragraph, and I think it's worth.
sr: У сваком случају, разлика ће бити једино у позицији екстра размака у обавијеном пасусу и ја мислим да је вредна.

note: type: =head2
en: Font specification
sr: Спецификација фонта

note: type: textblock
en: The first change is about font change specifications.  In nroff, there are several ways to specify if a given word should be written in small, bold or italics. In the text to translate, there is only one way, borrowed from the POD (Perl online documentation) format:
sr: Прва измена је у вези спецификација за промену фонта. У nroff, постоји неколико начина да се наведе да ли одређена реч треба да се испише малим словима, подебљано или курзивом. У тексту који се преводи, постоји само један начин, позајмљен из POD (Perl online documentation) формата:

note: type: =item
en: IE<lt>textE<gt> -- italic text
sr: IE<lt>текстE<gt> -- курзивни текст

note: type: textblock
en: equivalent to \fItext\fP or ".I text"
sr: еквивалентно са \fIтекст\fP или ".I текст"

note: type: =item
en: BE<lt>textE<gt> -- bold text
sr: BE<lt>текстE<gt> -- подебљани текст

note: type: textblock
en: equivalent to \fBtext\fP or ".B text"
sr: еквивалентно са \fBтекст\fP или ".B текст"

note: type: =item
en: RE<lt>textE<gt> -- roman text
sr: RE<lt>текстE<gt> -- латинични текст

note: type: textblock
en: equivalent to \fRtext\fP
sr: еквивалентно са \fRтекст\fP

note: type: =item
en: CWE<lt>textE<gt> -- constant width text
sr: CWE<lt>текстE<gt> -- текст са карактерима константне ширине

note: type: textblock
en: equivalent to \f(CWtext\fP or ".CW text"
sr: еквивалентно са \f(CWтекст\fP или ".CW текст"

note: type: textblock
en: Remark: The CW face is not available for all groff devices. It is not recommended to use it. It is provided for your convenience.
sr: Опаска: CW писмо није доступно за све groff уређаје. Његова употреба се не препоручује. Понуђено је да би вама било једноставно.

note: type: =head2
en: Automatic characters transliteration
sr: Аутоматско пресловљавање карактера

note: type: textblock
en: Po4a automatically transliterate some characters to ease the translation or the review of the translation.  Here is the list of the transliterations:
sr: Програм po4a аутоматски пресловљава неке карактере како би се олакшало превођење или лекторисање превода. Ево листе пресловљавања:

note: type: =item
en: hyphens
sr: цртице на крају реда

note: type: textblock
en: Hyphens (-) and minus signs (\-) in man pages are all transliterated as simple dashes (-) in the PO file.  Then all dash are transliterated into roff minus signs (\-) when the translation is inserted into the output document.
sr: У PO фајлу се цртице на крају реда (-) и минус знаци (\-) у man страницама све пресловљавају у просте цртице (-). Затим се све црте пресловљавају у roff минус знаке (\-) када се превод умеће у излазни документ.

note: type: textblock
en: Translators can force an hyphen by using the roff glyph '\[hy]' in their translations.
sr: Преводиоци могу да форсирају цртице на крају реда употребом roff глифа ’\[hy]’ у својим преводима.

note: type: =item
en: non-breaking spaces
sr: размаци на којима нема прелома реда

note: type: textblock
en: Translators can use non-breaking spaces in their translations.  These non-breaking spaces (0xA0 in latin1) will be transliterated into a roff non-breaking space ('\ ').
sr: Преводиоци у својим преводима могу да користе непреламајуће размаке. Ови непреламајући размаци (0xA0 у latin1 кодној страни) ће да се преслове у roff непреламајући размак (’\ ’).

note: type: =item
en: quotes transliterations
sr: пресловљавања навода

note: type: textblock
en: `` and '' are respectively tranliterated into \*(lq and \*(rq.
sr: `` и '' се пресловљавају у \*(lq и \*(rq респективно.

note: type: textblock
en: To avoid these transliterations, translators can insert a zero width roff character (i.e., using `\&` or '\&' respectively).
sr: Ако желе да спрече ова пресловљавања, преводиоци могу да уметну roff карактер нулте ширине (нпр. употребом `\&` или '\&' респективно).

note: type: =head2
en: Putting 'E<lt>' and 'E<gt>' in translations
sr: Стављање ’E<lt>’ и ’E<gt>’ и преводе

note: type: textblock
en: Since these chars are used to delimit parts under font modification, you can't use them verbatim. Use EE<lt>ltE<gt> and EE<lt>gtE<gt> instead (as in POD, one more time).
sr: Пошто се ови карактери користе за одвајање делова под изменом фонта, не можете да их користите дословно. Употребите уместо њих EE<lt>ltE<gt> и EE<lt>gtE<gt> (као у POD, још једном).

note: type: textblock
en: Activate debugging for some internal mechanisms of this module.  Use the source to see which parts can be debugged.
sr: Активира дибаговање за неке интерне механизме овог модула. Погледајте изворни код да сазнате за који делове може да се користи дибаг.

note: type: textblock
en: Increase verbosity.
sr: Повећава количину информација.

note: type: textblock
en: This option controls the behavior of the module when it encounter a .de, .ie or .if section. It can take the following values:
sr: Ова опција контролише понашање модула када наиђе на .de, .ie или .if одељке. Може да има следеће вредности:

note: type: textblock
en: This is the default value.  The module will fail when a .de, .ie or .if section is encountered.
sr: Ово је подразумевана вредност. Модул ће прекинути са извршавањем када се наиђе на .de, .ie или .if одељак.

note: type: textblock
en: Indicates that the .de, .ie or .if sections must be copied as is from the original to the translated document.
sr: Назначава да .de, .ie или .if одељци морају да се копирају из оригинала у преведени документ онакви какви су.

note: type: textblock
en: Indicates that the .de, .ie or .if sections will be proposed for the translation.  You should only use this option if a translatable string is contained in one of these section. Otherwise, I<verbatim> should be preferred.
sr: Назначава да ће .de, .ie или .if одељци да се предложе за превођење. Ову опцију би требало да користите само ако се стринг за превођење налази у једном од ових одељака. У супротном, бољи избор је I<verbatim>.

note: type: textblock
en: This option specifies that the file was generated, and that po4a should not try to detect if the man pages was generated from another format.  This option is mandatory to use po4a on generated man pages.  Note that translating generated pages instead of sources ones is often more fragile, and thus a bad idea.
sr: Ова опција наводи да је фајл генерисан, и да програм po4a не би требало да покуша са откривањем да ли су man стране генерисане из неког другог формата. Ова опција је обавезна код употребе po4a над генерисаним man страницама. Имајте на уму да превођење генерисаних страница уместо извора често доводи до грешака, па није добра идеја.

note: type: textblock
en: This option is only useful for mdoc pages.
sr: Ова опција је корисна само за mdoc странице.

note: type: textblock
en: It selects a stricter support of the mdoc format by telling po4a not to translate the 'NAME' section.  mdoc pages whose 'NAME' section is translated won't generate any header or footer.
sr: Она одабира стриктнију подршку mdoc формата наводећи програм po4a да не преводи ’NAME’ одељак. mdoc странице чији је ’NAME’ одељак преведен уопште неће генерисати заглавље или подножје.

note: type: verbatim
en: According to the groff_mdoc page, the NAME, SYNOPSIS and DESCRIPTION
    sections are mandatory.
    There are no known issues with translated SYNOPSIS or DESCRIPTION section,
    but you can also specify these sections this way:
     -o mdoc=NAME,SYNOPSIS,DESCRIPTION
sr: Према groff_mdoc страници, одељци NAME, SYNOPSIS и DESCRIPTION
    су обавезни.
    Нема познатих проблема за превођењем одељака SYNOPSIS или DESCRIPTION,
    мада ове одељке можете да наведете и на следећи начин:
     -o mdoc=NAME,SYNOPSIS,DESCRIPTION

note: type: verbatim
en: This mdoc issue can also be solved with an addendum like this one:
     PO4A-HEADER:mode=before;position=^.Dd
     .TH DOCUMENT_TITLE 1 "Month day, year" OS "Section Name"
sr: Овај mdoc проблем такође може да се реши са додатком, као што је овај:
     PO4A-HEADER:mode=before;position=^.Dd
     .TH DOCUMENT_TITLE 1 "Month day, year" OS "Section Name"

note: type: textblock
en: The following options specify the behavior of a user-defined macro (with a .de request), or of a classical macro that is not supported by po4a.  They take as argument a comma-separated list of macros.  For example:
sr: Опције које следе наводе понашање кориснички дефинисаног макроа (.de захтевом), или класичног макроа који програм po4a не подржава. Они као аргумент узимају листу макроа раздвојених зарезима. На пример:

note: type: textblock
en: Note: if a macro is not supported by po4a and if you consider that it is a standard roff macro, you should submit it to the po4a development team.
sr: Напомена: ако програм po4a не подржава макро, а ви сматрате да је то стандардни roff макро, требало би да га доставите развојном тиму програма po4a.

note: type: textblock
en: B<untranslated> indicates that this macro (at its arguments) don't have to be translated.
sr: B<untranslated> наводи да овај макро (као и његови аргументи) не морају да се преведу.

note: type: textblock
en: B<noarg> is like B<untranslated>, except that po4a will verify that no argument is added to this macro.
sr: B<noarg> је као B<untranslated>, осим што ће програм po4a проверити да ниједан аргумент није додат макроу.

note: type: textblock
en: B<translate_joined> indicates that po4a must propose to translate the arguments of the macro.
sr: B<translate_joined> наводи да програм po4a мора да предложи превођење аргумената макроа.

note: type: textblock
en: With B<translate_each>, the arguments will also be proposed for the translation, except that each one will be translated separately.
sr: Са B<translate_each>, аргументи ће такође бити предложени за превод, осим што ће сваки од њих да се преводи одвојено.

note: type: textblock
en: This option takes as argument a list of comma-separated couples I<begin>:I<end>, where I<begin> and I<end> are commands that delimit the begin and end of a section that should not be rewrapped.
sr: Ова опција као аргумент узима листу парова I<почетак>:I<крај> раздвојених зарезима, где су I<почетак> и I<крај> команде које ограђују почетак и крај одељка који не би требало да се поново обавија.

note: type: textblock
en: Note: no test is done to ensure that an I<end> command matches its I<begin> command; any ending command stop the no_wrap mode.  If you have a I<begin> (respectively I<end>) macro that has no I<end> (respectively I<begin>), you can specify an existing I<end> (like fi) or I<begin> (like nf) as a counterpart.  These macros (and their arguments) won't be translated.
sr: Напомена: не ради се никакав тест да се осигура подударање команде I<крај> са својом командом I<почетак>; било која команда уређивања зауставља no_wrap режим. Ако имате I<почетак> (и одговарајући I<крај>) макро који нема I<крај> (и одговарајући I<почетак>), можете да наведете неки постојећи I<крај> (као fi) или I<почетак> (као nf) као његов пар. Ови макрои (и њихови аргументи) неће бити превођени.

note: type: textblock
en: This option specifies a list of comma-separated macros that must not split the current paragraph. The string to translate will then contain I<foo E<lt>.bar baz quxE<gt> quux>, where I<bar> is the command that should be inlined, and I<baz qux> its arguments.
sr: Ова опција наводи листу макроа раздвојених зарезима који не смеју да преломе текући пасус. Тада ће стринг који треба да се преведе садржати I<foo E<lt>.bar baz quxE<gt> quux>, где је I<bar> команда која би требало да се налази унутар текста, а I<baz qux> су њени аргументи.

note: type: textblock
en: This option indicates how po4a should behave when an unknown macro is found.  By default, po4a fails with a warning.  It can take the following values: B<failed> (the default value), B<untranslated>, B<noarg>, B<translate_joined>, or B<translate_each> (see above for an explanation of these values).
sr: Ова опција одређује како би програм po4a требало да се понаша када се наиђе на непознат макро. Подразумева се да програм po4a прекине извршавање са упозорењем. Може да има следеће вредности: B<failed> (подразумевана вредност), B<untranslated>, B<noarg>, B<translate_joined>, или B<translate_each> (погледајте изнад за објашњење ових вредности).

note: type: =head1
en: AUTHORING MAN PAGES COMPLIANT WITH PO4A::MAN
sr: ПИСАЊЕ MAN СТРАНИЦА САГЛАСНИХ СА PO4A::MAN

note: type: textblock
en: This module is still very limited, and will always be, because it's not a real nroff interpreter. It would be possible to do a real nroff interpreter, to allow authors to use all the existing macros, or even to define new ones in their pages, but we didn't want to. It would be too difficult, and we thought it wasn't necessary. We do think that if manpages' authors want to see their productions translated, they may have to adapt to ease the work of translators.
sr: Овај модул је и даље веома ограничен, и увек ће бити, јер он није прави nroff интерпретер. Било би могуће да се направи прави nroff интерпретер, чиме би аутори могли да користе све постојеће макрое, или да чак у својим страницама дефинишу и нове, али нисмо хтели то да урадимо. Било би сувише тешко, и мислили смо да није неопходно. Сматрамо да ако аутори man страница желе да виде своја дела преведена, морали би мало да се прилагоде како би олакшали посао преводиоцима.

note: type: textblock
en: So, the man parser implemented in po4a have some known limitations we are not really inclined to correct, and which will constitute some pitfalls you'll have to avoid if you want to see translators taking care of your documentation.
sr: Дакле, man парсер имплементиран у програм po4a има нека позната ограничења која баш и не желимо да исправимо, и која ће проузроковати неке проблеме које ћете морати да избегнете ако желите да видите преводиоце како се старају о вашој документацији.

note: type: =head2
en: Don't program in nroff
sr: Немојте да програмирате у nroff

note: type: textblock
en: nroff is a complete programming language, with macro definition, conditionals and so on. Since this parser isn't a fully featured nroff interpreter, it will fail on pages using these facilities (There are about 200 such pages on my box).
sr: nroff је комплетан програмски језик, са дефиницијом макроа, кондиционалима и тако даље. Пошто овај парсер није комплетан nroff интерпретер, он неће успети да се изврши над странама које користе ове конструкције (на мојој машини има око 200 таквих страница).

note: type: =head2
en: Use the plain macro set
sr: Користите прости скуп макроа

note: type: textblock
en: There are still some macros which are not supported by po4a::man. This is only because I failed to find any documentation about them. Here is the list of unsupported macros used on my box. Note that this list isn't exhaustive since the program fails on the first encountered unsupported macro. If you have any information about some of these macros, I'll happily add support for them. Because of these macros, about 250 pages on my box are inaccessible to po4a::man.
sr: Постоји још макроа које po4a::man не подржава. То је само због тога јер нисам успео да пронађем документацију за њих. Ево листе макроа који нису подржани, а користе на мојој машини. Имајте на уму да листа није потпуна пошто програм прекида са извршавањем чин наиђе на први макро који не подржава. Ако имате било какве информације у вези неких од ових макроа, радо ћу да додам подршку за њих. Јер због ових макроа, око 250 страница на мојој машини нису доступне модулу po4a::man.

note: type: =head2
en: Hiding text from po4a
sr: Скривање текста од po4a

note: type: textblock
en: Sometimes, the author knows that some parts are not translatable, and should not be extracted by po4a. For example, an option may accept an I<other> argument, and I<other> may also appear as the last item of a list. In the first case, I<other> should be not be translatable. And in the second case, I<other> should be translated.
sr: Аутор понекад зна да неки делови не треба да се преводе и програм po4a не би требало да их издваја. На пример, опција би могла да прихвата аргумент I<other>, а I<other> такође може да се појави као последња ставка листе. У првом случају, I<other> не би требало да се преводи. А у другом случају, I<other> би требало да се преведе.

note: type: textblock
en: In such case, the author can avoid po4a to extract some strings, using some special groff constructs:
sr: Користећи неке специјалне groff конструкције, аутор у том случају може да постићи да po4a не издвоји неке стрингове:

note: type: textblock
en: (this will require the B<-o groff_code=verbatim> option)
sr: (за ово је неопходна опција B<-o groff_code=verbatim>)

note: type: verbatim
en: A new macro can also be defined to automate this:
     .de IR_untranslated
     .    IR \\$@
     ..
sr: Ово може да се аутоматизује дефинисањем новог макроа:
     .de IR_untranslated
     .    IR \\$@
     ..

note: type: textblock
en: (this will require the options B<-o groff_code=verbatim> and B<-o untranslated=IR_untranslated>; with this construct, the B<.if !'po4a'hide'> conditional is not strictly needed since po4a will not parse the internal of the macro definition)
sr: (за ово су неопходне опције B<-o groff_code=verbatim> и B<-o untranslated=IR_untranslated>; уз ову конструкцију, кондиционал B<.if !'po4a'hide'> није стриктно неопходан јер програм po4a неће парсирати интерну дефиницију макроа)

note: type: verbatim
en: or using an alias:
     .als IR_untranslated IR
sr: или коришћењем алијаса:
     .als IR_untranslated IR

note: type: textblock
en: This will require the B<-o untranslated=als,IR_untranslated> option.
sr: За ово је неопходна опција B<-o untranslated=als,IR_untranslated>.

note: type: =head2
en: Conclusion
sr: Закључак

note: type: textblock
en: To summarise this section, keep simple, and don't try to be clever while authoring your man pages. A lot of things are possible in nroff, and not supported by this parser. For example, don't try to mess with \c to interrupt the text processing (like 40 pages on my box do). Or, be sure to put the macro arguments on the same line that the macro itself. I know that it's valid in nroff, but would complicate too much the parser to be handled.
sr: Да укратко поновимо поенту овог одељка, нека буде једноставно, и немојте да се правите паметни када пишете своје man странице. У nroff је могуће урадити много ствари које овај парсер не подржава. На пример, не покушавајте да се петљате са \c како бисте прекинули процесирање текста (као што 40 страница на мојој машини ради). Или, будите сигурни да сте ставили аргументе макроа у исту линију у којој је и сам макро. Знам да је то исправно у nroff, али би сувише искомпликовало парсер ако би се применило.

note: type: textblock
en: Of course, another possibility is to use another format, more translator friendly (like POD using po4a::pod, or one of the XML family like SGML), but thanks to po4a::man it isn't needed anymore. That being said, if the source format of your documentation is POD, or XML, it may be clever to translate the source format and not this generated one. In most cases, po4a::man will detect generated pages and issue a warning. It will even refuse to process POD generated pages, because those pages are perfectly handled by po4a::pod, and because their nroff counterpart defines a lot of new macros I didn't want to write support for. On my box, 1432 of the 4323 pages are generated from POD and will be ignored by po4a::man.
sr: Наравно, друга могућност је да користите неки други формат, погоднији за преводиоца (као што је POD који користи po4a::pod, или неки из XML породице као што је SGML), мада захваљујући po4a::man то више није неопходно. Дакле, ако је изворни формат ваше документације POD, или XML, паметније би било да преведете изворни формат, а не овај генерисани. po4a::man ће у већини случајева моћи да детектује генерисане странице и издаће упозорење. Чак ће и одбити да обради POD генерисане стране, јер po4a::pod савршено ради са њима, а и због тога што њихови одговарајући nroff еквиваленти дефинишу пуно нових макроа, нисам желео да напишем подршку за то. На мојој машини, 1432 од 4323 странице су генерисане из POD и po4a::man ће да их игнорише.

note: type: textblock
en: In most cases, po4a::man will detect the problem and refuse to process the page, issuing an adapted message. In some rare cases, the program will complete without warning, but the output will be wrong. Such cases are called "bugs" ;) If you encounter such case, be sure to report this, along with a fix when possible…
sr: У већини случајева, po4a::man ће открити проблем и одбиће да обради страницу, издајући прилагођену поруку. У неким ретким случајевима, програм ће да се изврши без упозорења али излаз неће бити исправан. Такви случајеви се зову „багови” ;) Ако наиђете на такав случај, обавезно га пријавите, ако је могуће заједно са исправком…

note: type: textblock
en: This module can be used for most of the existing man pages.
sr: Овај модул може да се користи за већину постојећих man страница.

note: type: textblock
en: Some tests are regularly run on Linux boxes:
sr: Неки тестови се редовно врше на Linux машинама:

note: type: =item
en: one third of the pages are refused because they were generated from another format supported by po4a (e.g. POD or SGML).
sr: одбија се обрада једне трећине страница јер су генерисане из другог формата који програм po4a подржава (нпр. POD или SGML).

note: type: =item
en: 10% of the remaining pages are rejected with an error (e.g. a groff macro is not supported).
sr: 10% осталих страница се не обрађује услед неке грешке (нпр. groff макро који није подржан).

note: type: =item
en: Then, less than 1% of the pages are accepted silently by po4a, but with significant issues (i.e. missing words, or new words inserted)
sr: Затим, програм po4a без обавештења прихвата мање од 1% страница, али са озбиљним проблемима (нпр. речи које недостају, или уметнуте нове речи)

note: type: =item
en: The other pages are usually handled without differences more important than spacing differences or line rewrapped (font issues in less than 10% of the processed pages).
sr: Остале странице се обично обрађују без неких значајнијих разлика, осим на пример разлике у размацима или поново обавијене линије (проблеми са фонтом у мање од 10% обрађених страница).

note: type: textblock
en: Copyright © 2002-2008 SPI, Inc.
sr: Права умножавања © 2002-2008 SPI, Inc.

note: type: textblock
en: Locale::Po4a::Org - convert Org documents from/to PO files.
sr: Locale::Po4a::Org - двосмерна конверзија Org докумената и PO фајлова.

note: type: verbatim
en:  [type:org] /path/to/master.org              \
            $lang:/path/to/translation.$lang.org \
            opt:"                                \
            --option skip_keywords='             \
                include                          \
                export_file_name                 \
                link'                            \
            --option skip_properties='           \
                copying                          \
                NOBLOCKING                       \
                ORDERED'"
sr:  [type:org] /путања/до/master.org              \
            $lang:/путања/до/translation.$lang.org \
            opt:"                                \
            --option skip_keywords='             \
                include                          \
                export_file_name                 \
                link'                            \
            --option skip_properties='           \
                copying                          \
                NOBLOCKING                       \
                ORDERED'"

note: type: textblock
en: C<Locale::Po4a::Org> is a module to help the translation of documentation in the Org format, used by the L<Org Mode|https://orgmode.org/>.
sr: C<Locale::Po4a::Org> jе модул који помаже превођење документације у Org формату, који користи L<Org Mode|https://orgmode.org/>.

note: type: =head1
en: CONFIGURATION
sr: КОНФИГУРАЦИЈА

note: type: textblock
en: Space-separated list of keywords which won't be translated.
sr: Листа кључних речи раздвојених размацима које не желите да се преведу.

note: type: textblock
en: Space-separated list of properties which won't be translated.
sr: Листа особина раздвојених размацима које се неће превести.

note: type: textblock
en: If this is a true value, skip translating headings.  When your translation is converted to Texinfo format, the translation of headings can cause node names to become bizarre.  This option prevents that.
sr: Ако је ово истинита вредност, прескаче се превођење наслова. Када се ваш превод преведе у Texinfo формат, услед превода наслова имена чворова постају бизарна. Ова опција то спречава.

note: type: textblock
en: This module is in an early stage of development.  It is tested successfully on simple Org files, such as the L<Org Mode Compact Guide|https://orgmode.org/guide/>.  However it does not support the full L<Org syntax|https://orgmode.org/worg/org-syntax.html>; footnotes and nested plain lists cannot currently be parsed, for example.
sr: Овај модул је у раној фази развоја. Успешно је тестиран на једноставним Org фајловима, као што је L<Компактни водич за Org режим Guide|https://orgmode.org/guide/>. Међутим, он не подржава комплетну L<Org синтаксу|https://orgmode.org/worg/org-syntax.html>; на пример, фусноте и угњеждене просте листе се тренутно не парсирају.

note: type: verbatim
en:  Copyright © 2024 gemmaro.
sr:  Права умножавања © 2024 gemmaro.

note: type: textblock
en: This program is free software; you may redistribute it and/or modify it under the terms of GPL v2.0 or later (see the F<COPYING> file).
sr: Овај програм је слободан софтвер; можете да га редистрибуирате и/или мењате под условима GPL v2.0 или новије (погледајте фајл F<COPYING>).

note: type: textblock
en: Locale::Po4a::Po - PO file manipulation module
sr: Locale::Po4a::Po - модул за манипулацију PO фајла

note: type: verbatim
en:     use Locale::Po4a::Po;
        my $pofile=Locale::Po4a::Po->new();
    
        # Read PO file
        $pofile->read('file.po');
    
        # Add an entry
        $pofile->push('msgid' => 'Hello', 'msgstr' => 'bonjour',
                      'flags' => "wrap", 'reference'=>'file.c:46');
    
        # Extract a translation
        $pofile->gettext("Hello"); # returns 'bonjour'
    
        # Write back to a file
        $pofile->write('otherfile.po');
sr:     use Locale::Po4a::Po;
        my $pofile=Locale::Po4a::Po->new();
    
        # Прочитај PO фајл
        $pofile->read('file.po');
    
        # Додај ставку
        $pofile->push('msgid' => 'Hello', 'msgstr' => 'bonjour',
                      'flags' => "wrap", 'reference'=>'file.c:46');
    
        # Издвој превод
        $pofile->gettext("Hello"); # враћа 'bonjour'
    
        # Упиши назад у фајл
        $pofile->write('otherfile.po');

note: type: textblock
en: Locale::Po4a::Po is a module that allows you to manipulate message catalogs. You can load and write from/to a file (which extension is often I<po>), you can build new entries on the fly or request for the translation of a string.
sr: Locale::Po4a::Po који вам омогућава да манипулишете каталозима порука. Можете да учитате и уписујете у фајл (чија екстензија је обично I<po>), можете у лету да градите нове ставке или да захтевате превод стринга.

note: type: textblock
en: For a more complete description of message catalogs in the PO format and their use, please refer to the info documentation of the gettext program (node "`PO Files"').
sr: За потпунији опис каталога порука у PO формату, као и начин њихове употребе, молимо да погледате info документацију програма gettext (чвор "`PO Files"').

note: type: textblock
en: This module is part of the po4a project, which objective is to use PO files (designed at origin to ease the translation of program messages) to translate everything, including documentation (man page, info manual), package description, debconf templates, and everything which may benefit from this.
sr: Овај модуле је део пројекта po4a, чији је циљ да се PO фајлови (изворно направљених за олакшавање превода порука неког програма) користе за превођење свега, укључујући и документацију (man страница, info упутство), описе пакета, debconf шаблоне, као и све оно што може да има користи од овога.

note: type: =head1
en: Functions concerning entire message catalogs
sr: Функције које се тичу каталога порука у целини

note: type: textblock
en: Creates a new message catalog. If an argument is provided, it's the name of a PO file we should load.
sr: Креира нови каталог порука. Ако се наведе аргумент, то ће бити име PO фајла који би требало да се учита.

note: type: textblock
en: Reads a PO file (which name is given as argument).  Previously existing entries in self are not removed, the new ones are added to the end of the catalog.
sr: Чита PO фајл (чије име је дато аргументом). Претходно постојеће ставке у објекту се не уклањају, нове се додају на крај каталога.

note: type: textblock
en: Writes the current catalog to the given file.
sr: Уписује текући каталог у дати фајл.

note: type: textblock
en: Like write, but if the PO or POT file already exists, the object will be written in a temporary file which will be compared with the existing file to check if the update is needed (this avoids to change a POT just to update a line reference or the POT-Creation-Date field).
sr: Као write, али у случају да PO или POT фајл већ постоји, објекат ће да се упише у привремени фајл који ће затим да се упореди са постојећим како би се проверило да ли је неопходно ажурирање (на овај начин се избегава измена POT фајла само да би се ажурирала линија референце, или поље POT-Creation-Date).

note: type: textblock
en: This function extracts a catalog from an existing one. Only the entries having a reference in the given file will be placed in the resulting catalog.
sr: Ова функција издваја каталог из постојећег. У излазни каталог се смештају само оне ставке које имају референцу у датом фајлу.

note: type: textblock
en: This function parses its argument, converts it to a Perl function definition, evals this definition and filters the fields for which this function returns true.
sr: Ова функција парсира свој аргумент, конвертује га у дефиницију Perl функције, одређује вредност ове дефиниције и филтрира поља за коју функција враћа истиниту вредност.

note: type: textblock
en: I love Perl sometimes ;)
sr: Понекад волим Perl ;)

note: type: =head1
en: Functions to use a message catalog for translations
sr: Функције за коришћење каталога порука у преводима

note: type: textblock
en: Request the translation of the string given as argument in the current catalog.  The function returns the original (untranslated) string if the string was not found.
sr: Захтева из текућег каталога превод за стринг који је дат као аргумент. У случају да се превод не пронађе, функција враћа оригинални (непреведени) стринг.

note: type: textblock
en: After the string to translate, you can pass a hash of extra arguments. Here are the valid entries:
sr: Након стринга који треба да се преведе, можете да наведете хеш додатних аргумената. Ево важећих ставки:

note: type: textblock
en: boolean indicating whether we can consider that whitespaces in string are not important. If yes, the function canonizes the string before looking for a translation, and wraps the result.
sr: логичка вредност која указује на то да ли се празни карактери у стрингу сматрају за битне карактере. Ако је тачно, функција канонизује стринг пре тражења превода, и обавија резултат.

note: type: textblock
en: the column at which we should wrap (default: 76).
sr: колона око које се врши обавијање (подразумевано: 76).

note: type: textblock
en: Returns statistics about the hit ratio of gettext since the last time that stats_clear() was called. Please note that it's not the same statistics than the one printed by msgfmt --statistic. Here, it's statistics about recent usage of the PO file, while msgfmt reports the status of the file.  Example of use:
sr: Враћа статистику у вези успешности програма gettext у проналажења превода од тренутка када је последњи пут позвана функција stats_clear(). Молимо имајте на уму да ово није иста статистика коју приказује msgfmt --statistic. Овде је то статистика о недавном коришћењу PO фајла, док msgfmt пријављује статус фајла. Пример употребе:

note: type: verbatim
en:     [some use of the PO file to translate stuff]
    
        ($percent,$hit,$queries) = $pofile->stats_get();
        print "So far, we found translations for $percent\%  ($hit of $queries) of strings.\n";
sr:     [употреба PO фајла за превод ствари]
    
        ($percent,$hit,$queries) = $pofile->stats_get();
        print "До сада, пронашли смо преводе за $percent\%  ($hit од $queries) стрингова.\n";

note: type: textblock
en: Clears the statistics about gettext hits.
sr: Брише статистику и вези успешности програма gettext.

note: type: =head1
en: Functions to build a message catalog
sr: Функције за изградњу каталога порука

note: type: textblock
en: Push a new entry at the end of the current catalog. The arguments should form a hash table. The valid keys are:
sr: Додаје нову ставку не крај текућег каталога. Аргумент би требало да буде у форми хеш табеле. Важећи кључеви су:

note: type: textblock
en: the string in original language.
sr: стринг на оригиналном језику.

note: type: textblock
en: the translation.
sr: превод.

note: type: textblock
en: an indication of where this string was found. Example: file.c:46 (meaning in 'file.c' at line 46). It can be a space-separated list in case of multiple occurrences.
sr: указује на то где је стринг пронађен. Пример: file.c:46 (значи у 'file.c' на линији 46). У случају вишеструког појављивања, може да буде листа раздвојена размацима.

note: type: textblock
en: a comment added here manually (by the translators). The format here is free.
sr: коментар који (преводиоци) овде ручно додају. Формат је потпуно слободан.

note: type: textblock
en: a comment which was automatically added by the string extraction program. See the B<--add-comments> option of the B<xgettext> program for more information.
sr: коментар који аутоматски додаје програм за издвајање стрингова. За више информација, погледајте опцију B<--add-comments> програма B<xgettext>.

note: type: textblock
en: space-separated list of all defined flags for this entry.
sr: листа свих заставица дефинисаних за ову ставку, раздвојених размацима.

note: type: textblock
en: Valid flags are: B<c-text>, B<python-text>, B<lisp-text>, B<elisp-text>, B<librep-text>, B<smalltalk-text>, B<java-text>, B<awk-text>, B<object-pascal-text>, B<ycp-text>, B<tcl-text>, B<wrap>, B<no-wrap> and B<fuzzy>.
sr: Важеће заставице су: B<c-text>, B<python-text>, B<lisp-text>, B<elisp-text>, B<librep-text>, B<smalltalk-text>, B<java-text>, B<awk-text>, B<object-pascal-text>, B<ycp-text>, B<tcl-text>, B<wrap>, B<no-wrap> и B<fuzzy>.

note: type: textblock
en: See the gettext documentation for their meaning.
sr: За њихово значење, погледајте gettext документацију.

note: type: textblock
en: this is mostly an internal argument: it is used while gettextizing documents. The idea here is to parse both the original and the translation into a PO object, and merge them, using one's msgid as msgid and the other's msgid as msgstr. To make sure that things get ok, each msgid in PO objects are given a type, based on their structure (like "chapt", "sect1", "p" and so on in DocBook). If the types of strings are not the same, that means that both files do not share the same structure, and the process reports an error.
sr: ово је углавном интерни аргумент: користи се током gettextизације докумената. Идеја је да се у PO објекат парсирају и оригинал и превод, да се споје у нови каталог користећи msgid једног као msgid, а msgid другог као msgstr. Да би се обезбедило да све буде како треба, сваком msgid у PO објектима се даје тип, заснован на његовој структури (као "chapt", "sect1", "p" и тако даље у DocBook). Ако типови стрингова нису исти, то значи да два фајла немају исту структуру, па процес пријављује грешку.

note: type: textblock
en: This information is written as automatic comment in the PO file since this gives to translators some context about the strings to translate.
sr: Ова информација се у PO фајл уписује као аутоматски коментар јер се на тај начин преводиоцима приказује нешто од контекста у вези стрингова који треба да преведу.

note: type: textblock
en: boolean indicating whether whitespaces can be mangled in cosmetic reformattings. If true, the string is canonized before use.
sr: логичка вредност која говори да ли је код козметичких реформатирања дозвољено да се претумбају празни карактери. Ако је истинита, стринг се канонизује пре употребе.

note: type: textblock
en: This information is written to the PO file using the B<wrap> or B<no-wrap> flag.
sr: Ова информација се у PO уписује помоћу заставица B<wrap> или B<no-wrap>.

note: type: textblock
en: ignored; the key is kept for backward computability.
sr: игнорише се; кључ се чува из разлога компатибилности са ранијим верзијама.

note: type: =head1
en: Miscellaneous functions
sr: Разне функције

note: type: textblock
en: Returns the number of entries in the catalog (without the header).
sr: Враћа број ставки у каталогу (не узимајући у обзир заглавље).

note: type: textblock
en: Returns the number of entries in document. If a string appears multiple times in the document, it will be counted multiple times.
sr: Враћа број ставки у документу. Ако се стринг у документу појављује више пута, бројаће се више пута.

note: type: textblock
en: Returns the msgid of the given number.
sr: Враћа msgid датог броја.

note: type: textblock
en: Returns the msgid with the given position in the document.
sr: Враћа msgid са датом позицијом у документу.

note: type: textblock
en: Returns the type of the msgid with the given position in the document. This is probably only useful to gettextization, and it's stored separately from {$msgid}{'type'} because the later location may be overwritten by another type when the $msgid is duplicated in the master document.
sr: Враћа тип msgid стринга на задатој позицији у документу. Ово је вероватно корисно само код gettextизације и чува се одвојено од {$msgid}{'type'} јер ову локацују може да препише неки други тип када се у мастер документу $msgid дуплира.

note: type: textblock
en: Returns the character set specified in the PO header. If it hasn't been set, it will return "UTF-8".
sr: Враћа скуп карактера који је наведен у PO заглављу. Ако није било постављено, вратиће „UTF-8”.

note: type: textblock
en: Locale::Po4a::Pod - convert POD data from/to PO files
sr: Locale::Po4a::Pod - двосмерна конверзија POD података и PO фајлова

note: type: verbatim
en:     use Locale::Po4a::Pod;
        my $parser = Locale::Po4a::Pod->new();
    
        # Read POD from STDIN and write to STDOUT.
        $parser->parse_from_filehandle;
    
        # Read POD from file.pod and write to file.txt.
        $parser->parse_from_file ('file.pod', 'file.txt');
sr:     use Locale::Po4a::Pod;
        my $parser = Locale::Po4a::Pod->new();
    
        # Читај POD са STDIN и пиши на STDOUT.
        $parser->parse_from_filehandle;
    
        # Читај POD из file.pod и пиши у file.txt.
        $parser->parse_from_file ('file.pod', 'file.txt');

note: type: textblock
en: Locale::Po4a::Pod is a module to help the translation of documentation in the POD format (the preferred language for documenting Perl) into other [human] languages.
sr: Locale::Po4a::Pod је модул који помаже превођење документације у POD формату (препоручени језик за документовање Perl кода) на друге [људске] језике.

note: type: textblock
en: A new L<SimplePod|Locale::Po4a::SimplePod> parser is now available.  Please consider using it instead of the current Pod module.  If you encounter any bugs, your reports would be greatly appreciated.
sr: Сада је доступан нови L<SimplePod|Locale::Po4a::SimplePod> парсер. Молимо вас да га користите уместо текућег Pod модула. У случају да нађете на било какве багове, бићемо вам захвални ако поднесете извештаје о багу.

note: type: textblock
en: The above warning message will be displayed for a transitional period.  To disable it, set the C<no-warn-simple> option.
sr: У прелазном периоду ће се исплаћивати горња порука упозорења. Ако желите да је искључите, поставите опцију C<no-warn-simple>.

note: type: textblock
en: I think that this module is rock stable, and there is only one known bug with F</usr/lib/perl5/Tk/MainWindow.pod> (and some other pages, see below) which contains:
sr: Мислим да је овај модул чврст као стена, и постоји само један познати баг са F</usr/lib/perl5/Tk/MainWindow.pod> (и неким другим страницама, погледајте ниже) које садрже:

note: type: textblock
en: Lack of luck, in the po4a version, this was split on the space by the wrapping. As result, in the original version, the man page contains:
sr: Нема среће, у po4a верзији, ово је било подељено обавијањем на размаку. Као резултат, у оригиналној верзији, man страница садржи:

note: type: textblock
en: and mine contains:
sr: а моја садржи:

note: type: textblock
en: which is logic since CE<lt>foobarE<gt> is rewritten "foobar".
sr: што је и логично јер се CE<lt>foobarE<gt> поново исписује као "foobar".

note: type: textblock
en: Complete list of pages having this problem on my box (from 564 pages; note that it depends on the chosen wrapping column):
sr: Комплетна листа страница које имају овај проблем на мојој машини (од 564 страница; запазите да зависи од изабране колоне за обавијање):

note: type: =head1
en: INTERNALS
sr: ДЕТАЉИ ИНТЕРНОГ ФУНКЦИОНИСАЊА

note: type: textblock
en: As a derived class from Pod::Parser, Locale::Po4a::Pod supports the same methods and interfaces.  See L<Pod::Parser> for all the details; briefly, one creates a new parser with C<< Locale::Po4a::Pod->new() >> and then calls either parse_from_filehandle() or parse_from_file().
sr: Као класа изведена из Pod::Parser, Locale::Po4a::Pod подржава исте методе и интерфејсе. Погледајте L<Pod::Parser> за све детаље; укратко, креира се нови парсер са C<< Locale::Po4a::Pod->new() >> и затим се позива или parse_from_filehandle() или parse_from_file().

note: type: textblock
en: Locale::Po4a::RubyDoc -- Convert Ruby Document data from/to PO files
sr: Locale::Po4a::RubyDoc - двосмерна конверзија Ruby Document података и PO фајлова

note: type: textblock
en: Locale::Po4a::RubyDoc is a module to help the translation of documentation in the Ruby Document (RD) format (a language used to document Ruby) into other [human] languages.
sr: Locale::Po4a::RubyDoc је модул који помаже превођење документације у Ruby Document (RD) формату (језик који се користи за документовање Ruby кода) на друге [људске] језике.

note: type: textblock
en: This module has been successfully tested on simple Ruby Document files covering a good part of the format syntax.
sr: Овај модул је успешно тестиран на једноставним Ruby Document фајловима који покривају већи део синтаксе формата.

note: type: textblock
en: A known limitation is that it fails to properly recognize the stacked structure of input Ruby Document: this implies that when, for instance, an EnumListItem consists of more than one Block, only the first Block is actually recognized as EnumListItem, while the subsequent ones are considered just as TextBlocks...
sr: Познато ограничење је што не успева исправно да препозна наслагану структуру улазног Ruby Document фајла: на пример када се EnumListItem састоји од више блокова, само први се препознаје као EnumListItem, док се остали сматрају за обичне TextBlock...

note: type: textblock
en: This module supports the following option:
sr: Овај модул прихвата следеће опције:

note: type: textblock
en: Handle files entirely made of Ruby Document formatted text (without any "=begin" line).
sr: Обрада чистих Ruby Document форматираних текстова (без и једне „=begin” линије).

note: type: textblock
en: By default, this module only handles Ruby Document formatted text between "=begin" and "=end" lines (hence ignoring, among other things, everything that precedes the first "=begin" line).
sr: Овај модул подразумевано обрађује само Ruby Document форматирани текст између „=begin” и „=end” линија (игноришући, између осталог, и све испред прве „=begin” линије).

note: type: textblock
en: Francesco Poli <invernomuto@paranoici.org>
sr: Франческо Поли <invernomuto@paranoici.org>

note: type: verbatim
en:  Copyright © 2016-2017 Francesco Poli <invernomuto@paranoici.org>
sr:  Ауторска права © 2016-2017 Франческо Поли <invernomuto@paranoici.org>

note: type: textblock
en: This work is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
sr: Овај рад је слободни софтвер; можете за редистрибуирати и/или мењати под условима ГНУ Опште јавне лиценце, оне коју је објавила Фондација слободног софтвера; или верзије 2, или (према вашем мишљењу) било које касније верзије.

note: type: textblock
en: This work is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
sr: Овај рад се дистрибуира у нади да ће бити користан, али БЕЗ БИЛО КАКВЕ ГАРАНЦИЈЕ; чак и без подразумеване гаранције МОГУЋНОСТИ ПРОДАЈЕ или ПОДОБНОСТИ ЗА ОДРЕЂЕНУ УПОТРЕБУ. За више детаља, погледајте ГНУ Општиу јавну лиценцу.

note: type: textblock
en: You should have received a copy of the GNU General Public License along with this work; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
sr: Требало је да сте уз овај рад добили и копију ГНУ Опште јавне лиценце; у случају да нисте, пишите на адресу Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

note: type: textblock
en: Parts of the code (such as many regular expressions) were adapted from the source of rdtool, under the terms of the GNU General Public License, version 2 or later.  These parts are originally:
sr: Делови кода (као што су многи регуларни изрази)су прилагођени из изворног кода алата rdtool, под условима ГНУ Опште јавне лиценце, верзије 2 или касније. Ови делови су оригинално:

note: type: verbatim
en:  Copyright © 2004      MoonWolf <moonwolf@moonwolf.com>
     Copyright © 2011-2012 Youhei SASAKI <uwabami@gfd-dennou.org>
sr:  Ауторска права © 2004      MoonWolf <moonwolf@moonwolf.com>
     Ауторска права © 2011-2012 Јухеи САСАКИ <uwabami@gfd-dennou.org>

note: type: textblock
en: The initialize code was adapted from the source of Locale::Po4a::Text, under the terms of the GNU General Public License, version 2 or later.  This code was originally:
sr: Иницијализациони код је адаптиран из изворног кода Locale::Po4a::Text, под условима ГНУ Опште јавне лиценце, верзије 2 или касније. Овај код је био оригинално:

note: type: verbatim
en:  Copyright © 2005-2008 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>
sr:  Ауторска права © 2005-2008 Никола ФРАНСОА <nicolas.francois@centraliens.net>

note: type: textblock
en: Locale::Po4a::Sgml - convert SGML documents from/to PO files
sr: Locale::Po4a::Sgml - двосмерна конверзија SGML докумената и PO фајлова

note: type: textblock
en: Locale::Po4a::Sgml is a module to help the translation of documentation in the SGML format into other [human] languages.
sr: Locale::Po4a::Sgml је модул који помаже превођење документације у SGML формату на друге [људске] језике.

note: type: textblock
en: This module uses B<onsgmls>(1) to parse the SGML files. Make sure it is installed.  Also make sure that the DTD of the SGML files are installed in the system.
sr: Овај модул користи B<onsgmls>(1) за парсирање SGML фајлова. Неопходно је да га имате инсталираног. Такође обезбедите да је на систему инсталиран DTD за SGML фајлове.

note: type: textblock
en: Space-separated list of keywords indicating which category of extra debug messages should be shown. Possible values are: C<entities>, C<generic>, C<onsgml>, C<refs> and C<tag>.
sr: Листа кључних речи раздвојена размацима које назначавају категорију додатних дибаг порука које треба да се прикажу. Могуће вредности су: C<entities>, C<generic>, C<onsgml>, C<refs> и C<tag>.

note: type: textblock
en: Give more information about what's going on.
sr: Даје више информација о ономе што се догађа.

note: type: textblock
en: Space-separated list of extra tags (beside the DTD provided ones) whose content should form an extra msgid, i.e that should be translated.
sr: Листа додатних ознака (уз оне које наводи DTD) раздвојених размацима, чији садржај би требало да чини додатне msgid, тј. које би требало да се преведу.

note: type: textblock
en: Space-separated list of extra tags (beside the DTD provided ones)  containing other tags, some of them being of category B<translate>.
sr: Листа додатних ознака (уз оне које наводи DTD)  раздвојених размацима, која садржи остале ознаке, од којих су неки у категорији B<translate>.

note: type: textblock
en: Space-separated list of tags which increase the indentation level. This will affect the indentation in the resulting document.
sr: Листа ознака раздвојених размацима које увећавају ниво увлачења. Ово ће да утиче на увлачење у излазном документу.

note: type: textblock
en: The layout within those tags should not be changed. The paragraph won't get wrapped, and no extra indentation space or new line will be added for cosmetic purpose.
sr: Распоред текста унутар ових ознака не би требало да се мења. Пасус неће да се обавије, и неће из козметичких разлога да се додају екстра простор увлачења или прелом линије.

note: type: textblock
en: Tags not needing to be closed.
sr: Ознаке које не морају да се затворе.

note: type: textblock
en: Tags ignored and considered as plain char data by po4a. That is to say that they can be part of an msgid. For example, E<lt>bE<gt> is a good candidate for this category since putting it in the B<translate> section would create a msgids with only its content, (and it's usually not a whole sentence), which is bad.
sr: Ознаке које се игноришу и које програм po4a сматра за просте карактер податке. Другим речима, они могу да буду део msgid. На пример, E<lt>bE<gt> је одличан кандидат за ову категорију јер ако се постави у B<translate> одељак, креирали би се msgid стрингови само са његовим садржајем (а који обично нису целе реченице), што је лоше.

note: type: textblock
en: A space-separated list of attributes that need to be translated. You can specify the attributes by their name (for example, C<lang>), but you can also prefix it with a tag hierarchy, to specify that this attribute will only be translated when it is into the specified tag. For example: C<< <bbb><aaa>lang >> specifies that the lang attribute will only be translated if it is in an C<< <aaa> >> tag, which is in a C<< <bbb> >> tag.  The tag names are actually regular expressions so you can also write things like C<< <aaa|bbb>lang >> to only translate C<lang> attributes that are in an C<< <aaa> >> or a C<< <bbb> >> tag.
sr: Листа атрибута раздвојених размацима који требају да се преведу. Атрибуте можете да наведете њиховим именом (на пример, C<lang>), али такође можете испред атрибута да наведете хијерархију ознака, како бисте назначили да тај атрибут треба да се преведе само онда када се налази унутар одређене ознаке. На пример: C<< <bbb><aaa>lang >> наводи да ће lang атрибут да се преведе само у случају да се налази у C<< <aaa> >> ознаци, која се налази у C<< <bbb> >> ознаци.  Имена ознака су у ствари регуларни изрази, тако да можете написати нешто као што је C<< <aaa|bbb>lang >> да преведете само C<lang> атрибуте који се налазе у C<< <aaa> >>или C<< <bbb> >> ознаци.

note: type: textblock
en: A space-separated list of attributes for which the translation must be qualified by the attribute name, i.e. the text extracted for the translation will include both the attributes name and it's value. e.g. for a tag like C<< <aaa lang_en="foo"> >> translators will be presented with the string C<lang_en="foo">. Note that this also automatically adds the given attribute into the B<attributes> list too.
sr: Листа атрибута раздвојених размацима за које превод мора да се квалификује именом атрибута, тј. текст који се издваја за превођење ће садржати и име атрибута и његову вредност, нпр. за ознаку као што је C<< <aaa lang_en="foo"> >> преводиоци ће добити стринг C<lang_en="foo">. Имајте на уму да ово подешавање такође аутоматски додаје дате атрибуте и у B<attributes> листу.

note: type: textblock
en: Proceed even if the DTD is unknown or if B<onsgmls> finds errors in the input file.
sr: Наставља даље чак и у случају да је DTD непознат, или да B<onsgmls> пронађе грешке у улазном фајлу.

note: type: textblock
en: By default, msgids containing only one entity (like C<&version;>) are skipped for the translators' comfort. Activating this option prevents this optimisation. It can be useful if the document contains a construction like C<< <title>&Aacute;</title> >>, even if I doubt such things to ever happen...
sr: Подразумевано, msgid стрингови који садрже само један ентитет (као C<&version;>) се прескачу како би са преводиоцу олакшао посао. Активирање ове опције спречава ту оптимизацију. Може да буде корисно у случају да документ садржи конструкцију као што је C<< <title>&Aacute;</title> >>, мада ја чисто сумњам да сличне ствари могу икада да се догоде...

note: type: textblock
en: Space-separated list of entities that won't be inlined.  Use this option with caution: it may cause B<onsgmls> (used internally) to add tags and render the output document invalid.
sr: Листа ентитета раздвојених размацима који неће да се поставе у једну линију.  Ову опцију користите уз опрез: због ње би B<onsgmls> (који се интерно користи) могао да дода ознаке и учини излазни документ неважећим.

note: type: textblock
en: The result is perfect. I.e., the generated documents are exactly the same as the originals. But there are still some problems:
sr: Резултат је савршен. Тј. генерисани документи су потпуно исти као и оригинали. Али ипак постоје још неки проблеми:

note: type: =item
en: The error output of B<onsgmls> is redirected to /dev/null by default, which is clearly bad. I don't know how to avoid that.
sr: Излаз за грешке програма B<onsgmls> се подразумевано преусмерава на /dev/null, што је очигледно лоше. Не знам како да се то спречи.

note: type: textblock
en: The problem is that I have to "protect" the conditional inclusions (i.e. the C<E<lt>! [ %foo [> and C<]]E<gt>> stuff) from B<onsgmls>. Otherwise B<onsgmls> eats them, and I don't know how to restore them in the final document. To prevent that, I rewrite them to C<{PO4A-beg-foo}> and C<{PO4A-end}>.
sr: Проблем је што морам да „заштитим” условне инклузије (нпр. C<E<lt>! [ %foo [> and C<]]E<gt>> ствар) од програма B<onsgmls>. Иначе би их програм B<onsgmls> појео, а ја не знам како да их повратим назад у финални документ. Како би ово спречио, ја их препишем у C<{PO4A-beg-foo}> и C<{PO4A-end}>.

note: type: textblock
en: The problem with this is that the C<{PO4A-end}> and such I add are invalid in the document (not in a E<lt>pE<gt> tag or so).
sr: Проблем са овим је што су C<{PO4A-end}> и слично што додајем неважећи у документу (нису унутар E<lt>pE<gt> ознаке и слично).

note: type: textblock
en: If you want to view the B<onsgmls> output, just add the following to your command line (or po4a configuration line):
sr: Ако желите да видите излаз програма B<onsgmls>, једноставно додајте следеће у своју командну линију (или у po4a конфигурациону линију):

note: type: =item
en: It does work only with the DebianDoc and DocBook DTD. Adding support for a new DTD should be very easy. The mechanism is the same for every DTD, you just have to give a list of the existing tags and some of their characteristics.
sr: Функционише једино са DebianDoc и DocBook DTD. Додавање подршке за нови DTD би требало да буде веома једноставно. Механизам је исти за сваки DTD, потребно је само да задате листу постојећих ознака и неке од њихових карактеристика.

note: type: textblock
en: I agree, this needs some more documentation, but it is still considered as beta, and I hate to document stuff which may/will change.
sr: Слажем се, за ово је потребна детаљнија документација, али се и даље сматра да је бета, а ја мрзим да документујем ствари које би могле, или ће, да се измене.

note: type: =item
en: Warning, support for DTDs is quite experimental. I did not read any reference manual to find the definition of every tag. I did add tag definition to the module 'till it works for some documents I found on the net. If your document use more tags than mine, it won't work. But as I said above, fixing that should be quite easy.
sr: Упозорење, подршка за DTD-ове је прилично експериментална. Нисам читао било какво референтно упутство да пронађем дефиницију сваке ознаке. Модулу сам додавао дефиниције ознака све док није прорадио за неке документе које сам пронашао на интернету. Ако ваш документ користи више ознака него мој, онда модул неће моћи да функционише. Али као што сам већ рекао, исправљање тог проблема би требало да је прилично једноставно.

note: type: textblock
en: I did test DocBook against the SAG (System Administrator Guide) only, but this document is quite big, and should use most of the DocBook specificities.
sr: DocBook сам тестирао само са SAG (System Administrator Guide), али овај документ је прилично велики, и требало би да користи већину специфичности DocBook формата.

note: type: textblock
en: For DebianDoc, I tested some of the manuals from the DDP, but not all yet.
sr: За DebianDoc, тестирао сам нека упутства са DDP, али још не сва.

note: type: =item
en: In case of file inclusion, string reference of messages in PO files (i.e. lines like C<#: en/titletoc.sgml:9460>) will be wrong.
sr: У случају укључивања фајлова, стринг референце у PO фајловима (нпр. линије као што је C<#: en/titletoc.sgml:9460>) ће бити погрешне.

note: type: textblock
en: This is because I preprocess the file to protect the conditional inclusion (i.e. the C<E<lt>! [ %foo [> and C<]]E<gt>> stuff) and some entities (like C<&version;>) from B<onsgmls> because I want them verbatim to the generated document. For that, I make a temp copy of the input file and do all the changes I want to this before passing it to B<onsgmls> for parsing.
sr: То је зато што препроцесирам фајл како би заштитио условну инклузију (нпр. C<E<lt>! [ %foo [> и C<]]E<gt>> ствари) и неке ентитете (као C<&version;>) од програма B<onsgmls>, јер желим неизмењене да их пребацим у генерисани документ. Да би то постигао, правим привремену копију улазног фајла и вршим све измене које желим над овом копијом пре прослеђивања фајла програму B<onsgmls> на парсирање.

note: type: textblock
en: So that it works, I replace the entities asking for a file inclusion by the content of the given file (so that I can protect what needs to be in a subfile also). But nothing is done so far to correct the references (i.e., filename and line number) afterward. I'm not sure what the best thing to do is.
sr: Да би радило како треба, ентитете који траже инклузију фајла мењам садржајем траженог фајла (тако да такође штитим и оно што треба да буде у подфајлу). Али до сада се ништа није урадило како би се након тога исправиле референце (нпр. име фајла и број линије). Нисам сигуран шта је најбоље да се уради.

note: type: textblock
en: This module is an adapted version of sgmlspl (SGML postprocessor for the ONSGMLS parser) which was:
sr: Овај модул је прилагођена верзија sgmlspl (SGML постпроцесор за ONSGMLS парсер) који је био:

note: type: verbatim
en:  Copyright © 1995 David Megginson <dmeggins@aix1.uottawa.ca>
sr:  Права умножавања © 1995 Дејвид Мегинсон <dmeggins@aix1.uottawa.ca>

note: type: textblock
en: The adaptation for po4a was done by:
sr: Прилагођавање за po4a је урадио:

note: type: verbatim
en:  Copyright © 1995 David Megginson <dmeggins@aix1.uottawa.ca>.
     Copyright © 2002-2005 SPI, Inc.
sr:  Права умножавања © 1995 Дејвид Мегинсон <dmeggins@aix1.uottawa.ca>.
     Права умножавања © 2002-2005 SPI, Inc.

note: type: textblock
en: Locale::Po4a::SimplePod - convert POD data from/to PO files, with Pod::Simple
sr: Locale::Po4a::SimplePod - двосмерна конверзија POD података и PO фајлова са Pod::Simple

note: type: verbatim
en:   [po4a_paths] /path/to/pot $lang:/path/to/po
      [type:SimplePod] /path/to/source.pod $lang:/path/to/localized.pod
sr:   [po4a_paths] /путања/до/pot $lang:/путања/до/po
      [type:SimplePod] /путања/до/извор.pod $lang:/путања/до/локализовани.pod

note: type: textblock
en: or
sr: или

note: type: verbatim
en:   [po4a_paths] /path/to/pot $lang:/path/to/po
      [po4a_alias:pod] SimplePod
      [type:pod] /path/to/source.pod $lang:/path/to/localized.pod
sr:   [po4a_paths] /путања/до/pot $lang:/путања/до/po
      [po4a_alias:pod] SimplePod
      [type:pod] /путања/до/извор.pod $lang:/путања/до/локализовани.pod

note: type: textblock
en: This is a module to help the translation of documentation in the POD format (the preferred language for documenting Perl) into other human languages.
sr: Ово је модул који помаже превођење документације у POD формату (препоручени језик за документовање Perl кода) на друге људске језике.

note: type: textblock
en: The main differences between the current Pod format and the SimplePod format are as follows:
sr: Главне разлике између текућег Pod формата и SimplePod формата су:

note: type: =item
en: SimplePod format never includes additional newlines in messages to be translated.  The current Pod format, however, may contain extra newlines, particularly in verbatim message entries.
sr: SimplePod формат у поруке које се преводе никада не укључује додатне преломе редова. Текући Pod формат, међутим, може да има додатне преломе редова, посебно у ставкама дословних порука.

note: type: =item
en: Paragraphs may be rendered with line wrapping.  The L<Pod::Parser> module might apply special handling for line wrapping, making it difficult to replicate with L<Pod::Simple>.  However, L<Pod::Simple> appears to produce a more natural output.
sr: Пасуси могу да се исписују са обавијањем. Модул L<Pod::Parser> би могао да промени специјалну обраду за обавијање линија, што се тешко може постићи са L<Pod::Simple>. Ипак, изгледа да L<Pod::Simple> производи природнији излаз.

note: type: =item
en: In SimplePod, the C<=for> message (e.g., C<=for comment text>) does not include a format name (such as C<comment>), so the message consists solely of text.  In contrast, the current Pod format retains the format name, resulting in a message like C<comment text>.  The former behavior is considered more comfortable for translators.
sr: У SimplePod, C<=for> порука (нпр. C<=for comment text>) не укључује име формата (као што је C<comment>), тако да се порука састоји само од текста. За разлику од тога, текући Pod формат задржава име формата, па је резултат порука као што је C<comment text>. Сматра се да је оно прво понашање удобније за преводиоце.

note: type: =item
en: Entries like the one below, which denote C<=end comment>, are no longer present as seen in the current Pod module.  Since these are not translatable messages, their absence is an improvement.
sr: Ставке као што је она испод, која означава C<=end comment>, више нису присутне као што се виде у текућем Pod модулу. Пошто ове поруке не могу да се преведу, њихово одсуство представља побољшање.

note: type: =item
en: Text blocks whose POD format validity is uncertain are now treated as C<no-wrap>.  This applies, for example, to the content within a C<=begin html> block.  In the Pod module, these were not treated as C<no-wrap>, which sometimes resulted in line wrapping.
sr: Блокови текста за које није сигурно да поштују POD формат сада се третирају као C<no-wrap>. Ово се, на пример, примењује на садржај унутар C<=begin html> блока. У Pod модулу, они се нису третирали као C<no-wrap>, па је понекад последица тога било обавијање линије.

note: type: =item
en: The C<=begin> parameter section is no longer subject to translation.  In the current Pod module, it is included.  If there is a demand to include it in translation, please report it.
sr: Одељак C<=begin> параметра више није предмет превођења. У текућем Pod модулу, он се преводи. Ако постоји потреба да се укључи у превод, молимо вас да то пријавите.

note: type: textblock
en: This module is still newly developed, so it is less stable than L<Locale::Po4a::Pod>.  It continues to evolve, and there is room for further refinement.  Its behavior might change over time, and additional options may be introduced to better optimize the translation experience for users.  Feedback and use cases from real-world applications will play a key role in guiding its future development.
sr: Овај модул се још увек развија, тако да није стабилан као L<Locale::Po4a::Pod>. Још увек еволуира и постоји простор за даља унапређења. Временом се његово понашање може променити, и можда ће се увести додатне опције за бољу оптимизацију корисничког искуства превођења. Повратне информације и случајеви употребе из реалних апликација ће имати одлучујућу улогу у смеру даљег развоја.

note: type: textblock
en: The code is fully covered by our test suite, and we're not aware of any existing bugs.  However, as of 2025, it hasn't been battle-tested in real-world translation workflows by external projects.  That said, we believe the module is ready for production use, even if some bugs may inevitably be discovered as it gains wider adoption.
sr: Код је у потпуности покривен нашом свитом тестова и немамо сазнања о било каквим постојећим баговима. Ипак, у 2025 години, није подробно тестиран у реалним преводилачким токовима рада у постојећим пројектима. С тим у виду, верујемо да је модул спреман за праву употребу, чак и ако се током ширег прихватања открију неки неизбежни багови.

note: type: textblock
en: This module is intended to replace the current L<Locale::Po4a::Pod> module.  The reason is that L<Pod::Parser>, which is used by the current L<Locale::Po4a::Pod>, is now deprecated, and it is recommended to use L<Pod::Simple> instead.  See also L<GitHub issue #256 "Consider migrating away from deprecated C<Pod::Parser>"|https://github.com/mquinson/po4a/issues/256>.
sr: Предвиђено је да овај модул замени текући L<Locale::Po4a::Pod> модул. Разлог за то је што је L<Pod::Parser>, који користи текући L<Locale::Po4a::Pod>, сада превазиђен, и препорука је да се уместо њега користи L<Pod::Simple>. Погледајте и L<GitHub issue #256 "Consider migrating away from deprecated C<Pod::Parser>"|https://github.com/mquinson/po4a/issues/256>.

note: type: verbatim
en:   Copyright (C) 2025 gemmaro <gemmaro.dev@gmail.com>.
sr:   Права умножавања (C) 2025 gemmaro <gemmaro.dev@gmail.com>.

note: type: textblock
en: Locale::Po4a::TeX - convert TeX documents and derivatives from/to PO files
sr: Locale::Po4a::TeX - двосмерна конверзија TeX (и изведених из њега) докумената и PO фајлова

note: type: textblock
en: Locale::Po4a::TeX is a module to help the translation of TeX documents into other [human] languages. It can also be used as a base to build modules for TeX-based documents.
sr: Locale::Po4a::TeX је модул који помаже превођење TeX докумената на друге [људске] језике. Може да се користи и као основа за изградњу модула који обрађују документе базиране на TeX.

note: type: textblock
en: Users should probably use the LaTeX module, which inherits from the TeX module and contains the definitions of common LaTeX commands.
sr: Корисници би углавном требало да користе LaTeX модул, јер је он изведен из TeX модула и садржи дефиниције уобичајених LaTeX команди.

note: type: =head1
en: TRANSLATING WITH PO4A::TEX
sr: ПРЕВОЂЕЊЕ СА PO4A::TEX

note: type: textblock
en: This module can be used directly to handle generic TeX documents.  This will split your document in smaller blocks (paragraphs, verbatim blocks, or even smaller like titles or indexes).
sr: Овај модул може директно да се користи за обраду генеричких TeX докумената. Он ће да издели ваш документ на мање блокове (пасусе, дословне блокове, или чак мање, као што су наслови или индекси).

note: type: textblock
en: There are some options (described in the next section) that can customize this behavior.  If this doesn't fit to your document format you're encouraged to write your own derivative module from this, to describe your format's details.  See the section B<WRITING DERIVATE MODULES> below, for the process description.
sr: Постоје неке опције (описане у наредном одељку) које могу да прилагоде ово понашање. Ако се не уклапа у формат вашег документа, најбоље је да напишете ваш сопствени модул изведен из овога, који ће да опише детаље вашег формата. Погледајте одељак B<ПИСАЊЕ ИЗВЕДЕНИХ МОДУЛА> испод, да сазнате више о том процесу.

note: type: textblock
en: This module can also be customized by lines starting with "% po4a:" in the TeX file. This process is described in the B<INLINE CUSTOMIZATION> section.
sr: Овај модул такође може да се прилагоди линијама у TeX фајлу које почињу са „% po4a:”. Овај процес је описан у одељку B<ПРИЛАГОЂАВАЊЕ ИЗ САМОГ ФАЈЛА>.

note: type: textblock
en: Comma-separated list of environments which should not be re-wrapped.
sr: Листа окружења раздвојених зарезима која не би требало да се поново обавијају.

note: type: textblock
en: Note that there is a difference between verbatim and no_wrap environments.  There is no command and comments analysis in verbatim blocks.
sr: Имајте на уму да постоји разлика између дословног и no_wrap окружења. У дословним блоковима се не ради анализа команди и коментара.

note: type: textblock
en: If this environment was not already registered, po4a will consider that this environment does not take any parameters.
sr: Ако ово окружење није већ раније регистровано, програм po4a ће сматрати да ово окружење не узима никакве параметре.

note: type: textblock
en: Colon-separated list of files that should not be included by \input and \include.
sr: Листа фајлова раздвојених зарезима које команде \input и \include не би требало да прикључе.

note: type: textblock
en: Comma-separated list of environments which should be taken as verbatim.
sr: Листа окружења раздвојених зарезима која би требало да се пренесу дословно.

note: type: textblock
en: Use these options to override the default behavior of the defined commands.
sr: Употребите ове опције да преиначите подразумевано понашање дефинисаних команди.

note: type: textblock
en: The TeX module can be customized with lines starting by B<% po4a:>.  These lines are interpreted as commands to the parser.  The following commands are recognized:
sr: TeX модул може да се прилагоди линијама које почињу са B<% po4a:>. Ове линије се интерпретирају као команде парсера. Препознају се следеће команде:

note: type: =item
en: B<% po4a: command> I<command1> B<alias> I<command2>
sr: B<% po4a: command> I<команда1> B<alias> I<команда2>

note: type: textblock
en: Indicates that the arguments of the I<command1> command should be treated as the arguments of the I<command2> command.
sr: Наводи да би аргументи команде I<команда1> требало да се третирају као аргументи команде I<команда2>.

note: type: =item
en: B<% po4a: command> I<command1> I<parameters>
sr: B<% po4a: command> I<команда1> I<параметри>

note: type: textblock
en: This describes in detail the parameters of the I<command1> command.  This information will be used to check the number of arguments and their types.
sr: Ово детаљно описује параметре команде I<команда1>. Ова информација ће да се употреби за проверу броја аргумената и њихових типова.

note: type: textblock
en: You can precede the I<command1> command by
sr: Испред команде I<команда1> можете да ставите

note: type: =item
en: an asterisk (B<*>)
sr: звездицу (B<*>)

note: type: textblock
en: po4a will extract this command from paragraphs (if it is located at the beginning or the end of a paragraph).  The translators will then have to translate the parameters that are marked as translatable.
sr: Програм po4a ће ову команду да издвоји из пасуса (ако се налази на почетку или крају пасуса). Преводиоци ће онда морати да преведу параметре који су обележени као преводиви.

note: type: =item
en: a plus (B<+>)
sr: знак плус (B<+>)

note: type: textblock
en: As for an asterisk, the command will be extracted if it appear at an extremity of a block, but the parameters won't be translated separately.  The translator will have to translate the command concatenated to all its parameters.  This keeps more context, and is useful for commands with small words in parameter, which can have multiple meanings (and translations).
sr: Као за звездицу, команда ће да се издвоји у случају да се налази на крајевима блока, али параметри се неће преводити одвојено. Преводилац ће морати да преведе команду спојену са свим својим параметрима. На овај начин се задржава више контекста, и корисно је за команде са малим речима у параметрима, које могу да имају вишеструка значења (и преводе).

note: type: textblock
en: Note: In this case you don't have to specify which parameters are translatable, but po4a must know the type and number of parameters.
sr: Напомена: у овом случају не морате да наведете који параметри су преводиви, али програм po4a мора да зна типове и број параметара.

note: type: =item
en: a minus (B<->)
sr: знак минус (B<->)

note: type: textblock
en: In this case, the command won't be extracted from any block.  But if it appears alone on a block, then only the parameters marked as translatable will be presented to the translator.  This is useful for font commands.  These commands should generally not be separated from their paragraph (to keep the context), but there is no reason to annoy the translator with them if a whole string is enclosed in such a command.
sr: У овом случају команда неће да са издваја из било којег блока. Али ако се у блоку појави сама, онда ће се преводиоцу приказати само параметри означени као преводиви. Ово је корисно за фонт команде. У општем случају, ове команде не би требало да се одвајају од својих пасуса (да би се сачувао контекст), али нема разлога да се преводилац њима узнемирава ако је таквом командом уоквирен комплетан стринг.

note: type: verbatim
en: The I<parameters> argument is a set of [] (to indicate an optional
    argument) or {} (to indicate a mandatory argument).
    You can place an underscore (_) between these brackets to indicate that
    the parameter must be translated. For example:
     % po4a: command *chapter [_]{_}
sr: Аргумент I<параметри> је скуп [] (да се наведе опционални
    аргумент) или {} (да се наведе обавезан аргумент).
    Између ових заграда можете да ставите доњу црту (_) да бисте назначили
    да параметар мора да се преведе. На пример:
     % po4a: command *chapter [_]{_}

note: type: verbatim
en: This indicates that the chapter command has two parameters: an optional
    (short title) and a mandatory one, which must both be translated.
    If you want to specify that the href command has two mandatory parameters,
    that you don't want to translate the URL (first parameter), and that you
    don't want this command to be separated from its paragraph (which allow
    the translator to move the link in the sentence), you can use:
     % po4a: command -href {}{_}
sr: Ово указује да команда chapter има два параметра: опционални
    (кратак наслов) и обавезни, и да оба морају да се преведу.
    Ако желите да наведете да команда href има два обавезна параметра,
    и да не желите да преведете URL (први параметар), и да не
    желите да се ова команда издвоји из свог пасуса (што преводиоцу
    омогућава да помера везу по реченици), можете да употребите:
     % po4a: command -href {}{_}

note: type: textblock
en: In this case, the information indicating which arguments must be translated is only used if a paragraph is only composed of this href command.
sr: У овом случају, информација која говори који аргументи морају да се преведу, биће искоришћена само онда када је ова href команда једини садржај пасуса.

note: type: =item
en: B<% po4a: environment> I<env> I<parameters>
sr: B<% po4a: environment> I<окр> I<параметри>

note: type: verbatim
en: This defines the parameters accepted by the I<env> environment and specifies the ones to be translated.
    This information is later used to check the number of arguments of the
    \begin command.
    The syntax of the I<parameters> argument is the same as described for the
    others commands.
    The first parameter of the \begin command is the name of the environment.
    This parameter must not be specified in the list of parameters. Here are
    some examples:
     % po4a: environment multicols {}
     % po4a: environment equation
sr: Ово дефинише параметре које прихвата окружење I<окр> и наводи оне који треба да се преведу.
    Та информација се касније користи за проверу броја аргумената команде
    \begin, и дозвољава да се наведе који од њих морају да се преведу.
    Синтакса аргумента I<параметри> је иста као што је описано за остале
    команде.
    Први параметар команде \begin је име окружења.
    Овај параметар не сме да се наведе у листи параметара. Ево неколико
    примера:
     % po4a: environment multicols {}
     % po4a: environment equation

note: type: textblock
en: As for the commands, I<env> can be preceded by a plus (+) to indicate that the \begin command must be translated with all its arguments.
sr: Што се тиче команди, испред I<окр> може да се стави (+) чиме се назначава да команда \begin мора бити преведена заједно са свим својим аргументима.

note: type: =item
en: B<% po4a: separator> I<env> B<">I<regex>B<">
sr: B<% po4a: separator> I<окр> B<">I<регизраз>B<">

note: type: textblock
en: Indicates that an environment should be split according to the given regular expression.
sr: Назначава да би окружење требало да се подели сагласно са датим регуларним изразом.

note: type: textblock
en: The regular expression is delimited by quotes.  It should not create any back-reference.  You should use (?:) if you need a group.  It may also need some escapes.
sr: Регуларни израз је омеђен знацима навода. Не би требало да креира никакве повратне референце. Ако вам је потребна група, употребите (?:). Могуће је да ће бити потребно означавање специјалних карактера.

note: type: textblock
en: For example, the LaTeX module uses the "(?:&|\\\\)" regular expression to translate separately each cell of a table (lines are separated by '\\' and cells by '&').
sr: На пример, LaTeX модул користи регуларни израз "(?:&|\\\\)" за одвојено превођење сваке ћелије табеле (линије се раздвајају са ’\\’ а ћелије са ’&’).

note: type: textblock
en: The notion of environment is expanded to the type displayed in the PO file.  This can be used to split on "\\\\" in the first mandatory argument of the title command.  In this case, the environment is title{#1}.
sr: Појам окружења се пребацује у тип приказан у PO фајлу. Ово може да се искористи за поделу на „\\\\” у првом обавезном аргументу команде наслова. У овом случају, окружење је title{#1}.

note: type: =item
en: B<% po4a: verbatim environment> I<env>
sr: B<% po4a: verbatim environment> I<окр>

note: type: textblock
en: Indicate that I<env> is a verbatim environment.  Comments and commands will be ignored in this environment.
sr: Назначава да је I<окр> дословно окружење. У овом окружењу ће да се игноришу команде и коментари.

note: type: =head1
en: WRITING DERIVATE MODULES
sr: ПИСАЊЕ ИЗВЕДЕНИХ МОДУЛА

note: type: textblock
en: Add a string as a comment to be added around the next translated element.  This is mostly useful to the texinfo module, as comments are automatically handled in TeX.
sr: Додаје стринг као коментар који се додаје око наредног преводивог елемента. Ово је углавном корисно за texinfo модул, јер TeX аутоматски води рачуна о коментарима.

note: type: textblock
en: Wrapper around Transtractor's translate, with pre- and post-processing filters.
sr: Окружујућа класа око translate методе класе Transtractor, са филтерима за пре- и пост-процесирање.

note: type: textblock
en: Comments of a paragraph are inserted as a PO comment for the first translated string of this paragraph.
sr: Коментари пасуса се умећу као PO коментар за први преводиви стринг тог пасуса.

note: type: textblock
en: This function returns:
sr: Ова функција враћа:

note: type: =item
en: A command name
sr: Име команде

note: type: textblock
en: If no command is found at the beginning of the given buffer, this string will be empty.  Only commands that can be separated are considered.  The %separated_command hash contains the list of these commands.
sr: Ако се на почетку датог бафера не пронађе ниједна команда, овај стринг ће да буде празан. У обзир се узимају само команде које могу да се раздвоје. Хеш %separated_command  садржи листу ових команди.

note: type: =item
en: A variant
sr: Варијанту

note: type: textblock
en: This indicates if a variant is used.  For example, an asterisk (*) can be added at the end of sections command to specify that they should not be numbered.  In this case, this field will contain "*".  If there is no variant, the field is an empty string.
sr: Ово назначава да се користи варијанта. На пример, на крај команде краја одељка може да се дода звездица (*) чиме се наводи да одељци не би требало да се нумеришу. У том случају, ово поље ће да садржи „*”. Ако нема варијанте, ово поље ће бити празно.

note: type: =item
en: An array of tuples (type of argument, argument)
sr: Низ дублета (тип аргумента, аргумент)

note: type: textblock
en: The type of argument can be either '{' (for mandatory arguments) or '[' (for optional arguments).
sr: Типа аргумента може да буде или ’{’ (за обавезне аргументе) или ’[’ (за опционалне аргументе).

note: type: =item
en: The remaining buffer
sr: Остатак бафера

note: type: textblock
en: The rest of the buffer after the removal of this leading command and its arguments.  If no command is found, the original buffer is not touched and returned in this field.
sr: Остатак бафера након уклањања ове водеће команде и њених аргумената. Ако се не пронађе никаква команда, оригинални бафер остаје неизмењен и враћа се у овом пољу.

note: type: textblock
en: The same as B<get_leading_command>, but for commands at the end of a buffer.
sr: Исто као B<get_leading_command>, али за команде на крају бафера.

note: type: textblock
en: Recursively translate a buffer by separating leading and trailing commands (those which should be translated separately) from the buffer.
sr: Рекурзивно преводи бафер раздвајањем из бафера водећих команди и команди са краја (оне које би требало да се преведу одвојено).

note: type: textblock
en: If a function is defined in %translate_buffer_env for the current environment, this function will be used to translate the buffer instead of translate_buffer().
sr: Ако је за текуће окружење дефинисана функција у %translate_buffer_env, за превођење бафера ће уместо translate_buffer() да се употреби та функција.

note: type: textblock
en: Overloads Transtractor's read().
sr: Преиначује функцију read() из класе Transtractor.

note: type: textblock
en: Recursively read a file, appending included files which are not listed in the @exclude_include array.  Included files are searched using the B<kpsewhich> command from the Kpathsea library.
sr: Чита фајл рекурзивно, додајући на крај прикључене фајлове који нису наведени у низу @exclude_include. Прикључени фајлови се траже командом B<kpsewhich> из Kpathsea библиотеке.

note: type: textblock
en: Except from the file inclusion part, it is a cut and paste from Transtractor's read.
sr: Осим дела за прикључивање фајла, ово је чиста копија функције за читање из класе Transtractor.

note: type: textblock
en: Subroutine for parsing a file with po4a directives (definitions for new commands).
sr: Подрутина за парсирање фајла са директивама за програм po4a (дефиниције за нове команде).

note: type: textblock
en: Parse a definition line of the form "% po4a: ".
sr: Парсира линију дефиниције у облику „% po4a: ”.

note: type: textblock
en: See the B<INLINE CUSTOMIZATION> section for more details.
sr: За више детаља, погледајте одељак B<ПРИЛАГОЂАВАЊЕ ИЗ САМОГ ФАЈЛА>.

note: type: =head1
en: INTERNAL FUNCTIONS used to write derivative parsers
sr: ИНТЕРНЕ ФУНКЦИЈЕ које се користе за писање изведених парсера

note: type: textblock
en: Command and environment functions take the following arguments (in addition to the $self object):
sr: Функције за команде и окружења узимају следеће аргументе (поред $self објекта):

note: type: =item
en: An array of (type, argument) tuples
sr: Низ (тип, аргумент) дуплета

note: type: =item
en: The current environment
sr: Текуће окружење

note: type: textblock
en: The first 3 arguments are extracted by get_leading_command or get_trailing_command.
sr: Прва 3 аргумента издвајају get_leading_command или get_trailing_command.

note: type: textblock
en: Command and environment functions return the translation of the command with its arguments and a new environment.
sr: Функције команди и окружења враћају превод команде заједно са њеним аргументима и ново окружење.

note: type: textblock
en: Environment functions are called when a \begin command is found. They are called with the \begin command and its arguments.
sr: Функције окружења се позивају када се наиђе на команду \begin. Позивају се са \begin командом и њеним аргументима.

note: type: textblock
en: The TeX module only proposes one command function and one environment function: generic_command and generic_environment.
sr: TeX модул предлаже само једну функцију за команде и једну функцију за окружења: generic_command и generic_environment.

note: type: verbatim
en: generic_command uses the information specified by
    register_generic_command or by adding definition to the TeX file:
     % po4a: command I<command1> I<parameters>
sr: generic_command користи информације које наводи
    register_generic_command или из дефиниција додатих у TeX фајл:
     % po4a: command I<команда1> I<параметри>

note: type: verbatim
en: generic_environment uses the information specified by
    register_generic_environment or by adding definition to the TeX file:
     % po4a: environment I<env> I<parameters>
sr: generic_environment користи информације које наводи
    register_generic_environment или из дефиниција додатих у TeX фајл:
     % po4a: environment I<окр> I<параметри>

note: type: textblock
en: Both functions will only translate the parameters that were specified as translatable (with a '_').  generic_environment will append the name of the environment to the environment stack and generic_command will append the name of the command followed by an identifier of the parameter (like {#7} or [#2]).
sr: Обе функције ће да преведу само параметре коју су били наведени као преводиви (са ’_’). generic_environment ће да дода име окружења на стек окружења, а generic_command ће да дода име команде иза које следе идентификатори параметара (као {#7} или [#2]).

note: type: textblock
en: This module needs more tests.
sr: Потребно је да се овај модул додатно тестира.

note: type: textblock
en: It was tested on a book and with the Python documentation.
sr: Тестиран је на књизи и Python документацији.

note: type: =head1
en: TODO LIST
sr: ЛИСТА СТВАРИ КОЈЕ ТРЕБА ДА СЕ УРАДЕ

note: type: =item
en: Automatic detection of new commands
sr: Аутоматска детекција нових команди

note: type: textblock
en: The TeX module could parse the newcommand arguments and try to guess the number of arguments, their type and whether or not they should be translated.
sr: TeX модул би могао да парсира аргументе команде newcommand и да покуша да погоди број аргумената, њихов тип и да ли треба да се преведу или не.

note: type: =item
en: Translation of the environment separator
sr: Превод сепаратора окружења

note: type: textblock
en: When \item is used as an environment separator, the item argument is attached to the following string.
sr: Када се као сепаратор окружења користи \item, аргумент ставке се прикључује наредном стрингу.

note: type: =item
en: Some commands should be added to the environment stack
sr: Неке команде би требало да се додају на стек окружења

note: type: textblock
en: These commands should be specified by couples.  This can be used to specify commands beginning or ending a verbatim environment.
sr: Ове команде би требало да буду наведене паровима. То може да се употреби за навођење команди које почињу или завршавају дословно окружење.

note: type: =item
en: Others
sr: Остало

note: type: textblock
en: Various other points are tagged TODO in the source.
sr: Разне друге ствари су обележене са TODO и изворном коду.

note: type: =head1
en: KNOWN BUGS
sr: ПОЗНАТИ БАГОВИ

note: type: textblock
en: Various points are tagged FIXME in the source.
sr: Разне ствари обележене са FIXME у изворном коду.

note: type: textblock
en: Locale::Po4a::Texinfo - convert Texinfo documents and derivates from/to PO files
sr: Locale::Po4a::Texinfo - двосмерна конверзија Texinfo (и изведених) докумената и PO фајлова

note: type: textblock
en: Locale::Po4a::Texinfo is a module to help the translation of Texinfo documents into other [human] languages.
sr: Locale::Po4a::Texinfo је модул који помаже превођење Texinfo докумената на друге [људске] језике.

note: type: textblock
en: This module contains the definitions of common Texinfo commands and environments.
sr: Овај модул садржи дефиниције уобичајених Texinfo команди и окружења.

note: type: textblock
en: Only the comments starting with 'TRANSLATORS' are added to the PO files to guide the translators.
sr: У PO фајлове се додају само коментари који почињу са ’TRANSLATORS’. Они служе као водич преводиоцима.

note: type: textblock
en: This module is still beta and not ready for production use.  Please send patches to contribute, not bug reports as we don't know how to deal with them.
sr: Овај модул је у бета фази и није спреман за продукцију.  Молимо вас да шаљете закрпе, а не извештаје о багу јер не знамо како да се носимо са њима.

note: type: textblock
en: Do not warn about the current state of this module.
sr: Не исписује упозорење о тренутном статусу овог модула.

note: type: textblock
en: Copyright © 2004-2007 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>.
sr: Права умножавања © 2004-2007 Никола ФРАНСОА <nicolas.francois@centraliens.net>.

note: type: textblock
en: Locale::Po4a::Text - convert text documents from/to PO files
sr: Locale::Po4a::Text - двосмерна конверзија текст докумената и PO фајлова

note: type: textblock
en: Locale::Po4a::Text is a module to help the translation of text documents into other [human] languages.
sr: Locale::Po4a::Text је модул који помаже превођење текстуалних докумената на друге [људске] језике.

note: type: textblock
en: Paragraphs are split on empty lines (or lines containing only spaces or tabulations).
sr: Пасуси се деле на празним линијама (или на линијама које садрже само размаке или табулаторе).

note: type: textblock
en: If a paragraph contains a line starting by a space (or tabulation), this paragraph won't be rewrapped.
sr: Ако пасус садржи линију која почиње размаком (или табулатором), он неће поново да се обавија.

note: type: textblock
en: Treat paragraphs that look like a colon-separated key-value pair as verbatim (with the C<no-wrap> flag in the PO file). A key-value pair string is a string like C<key: value>, containing one or more non-colon and non-space characters followed by a colon followed by at least one non-space character before the end of the line.
sr: Пасуси који личе на парове кључ-вредност раздвојене двотачкама се третирају дословно (са C<no-wrap> заставицом у PO фајлу). Стрингови парова кључ-вредност су стрингови као што је C<key: value>, садрже један или више карактера који нису двотачка и нису размак иза којих следи двотачка након које следи барем један карактер који није размак испред краја линије.

note: type: textblock
en: Deactivate the detection of bullets.
sr: Искључује детекцију знакова набрајања.

note: type: textblock
en: By default, when a bullet is detected, the bullet paragraph is not considered as a verbatim paragraph (with the C<no-wrap> flag in the PO file). Instead, the corresponding paragraph is rewrapped in the translation.
sr: Када се открије знак за набрајање, подразумевано је да се пасус који садржи тај знак не узима као дословни пасус (са C<no-wrap> заставицом у PO фајлу). Уместо тога, у преводу се одговарајући пасус се поново обавија.

note: type: =item
en: B<tabs=>I<mode>
sr: B<tabs=>I<режим>

note: type: textblock
en: Specify how tabulations shall be handled. The I<mode> can be any of:
sr: Наводи како би требало да се поступа са табулаторима. I<режим> може да буде било шта од следећег:

note: type: textblock
en: Lines with tabulations introduce breaks in the current paragraph.
sr: Линије са табулаторима умећу преломе у текући пасус.

note: type: textblock
en: Paragraph containing tabulations will not be re-wrapped.
sr: Пасус који садржи табулаторе се неће поново обавијати.

note: type: textblock
en: By default, tabulations are considered as spaces.
sr: Табулатори се подразумевано сматрају за размаке.

note: type: =item
en: B<breaks=>I<regex>
sr: B<breaks=>I<регизраз>

note: type: textblock
en: A regular expression matching lines which introduce breaks.  The regular expression will be anchored so that the whole line must match.
sr: Регуларни израз који се подудара са линијама које умећу преломе. Регуларни израз може да буде усидрен, тако да буде обавезно да се подудара цела линија.

note: type: textblock
en: Handle the header and footer of released versions, which only contain non translatable information.
sr: Обрађује заглавље и подножје објављених верзија, која садрже само информације које се не преводе.

note: type: textblock
en: Handle the fortunes format, which separate fortunes with a line which consists in '%' or '%%', and use '%%' as the beginning of a comment.
sr: Обрађује fortunes формат, који раздваја пророчанства са линијама које се састоје из ’%’ или ’%%’, и користе ’%%’ као почетак коментара.

note: type: textblock
en: Handle some special markup in Markdown-formatted texts.
sr: Обрађује неко специјално маркирање у Markdown форматираним текстовима.

note: type: =item
en: B<yfm_keys> (markdown-only)
sr: B<yfm_keys> (само markdown)

note: type: =item
en: B<yfm_lenient> (markdown only)
sr: B<yfm_lenient> (само markdown)

note: type: textblock
en: Allow the YAML Front Matter parser to fail on malformated headers. This is particularly helpful when your file starts with a horizontal ruler instead of a YAML Front Matter, but you insist on using three dashes only for your ruler.
sr: Дозвољава да YAML Front Matter парсер прекине рад када наиђе на лоше форматирано заглавље. Ово је посебно корисно када ваш фајл почиње хоризонталном линијом а не са YAML Front Matter, али ви инсистирате да се за линију користе само три цртице.

note: type: =item
en: B<yfm_paths> (markdown only)
sr: B<yfm_paths> (само markdown)

note: type: =item
en: B<yfm_skip_array> (markdown-only)
sr: B<yfm_skip_array> (само markdown)

note: type: =item
en: B<control>[B<=>I<field_list>]
sr: B<control>[B<=>I<листа_поља>]

note: type: textblock
en: Handle Debian's control files.  A comma-separated list of fields to be translated can be provided.
sr: Обрађује Дебијан контролне фајлове.  Може да се наведе листа поља раздвојених запетама које треба да се преведу.

note: type: textblock
en: Prevent po4a from wrapping any lines. This means that every content is handled verbatim, even simple paragraphs.
sr: Наводи да програм po4a уопште не обавија линије. То значи да се сав садржај обрађује дословно, чак и прости пасуси.

note: type: textblock
en: Tested successfully on simple text files and NEWS.Debian files.
sr: Успешно је тестиран на једноставним текстуалним фајловима и на NEWS.Debian фајловима.

note: type: verbatim
en:  Copyright © 2005-2008 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>.
    
     Copyright © 2008-2009, 2018 Jonas Smedegaard <dr@jones.dk>.
     Copyright © 2020 Martin Quinson <mquinson#debian.org>.
sr:  Права умножавања © 2005-2008 Никола ФРАНСОА <nicolas.francois@centraliens.net>.
    
     Права умножавања © 2008-2009, 2018 Јонас Смедегард <dr@jones.dk>
     Права умножавања © 2020 Мартин Квинсон <mquinson#debian.org>.

note: type: textblock
en: Locale::Po4a::TransTractor - generic trans(lator ex)tractor.
sr: Locale::Po4a::TransTractor - генерички транс(латор екс)трактор.

note: type: textblock
en: This class is the ancestor of every po4a parser used to parse a document, to search translatable strings, to extract them to a PO file and to replace them by their translation in the output document.
sr: Ова класа је предак сваког po4a парсера који се користи за парсирање документа, за претрагу стрингова који могу да се преведу, за њихово издвајање у PO фајл и њихову замену са својим преводима у излазном документу.

note: type: textblock
en: More formally, it takes the following arguments as input:
sr: Формалније речено, она узима као улаз следеће аргументе:

note: type: textblock
en: a document to translate;
sr: документ који се преводи;

note: type: textblock
en: a PO file containing the translations to use.
sr: PO фајл са преводима који треба се употребе.

note: type: textblock
en: As output, it produces:
sr: Као излаз, она креира:

note: type: textblock
en: another PO file, resulting of the extraction of translatable strings from the input document;
sr: други PO фајл, који настаје као резултат издвајања преводивих стрингова из улазног документа;

note: type: textblock
en: a translated document, with the same structure than the one in input, but with all translatable strings replaced with the translations found in the PO file provided in input.
sr: преведени документ, са истом структуром као и онај са улаза, али у коме су сви стрингови замењени са преводима пронађеним у PO фајлу који је наведен у улазу.

note: type: textblock
en: Here is a graphical representation of this:
sr: Ево графичке представе овога:

note: type: verbatim
en:    Input document --\                             /---> Output document
                         \                           /       (translated)
                          +-> parse() function -----+
                         /                           \
       Input PO --------/                             \---> Output PO
                                                             (extracted)
sr:    Улазни документ --\                             /---> Излазни документ
                          \                           /       (преведен)
                           +-> parse() функција -----+
                          /                           \
       Улазни PO --------/                             \---> Излазни PO
                                                             (издвојен)

note: type: =head1
en: FUNCTIONS YOUR PARSER SHOULD OVERRIDE
sr: ФУНКЦИЈЕ КОЈЕ БИ ВАШ ПАРСЕР ТРЕБАЛО ДА ПРЕИНАЧИ

note: type: textblock
en: This is where all the work takes place: the parsing of input documents, the generation of output, and the extraction of the translatable strings. This is pretty simple using the provided functions presented in the section B<INTERNAL FUNCTIONS> below. See also the B<SYNOPSIS>, which presents an example.
sr: Ово је место на којем се обавља сав посао: парсирање улазних докумената, генерисање излаза и издвајање преводивих стрингова. Ово је прилично једноставно употребом приложених функција приказаних у одељку B<ИНТЕРНЕ ФУНКЦИЈЕ> испод. Погледајте такође B<СИНОПСИС>, који представља пример.

note: type: textblock
en: This function is called by the process() function below, but if you choose to use the new() function, and to add content manually to your document, you will have to call this function yourself.
sr: Ову функцију позива функција process() испод, али ако изаберете да користите функцију new(), и да ручно додате садржај у свој документ, ову функцију ћете морати сами да позовете.

note: type: textblock
en: This function returns the header we should add to the produced document, quoted properly to be a comment in the target language.  See the section B<Educating developers about translations>, from L<po4a(7)|po4a.7>, for what it is good for.
sr: Ова функција враћа заглавље које би требало да се дода у креирани документ, прописно цитирано тако да буде коментар у циљном језику. Погледајте одељак B<Едуковање девелопера у вези превода>, из L<po4a(7)|po4a.7>, у вези онога за шта је добра ова функција.

note: type: textblock
en: The following example parses a list of paragraphs beginning with "<p>". For the sake of simplicity, we assume that the document is well formatted, i.e. that '<p>' tags are the only tags present, and that this tag is at the very beginning of each paragraph.
sr: Следећи пример парсира листу пасуса који почињу са „<p>”. Ради једноставности, претпостављамо да је документ добро форматиран, тј. да су ’<p>’ ознаке једине присутне ознаке, и да се ова ознака налази на самом почетку сваког пасуса.

note: type: verbatim
en:  sub parse {
       my $self = shift;
    
       PARAGRAPH: while (1) {
           my ($paragraph,$pararef)=("","");
           my $first=1;
           my ($line,$lref)=$self->shiftline();
           while (defined($line)) {
               if ($line =~ m/<p>/ && !$first--; ) {
                   # Not the first time we see <p>.
                   # Reput the current line in input,
                   #  and put the built paragraph to output
                   $self->unshiftline($line,$lref);
    
                   # Now that the document is formed, translate it:
                   #   - Remove the leading tag
                   $paragraph =~ s/^<p>//s;
    
                   #   - push to output the leading tag (untranslated) and the
                   #     rest of the paragraph (translated)
                   $self->pushline(  "<p>"
                                   . $self->translate($paragraph,$pararef)
                                   );
    
                   next PARAGRAPH;
               } else {
                   # Append to the paragraph
                   $paragraph .= $line;
                   $pararef = $lref unless(length($pararef));
               }
    
               # Reinit the loop
               ($line,$lref)=$self->shiftline();
           }
           # Did not get a defined line? End of input file.
           return;
       }
     }
sr:  sub parse {
       my $self = shift;
    
       PARAGRAPH: while (1) {
           my ($paragraph,$pararef)=("","");
           my $first=1;
           my ($line,$lref)=$self->shiftline();
           while (defined($line)) {
               if ($line =~ m/<p>/ && !$first--; ) {
                   # Није први пут да видимо <p>.
                   # Поново постави текући линију на улаз,
                   #  и постави изграђени пасуси на излаз
                   $self->unshiftline($line,$lref);
    
                   # Сада када је документ формиран, преведи га:
                   #   - уклони водећу ознаку
                   $paragraph =~ s/^<p>//s;
    
                   #   - гурну на излаз водећу ознаку (непреведену) и остатак
                   #     пасуса (преведен)
                   $self->pushline(  "<p>"
                                   . $self->translate($paragraph,$pararef)
                                   );
    
                   next PARAGRAPH;
               } else {
                   # Надовежи на пасус
                   $paragraph .= $line;
                   $pararef = $lref unless(length($pararef));
               }
    
               # Поново иницијализуј петљу
               ($line,$lref)=$self->shiftline();
           }
           # Није се добила дефинисана линија? Крај улазног фајла.
           return;
       }
     }

note: type: textblock
en: Once you've implemented the parse function, you can use your document class, using the public interface presented in the next section.
sr: Једном када сте имплементирали функцију за парсирање, можете да употребите своју класу документа, користећи јавни интерфејс који је представљен у следећем одељку.

note: type: =head1
en: PUBLIC INTERFACE for scripts using your parser
sr: ЈАВНИ ИНТЕРФЕЈС за скрипте које користе ваш парсер

note: type: =head2
en: Constructor
sr: Конструктор

note: type: textblock
en: This function can do all you need to do with a po4a document in one invocation. Its arguments must be packed as a hash. ACTIONS:
sr: Ова функција може да уради све што је потребно да се уради са po4a документом у једном позиву. Њени аргументи морају да се упакују као хеш. АКЦИЈЕ:

note: type: =item
en: a.
sr: а.

note: type: textblock
en: Reads all the PO files specified in po_in_name
sr: Чита све PO фајлове наведене у po_in_name

note: type: =item
en: b.
sr: б.

note: type: textblock
en: Reads all original documents specified in file_in_name
sr: Чита све оригиналне документе наведене у file_in_name

note: type: =item
en: c.
sr: г.

note: type: textblock
en: Parses the document
sr: Парсира документ

note: type: =item
en: d.
sr: д.

note: type: textblock
en: Reads and applies all the addenda specified
sr: Чита и примењује све наведене додатке

note: type: =item
en: e.
sr: ђ.

note: type: textblock
en: Writes the translated document to file_out_name (if given)
sr: Уписује преведени документ у file_out_name (ако је задато)

note: type: =item
en: f.
sr: е.

note: type: textblock
en: Writes the extracted PO file to po_out_name (if given)
sr: Уписује издвојени PO фајл у po_out_name (ако је задато)

note: type: textblock
en: ARGUMENTS, beside the ones accepted by new() (with expected type):
sr: АРГУМЕНТИ, уз оне које прихвата new() (са очекиваним типом):

note: type: textblock
en: List of filenames where we should read the input document.
sr: Листа имена фајлова из којих би требало да прочитамо улазни документ.

note: type: textblock
en: Charset used in the input document (if it isn't specified, use UTF-8).
sr: Скуп карактера који се користи у улазном документу (ако није наведен, користиће се UTF-8).

note: type: textblock
en: Filename where we should write the output document.
sr: Име фајла у који би требало да упишемо излазни документ.

note: type: textblock
en: Charset used in the output document (if it isn't specified, use UTF-8).
sr: Скуп карактера који се користи у излазном документу (ако није наведен, користиће се UTF-8).

note: type: textblock
en: List of filenames where we should read the input PO files from, containing the translation which will be used to translate the document.
sr: Листа имена фајлова из којих би требало да се читају PO фајлови, они који садрже преведене стрингове који ће се користити за превод документа.

note: type: textblock
en: Filename where we should write the output PO file, containing the strings extracted from the input document.
sr: Име фајла у који би требало да упишемо излазни PO фајл, који садржи стрингове издвојене из улазног документа.

note: type: textblock
en: List of filenames where we should read the addenda from.
sr: Листа имена фајлова из којих треба да се читају додаци.

note: type: textblock
en: Charset for the addenda.
sr: Скуп карактера за додатке.

note: type: textblock
en: Create a new po4a document. Accepted options (in the hash passed as a parameter):
sr: Креира нови po4a документ. Прихватају се опције (у хешу који се прослеђује као параметар):

note: type: textblock
en: Sets the verbosity.
sr: Поставља детаљност извештавања.

note: type: textblock
en: Sets the debugging.
sr: Поставља режим исправљања грешака.

note: type: textblock
en: The column at which we should wrap text in output document (default: 76).
sr: Колона око које би требало да се врши обавијање текста у излазном документу (подразумевано: 76).

note: type: textblock
en: The negative value means not to wrap lines at all.
sr: Негативна вредност значи да се линије уопште не обавијају.

note: type: textblock
en: Also it accepts next options for underlying Po-files: B<porefs>, B<copyright-holder>, B<msgid-bugs-address>, B<package-name>, B<package-version>, B<wrap-po>.
sr: Такође прихвата и следеће опције за одговарајуће Po-фајлове: B<porefs>, B<copyright-holder>, B<msgid-bugs-address>, B<package-name>, B<package-version>, B<wrap-po>.

note: type: =head2
en: Manipulating document files
sr: Манипулација фајловима докумената

note: type: textblock
en: Add another input document data at the end of the existing array C<< @{$self->{TT}{doc_in}} >>.
sr: Додаје податке из другог улазног документа на крај постојећег низа C<< @{$self->{TT}{doc_in}} >>.

note: type: verbatim
en: This function takes two mandatory arguments and an optional one.
     * The filename to read on disk;
     * The name to use as filename when building the reference in the PO file;
     * The charset to use to read that file (UTF-8 by default)
sr: Ова функција узима два обавезна аргумента и један необавезни.
     * Име фајла који се чита са диска;
     * Име које ће се користити као име фајла када се буду изграђивале референце у PO фајлу;
     * Скуп карактера који ће се употребити за читање тог фајла (подразумевано је UTF-8)

note: type: verbatim
en: This array C<< @{$self->{TT}{doc_in}} >> holds this input document data as an
    array of strings with alternating meanings.
     * The string C<$textline> holding each line of the input text data.
     * The string C<< $filename:$linenum >> holding its location and called as
       "reference" (C<linenum> starts with 1).
sr: Низ C<< @{$self->{TT}{doc_in}} >> чува податке из овог улазни документа
    као низ стрингова са наизменичним значењима.
     * Стринг C<$textline> који држи сваку линију улазног текста.
     * Стринг C<< $filename:$linenum >> који држи његову локацију и који се
       зове "reference" (C<linenum> почиње од 1).

note: type: textblock
en: Please note that it does not parse anything. You should use the parse()  function when you're done with packing input files into the document.
sr: Имајте на уму, молим вас, да ово још ништа не парсира. Када завршите са паковањем улазних фајлова у документ, требало би да употребите функцију parse().

note: type: textblock
en: Write the translated document to the given filename.
sr: Уписује преведени документ у фајл са датим именом.

note: type: verbatim
en: This translated document data are provided by:
     * C<< $self->docheader() >> holding the header text for the plugin, and
     * C<< @{$self->{TT}{doc_out}} >> holding each line of the main translated text in the array.
sr: Ови подаци преведеног документа се добијају из:
     * C<< $self->docheader() >> који чува текст заглавља за модул додатка, и
     * C<< @{$self->{TT}{doc_out}} >> који у низу чува сваку линију главног преведеног текста.

note: type: =head2
en: Manipulating PO files
sr: Манипулација PO фајловима

note: type: textblock
en: Add the content of a file (which name is passed as argument) to the existing input PO. The old content is not discarded.
sr: Додаје садржај фајла (чије име је прослеђено као аргумент) постојећем улазном PO. Стари садржај се не одбацује.

note: type: textblock
en: Write the extracted PO file to the given filename.
sr: Уписује издвојени PO фајл у дато име фајла.

note: type: textblock
en: Returns some statistics about the translation done so far. Please note that it's not the same statistics than the one printed by msgfmt --statistic. Here, it's stats about recent usage of the PO file, while msgfmt reports the status of the file. It is a wrapper to the Locale::Po4a::Po::stats_get function applied to the input PO file. Example of use:
sr: Враћа неке статистичке податке у вези до сада одрађеног превода. Имајте не уму, молим вас, да ово није иста статистика коју исписује msgfmt --statistic. Овде је то статистика у вези скорашње употребе PO фајла, док msgfmt пријављује статус фајла. То је функција која обавија функцију Locale::Po4a::Po::stats_get function примењену на улазни PO фајл. Пример употребе:

note: type: verbatim
en:     [normal use of the po4a document...]
    
        ($percent,$hit,$queries) = $document->stats();
        print "We found translations for $percent\%  ($hit from $queries) of strings.\n";
sr:     [нормална употреба po4a документа...]
    
        ($percent,$hit,$queries) = $document->stats();
        print "Пронашли смо преводе за $percent\%  ($hit од $queries) стрингова.\n";

note: type: =head2
en: Manipulating addenda
sr: Манипулација додацима

note: type: textblock
en: Please refer to L<po4a(7)|po4a.7> for more information on what addenda are, and how translators should write them. To apply an addendum to the translated document, simply pass its filename to this function and you are done ;)
sr: Молимо погледајте L<po4a(7)|po4a.7> за више информација о томе шта су додаци, и како би преводиоци требало да их пишу. Да бисте применили додатак на преведени документ, једноставно проследите име његовог фајла овој функцији и то је то ;)

note: type: textblock
en: This function returns a non-null integer on error.
sr: У случају грешке, ова функција враћа цео број различит од нуле.

note: type: =head2
en: Getting input, providing output
sr: Добављање улаза, обезбеђивање излаза

note: type: textblock
en: Four functions are provided to get input and return output. They are very similar to shift/unshift and push/pop of Perl.
sr: За преузимање улаза и враћање излаза се користе четири функције. Оне су врло сличне са shift/unshift и push/pop у језику Perl.

note: type: verbatim
en:  * Perl shift returns the first array item and drop it from the array.
     * Perl unshift prepends an item to the array as the first array item.
     * Perl pop returns the last array item and drop it from the array.
     * Perl push appends an item to the array as the last array item.
sr:  * Perl shift враћа прву ставку низа и уклања је из њега.
     * Perl unshift ставља ставку на почетак низа као прву.
     * Perl pop враћа последњу ставку низа и уклања је из њега.
     * Perl push додаје ставку у низ као последњу.

note: type: textblock
en: The first pair is about input, while the second is about output. Mnemonic: in input, you are interested in the first line, what shift gives, and in output you want to add your result at the end, like push does.
sr: Први пар се тиче улаза, док је други у вези излаза. Да се лакше упамти: за улаз вам је од интереса прва линија, а то је управо оно што враћа shift, док за излаз желите да свој резултат додате на крај, као што то ради push.

note: type: textblock
en: This function returns the first line to be parsed and its corresponding reference (packed as an array) from the array C<< @{$self->{TT}{doc_in}} >> and drop these first 2 array items.  Here, the reference is provided by a string C<< $filename:$linenum >>.
sr: Ова функција враћа прву линију која треба да се парсира у њену одговарајућу референцу (упаковано као низ) из низа C<< @{$self->{TT}{doc_in}} >> и уклања ове прве 2 ставке низа. Референцу овде обезбеђује стринг C<< $filename:$linenum >>.

note: type: textblock
en: Unshifts the last shifted line of the input document and its corresponding reference back to the head of C<< {$self->{TT}{doc_in}} >>.
sr: Unshift-ује последњу shift-овану линију улазног документа и њену одговарајућу референцу назад на почетак C<< {$self->{TT}{doc_in}} >>.

note: type: textblock
en: Push a new line to the end of C<< {$self->{TT}{doc_out}} >>.
sr: Ради push нове линије на крај C<< {$self->{TT}{doc_out}} >>.

note: type: textblock
en: Pop the last pushed line from the end of C<< {$self->{TT}{doc_out}} >>.
sr: Ради pop последње push-оване линије са краја C<< {$self->{TT}{doc_out}} >>.

note: type: =head2
en: Marking strings as translatable
sr: Обележавање стрингова као преводивих

note: type: textblock
en: One function is provided to handle the text which should be translated.
sr: Достављена је једна функција која обрађује текст предвиђен за превођење.

note: type: textblock
en: Mandatory arguments:
sr: Обавезни аргументи:

note: type: textblock
en: A string to translate
sr: Стринг за превођење

note: type: textblock
en: The reference of this string (i.e. position in inputfile)
sr: Референца овог стринга (тј. позиција у улазном фајлу)

note: type: textblock
en: The type of this string (i.e. the textual description of its structural role; used in Locale::Po4a::Po::gettextization(); see also L<po4a(7)|po4a.7>, section B<Gettextization: how does it work?>)
sr: Тип овог стринга (тј. текстуални опис његове структурне улоге; користи се у Locale::Po4a::Po::gettextization(); погледајте такође L<po4a(7)|po4a.7>, одељак B<На који начин програм функционише?>)

note: type: textblock
en: This function can also take some extra arguments. They must be organized as a hash. For example:
sr: И ова функција може да узме неколико додатних аргумената. Они морају да се организују у хеш. На пример:

note: type: textblock
en: boolean indicating whether we can consider that whitespaces in string are not important. If yes, the function canonizes the string before looking for a translation or extracting it, and wraps the translation.
sr: логичка вредност која назначава можемо ли претпоставити да празни карактери у стрингу нису битни. Ако је истинита, функција канонизује стринг пре тражења превода или његовог издвајања, и обавија превод.

note: type: textblock
en: the column at which we should wrap (default: the value of B<wrapcol> specified during creation of the TransTractor or 76).
sr: колона око које би требало да се обавија текст (подразумевано: вредност B<wrapcol> наведена током креирања TransTractor или 76).

note: type: textblock
en: The negative value will be substracted from the default.
sr: Негативна вредност ће се одузети од подразумеване.

note: type: textblock
en: an extra comment to add to the entry.
sr: допунски коментар који се додаје ставци.

note: type: textblock
en: Actions:
sr: Акције:

note: type: textblock
en: Pushes the string, reference and type to po_out.
sr: Ради push стринга, референце и типа у po_out.

note: type: textblock
en: Returns the translation of the string (as found in po_in) so that the parser can build the doc_out.
sr: Враћа стринг превода (као што је пронађен у po_in) и омогућава да парсер изгради doc_out.

note: type: textblock
en: Handles the charsets to recode the strings before sending them to po_out and before returning the translations.
sr: Обрађује скупове карактера како би се стрингови рекодирали пре него што се пошаљу у po_out и пре враћања превода.

note: type: =head2
en: Misc functions
sr: Разне функције

note: type: textblock
en: Returns if the verbose option was passed during the creation of the TransTractor.
sr: Враћа информацију да ли је током креирања објекта TransTractor прослеђена опција детаљног извештавања.

note: type: textblock
en: Returns if the debug option was passed during the creation of the TransTractor.
sr: Враћа информацију да ли је приликом креирања објекта TransTractor била прослеђена опција детаљнијег извештавања.

note: type: textblock
en: This function return the charset that was provided as master charset
sr: Ова функција враћа скуп карактера који је наведен као мастер скуп карактера

note: type: textblock
en: This function will return the charset that should be used in the output document (usually useful to substitute the input document's detected charset where it has been found).
sr: Ова функција ће да врати скуп карактера који би требало да се користи у излазном документу (обично је корисно за замену скупа карактера детектованог у улазном документу у коме је пронађен).

note: type: textblock
en: It will use the output charset specified in the command line. If it wasn't specified, it will use the input PO's charset, and if the input PO has the default "CHARSET", it will return the input document's charset, so that no encoding is performed.
sr: Користиће излазни скуп карактера наведен у командној линији. Ако није био задат, користиће се скуп карактера улазног PO, а ако улазни PO има подразумевану вредност „CHARSET”, вратиће скуп карактера улазног документа, тако да се не обавља кодирање..

note: type: =head1
en: FUTURE DIRECTIONS
sr: СМЕРНИЦЕ ЗА БУДУЋНОСТ

note: type: textblock
en: One shortcoming of the current TransTractor is that it can't handle translated document containing all languages, like debconf templates, or .desktop files.
sr: Једна од лоших страна текуће TransTractor класе је да не може обрађивати преведене документе који садрже све језике, као што су debconf шаблони, или .desktop фајлови.

note: type: textblock
en: To address this problem, the only interface changes needed are:
sr: Како би се решио проблем, неопходне су само следеће измене интерфејса:

note: type: textblock
en: take a hash as po_in_name (a list per language)
sr: po_in_name треба да узима хеш (листу за сваки појединачни језик)

note: type: textblock
en: add an argument to translate to indicate the target language
sr: додати аргумент функцији translate који наводи циљни језик

note: type: textblock
en: make a pushline_all function, which would make pushline of its content for all languages, using a map-like syntax:
sr: креирати функцију pushline_all, која би одрадила pushline свог садржаја за све језике, користећи синтаксу сличну са map:

note: type: textblock
en: Will see if it's enough ;)
sr: Видећемо да ли је ово довољно ;)

note: type: verbatim
en:  Denis Barbier <barbier@linuxfr.org>
     Martin Quinson (mquinson#debian.org)
     Jordi Vilalta <jvprat@gmail.com>
sr:  Дени Барбије <barbier@linuxfr.org>
     Мартин Квинсон (mquinson#debian.org)
     Жорди Вилалта <jvprat@gmail.com>

note: type: textblock
en: Locale::Po4a::VimHelp - convert Vim help files from/to PO files.
sr: Locale::Po4a::VimHelp - двосмерна конверзија фајлова Vim помоћи и PO фајлова.

note: type: textblock
en: C<Locale::Po4a::VimHelp> is a module to help the translation of Vim help file.  See also L<Writing help files|https://vimhelp.org/helphelp.txt.html#help-writing> for its syntax.
sr: C<Locale::Po4a::VimHelp> је модул који помаже превођење фајлова помоћи за едитор Vim. Погледајте и L<Писање фајлова помоћи|https://vimhelp.org/helphelp.txt.html#help-writing> да се упознате са њиховом синтаксом.едитор Vim. Погледајте и L<Писање фајлова помоћи|https://vimhelp.org/helphelp.txt.html#help-writing> да се упознате са њиховом синтаксом.

note: type: textblock
en: This module is in an early stage of development.  It has been successfully tested on simple files like C<helphelp.txt>.  However, it has not yet been tested on full help files, and the way it parses them may change for fixes and improvements, especially paragraph wrapping.
sr: Овај модул је у раној фази развоја. Успешно је тестиран на простим фајловима као што је C<helphelp.txt>. Међутим, још увек није тестиран на комплетним фајловима помоћи, тако да начин на који врши парсирање може да се промени због исправки и побољшања, а посебно обавијање пасуса.

note: type: =head1
en: DEVELOPING
sr: РАЗВОЈ

note: type: textblock
en: Parsing Vim help files for po4a is difficult.  Here are some obstacles while developing this module.  If you have a better idea, feel free to suggest a patch (with additional test cases).
sr: Парсирање Vim фајлова помоћи за po4a је компликовано. Ево неких препрека на које се наишло током развоја овог модула. Ако имате бољу идеју, слободно предложите закрпу (заједно са додатним тест случајевима).

note: type: =item
en: C<1. foo> sounds like an ordered list
sr: C<1. нешто> личи на уређену листу

note: type: textblock
en: Not necessarily.  Consider the following paragraph.
sr: Не обавезно. Узмите у обзир следећи пасус.

note: type: verbatim
en:  There are 2 wandering tanukis, not
     1. He's using his cloning technique.
sr:  Постоје 2 лутајућа танукија, не
     1. Он употребљава своју технику клонирања.

note: type: textblock
en: For the same reason, what appears to be a heading (e.g. C<1.1 bar>) or an unordered list (e.g. C<o baz>) cannot be detected.
sr: Из истог разлога, не може да се детектује оно што изгледа као наслов (нпр. C<1.1 ово>) или неуређена листа (нпр. C<o оно>).

note: type: =item
en: Flushed right tags should be excluded from translation target
sr: Ознаке поравнате десно не би требало да се уметну у циљ превода

note: type: textblock
en: This topic is also difficult since it relates to language differences in localization.
sr: И ова тема је компликована јер има везе са разликама у локализацији језика.

note: type: textblock
en: Consider the following example.
sr: Узмите у обзир следећи пасус.

note: type: verbatim
en:  Such a common and short concept in some languages *tags*
sr:  Тако уобичајен и кратак концепт у неким језицима *ознаке*

note: type: textblock
en: which might be translated to
sr: што би могло да се преведе као

note: type: verbatim
en:  They are unfamiliar, there are no corresponding concepts and *tags*
     it takes a longer sentence to express them in this language
sr:  Нису уобичајени, нема одговарајућих концепата и *ознаке*
     потребна је много дужа реченица да се изразе на овом језику

note: type: textblock
en: When this happens, you have to decide at what point you want to add a tag I<nicely>.  This shouldn't be easy.  The Vim help file is in a hard wrapped format, even for parts that are not code blocks.
sr: Када се ово догоди, морате да одлучите на које место желите I<фино> да уметнете ознаку. То не би требало да буде једноставно. Vim фајл помоћи је у круто обавијеном формату, чак и у деловима који нису блокови кода.

note: type: textblock
en: The same applies to tag references such as C<|ref|>.
sr: Исто се односи и на референце на ознаке C<|ref|>.

note: type: =item
en: Leveraging C<--wrapcol> to monitor text widths
sr: Коришћење C<--wrapcol> за праћење ширина текста

note: type: textblock
en: Using the C<--wrapcol> option to issue warnings when text width exceeds specified limits seems like a reasonable approach.  The official Vim help files feature a mode line, such as C<vim:tw=78:ts=8:noet:ft=help:norl:>, as seen in L<C<runtime/doc/if_perl.txt>|https://github.com/vim/vim/blob/04cc8975930b7b2c5d6753d3eddf57dab2816518/runtime/doc/if_perl.txt#L307>.  However, there are a few challenges to consider:
sr: Употреба C<--wrapcol> опције за издавање упозорења када ширина текста пређе наведено ограничење изгледа као разумни приступ. Званични Vim фајлови помоћи поседују режимски линију, као што је на пример C<vim:tw=78:ts=8:noet:ft=help:norl:>, и која се налази у L<C<runtime/doc/if_perl.txt>|https://github.com/vim/vim/blob/04cc8975930b7b2c5d6753d3eddf57dab2816518/runtime/doc/if_perl.txt#L307>. Међутим, постоји неколико изазова који треба да се узму у разматрање:

note: type: =item
en: File Parsing Behavior
sr: Понашање парсирања фајлова

note: type: textblock
en: If this option is implemented, it would be ideal to read the entire file first, detect whether the mode line exists, and determine which sections are affected.  Unfortunately, the progressive parsing mechanism is not employed in this case.
sr: Да је ова опција имплементирана, било би идеално да се најпре прочита комплетан фајл, одреди да ли у њему постоји режимска линија, па утврди који одељци су погођени. Нажалост, у овом случају још увек није имплементиран механизам прогресивног парсирања.

note: type: =item
en: Default vs. Custom Values
sr: Подразумеване или произвољне вредности

note: type: textblock
en: The generic default value of C<--wrapcol> is 76, whereas Vim help files commonly use 78.  In most cases, the value in the options passed to this module defaults to 76, but it is unclear whether this value was explicitly set or implicitly applied.
sr: Општа подразумевана вредност за C<--wrapcol> је 76, док Vim фајлови помоћи обично користе 78. У већини случајева вредност која се прослеђује овом модулу је 76, али није у потпуности јасно да ли је ова вредност постављена експлицитно или је примењена имплицитно.

note: type: verbatim
en:  Copyright © 2024, 2025 gemmaro.
sr:  Ауторска права © 2024, 2025 gemmaro.

note: type: textblock
en: Locale::Po4a::Wml - convert WML (web markup language) documents from/to PO files
sr: Locale::Po4a::Wml - двосмерна WML (web markup language) докумената и PO фајлова

note: type: textblock
en: Locale::Po4a::Wml is a module to help the translation of WML documents into other [human] languages. Do not mixup the WML we are speaking about here (web markup language) and the WAP crap used on cell phones.
sr: Locale::Po4a::Wml је модул који помаже превод WML докумената на друге [људске] језике. Немојте да мешате WML о коме овде говоримо (web markup language) са WAP кршем који се користи на мобилним телефонима.

note: type: textblock
en: Please note that this module relies upon the Locale::Po4a::Xhtml module, which also relies upon the Locale::Po4a::Xml module.  This means that all tags for web page expressions are assumed to be written in the XHTML syntax.
sr: Имајте на уму, молим вас, да се овај модула ослања на Locale::Po4a::Xhtml модул, који се са своје стране ослања на Locale::Po4a::Xml модул. Ово значи да се претпоставља како су све ознаке које се користе за описивање веб страница написане у XHTML синтакси.

note: type: textblock
en: This module works for some simple documents, but is still young.  Currently, the biggest issue of the module is probably that it cannot handle documents that contain non-XML inline tags such as <email "foo@example.org">, which are often defined in the WML.  Improvements will be added in the future releases.
sr: Овај модул функционише за неке једноставне документе, али је још увек у раној фази развоја. Тренутно је вероватно највећи проблем модула то што не може да се носи са документима који садрже не-XML ознаке у једној линији као што је <email "пера@мика.рс">, а које се често дефинишу у WML језику. Наредна издања програма ће укључити побољшања овог модула.

note: type: verbatim
en:  Martin Quinson (mquinson#debian.org)
     Noriada Kobayashi <nori1@dolphin.c.u-tokyo.ac.jp>
sr:  Мартин Квинсон (mquinson#debian.org)
     Норијада Кобајаши <nori1@dolphin.c.u-tokyo.ac.jp>

note: type: verbatim
en:  Copyright © 2005 SPI, Inc.
sr:  Права умножавања © 2005 SPI, Inc.

note: type: textblock
en: Locale::Po4a::Xhtml - convert XHTML documents from/to PO files
sr: Locale::Po4a::Xhtml - двосмерна конверзија XHTML докумената и PO фајлова

note: type: textblock
en: Locale::Po4a::Xhtml is a module to help the translation of XHTML documents into other [human] languages.
sr: Locale::Po4a::Xhtml је модул који помаже превод XHTML докумената у друге [људске] језике.

note: type: =item
en: B<includessi>[B<=>I<rootpath>]
sr: B<includessi>[B<=>I<коренапутања>]

note: type: textblock
en: Include files specified by an include SSI (Server Side Includes) element (e.g. <!--#include virtual="/foo/bar.html" -->).
sr: Прикључује све фајлове које наводи елемент include SSI (Server Side Includes) (нпр. <!--#include virtual="/foo/bar.html" -->).

note: type: textblock
en: B<Note:> You should use it only for static files.
sr: B<Напомена:> требало би да је користите само за статичке фајлове.

note: type: textblock
en: An additional I<rootpath> parameter can be specified. It specifies the root path to find files included by a B<virtual> attribute.
sr: Може да се наведе и додатни параметар I<коренапутања>. Он наводи корену путању од које се атрибутом за прикључивање B<virtual> задају фајлови за укључивање.

note: type: textblock
en: "It works for me", which means I use it successfully on my personal Web site.  However, YMMV: please let me know if something doesn't work for you.
sr: „Мени функционише”, што значи да га успешно користим на свом личном вебсајту. Ипак, YMMV (у вашем случају може бити другачије): молим вас да ми пријавите ако нешто не функционише код вас.

note: type: verbatim
en:  Yves Rütschlé <po4a@rutschle.net>
     Nicolas François <nicolas.francois@centraliens.net>
sr:  Ив Ричле <po4a@rutschle.net>
     Никола Франсоа <nicolas.francois@centraliens.net>

note: type: verbatim
en:  Copyright © 2004 Yves Rütschlé <po4a@rutschle.net>
     Copyright © 2007-2008 Nicolas François <nicolas.francois@centraliens.net>
sr:  Права умножавања © 2004 Ив Ричле <po4a@rutschle.net>
     Права умножавања © 2007-2008 Никола Франсоа <nicolas.francois@centraliens.net>

note: type: textblock
en: Locale::Po4a::Xml - convert XML documents and derivates from/to PO files
sr: Locale::Po4a::Xml - двосмерна конверзија XML (и изведених из њега) докумената и PO фајлова

note: type: textblock
en: Locale::Po4a::Xml is a module to help the translation of XML documents into other [human] languages. It can also be used as a base to build modules for XML-based documents.
sr: Locale::Po4a::Xml је модул који помаже превод XML докумената на друге [људске] језике. Такође може да се употреби и као основа за изградњу модула који обрађују документе базиране на XML.

note: type: =head1
en: TRANSLATING WITH PO4A::XML
sr: ПРЕВОЂЕЊЕ ПОМОЋУ PO4A::XML

note: type: textblock
en: This module can be used directly to handle generic XML documents.  This will extract all tag's content, and no attributes, since it's where the text is written in most XML based documents.
sr: Овај модул може да се користи за директну обраду генеричких XML докумената. Издвојиће сав садржај ознаке, без атрибута, јер је ро место на коме се пише текст у већини докумената базираних на XML.

note: type: textblock
en: There are some options (described in the next section) that can customize this behavior.  If this doesn't fit to your document format you're encouraged to write your own module derived from this, to describe your format's details.  See the section B<WRITING DERIVATE MODULES> below, for the process description.
sr: Постоје неке опције (описане у наредном одељку) које могу да прилагоде ово понашање. Ако се не уклапа у формат вашег документа, најбоље је да напишете ваш сопствени модул изведен из овога, који ће да опише детаље вашег формата. Да сазнате више о том процесу, погледајте одељак B<ПИСАЊЕ ИЗВЕДЕНИХ МОДУЛА> испод.

note: type: textblock
en: The global debug option causes this module to show the excluded strings, in order to see if it skips something important.
sr: Глобална дибаг опција чини да овај модул прикаже искључене стрингове, како би се видело ако прескаче нешто важно.

note: type: textblock
en: Prevents it to strip the spaces around the extracted strings.
sr: Спречава да модул уклони размаке око издвојених стрингова.

note: type: textblock
en: Canonicalizes the string to translate, considering that whitespaces are not important, and wraps the translated document. This option can be overridden by custom tag options. See the B<translated> option below.
sr: Каноникализује стринг који се преводи, сматрајући да празни карактери нису битни и обавија преведени документ. Ова опција може да се преиначи прилагођеним опцијама за ознаке. Погледајте опцију B<translated> ниже.

note: type: textblock
en: Attributes are wrapped by default. This option disables wrapping.
sr: Атрибути се подразумевано обвијају. Ова опција искључује обавијање.

note: type: textblock
en: It makes the tags and attributes searching to work in a case insensitive way.  If it's defined, it will treat E<lt>BooKE<gt>laNG and E<lt>BOOKE<gt>Lang as E<lt>bookE<gt>lang.
sr: Чини да претрага ознака и атрибута не прави разлику између малих и великих слова. Ако је дефинисана, третираће E<lt>BooKE<gt>laNG and E<lt>BOOKE<gt>Lang као E<lt>bookE<gt>lang.

note: type: textblock
en: Escape quotes in output strings.  Necessary, for example, for creating string resources for use by Android build tools.
sr: Означава знаке навода у излазним стринговима. Неопходно је, на пример, код креирања стринг ресурса које користе Андроид алати за изградњу апликација.

note: type: textblock
en: See also: https://developer.android.com/guide/topics/resources/string-resource.html
sr: Погледајте такође: https://developer.android.com/guide/topics/resources/string-resource.html

note: type: textblock
en: When defined, external entities are included in the generated (translated)  document, and for the extraction of strings.  If it's not defined, you will have to translate external entities separately as independent documents.
sr: Када је дефинисано, спољни ентитети се прикључују у генерисани (преведени) документ, као и код издвајања стрингова. Ако није дефинисано, мораћете одвојено да преведете спољне ентитете као независне документе.

note: type: textblock
en: This option defines the behavior of the module when it encounters invalid XML syntax (a closing tag which does not match the last opening tag).  It can take the following values:
sr: Ова опција дефинише понашање модула када наиђе на неважећу XML синтаксу (затварајућа ознака се не одговара последњој отварајућој ознаци). Може да има следеће вредности:

note: type: textblock
en: This is the default value.  The module will exit with an error.
sr: Ово је подразумевана вредност. Модул ће да заврши са радом уз поруку о грешки.

note: type: textblock
en: The module will continue, and will issue a warning.
sr: Модул ће да настави са извршавањем, али ће да изда упозорење.

note: type: textblock
en: The module will continue without any warnings.
sr: Модул ће да настави са извршавањем без икаквог упозорења.

note: type: textblock
en: Be careful when using this option.  It is generally recommended to fix the input file.
sr: Будите опрезни када користите ову опцију. Најбоље би било да поправите улазни фајл.

note: type: textblock
en: Note: This option is deprecated.
sr: Напомена: ова опција је застарела.

note: type: textblock
en: Extracts only the specified tags in the B<tags> option.  Otherwise, it will extract all the tags except the ones specified.
sr: Издваја само ознаке наведене у опцији B<tags>. Иначе, издвајаће се све ознаке осим оних наведених.

note: type: textblock
en: String that will try to match with the first line of the document's doctype (if defined). If it doesn't, a warning will indicate that the document might be of a bad type.
sr: Стринг који ће покушати да се подудари са првом линијом doctype декларације у документу (у случају да је дефинисана). Ако није, упозорење ће да укаже на то како је могуће да је документ лошег типа.

note: type: textblock
en: String indicating the path (e.g. E<lt>bbbE<gt>E<lt>aaaE<gt>) of a tag where a lang="..." attribute shall be added. The language will be defined as the basename of the PO file without any .po extension.
sr: Стринг који наводи путању (нпр. E<lt>bbbE<gt>E<lt>aaaE<gt>) ознаке где би требало да се дода атрибут lang="...". Језик ће да се дефинише као базно име PO фајла без било какве .po екстензије.

note: type: textblock
en: Boolean indicating whether closing tags are optional (as in HTML). By default, missing closing tags raise an error handled according to B<ontagerror>.
sr: Логичка вредност која означава да ли су затварајуће ознаке опционалне (као у HTML). Подразумевано понашање је да се за затварајућу ознаку која недостаје пријави грешка која се затим обрађује сагласно са B<ontagerror>.

note: type: textblock
en: Note: This option is deprecated.  You should use the B<translated> and B<untranslated> options instead.
sr: Напомена: ова опција је застарела. Требало би да уместо ње користите опције B<translated> и B<untranslated>.

note: type: textblock
en: Space-separated list of tags you want to translate or skip.  By default, the specified tags will be excluded, but if you use the "tagsonly" option, the specified tags will be the only ones included.  The tags must be in the form E<lt>aaaE<gt>, but you can join some (E<lt>bbbE<gt>E<lt>aaaE<gt>) to say that the content of the tag E<lt>aaaE<gt> will only be translated when it's into a E<lt>bbbE<gt> tag.
sr: Листа ознака раздвојених размацима које желите да преведете или прескочите. Подразумевано, наведене ознаке се неће преводити, али ако употребите опцију „tagsonly”, наведене ознаке су и једине које ће се преводити. Ознака мора да буде у формату E<lt>aaaE<gt>, али можете неке и да спојите (E<lt>bbbE<gt>E<lt>aaaE<gt>) чиме наводите да ће садржај ознаке E<lt>aaaE<gt> да се преведе само у случају да се налази у ознаци E<lt>bbbE<gt>.

note: type: textblock
en: You can also specify some tag options by putting some characters in front of the tag hierarchy. For example, you can put I<w> (wrap) or I<W> (don't wrap)  to override the default behavior specified by the global B<wrap> option.
sr: Такође можете да наведете и неке опције за ознаке стављањем неких карактера испред хијерархије ознака. На пример, можете да ставите I<w> (wrap - обавијај) или I<W> (не обавијај) и тиме преиначите подразумевано понашање задато глобалном опцијом B<wrap>.

note: type: textblock
en: Example: WE<lt>chapterE<gt>E<lt>titleE<gt>
sr: Пример: WE<lt>chapterE<gt>E<lt>titleE<gt>

note: type: textblock
en: Space-separated list of tag's attributes you want to translate.  You can specify the attributes by their name (for example, "lang"), but you can prefix it with a tag hierarchy, to specify that this attribute will only be translated when it's in the specified tag. For example: E<lt>bbbE<gt>E<lt>aaaE<gt>lang specifies that the lang attribute will only be translated if it's in an E<lt>aaaE<gt> tag, and it's in a E<lt>bbbE<gt> tag.
sr: Листа атрибута ознака раздвојених размацима које желите да буду преведени. Атрибуте можете да наведете према свом имену (на пример „lang”), али можете и испред њих да поставите хијерархију ознака, чиме наводите да се тај атрибут преводи само онда када се налази у задатој ознаци. На пример: E<lt>bbbE<gt>E<lt>aaaE<gt>lang наводи да ће се lang атрибут преводити само онда када је унутар E<lt>aaaE<gt> ознаке, која се налази унутар E<lt>bbbE<gt> ознаке.

note: type: textblock
en: Do not translate attributes in inline tags.  Instead, replace all attributes of a tag by po4a-id=<id>.
sr: Атрибути који се део ознака у једној линији се не преводе. Уместо тога, сви атрибути ознаке се замењују са po4a-id=<id>.

note: type: textblock
en: This is useful when attributes shall not be translated, as this simplifies the strings for translators, and avoids typos.
sr: Ово је корисни када атрибути не смеју да се преводе, јер се тиме поједностављују стрингови за преводиоце и спречавају грешке у куцању.

note: type: textblock
en: Space-separated list of tags which should not be treated as tags.  These tags are treated as inline, and do not need to be closed.
sr: Листа ознака раздвојених размацима који не би требало да се третирају као ознаке. Оне се третирају као део линије и не морају да се затварају.

note: type: textblock
en: Space-separated list of tags which should break the sequence.  By default, all tags break the sequence.
sr: Листа ознака раздвојених размацима које би требало да преламају секвенцу. Подразумевано је да све ознаке преламају секвенцу.

note: type: textblock
en: The tags must be in the form <aaa>, but you can join some (<bbb><aaa>), if a tag (<aaa>) should only be considered when it's within another tag (<bbb>).
sr: Ознаке морају да буду у облику <aaa>, али неке можете и да спојите (<bbb><aaa>), у случају да се ознака (<aaa>) разматра само онда када се налази унутар друге ознаке (<bbb>).

note: type: textblock
en: Please note a tag should be listed in only one of the B<break>, B<inline> B<placeholder>, or B<customtag> setting string.
sr: Молимо имајте на уму да би ознака требало да се наведе само у једном од стрингова подешавања B<break>, B<inline> B<placeholder>, или B<customtag>.

note: type: textblock
en: Space-separated list of tags which should be treated as inline.  By default, all tags break the sequence.
sr: Листа ознака раздвојених размацима које би требало да се третирају као део линије. Подразумева се да све ознаке преламају секвенцу.

note: type: textblock
en: Space-separated list of tags which should be treated as placeholders.  Placeholders do not break the sequence, but the content of placeholders is translated separately.
sr: Листа ознака раздвојених размацима које би требало да се третирају као чувари места. Чувари места не преламају секвенцу, али садржај чувара места се преводи одвојено.

note: type: textblock
en: The location of the placeholder in its block will be marked with a string similar to:
sr: Локација чувара места ће у свом блоку бити означена стрингом који је сличан са:

note: type: textblock
en: By default, Processing Instructions (i.e., C<E<lt>? ... ?E<gt>> tags) are handled as inline tags.  Pass this option if you want the PI to be handled as breaking tag.  Note that unprocessed PHP tags are handled as Processing Instructions by the parser.
sr: Подразумевано се Инструкције за Процесирање (нпр. C<E<lt>? ... ?E<gt>> ознаке) обрађују као ознаке унутар линије. Проследите ову опције ако желите да се ИП обрађују као ознака која прелама. Имајте на уму да парсер обрађује непроцесиране PHP ознаке као Инструкције за Процесирање.

note: type: textblock
en: Space separated list of tags that the module should not try to set by default in any category.
sr: Листа ознака раздвојених размацима које модул не би требало да покуша поставити као подразумеване у било којој категорији.

note: type: textblock
en: If you have a tag which has its default setting by the subclass of this module but you want to set alternative setting, you need to list that tag as a part of the B<nodefault> setting string.
sr: Ако имате ознаку чије је подразумевано подешавање поставила подкласа овог модула, али желите да јој поставите алтернативно подешавање, морате ту ознаку да наведете као део B<nodefault> стринга подешавања.

note: type: textblock
en: Support C preprocessor directives.  When this option is set, po4a will consider preprocessor directives as paragraph separators.  This is important if the XML file must be preprocessed because otherwise the directives may be inserted in the middle of lines if po4a consider it belong to the current paragraph, and they won't be recognized by the preprocessor.  Note: the preprocessor directives must only appear between tags (they must not break a tag).
sr: Подршка за C препроцесорске директиве. Када је ова опција постављена, програм po4a ће да посматра препроцесорске директиве као сепараторе пасуса. То је важно у случају када XML мора да прође препроцесирање, јер би у супротном директиве могле да се уметну у сред линија које програм po4a посматра као део текућег пасуса, па их препроцесор неће препознати. Напомена: препроцесорске директиве морају да се поставе између ознака (дакле, не смеју да преломе ознаку).

note: type: textblock
en: Space-separated list of tags you want to translate.
sr: Листа ознака раздвојених размацима које желите да се преведу.

note: type: textblock
en: You can also specify some tag options by putting some characters in front of the tag hierarchy.  This overrides the default behavior specified by the global B<wrap> and B<defaulttranslateoption> option.
sr: Можете такође да наведете и неке опције за ознаке стављањем одређених карактера испред хијерархије ознака. То преиначује подразумевано понашање које задају глобалне опције B<wrap> и B<defaulttranslateoption>.

note: type: textblock
en: Tags should be translated and content can be re-wrapped.
sr: Ознаке би требало да се преведу, а садржај може поново да се обавије.

note: type: textblock
en: Tags should be translated and content should not be re-wrapped.
sr: Ознаке би требало да се преведу, а садржај не сме поново да се обавије.

note: type: textblock
en: Tags should be translated inline.
sr: Ознаке би требало да преведу унутар линије.

note: type: textblock
en: Tags should be translated as placeholders.
sr: Ознаке би требало да се преведу као чувари места.

note: type: textblock
en: Internally, the XML parser only cares about these four options: I<w> I<W> I<i> I<p>.
sr: Интерно, XML парсеру су битне само следеће четири опције: I<w> I<W> I<i> I<p>.

note: type: textblock
en: * Tags listed in B<break> are set to I<w> or I<W> depending on the B<wrap> option.
sr: * Ознаке наведене у B<break> се постављају на I<w> или I<W> у зависности од опције B<wrap>.

note: type: textblock
en: * Tags listed in B<inline> are set to I<i>.
sr: * Ознаке наведене у B<inline> се постављају на I<i>.

note: type: textblock
en: * Tags listed in B<placeholder> are set to I<p>.
sr: * Ознаке наведене у B<placeholder> се постављају I<p>.

note: type: textblock
en: * Tags listed in B<untranslated> are without any of these options set.
sr: * Ознакама наведеним у B<untranslated> није постављена ниједна од ових опција.

note: type: textblock
en: You can verify actual internal parameter behavior by invoking B<po4a> with B<--debug> option.
sr: Стварно понашање интерних параметара можете да потврдите позивајући B<po4a> са опцијом B<--debug>.

note: type: textblock
en: Please note a tag should be listed in either B<translated> or B<untranslated> setting string.
sr: Молим вас, имајте на уму да би ознака требало да се наведе или у B<translated>, или у B<untranslated> стрингу подешавања.

note: type: textblock
en: Space-separated list of tags you do not want to translate.
sr: Листа ознака раздвојених размацима које не желите да се преводе.

note: type: textblock
en: Please note a translatable inline tag in an untranslated tag is treated as a translatable breaking tag, I<i> setting is dropped and I<w> or I<W> is set depending on the B<wrap> option.
sr: Молим вас, имајте на уму да се преводива ознака унутар линије која се налази у непреводивој ознаци третира као преламајућа ознака, I<i> подешавање се брише и поставља се I<w> или I<W> у зависности од опције B<wrap>.

note: type: textblock
en: The default categories for tags that are not in any of the translated, untranslated, break, inline, or placeholder.
sr: Подразумеване категорије за ознаке које не припадају ниједној од translated, untranslated, break, inline, или placeholder.

note: type: textblock
en: This is a set of letters as defined in B<translated> and this setting is only valid for translatable tags.
sr: Ово је скуп слова као што је дефинисано у B<translated> и ова опција важи само за преводиве ознаке.

note: type: =head1
en: WRITING DERIVATIVE MODULES
sr: ПИСАЊЕ ИЗВЕДЕНИХ МОДУЛА

note: type: =head2
en: DEFINE WHAT TAGS AND ATTRIBUTES TO TRANSLATE
sr: ДЕФИНИШИТЕ КОЈЕ ОЗНАКЕ И КОЈИ АТРИБУТИ СЕ ПРЕВОДЕ

note: type: textblock
en: The simplest customization is to define which tags and attributes you want the parser to translate.  This should be done in the initialize function.  First you should call the main initialize, to get the command-line options, and then, append your custom definitions to the options hash.  If you want to treat some new options from command line, you should define them before calling the main initialize:
sr: Најједноставније прилагођавање је да се дефинише које ознаке и који атрибути би парсер требало да преведе. Ово би требало да се одради у функцији за иницијализацију. Најпре би требало да позовете главну иницијализацију, чиме добијате опције командне линије, па затим, да додате своје дефиниције у хеш опција. Ако желите да неке нове опције третирате из командне линије, требало би да их дефинишете пре позива главне функције за иницијализацију:

note: type: textblock
en: You should use the B<_default_inline>, B<_default_break>, B<_default_placeholder>, B<_default_translated>, B<_default_untranslated>, and B<_default_attributes> options in derivative modules. This allow users to override the default behavior defined in your module with command line options.
sr: Опције B<_default_inline>, B<_default_break>, B<_default_placeholder>, B<_default_translated>, B<_default_untranslated> и B<_default_attributes> би требало да користите у изведеним модулима. Тиме се омогућава да корисник помоћу опција у командној линији преиначи подразумевано понашање које дефинише ваш модул.

note: type: textblock
en: If you don't like the default behavior of this xml module and its derivative modules, you can provide command line options to change their behavior.
sr: Ако вам се не свиђа подразумевано понашање овог xml модула и оних изведених из њега, можете да наведете опције у командној линији којима се то понашање мења.

note: type: textblock
en: See L<Locale::Po4a::Docbook(3pm)|Locale::Po4a::Docbook>,
sr: Погледајте L<Locale::Po4a::Docbook(3pm)|Locale::Po4a::Docbook>,

note: type: =head2
en: OVERRIDING THE found_string FUNCTION
sr: ПРЕИНАЧАВАЊЕ ФУНКЦИЈЕ found_string

note: type: textblock
en: Another simple step is to override the function "found_string", which receives the extracted strings from the parser, in order to translate them.  There you can control which strings you want to translate, and perform transformations to them before or after the translation itself.
sr: Још један једноставан корак је да се преиначи функција „found_string”, која у циљу превођења прихвата стрингове које издваја парсер. Ту можете да контролишете који стрингови желите да се преводе, као и да над њима обавите трансформације пре или након самог превођења.

note: type: textblock
en: It receives the extracted text, the reference on where it was, and a hash that contains extra information to control what strings to translate, how to translate them and to generate the comment.
sr: Она прихвата издвојени текст, референцу места на коме се налазио и хеш који садржи додатне информације за контролу над тиме који стрингови треба да се преведу, како да се преведу и да се генерише коментар.

note: type: textblock
en: The content of these options depends on the kind of string it is (specified in an entry of this hash):
sr: Садржај ових опција зависи од врсте стринга (наведена је ставки овог хеша):

note: type: textblock
en: The found string is the content of a translatable tag. The entry "tag_options" contains the option characters in front of the tag hierarchy in the module "tags" option.
sr: Пронађени стринг је садржај преводиве ознаке. Ставка „tag_options” садржи карактере опција испред хијерархије ознака у „tags”опцији модула.

note: type: textblock
en: Means that the found string is the value of a translatable attribute. The entry "attribute" has the name of the attribute.
sr: Значи да је пронађени стринг вредност преводивог атрибута. Ставка „attribute” садржи име тог атрибута.

note: type: textblock
en: It must return the text that will replace the original in the translated document. Here's a basic example of this function:
sr: Она мора да врати текст који ће у преведеном документу да замени оригинал. Ево основног примера ове функције:

note: type: textblock
en: There's another simple example in the new Dia module, which only filters some strings.
sr: Постоји још један прости пример у новом Dia модулу, који само филтрира неке стрингове.

note: type: =head2
en: MODIFYING TAG TYPES (TODO)
sr: ИЗМЕНА ТИПОВА ОЗНАКА (УРАДИТИ)

note: type: textblock
en: This is a more complex one, but it enables a (almost) total customization.  It's based on a list of hashes, each one defining a tag type's behavior. The list should be sorted so that the most general tags are after the most concrete ones (sorted first by the beginning and then by the end keys). To define a tag type you'll have to make a hash with the following keys:
sr: Ово је компликованије, али омогућава (скоро) тоталну могућност прилагођавања. Базира се на листи хешева, од којих сваки дефинише понашање одређеног типа ознака. Листа би требало да буде сортирана тако да се општији типови налазе иза конкретнијих (сортираних најпре према beginning, па према end кључевима). Ако желите да дефинишете тип ознаке, мораћете да направите хеш са следећим кључевима:

note: type: textblock
en: Specifies the beginning of the tag, after the "E<lt>".
sr: Наводи почетак ознаке, након „E<lt>”.

note: type: textblock
en: Specifies the end of the tag, before the "E<gt>".
sr: Наводи крај ознаке, испред „E<gt>”.

note: type: textblock
en: It says if this is a breaking tag class.  A non-breaking (inline) tag is one that can be taken as part of the content of another tag.  It can take the values false (0), true (1) or undefined.  If you leave this undefined, you'll have to define the f_breaking function that will say whether a concrete tag of this class is a breaking tag or not.
sr: Говори да ли је ово класа преламајућих ознака. Непреламајућа (унутар линије) ознака је она која може да се узме као део садржаја неке друге ознаке. Може да има вредности неистинито (0), истинито (1) или да буде недефинисана. Ако је оставите недефинисаном, мораћете да дефинишете функцију f_breaking која ће да каже да ли је конкретна ознака ове класе преламајућа или није.

note: type: textblock
en: It's a function that will tell if the next tag is a breaking one or not.  It should be defined if the B<breaking> option is not.
sr: Ово је функција која ће да каже да ли је наредна ознака преламајућа, или не. Мора да се дефинише у случају када опција B<breaking> није дефинисана.

note: type: textblock
en: If you leave this key undefined, the generic extraction function will have to extract the tag itself.  It's useful for tags that can have other tags or special structures in them, so that the main parser doesn't get mad.  This function receives a boolean that says if the tag should be removed from the input stream or not.
sr: Ако овај кључ оставите недефинисан, генеричка функција за издвајање ће морати да издвоји саму ознаку. Ово је корисно за ознаке које у себи могу да садрже друге ознаке или специјалне структуре, тако да се не наљути главни парсер. Ова функција прихвата логичку вредност која говори да ли ознака треба да се уклони из улазног тока или не.

note: type: textblock
en: This function receives the tag (in the get_string_until() format) and returns the translated tag (translated attributes or all needed transformations) as a single string.
sr: Ова функција прихвата ознаку (у get_string_until() формату) и враћа преведену ознаку (преведене атрибуте или све потребне трансформације) као један стринг.

note: type: =head2
en: WORKING WITH TAGS
sr: РАД СА ОЗНАКАМА

note: type: textblock
en: This function returns the path to the current tag from the document's root, in the form E<lt>htmlE<gt>E<lt>bodyE<gt>E<lt>pE<gt>.
sr: Ова функција враћа путању од корена документа до текуће ознаке, у облику E<lt>htmlE<gt>E<lt>bodyE<gt>E<lt>pE<gt>.

note: type: textblock
en: An additional array of tags (without brackets) can be passed as argument.  These path elements are added to the end of the current path.
sr: Као аргумент може да се проследи додатни низ ознака (без заграда). Ови елементи путање се додају на крај текуће путање.

note: type: textblock
en: This function returns the index from the tag_types list that fits to the next tag in the input stream, or -1 if it's at the end of the input file.
sr: Ова функција враћа индекс из tag_types листе који се подудара са наредном ознаком у улазном току, или -1 ако је дошла до краја улазног фајла.

note: type: textblock
en: Here, the tag has structure started by E<lt> and end by E<gt> and it can contain multiple lines.
sr: Овде, ознака има структуру започету са E<lt> и крај са E<gt>, а може да се састоји од више линија.

note: type: textblock
en: This works on the array C<< @{$self->{TT}{doc_in}} >> holding input document data and reference indirectly via C<< $self->shiftline() >> and C<< $self->unshiftline($$) >>.
sr: Ово ради над низом C<< @{$self->{TT}{doc_in}} >> који чува податке из улазног документа и индиректно референцира се индиректно преко C<< $self->shiftline() >> и C<< $self->unshiftline($$) >>.

note: type: textblock
en: This function returns the next tag from the input stream without the beginning and end, in an array form, to maintain the references from the input file.  It has two parameters: the type of the tag (as returned by tag_type) and a boolean, that indicates if it should be removed from the input stream.
sr: Ова функција у облику низа враћа из улазног тока следећу ознаку без почетка и краја, како би се одржале референце из улазног фајла. Има два параметра: тип ознаке (као што га враћа tag_type) и логичку вредност која означава да ли би ознака требало да се уклони из улазног тока.

note: type: textblock
en: This function returns the name of the tag passed as an argument, in the array form returned by extract_tag.
sr: Ова функција враћа име ознаке која јој се прослеђује као аргумент, у облику низа који враћа extract_tag.

note: type: textblock
en: This function returns a boolean that says if the next tag in the input stream is a breaking tag or not (inline tag).  It leaves the input stream intact.
sr: Ова функција враћа логичку вредност која говори да ли је наредна ознака у улазном току преламајућа ознака или није (ознака унутар линије). Улазни ток оставља нетакнут.

note: type: textblock
en: This function translates the next tag from the input stream.  Using each tag type's custom translation functions.
sr: Ова функција преводи следећу ознаку у улазном току. Употребом прилагођених функција превођења сваког од типова ознака.

note: type: textblock
en: This function returns a string value that says if the first argument (a tag hierarchy) matches any of the tags from the second argument (a list of tags or tag hierarchies). If it doesn't match, it returns 0. Else, it returns the matched tag's options (the characters in front of the tag) or 1 (if that tag doesn't have options).
sr: Ова функција враћа стринг вредност која говори да ли се први аргумент (у хијерархији ознака) подудара са неком од ознака у другом аргументу (листа ознака или листа хијерархија ознака). Ако се не подудара, враћа се 0. Ако се подудара, враћају се опције подударене ознаке (карактери испред ознаке) или 1 (ако та ознака нема опције).

note: type: =head2
en: WORKING WITH ATTRIBUTES
sr: РАД СА АТРИБУТИМА

note: type: textblock
en: This function handles the translation of the tags' attributes. It receives the tag without the beginning / end marks, and then it finds the attributes, and it translates the translatable ones (specified by the module option B<attributes>).  This returns a plain string with the translated tag.
sr: Ова функција обрађује превођење атрибута ознаке. Она прихвата ознаку без маркера почетка / краја, па затим проналази атрибуте и преводи оне који могу да се преведу (њих наводи опција модула B<attributes>). Она враћа прости стринг са преведеном ознаком.

note: type: =head2
en: WORKING WITH TAGGED CONTENTS
sr: РАД СА ОЗНАЧЕНИМ САДРЖАЈЕМ

note: type: textblock
en: This function gets the text until the next breaking tag (not inline) from the input stream.  Translate it using each tag type's custom translation functions.
sr: Ова функција враћа из улазног тока текст све до следеће преламајуће ознаке (оне која није унутар линије). Преводи га користећи прилагођене функције за превођење сваког од типова ознака.

note: type: =head2
en: WORKING WITH THE MODULE OPTIONS
sr: РАД СА ОПЦИЈАМА МОДУЛА

note: type: textblock
en: This function fills the internal structures that contain the tags, attributes and inline data with the options of the module (specified in the command-line or in the initialize function).
sr: Ова функција попуњава интерне структуре које садрже ознаке, атрибуте и податке унутар линија опцијама модула (које су наведене у командној линији или у функцији за иницијализацију).

note: type: =head2
en: GETTING TEXT FROM THE INPUT DOCUMENT
sr: ПРИХВАТАЊЕ ТЕКСТА ИЗ УЛАЗНОГ ДОКУМЕНТА

note: type: textblock
en: This function returns an array with the lines (and references) from the input document until it finds the first argument.  The second argument is an options hash. Value 0 means disabled (the default) and 1, enabled.
sr: Ова функција враћа низ са линијама (и референцама) из улазног документа све док не наиђе на први аргумент. Други аргумент је хеш са опцијама. Вредност 0 значи искључено (подразумевано), а 1 укључено.

note: type: textblock
en: The valid options are:
sr: Важеће опције су:

note: type: textblock
en: This makes the returned array to contain the searched text
sr: Ово чини да враћени низ садржи текст за претрагу

note: type: textblock
en: This removes the returned stream from the input
sr: Ово из улаза уклања враћени ток

note: type: textblock
en: This ensures that the searched text is outside any quotes
sr: Ово обезбеђује да се текст који се претражује не налази унутар било каквих знакова навода

note: type: textblock
en: This denotes that the first argument is a regular expression rather than an plain string
sr: Ово означава да је први аргумент регуларни израз, а не прости стринг

note: type: textblock
en: This function receives as argument the reference to a paragraph (in the format returned by get_string_until), skips his heading spaces and returns them as a simple string.
sr: Ова функција прихвата као свој аргумент референцу на пасус (у облику који враћа get_string_until), прескаче њене размаке у наслову и враћа их као прост стринг.

note: type: textblock
en: This function returns a simple string with the text from the argument array (discarding the references).
sr: Ова функција враћа прост стринг са текстом из низа који је добила као аргумент (одбацујући референце).

note: type: textblock
en: This module can translate tags and attributes.
sr: Овај модул може да преведе ознаке и атрибуте.

note: type: textblock
en: DOCTYPE (ENTITIES)
sr: DOCTYPE (ЕНТИТЕТИ)

note: type: textblock
en: There is a minimal support for the translation of entities. They are translated as a whole, and tags are not taken into account. Multilines entities are not supported and entities are always rewrapped during the translation.
sr: Постоји минимална подршка за превођење ентитета. Они се преводе као целина, ознаке се не узимају у обзир. Ентитети у више линија нису подржани, а ентитети се увек поново обавијају током превођења.

note: type: textblock
en: MODIFY TAG TYPES FROM INHERITED MODULES (move the tag_types structure inside the $self hash?)
sr: ИЗМЕНА ТИПОВА ОЗНАКА ИЗ НАСЛЕЂЕНИХ МОДУЛА (померити структуру tag_types унутар $self хеша?)

note: type: verbatim
en:  Jordi Vilalta <jvprat@gmail.com>
     Nicolas François <nicolas.francois@centraliens.net>
sr:  Жорди Вилалта<jvprat@gmail.com>
     Никола Франсоа <nicolas.francois@centraliens.net>

note: type: verbatim
en:  Copyright © 2004 Jordi Vilalta  <jvprat@gmail.com>
     Copyright © 2008-2009 Nicolas François <nicolas.francois@centraliens.net>
sr:  Права умножавања © 2004 Жорди Вилалта <jvprat@gmail.com>
     Права умножавања © 2008-2009 Никола Франсоа <nicolas.francois@centraliens.net>

note: type: textblock
en: Locale::Po4a::Yaml - convert YAML files from/to PO files
sr: Locale::Po4a::Yaml - двосмерна конверзија YAML фајлова и PO фајлова

note: type: textblock
en: Locale::Po4a::Yaml is a module to help the translation of Yaml files into other [human] languages.
sr: Locale::Po4a::Yaml је модул који помаже у превођењу Yaml фајлова на друге [људске] језике.

note: type: textblock
en: The module extracts the value of YAML hashes and arrays. Hash keys are not extracted.
sr: Модул издваја вредност YAML хешева и низова. Хеш кључеви се не издвајају.

note: type: textblock
en: NOTE: This module parses the YAML file with YAML::Tiny.
sr: НАПОМЕНА: овај модул парсира YAML фајл помоћу YAML::Tiny.

note: type: textblock
en: Space-separated list of hash keys to process for extraction, all other keys are skipped.  Keys are matched with a case-sensitive match.  If B<paths> and B<keys> are used together, values are included if they are matched by at least one of the options.  Arrays values are always returned unless the B<skip_array> option is provided.
sr: Листа хеш кључева раздвојених размацима који треба да се обраде за издвајање, сви остали кључеви се прескачу. При подударању кључева се води рачуна о разлици малих и великих слова. Ако се B<paths> и B<keys> употребе заједно, вредности се укључују ако се подударају са барем једном од њих. Вредности низова се увек враћају, осим у случају када је постављена опција B<skip_array>.

note: type: textblock
en: Comma-separated list of hash paths to process for extraction, all other paths are skipped. Paths are matched with a case-sensitive match.  If B<paths> and B<keys> are used together, values are included if they are matched by at least one of the options.  Arrays values are always returned unless the B<skip_array> option is provided.
sr: Листа хеш путања раздвојених запетама који треба да се обраде за издвајање, све остале путање се прескачу. При подударању путања се води рачуна о разлици малих и великих слова. Ако се B<paths> и B<keys> употребе заједно, вредности се укључују ако се подударају са барем једном од опција. Вредности низова се увек враћају, осим у случају када је постављена опција B<skip_array>.

note: type: textblock
en: Do not translate array values.
sr: Вредности низа се не преводе.

note: type: verbatim
en:  Brian Exelbierd <bex@pobox.com>
sr:  Брајан Екселбирд <bex@pobox.com>

note: type: verbatim
en:  Copyright © 2017 Brian Exelbierd.
     Copyright © 2022 Martin Quinson <mquinson#debian.org>.
sr:  Copyright © 2017 Брајан Ексебирд.
     Copyright © 2022 Мартин Квенсон <mquinson#debian.org>.
