Конструктор¶

process(%)

Ова функција може да уради све што је потребно да се уради са po4a документом у једном позиву. Њени аргументи морају да се упакују као хеш. АКЦИЈЕ:

new(%)

Креира нови po4a документ. Прихватају се опције (морају да буду у хешу):

Манипулација фајловима докумената¶

read($$)

Додаје податке другог улазног документа на крај постојећег низа "@{$self->{TT}{doc_in}}". Аргумент је име фајла који треба да се прочита. Ако се зада и други аргумент, он представља име фајла који треба да се користи у референцама.

Низ "@{$self->{TT}{doc_in}}" чува податке из овог улазни документа као низ стрингова са наизменичним значењима.
* Стринг $textline који држи сваку линију улазног текста.
* Стринг "$filename:$linenum" који држи његову локацију и који се
зове "reference" ("linenum" почиње од 1).

Имајте на уму, молим вас, да ово још ништа не парсира. Када завршите са паковањем улазних фајлова у документ, требало би да употребите функцију parse().

write($)

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

Ови подаци преведеног документа се добијају из:
* "$self->docheader()" који чува текст заглавља за модул додатка, и
* "@{$self->{TT}{doc_out}}" који у низу чува сваку линију главног преведеног текста.

Манипулација PO фајловима¶

readpo($)

Додаје садржај фајла (чије име је прослеђено као аргумент) постојећем улазном PO. Стари садржај се не одбацује.

writepo($)

Уписује издвојени PO фајл у дато име фајла.

stats()

Враћа неке статистичке податке у вези до сада одрађеног превода. Имајте не уму, молим вас, да ово није иста статистика коју исписује msgfmt --statistic. Овде је то статистика у вези скорашње употребе PO фајла, док msgfmt пријављује статус фајла. То је функција која обавија функцију Locale::Po4a::Po::stats_get function примењену на улазни PO фајл. Пример употребе:

    [нормална употреба po4a документа...]
    ($percent,$hit,$queries) = $document->stats();
    print "Пронашли смо преводе за $percent\%  ($hit од $queries) стрингова.\n";
    

is_po_uptodate()

Враћа ($uptodate, $diagnostic) где $uptodate говори да ли се улазни po и излазни po подударају (ако не, то значи да би улазни po требало да се ажурира) и $diagnostic је стринг који објашњава разлог због ког po фајл није ажуран, онда када се то догоди.

Манипулација додацима¶

addendum($)

Молимо погледајте po4a(7) за више информација о томе шта су додаци, и како би преводиоци требало да их пишу. Да бисте применили додатак на преведени документ, једноставно проследите име његовог фајла овој функцији и то је то ;)

У случају грешке, ова функција враћа цео број различит од нуле.

Добављање улаза, обезбеђивање излаза¶

За преузимање улаза и враћање излаза се користе четири функције. Оне су врло сличне са shift/unshift и push/pop у језику Perl.

 * Perl shift враћа прву ставку низа и уклања је из њега.
 * Perl unshift ставља ставку на почетак низа као прву.
 * Perl pop враћа последњу ставку низа и уклања је из њега.
 * Perl push додаје ставку у низ као последњу.

Први пар се тиче улаза, док је други у вези излаза. Да се лакше упамти: за улаз вам је од интереса прва линија, а то је управо оно што враћа shift, док за излаз желите да свој резултат додате на крај, као што то ради push.

shiftline()

Ова функција враћа прву линију која треба да се парсира у њену одговарајућу референцу (упаковано као низ) из низа "@{$self->{TT}{doc_in}}" и уклања ове прве 2 ставке низа. Референцу овде обезбеђује стринг "$filename:$linenum".

unshiftline($$)

Unshift-ује последњу shift-овану линију улазног документа и њену одговарајућу референцу назад на почетак "{$self->{TT}{doc_in}}".

pushline($)

Ради push нове линије на крај "{$self->{TT}{doc_out}}".

popline()

Ради pop последње push-оване линије са краја "{$self->{TT}{doc_out}}".

Обележавање стрингова као преводивих¶

Достављена је једна функција која обрађује текст предвиђен за превођење.

translate($$$)

Обавезни аргументи:

  $self->translate("string","ref","type",
                   'wrap' => 1);

Разне функције¶

verbose()

Враћа информацију да ли је током креирања објекта TransTractor прослеђена опција детаљног извештавања.

debug()

Враћа информацију да ли је приликом креирања објекта TransTractor била прослеђена опција детаљнијег извештавања.

detected_charset($)

Ово говори TransTractor -у да је откривен нови скуп карактера (први аргумент) у улазном документу. Обично може да се прочита из заглавља документа. Преостаће само први скуп карактера, који долази или из аргумената функције process(), или се детектује из документа.

get_out_charset()

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

Користиће излазни скуп карактера наведен у командној линији. Ако није био задат, користиће се скуп карактера улазног PO, а ако улазни PO има подразумевану вредност „CHARSET”, вратиће скуп карактера улазног документа, тако да се не обавља кодирање..

recode_skipped_text($)

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