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

process(%)

Ця функція може виконувати усі дії, які слід виконати з документом po4a за один виклик. Її аргументи слід запакувати як хеш. ДІЇ:

new(%)

Створити документ po4a. Прийнятні параметри (але у хеші):

Робота з файлами документів¶

read($$)

Додати іще один вхідний документ наприкінці наявного масиву "@{$self->{TT}{doc_in}}". Аргументом є назва файла, з якого слід прочитати дані. Якщо вказано другий аргумент, він вважається назвою файла, який слід використовувати у посиланнях.

Цей масив "@{$self->{TT}{doc_in}}" містить дані вхідного документа у форматі масиву рядків із різним призначенням.
* Рядок $textline містить кожен з рядків вхідних текстових даних.
* Рядок "$filename:$linenum" містить його розташування у тексті і
називається «прив'язка» ("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, застосованою до файла 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.

 * shift у Perl повертає перший запис масиву і викидає його з масиву.
 * unshift у Perl дописує запис на початку масиву як його перший запис.
 * pop у Perl повертає останній запис масиву і викидає його з масиву.
 * push у Perl дописує запис до масиву наприкінці.

Перша пара працює із вхідними даними, а друга — з вихідними. Мнемоніка: у вхідних даних вас цікавитиме перший рядок, який дає shift, у вихідних ви додаєте результат наприкінці, як це робить push.

shiftline()

Ця функція повертає перший рядок для обробки і відповідне посилання (запаковане до масиву) з масиву "@{$self->{TT}{doc_in}}" і викидає з цього масиву два перших записи. Тут дані посилання надаються рядком "$filename:$linenum".

unshiftline($$)

Скасовує зсування останнього зсунутого рядка вхідного документа і його прив'язки на початку "{$self->{TT}{doc_in}}".

pushline($)

Вставити новий рядок наприкінці "{$self->{TT}{doc_out}}".

popline()

Виштовхнути останній вставлений рядок з кінця "{$self->{TT}{doc_out}}".

Позначення придатних до перекладу рядків¶

Одну функцію передбачено для обробки тексту, який має бути перекладено.

translate($$$)

Обов'язкові аргументи:

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

Інші функції¶

verbose()

Повертає значення, яке вказує, чи було передано під час створення TransTractor параметр докладного режиму повідомлень.

debug()

Повертає значення, яке вказує, чи було передано під час створення TransTractor параметр режиму діагностики.

detected_charset($)

Ця функція повідомляє TransTractor, що у вхідному документі було виявлено нове кодування (перший аргумент). Кодування, зазвичай, можна прочитати із заголовка документа. Використовуватиметься лише перше кодування, яке буде отримано з аргументів process() або визначено з документа.

get_out_charset()

Ця функція повертає кодування, яке слід використовувати у виведеному документі (зазвичай, корисно для заміни виявленого кодування вхідного документа, де його було визначено).

Функція використовуватиме для виведення кодування, вказане у рядку команди. Якщо кодування не вказано, буде використано кодування з вхідного файла PO. Якщо ж у цьому файлі лишатиметься типове значення кодування, «CHARSET», функція поверне значення кодування вхідного документа, отже ніякого перекодування не виконуватиметься.

recode_skipped_text($)

Ця функція повертає перекодований текст, переданий їй як аргумент, з кодування вхідного документа у кодування вихідного документа. У такому перекодуванні немає потреби, якщо рядок перекладається (translate() сама усе перекодовує), але воно потрібне, якщо ви пропускаєте рядок із вхідного документа і хочете, щоб вихідний документ був однорідним у сенсі загального кодування.