Online konvertor POD do PDF zdarma

Čtečka, archivní systém nebo workflow dokumentů může přijímat PDF, ale ne zdrojový formát POD jazyka Perl. Převod POD do PDF vytvoří soubor s pevným rozvržením, který lze tisknout, sdílet, archivovat nebo zobrazit bez nástrojů pro dokumentaci Perlu.

Co je formát POD

POD znamená Plain Old Documentation, odlehčený značkovací jazyk Perlu pro dokumentaci programů a modulů. Objevuje se v samostatných souborech .pod a v sekcích dokumentace vložených do modulů .pm a skriptů .pl.

Direktivy jako =head1, =head2, =over, =item a =cut definují nadpisy, seznamy a hranici mezi dokumentací a kódem Perlu. Distribuce Perlu, balíčky CPAN, zdrojové repozitáře, manuály Perlu a dokumentační workflow Unixu běžně používají POD. POD popisuje strukturu dokumentu, nikoli přesné stránky, takže jeho vzhled závisí na rendereru.

Co je formát PDF

PDF je formát orientovaný na stránky, který ukládá rozměry stránek, umístění textu, fonty, obrázky, odkazy a vektorovou grafiku. Obvykle zachovává stránkování a rozvržení napříč operačními systémy a prohlížeči PDF, takže je vhodný pro tisk, sdílení, archivaci a systémy pro správu dokumentů.

PDF je distribuční formát, nikoli ideální upravitelný zdroj. Ponechte si původní soubor .pod, .pm nebo .pl pro budoucí změny.

Jak převést POD do PDF

Použití 101convert.com

1. Otevřete převodník POD do PDF na webu 101convert.com.
2. Nahrajte zdrojový soubor .pod nebo vyberte podporovaný zdrojový soubor Perlu obsahující dokumentaci POD.
3. Jako výstupní formát zvolte PDF a spusťte převod.
4. Stáhněte vygenerované PDF a zkontrolujte jeho nadpisy, seznamy, bloky kódu, odkazy, znaky a zalomení stránek.

Tato možnost nevyžaduje instalaci Perlu ani LaTeXu a je na webu 101convert.com dostupná zdarma. Nenahrávejte důvěrný zdrojový kód ani soukromou dokumentaci, pokud vám nevyhovují podmínky služby týkající se zpracování a uchovávání dat.

Místní převod pomocí HTML

pod2html je součástí mnoha instalací Perlu. V systému Windows poskytuje Strawberry Perl Perl a běžně používané nástroje POD.

1. Otevřete terminál v adresáři obsahujícím zdrojový soubor.
2. Vygenerujte HTML ze samostatného souboru POD:

pod2html --outfile=manual.html manual.pod

Stejný příkaz může zpracovat modul nebo skript obsahující POD:

pod2html --outfile=manual.html Module.pm

Vykreslí se pouze sekce POD; kód Perlu mimo tyto sekce se nespouští ani neformátuje jako dokumentace.

3. Otevřete manual.html v prohlížeči Chrome, Chromium, Microsoft Edge nebo Firefox.
4. Vyberte Print → Save as PDF, zvolte velikost papíru a okraje a uložte výsledek jako manual.pdf.
5. Před distribucí souboru zkontrolujte záhlaví, zápatí, měřítko, grafiku na pozadí, odkazy, odsazení kódu a zalomení stránek.

Pro opakovatelný výstup založený na prohlížeči může Chromium vytisknout HTML bez otevření dialogu:

chromium --headless --disable-gpu --print-to-pdf=manual.pdf file:///absolute/path/manual.html

Nahraďte chromium názvem nainstalovaného spustitelného souboru. Použijte absolutní adresu URL file://; relativní cesty mohou v režimu headless selhat.

Místní převod pomocí LaTeXu

pod2latex vytvoří dokument LaTeXu, který může distribuce LaTeXu, například TeX Live nebo MiKTeX, zkompilovat do PDF. Tento nástroj může být nutné nainstalovat odděleně od Perlu.

1. Vygenerujte LaTeX ze zdroje POD:

pod2latex -out manual.tex manual.pod

2. Zkompilujte vygenerovaný soubor:

pdflatex manual.tex

Pokud dokument obsahuje obsah nebo křížové odkazy, spusťte pdflatex znovu. Tato metoda může ve srovnání s tiskem z prohlížeče poskytovat konzistentnější typografii a stránkování dlouhých dokumentů, ale její výstup závisí na nainstalovaných balíčcích a fontech LaTeXu.

Řízení rozvržení a kódování

Pro výstup HTML přidejte stylesheet:

pod2html --css=manual.css --title="Manual" --outfile=manual.html manual.pod

Print CSS může nastavit okraje stránky a zabránit rozdělení bloků kódu:

@page { margin: 20mm; } pre { break-inside: avoid; }

Nastavení tisku prohlížeče stále řídí velikost papíru, měřítko, záhlaví, zápatí a vykreslování pozadí. Při otevírání HTML mějte k dispozici místní stylesheety a odkazované obrázky.

Pokud jsou přítomny ne-ASCII znaky, deklarujte kódování zdroje:

=encoding utf8

Umístěte deklaraci do blízkosti začátku dokumentu POD. Zvolený prohlížeč nebo engine LaTeXu musí také používat font obsahující požadované znaky.

Omezení kvality a kompatibility

Různé renderery POD mohou nadpisy, seznamy, doslovný kód, odkazy a tabulky umisťovat odlišně. pod2html a pod2latex nemusí přesně reprodukovat výstup terminálu, styl Unixových manuálových stránek, chování vlastního formátovače, nezpracovaný HTML, direktivy specifické pro formátovač ani nestandardní rozšíření POD.

Zkontrolujte vnořené seznamy, odsazený kód, escapované znaky, symboly Unicode, hypertextové odkazy, obrázky, tabulky a zalomení stránek. Odkazy na místní soubory, nainstalované moduly nebo vygenerované manuálové stránky mohou být po převodu nepoužitelné. Velmi dlouhé bloky kódu se mohou stále rozdělit mezi stránky, i když je zadáno break-inside: avoid. Chybějící znaky se obvykle zobrazí jako prázdné čtverečky a vyžadují font s podporou Unicode. Zdroj POD ponechte jako hlavní upravitelný dokument.