blib::man::Pod(3pm)

NAZWA
Locale::Po4a::Pod - Konwersja danych POD z/do plikow PO

SKXADNIA
    use Locale::Po4a::Pod;
    my $parser = Locale::Po4a::Pod->new (sentence => 0, width => 78);

    # Czytanie POD ze STDIN i zapisanie do STDOUT.
    $parser->parse_from_filehandle;

    # Czytanie POD z plik.pod i zapisanie do plik.txt.
    $parser->parse_from_file ('plik.pod', 'plik.txt');

OPIS
Locale::Po4a::Pod jest moduXem uXatwiajXcym tXumaczenie dokumentacji w formacie POD (preferowany jezyk dokumentowania programow napisanych w Perlu) do innych jezykow [uXywanych przez ludzi].

STATUS MODUXU
MyXle, Xe ten moduX jest stabilny jak skaXa, ma tylko jeden znany bXXd:

Mam problem z /usr/lib/perl5/Tk/MainWindow.pod (i innymi stronami, patrz niXej) ktory zawiera:

  CE<lt>" #n"E<gt>

Niestety, w wersji z po4a zostaXo to rozdzielone na spacji podczas zawijania. W wyniku, oryginalna strona podrecznika zawiera

 " #n"

a moj zawiera

 "" #n""

co jest logiczne, skoro "coXtam" jest przepisane jako "coXtam"

PeXna lista stron majXcych ten problem na moim komputerze (z 564 stron; prosze zauwaXyae, Xe zaleXy to od wyboru kolumny zawijania): /usr/lib/perl5/Tk/MainWindow.pod /usr/share/perl/5.8.0/overload.pod /usr/share/perl/5.8.0/pod/perlapi.pod /usr/share/perl/5.8.0/pod/perldelta.pod /usr/share/perl/5.8.0/pod/perlfaq5.pod /usr/share/perl/5.8.0/pod/perlpod.pod /usr/share/perl/5.8.0/pod/perlre.pod /usr/share/perl/5.8.0/pod/perlretut.pod

STRUKTURY WEWNETRZNE
Locale::Po4a::Pod, jako klasa dziedziczona z Pod::Parser, obsXuguje te same interfejsy i metody. Wszystkie szczegoXy moXna znaleXae w Pod::Parser; w skrocie: najpierw trzeba utworzyae parser, uXywajXc "Locale::Po4a::Pod->new()", a potem wywoXaae albo parse_from_filehandle() albo parse_from_file().

new() moXe pobraae opcje, w postaci par klucz/wartoXae, kontrolujXce zachowanie parsera. NastepujXce wspolne opcje sX rozpoznawane przez wszystkie dzieci Pod::Parser:

alt JeXli ustawione na true, wybiera alternatywny format wyjXcia, miedzy innymi uXywa innego stylu nagXowka i oznacza wpisy "=item" dwukropkiem na lewym marginesie. DomyXlnX wartoXciX jest false.

kod JeXli ustawione na true, czeXci nie-POD pliku wejXciowego bedX doXXczone do pliku wyjXciowego. UXyteczne podczas oglXdania dokumentu majXcego bloki POD z POD przeksztaXconym, a kodem pozostawionym bez zmian.

indent
    Liczba spacji wcinania zwykXego tekstu i domyXlne wcinanie blokow "=over". DomyXlnie 4.

loose
    JeXli ustawione na true, po nagXowku "=head1" jest dodawana pusta linia. JeXli ustawione na false (domyXlnie), to nie jest wypisywana pusta linia po "=head1", ale jest wciXX wypisywana po "=head2". Jest to wartoXae domyXlna, poniewaX jest to oczekiwane formatowanie stron podrecznika ekranowego. Podczas formatowania dowolnych dokumentow tekstowych, ustawienie tego na true moXe wygenerowaae przyjemniejsze wyjXcie.

quotes
    Ustawia znaki cudzysXowu uXywane do otaczania tekstow C<>. JeXeli wartoXciX jest pojedynczy znak, to jest on uXywany jako lewy i prawy cudzysXow; jeXli sX to dwa znaki, to pierwszy z nich jest lewym cudzysXowem, a drugi - prawym; jeXli sX cztery znaki, to pierwsze dwa sX lewym cudzysXowem, a kolejne dwa - prawym.

    MoXe to takXe przyjmowaae na specjalnX wartoXae "none", okreXlajXcX, Xe tekst C<> nie zostanie otoczony znakami cudzysXowu.

sentence
    JeXli jest ustawione na true, Locale::Po4a::Pod przyjmie, Xe kaXde zdanie kon~czy sie dwoma spacjami i postara sie to zachowaae. JeXli ustawione na false, wszystkie kolejne biaXe znaki w niedosXownych akapitach sX zamieniane na jednX spacje. DomyXlnX wartoXciX jest true.

width
    Numer kolumny, wedXug ktorej zawijaae tekst po jego prawej stronie. DomyXlnie jest to 76.

ZOBACZ TAKXE
Pod::Parser, po4a(7), Locale::Po4a::TransTractor(3pm), Locale::Po4a::Man(3pm),

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

TXUMACZENIE
 Robert Luberda <robert@debian.org>

PRAWA AUTORSKIE I LICENCJA
Copyright 2002 by SPI, inc.

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