PO4A-TRANSLATE(1p)

NAZWA
po4a-translate - konwertuje plik po z powrotem do formatu dokumentacji

SKXADNIA
po4a-translate -f <fmt> -m <master.doc> -p <XX.po> -l <XX.doc>

(XX.doc jest plikiem wyjXciowym, wszystkie pozostaXe sX plikami wejXciowymi)

OPIS
Celem projektu po4a ("po for anything") jest uXatwienie tXumaczen~ (oraz, co ciekawsze, zarzXdzania tXumaczeniami) przy uXyciu narzedzi gettext w tych obszarach, gdzie nie byXy uXywane, jak na przykXad w obszarze dokumentacji.

Skrypt "po4a-translate" odpowiada za konwertowanie tXumaczen~ (dokonanych w pliku po) z powrotem do formatu dokumentacji. Przekazany plik "po" powinien byae tXumaczeniem pliku "pot" utworzonego przez po4a-gettextize(1).

OPCJE

-f, --format
    Format dokumentacji, ktorX chce sie obsXuXyae. Liste dostepnych formatow moXna wyXwietliae, podajXc opcje --help-format.

-a, --addendum
    Dodaje zaXXcznik do pliku wynikowego (na przykXad, aby umieXciae nazwisko tXumacza albo sekcje "O tXumaczeniu"). PierwszX liniX tego pliku powinien byae nagXowek PO4A, okreXlajXcy, gdzie zawartoXae powinna byae dodana (patrz sekcja JAK umieXciae dodatkowy tekst w tXumaczeniach w po4a(7)).

-A, --addendum-charset
    Kodowanie znakow zaXXcznika. Prosze zauwaXyae, Xe wszystkie zaXXczniki powinny mieae to samo kodowanie znakow.

-m, --master
    Plik zawierajXcy dokument do przetXumaczenia.

-M, --master-charset
    Kodowanie znakow pliku zawierajXcego dokument do przetXumaczenia.

-l, --localized
    Plik, do ktorego powinien byae zapisany przetXumaczony dokument.

-L, --localized-charset
    Kodowanie znakow pliku zawierajXcego przetXumaczony dokument.

-p, --po
    Plik, z ktorego powinien byae odczytany katalog wiadomoXci.

-o, --option
    Dodatkowe opcje przekazywane moduXowi formatu. KaXda opcja powinna byae w formacie "nazwa=wartoXae". Wiecej informacji o dostepnych opcjach i ich znaczeniu moXna znaleXae w dokumentacji kaXdego moduXu.

-k, --keep
    Minimalny procentowy prog tXumaczen~ pozwalajXcy zachowaae (tj. zapisaae) plik wynikowy (domyXlnie: 80). Czyli, domyXlnie, aby pliki zostaXy zapisane, muszX byae przetXumaczone co najmniej w 80%.

-w, --width
    Kolumna, wg ktorej powinien byae zawijany plik wynikowy.

-h, --help
    Pokazuje krotki komunikat pomocy.

--help-format
    WyXwietla liste formatow dokumentacji obsXugiwanych przez po4a.

-V, --version
    WyXwietla wersje skryptu i kon~czy dziaXanie.

-v, --verbose
    Zwieksza gadatliwoXae programu.

-d, --debug
    Wypisuje informacje przydatne do debugowania.

Dodawanie zawartoXci (poza tXumaczeniami) do generowanych plikow
Aby w wygenerowanym dokumencie umieXciae dodatkowX zawartoXae, nie bedXcX tXumaczeniem oryginaXu (np. nazwisko tXumacza lub sekcje "o tXumaczeniu"), naleXy uXyae opcji "--addendum".

Pierwsza linia zaXXcznika musi zawieraae nagXowek, wskazujXcy, gdzie umieXciae reszte zaXXcznika w dokumencie (moXe to byae przed podanX czeXciX dokumentu lub za niX). Reszta pliku zaXXcznika bedzie dodana niezmieniona do pliku wynikowego.

Prosze zauwaXyae, Xe jeXeli po4a-translate zwroci bXXd podczas dodawania ktoregokolwiek z podanych zaXXcznikow, odrzuci caXe tXumaczenie (poniewaX brakujXcym plikiem moXe byae ten, ktory wskazuje na autora, co uniemoXliwi uXytkownikom skontaktowanie sie z nim i zgXoszenie bXedow w tXumaczeniu).

SkXadnia nagXowka jest bardzo sztywna. Wiecej informacji o tym, jak uXywaae zaXXcznikow i jak dziaXajX, moXna znaleXae w stronie podrecznika po4a(7).

ZOBACZ TAKXE
po4a(7), po4a-gettextize(1), po4a-updatepo(1), po4a-normalize(1).

AUTORZY
 Denis Barbier <barbier@linuxfr.org>
 Martin Quinson (mquinson#debian.org)

TXUMACZENIE
 Robert Luberda <robert@debian.org>

PRAWA AUTORSKIE I LICENCJA
Copyright 2002, 2003, 2004 by SPI, inc.

Program jest wolnym oprogramowaniem; moXna go redystrybuowaae i/lub modyfikowaae zgodnie z warunkami licencji GPL (patrz plik COPYING).