Konverter online gratis POD ke PDF

Reader, sistem arsip, atau alur kerja dokumen mungkin menerima PDF tetapi tidak menerima format source POD milik Perl. Mengonversi POD ke PDF menghasilkan file dengan tata letak tetap yang dapat dicetak, dibagikan, diarsipkan, atau dilihat tanpa Perl documentation tools.

Apa itu format POD

POD berarti Plain Old Documentation, yaitu lightweight markup language milik Perl untuk mendokumentasikan program dan module. POD terdapat dalam file .pod mandiri serta bagian dokumentasi yang disematkan dalam module .pm dan script .pl.

Directive seperti =head1, =head2, =over, =item, dan =cut menentukan heading, list, serta batas antara dokumentasi dan kode Perl. Distribusi Perl, package CPAN, source repository, manual Perl, dan workflow dokumentasi Unix umumnya menggunakan POD. POD menjelaskan struktur dokumen, bukan halaman yang tepat, sehingga tampilannya bergantung pada renderer.

Apa itu format PDF

PDF adalah format berorientasi halaman yang menyimpan dimensi halaman, penempatan teks, font, image, link, dan vector graphic. PDF biasanya mempertahankan pagination dan layout di berbagai operating system serta PDF viewer, sehingga sesuai untuk pencetakan, berbagi, pengarsipan, dan document-management system.

PDF adalah format distribusi, bukan source yang ideal untuk diedit. Simpan file asli .pod, .pm, atau .pl untuk perubahan di masa mendatang.

Cara mengonversi POD ke PDF

Gunakan 101convert.com

1. Buka POD-to-PDF converter di 101convert.com.
2. Upload file source .pod, atau pilih file source Perl yang didukung dan berisi dokumentasi POD.
3. Pilih PDF sebagai format output dan mulai konversi.
4. Download PDF yang dihasilkan, lalu periksa heading, list, code block, link, karakter, dan page break.

Opsi ini tidak memerlukan instalasi Perl atau LaTeX dan tersedia gratis di 101convert.com. Jangan upload source code rahasia atau dokumentasi pribadi kecuali ketentuan penanganan dan penyimpanan layanan tersebut dapat diterima.

Konversi secara lokal dengan HTML

pod2html disertakan dalam banyak instalasi Perl. Di Windows, Strawberry Perl menyediakan Perl dan utilitas POD yang umum digunakan.

1. Buka terminal di direktori yang berisi source.
2. Hasilkan HTML dari file POD mandiri:

pod2html --outfile=manual.html manual.pod

Command yang sama dapat memproses module atau script yang berisi POD:

pod2html --outfile=manual.html Module.pm

Hanya bagian POD yang dirender; kode Perl di luar bagian tersebut tidak dieksekusi atau diformat sebagai dokumentasi.

3. Buka manual.html di Chrome, Chromium, Microsoft Edge, atau Firefox.
4. Pilih Print → Save as PDF, pilih ukuran kertas dan margin, lalu simpan hasilnya sebagai manual.pdf.
5. Periksa header, footer, scaling, background graphic, link, indentasi kode, dan page break sebelum mendistribusikan file.

Untuk output berbasis browser yang dapat diulang, Chromium dapat mencetak HTML tanpa membuka dialog:

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

Ganti chromium dengan nama executable yang terinstal. Gunakan URL absolut file://; relative path dapat gagal dalam headless mode.

Konversi secara lokal dengan LaTeX

pod2latex membuat dokumen LaTeX yang dapat dikompilasi oleh distribusi LaTeX seperti TeX Live atau MiKTeX menjadi PDF. Utilitas ini mungkin perlu diinstal secara terpisah dari Perl.

1. Hasilkan LaTeX dari source POD:

pod2latex -out manual.tex manual.pod

2. Kompilasi file yang dihasilkan:

pdflatex manual.tex

Jalankan pdflatex lagi jika dokumen berisi daftar isi atau cross-reference. Metode ini dapat memberikan tipografi dan pagination dokumen panjang yang lebih konsisten daripada pencetakan melalui browser, tetapi output-nya bergantung pada package dan font LaTeX yang terinstal.

Kontrol layout dan encoding

Untuk output HTML, tambahkan stylesheet:

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

Print CSS dapat mengatur margin halaman dan mencegah code block terpisah:

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

Pengaturan print browser tetap mengontrol ukuran kertas, scaling, header, footer, dan rendering background. Pastikan stylesheet lokal dan image yang dirujuk tetap tersedia saat membuka HTML.

Nyatakan source encoding jika terdapat karakter non-ASCII:

=encoding utf8

Tempatkan deklarasi tersebut di dekat awal dokumen POD. Browser atau LaTeX engine yang dipilih juga harus menggunakan font yang berisi glyph yang diperlukan.

Batasan kualitas dan kompatibilitas

Renderer POD yang berbeda dapat menempatkan heading, list, kode verbatim, link, dan table secara berbeda. pod2html dan pod2latex mungkin tidak mereproduksi output terminal, styling Unix man-page, perilaku custom formatter, raw HTML, directive khusus formatter, atau ekstensi POD nonstandar secara persis.

Periksa nested list, kode berindentasi, karakter yang di-escape, simbol Unicode, hyperlink, image, table, dan page break. Link ke file lokal, module yang terinstal, atau manual page yang dihasilkan mungkin tidak dapat digunakan setelah konversi. Code block yang sangat panjang tetap dapat terpisah di antara halaman meskipun break-inside: avoid ditentukan. Glyph yang hilang biasanya muncul sebagai kotak kosong dan memerlukan font yang mendukung Unicode. Pertahankan source POD sebagai dokumen editable utama.