Konverter online gratis ASCIIDOC ke PDF

Apa itu format ASCIIDOC

AsciiDoc adalah format markup teks biasa untuk dokumen terstruktur seperti manual software, file README, buku, artikel, dan spesifikasi teknis. Penulis membuat source file yang mudah dibaca dengan headings, lists, delimited code blocks, tables, attributes, cross-references, dan extensions opsional; ekstensi filename yang umum adalah .adoc dan .asciidoc.

File AsciiDoc biasanya dibuat dalam text editor, integrated development environment, documentation repository, dan sistem yang menggunakan Asciidoctor atau original AsciiDoc processor. Source tetap dapat diedit dan kompatibel dengan version control, tetapi tampilan akhirnya bergantung pada converter, theme, fonts, image assets, dan document attributes.

Apa itu format PDF

PDF menyimpan halaman beserta layout, fonts, graphics, dan dimensi yang dapat dicetak, dengan tetap mempertahankannya di berbagai operating system. PDF cocok untuk documentation formal, email attachments, printing, records, dan review karena penerima umumnya tidak memerlukan source editor atau AsciiDoc toolchain.

PDF kurang praktis dibandingkan AsciiDoc untuk editing dan automatic version comparison. Ukurannya juga dapat lebih besar daripada source file, terutama jika menyematkan fonts atau high-resolution images.

Cara mengonversi ASCIIDOC ke PDF

Metode command-line yang paling langsung adalah Asciidoctor PDF, PDF converter untuk Ruby-based Asciidoctor toolchain.

1. Install Ruby jika belum tersedia.
2. Install converter dengan gem install asciidoctor-pdf --pre. Opsi --pre mungkin diperlukan untuk current prerelease package; hilangkan opsi tersebut saat menginstal latest stable release.
3. Buka terminal di directory yang berisi source file, lalu jalankan asciidoctor-pdf manual.adoc -o manual.pdf.
4. Buka manual.pdf di PDF viewer dan periksa page breaks, tables, code blocks, links, dan images.

Untuk source file yang mereferensikan images atau menyertakan file AsciiDoc lainnya, jalankan command dari document’s project directory dan pertahankan relative folder structure-nya. Gunakan -a toc=left atau -a toc=macro untuk menambahkan table of contents, dan -a pdf-theme=custom-theme.yml untuk menerapkan custom PDF theme. Title, author, dan revision dapat ditetapkan di document header dengan attributes seperti = Installation manual, Author Name <author@example.com>, dan :revnumber: 1.2.

Anda juga dapat mengonversi file secara gratis di website 101convert.com tanpa menginstal software. Upload file AsciiDoc, pilih PDF sebagai output format, mulai conversion, lalu download document yang dihasilkan.

Pertimbangan kualitas dan kompatibilitas

Syntax AsciiDoc diproses oleh converter, bukan disalin langsung ke PDF, sehingga unsupported extensions, custom macros, include paths, dan conditional content dapat mengubah hasilnya. Asciidoctor PDF menggunakan current working directory dan document attributes untuk me-resolve includes dan assets; missing paths menghasilkan output yang tidak lengkap atau warnings.

Untuk pagination yang dapat diprediksi, embed atau konfigurasikan fonts secara eksplisit, tetapkan page size dan margins dalam PDF theme, dan gunakan image dimensions yang ditujukan untuk printing. Periksa diagrams, SVG files, external links, footnotes, table overflow, serta karakter right-to-left atau non-Latin setelah conversion. Source file dapat berhasil dikonversi tetapi tetap menghasilkan tables yang terpotong atau glyphs yang hilang jika selected font tidak memiliki karakter yang diperlukan.