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

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

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

=encoding UTF-8

=head1 ИМЕ

Locale::Po4a::Po - модул за манипулацију PO фајла

=head1 СИНОПСИС

    use Locale::Po4a::Po;
    my $pofile=Locale::Po4a::Po->new();

    # Читање PO фајла
    $pofile->read('фајл.po');

    # Уметање ставке
    $pofile->push('msgid' => 'Hello', 'msgstr' => 'bonjour',
                  'flags' => "wrap", 'reference'=>'file.c:46');

    # Издвајање превода
    $pofile->gettext("Hello"); # враћа 'bonjour'

    # Уписивање назад у фајл
    $pofile->write('другифајл.po');

=head1 ОПИС

Locale::Po4a::Po који вам омогућава да манипулишете каталозима порука. Можете да учитате и уписујете у фајл (чија екстензија је обично I<po>), можете у лету да градите нове ставке или да захтевате превод стринга.

За потпунији опис каталога порука у PO формату, као и начин њихове употребе, молимо да погледате info документацију програма gettext (чвор "`PO Files"').

Овај модуле је део пројекта po4a, чији је циљ да се PO фајлови (изворно направљених за олакшавање превода порука неког програма) користе за превођење свега, укључујући и документацију (man страница, info упутство), описе пакета, debconf шаблоне, као и све оно што може да има користи од овога.

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

=over 4

=item B<--porefs> I<тип>

Наводи форамт референци. Аргумент I<тип> може да буде једно од: B<never> да се не креирају никакве референце, B<file> да се наведе само фајл без броја линије, B<counter> да се број линије замени растућим бројачем, и B<full> да се креирају комплетне референце (подразумевано: full).

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

Наводи како би po фајл требало да се обавија. Овим вам се даје избор између фајлова који су лепо обавијени али би могли да доведу до git конфликата, или фајлова који се лакше обрађују аутоматски, али су компликованији за читање.

Раније је gettext свита програма реформатирала po фајлове на 77ој колони ради лепшег изгледа. Ова опција одрешује понашање програма po4a. Ако се постави на нумеричку вредност, po4a ће да обавије po након колоне под тим бројем и након прелома линија у садржају. Ако се постави на B<newlines>, po4a ће само да раздели msgid и msgstr након прелома линија у садржају. Ако се постави на B<no>, po4a уопште неће да обавија po фајл. gettext алати које интерно користимо увек обавијају референтне коментаре.

Имајте на уму да ова опција не утиче на то како се msgid и msgstr обавијају, тј. на то како се додају преломи линија у садржај ових стрингова.

=item B<--msgid-bugs-address> I<имејл@адреса>

Поставља адресу за пријаву msgid багова. Подразумевано, креирани POT немају Report-Msgid-Bugs-To поља.

=item B<--copyright-holder> I<стринг>

Поставља власника права умножавања у POT заглавље. Подразумевана вредност је "Free Software Foundation, Inc."

=item B<--package-name> I<стринг>

Поставља име пакета у POT заглавље. Подразумевано је "PACKAGE".

=item B<--package-version> I<стринг>

Поставља верзију пакета у POT заглавље. Подразумевано је "VERSION".

=back

=head1 Функције које се тичу каталога порука у целини

=over 4

=item new()

Креира нови каталог порука. Ако се наведе аргумент, то ће бити име PO фајла који би требало да се учита.

=item read($)

Чита PO фајл (чије име је дато аргументом). Претходно постојеће ставке у објекту се не уклањају, нове се додају на крај каталога.

=item write($)

Уписује текући каталог у дати фајл.

=item write_if_needed($$)

Као write, али у случају да PO или POT фајл већ постоји, објекат ће да се упише у привремени фајл који ће затим да се упореди са постојећим како би се проверило да ли је неопходно ажурирање (на овај начин се избегава измена POT фајла само да би се ажурирала линија референце, или поље POT-Creation-Date).

=item filter($)

Ова функција издваја каталог из постојећег. У излазни каталог се смештају само оне ставке које имају референцу у датом фајлу.

Ова функција парсира свој аргумент, конвертује га у дефиницију Perl функције, одређује вредност ове дефиниције и филтрира поља за коју функција враћа истиниту вредност.

Понекад волим Perl ;)

=item to_utf8()

Поново кодира msgstr стрингове из PO фајла у UTF-8. Не ради ништа у случају да скуп карактера није наведен у PO фајлу (вредност "CHARSET"), или је већ UTF-8 или ASCII.

=back

=head1 Функције за коришћење каталога порука у преводима

=over 4

=item gettext($%)

Захтева из текућег каталога превод за стринг који је дат као аргумент. У случају да се превод не пронађе, функција враћа оригинални (непреведени) стринг.

Након стринга који треба да се преведе, можете да наведете хеш додатних аргумената. Ево важећих ставки:

=over 

=item B<wrap>

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

=item B<wrapcol>

колона око које се врши обавијање (подразумевано: 76).

=back

=item stats_get()

Враћа статистику у вези успешности програма gettext у проналажења превода од тренутка када је последњи пут позвана функција stats_clear(). Молимо имајте на уму да ово није иста статистика коју приказује msgfmt --statistic. Овде је то статистика о недавном коришћењу PO фајла, док msgfmt пријављује статус фајла. Пример употребе:

    [нека употреба PO фајла за превођење нечега]

    ($percent,$hit,$queries) = $pofile->stats_get();
    print "До сада, пронашли смо преводе за $percent\%  ($hit од $queries) стрингова.\n";

=item stats_clear()

Брише статистику и вези успешности програма gettext.

=back

=head1 Функције за изградњу каталога порука

=over 4

=item push(%)

Додаје нову ставку не крај текућег каталога. Аргумент би требало да буде у форми хеш табеле. Важећи кључеви су:

=over 4

=item B<msgid>

стринг на оригиналном језику.

=item B<msgstr>

превод.

=item B<reference>

указује на то где је стринг пронађен. Пример: file.c:46 (значи у 'file.c' на линији 46). У случају вишеструког појављивања, може да буде листа раздвојена размацима.

=item B<comment>

коментар који (преводиоци) овде ручно додају. Формат је потпуно слободан.

=item B<automatic>

коментар који аутоматски додаје програм за издвајање стрингова. За више информација, погледајте опцију B<--add-comments> програма B<xgettext>.

=item B<flags>

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

Важеће заставице су: 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>.

За њихово значење, погледајте gettext документацију.

=item B<type>

ово је углавном интерни аргумент: користи се током gettextизације докумената. Идеја је да се у PO објекат парсирају и оригинал и превод, да се споје у нови каталог користећи msgid једног као msgid, а msgid другог као msgstr. Да би се обезбедило да све буде како треба, сваком msgid у PO објектима се даје тип, заснован на његовој структури (као "chapt", "sect1", "p" и тако даље у DocBook). Ако типови стрингова нису исти, то значи да два фајла немају исту структуру, па процес пријављује грешку.

Ова информација се у PO фајл уписује као аутоматски коментар јер се на тај начин преводиоцима приказује нешто од контекста у вези стрингова који треба да преведу.

=item B<wrap>

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

Ова информација се у PO уписује помоћу заставица B<wrap> или B<no-wrap>.

=item B<wrapcol>

колона око које се врши обавијање (подразумевано: 76).

Ова информација се не уписује у PO фајл.

=back

=back

=head1 Разне функције

=over 4

=item count_entries()

Враћа број ставки у каталогу (не узимајући у обзир заглавље).

=item count_entries_doc()

Враћа број ставки у документу. Ако се стринг у документу појављује више пута, бројаће се више пута.

=item msgid($)

Враћа msgid датог броја.

=item msgid_doc($)

Враћа msgid са датом позицијом у документу.

=item type_doc($)

Враћа тип msgid стринга на задатој позицији у документу. Ово је вероватно корисно само код gettextизације и чува се одвојено од {$msgid}{'type'} јер ову локацују може да препише неки други тип када се у мастер документу $msgid дуплира.

=item get_charset()

Враћа скуп карактера који је наведен у PO заглављу. Ако није било постављено, вратиће „UTF-8”.

=item set_charset($)

Ово поставља скуп карактера PO заглавља на вредност наведену у свом аргументу. Ако никада не позовете ову функцију (и ниједан фајл са наведеним скупом карактера се не чита), подразумевана вредност се оставља на „UTF-8”. Ова вредност не мења понашање модула, користи се само за попуњавање заглавља, и да се врати функцијом get_charset().

=back

=head1 АУТОРИ

 Дени Барбије <barbier@linuxfr.org>
 Мартин Квинсон (mquinson#debian.org)

