.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "LOCALE::PO4A::PO.3PM 1"
.TH LOCALE::PO4A::PO.3PM 1 2024-06-26 "perl v5.38.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH ИМЕ
.IX Header "ИМЕ"
Locale::Po4a::Po \- модул за манипулацију PO фајла
.SH СИНОПСИС
.IX Header "СИНОПСИС"
.Vb 2
\&    use Locale::Po4a::Po;
\&    my $pofile=Locale::Po4a::Po\->new();
\&
\&    # Читање PO фајла
\&    $pofile\->read(\*(Aqфајл.po\*(Aq);
\&
\&    # Уметање ставке
\&    $pofile\->push(\*(Aqmsgid\*(Aq => \*(AqHello\*(Aq, \*(Aqmsgstr\*(Aq => \*(Aqbonjour\*(Aq,
\&                  \*(Aqflags\*(Aq => "wrap", \*(Aqreference\*(Aq=>\*(Aqfile.c:46\*(Aq);
\&
\&    # Издвајање превода
\&    $pofile\->gettext("Hello"); # враћа \*(Aqbonjour\*(Aq
\&
\&    # Уписивање назад у фајл
\&    $pofile\->write(\*(Aqдругифајл.po\*(Aq);
.Ve
.SH ОПИС
.IX Header "ОПИС"
Locale::Po4a::Po који вам омогућава да манипулишете каталозима порука. Можете да учитате и уписујете у фајл (чија екстензија је обично \fIpo\fR), можете у лету да градите нове ставке или да захтевате превод стринга.
.PP
За потпунији опис каталога порука у PO формату, као и начин њихове употребе, молимо да погледате info документацију програма gettext (чвор "`PO Files"').
.PP
Овај модуле је део пројекта po4a, чији је циљ да се PO фајлови (изворно направљених за олакшавање превода порука неког програма) користе за превођење свега, укључујући и документацију (man страница, info упутство), описе пакета, debconf шаблоне, као и све оно што може да има користи од овога.
.SH "ОПЦИЈЕ КОЈЕ ПРИХВАТА ОВАЈ МОДУЛ"
.IX Header "ОПЦИЈЕ КОЈЕ ПРИХВАТА ОВАЈ МОДУЛ"
.IP "\fB\-\-porefs\fR \fIтип\fR" 4
.IX Item "--porefs тип"
Наводи форамт референци. Аргумент \fIтип\fR може да буде једно од: \fBnever\fR да се не креирају никакве референце, \fBfile\fR да се наведе само фајл без броја линије, \fBcounter\fR да се број линије замени растућим бројачем, и \fBfull\fR да се креирају комплетне референце (подразумевано: full).
.IP "\fB\-\-wrap\-po\fR \fBno\fR|\fBnewlines\fR|\fIброј\fR (подразумевано: 76)" 4
.IX Item "--wrap-po no|newlines|број (подразумевано: 76)"
Наводи како би po фајл требало да се обавија. Овим вам се даје избор између фајлова који су лепо обавијени али би могли да доведу до git конфликата, или фајлова који се лакше обрађују аутоматски, али су компликованији за читање.
.Sp
Раније је gettext свита програма реформатирала po фајлове на 77ој колони ради лепшег изгледа. Ова опција одрешује понашање програма po4a. Ако се постави на нумеричку вредност, po4a ће да обавије po након колоне под тим бројем и након прелома линија у садржају. Ако се постави на \fBnewlines\fR, po4a ће само да раздели msgid и msgstr након прелома линија у садржају. Ако се постави на \fBno\fR, po4a уопште неће да обавија po фајл. gettext алати које интерно користимо увек обавијају референтне коментаре.
.Sp
Имајте на уму да ова опција не утиче на то како се msgid и msgstr обавијају, тј. на то како се додају преломи линија у садржај ових стрингова.
.IP "\fB\-\-msgid\-bugs\-address\fR \fIимејл@адреса\fR" 4
.IX Item "--msgid-bugs-address имејл@адреса"
Поставља адресу за пријаву msgid багова. Подразумевано, креирани POT немају Report-Msgid-Bugs-To поља.
.IP "\fB\-\-copyright\-holder\fR \fIстринг\fR" 4
.IX Item "--copyright-holder стринг"
Поставља власника права умножавања у POT заглавље. Подразумевана вредност је "Free Software Foundation, Inc."
.IP "\fB\-\-package\-name\fR \fIстринг\fR" 4
.IX Item "--package-name стринг"
Поставља име пакета у POT заглавље. Подразумевано је "PACKAGE".
.IP "\fB\-\-package\-version\fR \fIстринг\fR" 4
.IX Item "--package-version стринг"
Поставља верзију пакета у POT заглавље. Подразумевано је "VERSION".
.SH "Функције које се тичу каталога порука у целини"
.IX Header "Функције које се тичу каталога порука у целини"
.IP \fBnew()\fR 4
.IX Item "new()"
Креира нови каталог порука. Ако се наведе аргумент, то ће бити име PO фајла који би требало да се учита.
.IP read($) 4
.IX Item "read($)"
Чита PO фајл (чије име је дато аргументом). Претходно постојеће ставке у објекту се не уклањају, нове се додају на крај каталога.
.IP write($) 4
.IX Item "write($)"
Уписује текући каталог у дати фајл.
.IP write_if_needed($$) 4
.IX Item "write_if_needed($$)"
Као write, али у случају да PO или POT фајл већ постоји, објекат ће да се упише у привремени фајл који ће затим да се упореди са постојећим како би се проверило да ли је неопходно ажурирање (на овај начин се избегава измена POT фајла само да би се ажурирала линија референце, или поље POT-Creation-Date).
.IP filter($) 4
.IX Item "filter($)"
Ова функција издваја каталог из постојећег. У излазни каталог се смештају само оне ставке које имају референцу у датом фајлу.
.Sp
Ова функција парсира свој аргумент, конвертује га у дефиницију Perl функције, одређује вредност ове дефиниције и филтрира поља за коју функција враћа истиниту вредност.
.Sp
Понекад волим Perl ;)
.SH "Функције за коришћење каталога порука у преводима"
.IX Header "Функције за коришћење каталога порука у преводима"
.IP gettext($%) 4
.IX Item "gettext($%)"
Захтева из текућег каталога превод за стринг који је дат као аргумент. У случају да се превод не пронађе, функција враћа оригинални (непреведени) стринг.
.Sp
Након стринга који треба да се преведе, можете да наведете хеш додатних аргумената. Ево важећих ставки:
.RS 4
.IP \fBwrap\fR 4
.IX Item "wrap"
логичка вредност која указује на то да ли се празни карактери у стрингу сматрају за битне карактере. Ако је тачно, функција канонизује стринг пре тражења превода, и обавија резултат.
.IP \fBwrapcol\fR 4
.IX Item "wrapcol"
колона око које се врши обавијање (подразумевано: 76).
.RE
.RS 4
.RE
.IP \fBstats_get()\fR 4
.IX Item "stats_get()"
Враћа статистику у вези успешности програма gettext у проналажења превода од тренутка када је последњи пут позвана функција \fBstats_clear()\fR. Молимо имајте на уму да ово није иста статистика коју приказује msgfmt \-\-statistic. Овде је то статистика о недавном коришћењу PO фајла, док msgfmt пријављује статус фајла. Пример употребе:
.Sp
.Vb 1
\&    [нека употреба PO фајла за превођење нечега]
\&
\&    ($percent,$hit,$queries) = $pofile\->stats_get();
\&    print "До сада, пронашли смо преводе за $percent\e%  ($hit од $queries) стрингова.\en";
.Ve
.IP \fBstats_clear()\fR 4
.IX Item "stats_clear()"
Брише статистику и вези успешности програма gettext.
.SH "Функције за изградњу каталога порука"
.IX Header "Функције за изградњу каталога порука"
.IP push(%) 4
.IX Item "push(%)"
Додаје нову ставку не крај текућег каталога. Аргумент би требало да буде у форми хеш табеле. Важећи кључеви су:
.RS 4
.IP \fBmsgid\fR 4
.IX Item "msgid"
стринг на оригиналном језику.
.IP \fBmsgstr\fR 4
.IX Item "msgstr"
превод.
.IP \fBreference\fR 4
.IX Item "reference"
указује на то где је стринг пронађен. Пример: file.c:46 (значи у 'file.c' на линији 46). У случају вишеструког појављивања, може да буде листа раздвојена размацима.
.IP \fBcomment\fR 4
.IX Item "comment"
коментар који (преводиоци) овде ручно додају. Формат је потпуно слободан.
.IP \fBautomatic\fR 4
.IX Item "automatic"
коментар који аутоматски додаје програм за издвајање стрингова. За више информација, погледајте опцију \fB\-\-add\-comments\fR програма \fBxgettext\fR.
.IP \fBflags\fR 4
.IX Item "flags"
листа свих заставица дефинисаних за ову ставку, раздвојених размацима.
.Sp
Важеће заставице су: \fBc\-text\fR, \fBpython-text\fR, \fBlisp-text\fR, \fBelisp-text\fR, \fBlibrep-text\fR, \fBsmalltalk-text\fR, \fBjava-text\fR, \fBawk-text\fR, \fBobject-pascal-text\fR, \fBycp-text\fR, \fBtcl-text\fR, \fBwrap\fR, \fBno-wrap\fR и \fBfuzzy\fR.
.Sp
За њихово значење, погледајте gettext документацију.
.IP \fBtype\fR 4
.IX Item "type"
ово је углавном интерни аргумент: користи се током gettextизације докумената. Идеја је да се у PO објекат парсирају и оригинал и превод, да се споје у нови каталог користећи msgid једног као msgid, а msgid другог као msgstr. Да би се обезбедило да све буде како треба, сваком msgid у PO објектима се даје тип, заснован на његовој структури (као "chapt", "sect1", "p" и тако даље у DocBook). Ако типови стрингова нису исти, то значи да два фајла немају исту структуру, па процес пријављује грешку.
.Sp
Ова информација се у PO фајл уписује као аутоматски коментар јер се на тај начин преводиоцима приказује нешто од контекста у вези стрингова који треба да преведу.
.IP \fBwrap\fR 4
.IX Item "wrap"
логичка вредност која говори да ли је код козметичких реформатирања дозвољено да се претумбају празни карактери. Ако је истинита, стринг се канонизује пре употребе.
.Sp
Ова информација се у PO уписује помоћу заставица \fBwrap\fR или \fBno-wrap\fR.
.IP \fBwrapcol\fR 4
.IX Item "wrapcol"
игнорише се; кључ се чува из разлога компатибилности са ранијим верзијама.
.RE
.RS 4
.RE
.SH "Разне функције"
.IX Header "Разне функције"
.IP \fBcount_entries()\fR 4
.IX Item "count_entries()"
Враћа број ставки у каталогу (не узимајући у обзир заглавље).
.IP \fBcount_entries_doc()\fR 4
.IX Item "count_entries_doc()"
Враћа број ставки у документу. Ако се стринг у документу појављује више пута, бројаће се више пута.
.IP msgid($) 4
.IX Item "msgid($)"
Враћа msgid датог броја.
.IP msgid_doc($) 4
.IX Item "msgid_doc($)"
Враћа msgid са датом позицијом у документу.
.IP type_doc($) 4
.IX Item "type_doc($)"
Враћа тип msgid стринга на задатој позицији у документу. Ово је вероватно корисно само код gettextизације и чува се одвојено од {$msgid}{'type'} јер ову локацују може да препише неки други тип када се у мастер документу \f(CW$msgid\fR дуплира.
.IP \fBget_charset()\fR 4
.IX Item "get_charset()"
Враћа скуп карактера који је наведен у PO заглављу. Ако није било постављено, вратиће „UTF\-8”.
.SH АУТОРИ
.IX Header "АУТОРИ"
.Vb 2
\& Дени Барбије <barbier@linuxfr.org>
\& Мартин Квинсон (mquinson#debian.org)
.Ve