Konverter online gratis ADOC ke PDF

Penerima, printer, sistem arsip, atau alur kerja dokumen mungkin memerlukan PDF dengan tata letak tetap, bukan source AsciiDoc yang dapat diedit. Merender source sebagai PDF mempertahankan penomoran halaman dan membuat dokumen dapat dilihat tanpa tool AsciiDoc.

Apa itu format ADOC

ADOC adalah ekstensi nama file umum untuk dokumen AsciiDoc; .asciidoc dan .asc juga digunakan. Format source teks biasa ini berisi markup untuk heading, daftar, tautan, tabel, atribut, referensi gambar, dan direktif include::.

Developer, penulis teknis, dan tim dokumentasi menggunakan file ADOC dengan tool seperti Asciidoctor, AsciidoctorJ, dan Antora. Editor teks menampilkan markup source seperti = Document title dan == Section, bukan dokumen dengan penomoran halaman yang dihasilkan melalui rendering.

Apa itu format PDF

PDF adalah format deskripsi halaman yang mempertahankan ukuran halaman, tipografi, spasi, gambar, dan penomoran halaman di berbagai sistem operasi dan printer. Format ini cocok untuk pencetakan, berbagi, salinan arsip, dan dokumen yang harus ditampilkan secara konsisten di berbagai perangkat.

PDF kurang praktis untuk diedit dibandingkan ADOC. Untuk dokumentasi yang dikontrol dengan version control, edit file ADOC dan buat ulang PDF, bukan memodifikasi PDF secara langsung.

Cara mengonversi file ADOC ke PDF

Menggunakan Asciidoctor PDF

Asciidoctor PDF adalah converter lokal yang paling langsung karena menginterpretasikan sintaks AsciiDoc dan membuat PDF tanpa file HTML perantara. Tool ini memerlukan Ruby.

1. Install Ruby jika belum tersedia di komputer.
2. Install Asciidoctor PDF dari terminal dengan gem install asciidoctor-pdf.
3. Buka terminal di direktori yang berisi file source, atau berikan path lengkapnya.
4. Jalankan asciidoctor-pdf document.adoc -o document.pdf.
5. Buka hasilnya dan periksa heading, tautan, gambar, tabel, blok kode, serta pemisah halaman.

Ganti nama file dengan nama source dan output yang sebenarnya. Tema PDF khusus dapat diberikan dengan atribut seperti -a pdf-theme=my-theme.yml, asalkan file tema dan font apa pun yang dirujuk tersedia.

Asciidoctor PDF juga dapat diintegrasikan ke dalam script dan build dokumentasi, yang lebih disarankan ketika PDF harus dibuat ulang secara konsisten dari source yang dikontrol dengan version control.

Menggunakan 101convert.com

Anda dapat mengonversi file secara gratis di 101convert.com tanpa menginstall software: upload file .adoc, pilih PDF sebagai format output, mulai konversi, lalu download hasilnya. Gunakan Asciidoctor PDF lokal untuk dokumen rahasia atau file yang bergantung pada gambar lokal, include, tema khusus, atau ekstensi.

Pertimbangan kualitas dan kompatibilitas

• Mengganti nama document.adoc menjadi document.pdf tidak mengonversi file; source AsciiDoc harus dirender.
• Path gambar relatif dan direktif include:: harus dapat di-resolve dengan benar. File yang hilang dapat membuat area gambar kosong atau konten include yang tidak ter-resolve.
• Asciidoctor PDF menggunakan tema dan aturan tata letaknya sendiri. CSS yang digunakan untuk output HTML AsciiDoc tidak menentukan tampilan PDF.
• Font harus di-install atau disediakan ke PDF build dan harus berisi karakter yang diperlukan. Jika tidak, glyph dapat diganti atau ditampilkan sebagai kotak karakter yang hilang.
• Diagram, chart, syntax highlighting, dan sample kode yang dibuat secara otomatis mungkin memerlukan ekstensi AsciiDoc tambahan, executable, atau langkah build sebelum pembuatan PDF.
• Tabel panjang dan blok kode dapat terputus secara kurang baik di batas halaman. Sesuaikan lebar, pengaturan tema, atau kontrol pemisah halaman, lalu periksa PDF yang dirender sebelum didistribusikan.
• Output PDF bergantung pada versi converter, tema, font, dan asset yang disertakan, sehingga environment yang berbeda dapat menghasilkan penomoran halaman yang sedikit berbeda.