Konverter online gratis ASCIIDOC ke EPUB

Pembaca e-book dan sistem penerbitan umumnya memerlukan EPUB, bukan file sumber AsciiDoc. Mengonversi sumber akan mempertahankan judul, paragraf, daftar, tautan, gambar, dan konten terstruktur lainnya dalam format reflowable yang dapat dibuka oleh pembaca di ponsel, tablet, dan perangkat e-book khusus.

Apa itu format ASCIIDOC

AsciiDoc adalah format markup teks biasa untuk dokumen terstruktur seperti buku, manual, dokumentasi software, artikel, dan file README. Penulis membuat judul, daftar, tabel, tautan, blok kode, atribut, referensi silang, dan admonition menggunakan sintaks teks yang mudah dibaca, bukan dengan mengedit dokumen biner.

Ekstensi sumber yang umum meliputi .adoc, .asciidoc, dan .asc. Asciidoctor dan Asciidoc menggunakan file-file ini untuk menghasilkan dokumen HTML, PDF, man page, dan EPUB. Developer biasanya menjumpainya di repositori dokumentasi, proyek static-site, proyek berbasis Git, dan sistem build dokumentasi.

Apa itu format EPUB

EPUB adalah paket e-book berbasis ZIP yang berisi konten XHTML, stylesheet CSS, metadata, file navigasi, serta gambar, font, dan resource lainnya secara opsional. EPUB 3 mendukung HTML semantik, layout responsif, navigasi, audio atau video, serta penulisan dari kanan ke kiri atau vertikal jika reading system mendukung fitur-fitur tersebut.

Berbeda dengan PDF dengan halaman tetap, konten EPUB dapat menyesuaikan diri dengan ukuran layar, pengaturan font, dan orientasi perangkat pembaca. Format ini cocok untuk mendistribusikan dokumentasi atau buku panjang melalui pembaca e-book dan perpustakaan, serta untuk memeriksa hasilnya menggunakan aplikasi yang kompatibel dengan EPUB.

Cara mengonversi ASCIIDOC ke EPUB

Gunakan Asciidoctor EPUB3

Asciidoctor EPUB3 adalah pilihan paling langsung karena memahami konstruksi khusus AsciiDoc, bukan memperlakukan sumber sebagai markup generik. Instal Ruby terlebih dahulu jika belum tersedia, lalu instal converter:

gem install asciidoctor-epub3

Dari direktori yang berisi file sumber, jalankan:

asciidoctor-epub3 book.adoc -o book.epub

Ganti book.adoc dengan nama file yang sebenarnya. Converter membaca header dokumen, file yang disertakan, gambar yang direferensikan, atribut, dan elemen struktural, lalu menulis book.epub.

Untuk proyek multi-file, simpan sumber yang disertakan dan direktori gambar di lokasi relatif yang diharapkan. Contoh perintah dengan direktori kerja khusus:

asciidoctor-epub3 -D output book.adoc

Tetapkan metadata dokumen di header AsciiDoc sebelum konversi, misalnya:

= Book title
Author Name <author@example.com>
:revnumber: 1.0
:description: A short description
:doctype: book
:toc:
:sectnums:

Gunakan atribut gambar seperti :imagesdir: images jika path gambar relatif terhadap direktori umum. Pastikan setiap gambar yang direferensikan tersedia dan menggunakan format yang didukung oleh reading system target, biasanya JPEG, PNG, atau SVG.

Konversi tanpa menginstal software

Anda dapat mengonversi file secara gratis di situs web 101convert.com jika menginstal Ruby atau Asciidoctor tidak praktis. Upload file AsciiDoc, pilih EPUB sebagai format output, mulai konversi, lalu download e-book yang dihasilkan.

Gunakan Pandoc sebagai alternatif

Pandoc dapat mengonversi beberapa dokumen AsciiDoc secara langsung:

pandoc book.adoc -o book.epub

Gunakan Pandoc untuk dokumen yang relatif sederhana atau jika software tersebut sudah menjadi bagian dari workflow penerbitan. Asciidoctor EPUB3 umumnya mempertahankan atribut khusus AsciiDoc, admonition, include, dan referensi silang dengan lebih andal.

Kualitas, kompatibilitas, dan keterbatasan

EPUB bersifat reflowable, sehingga pemisah baris tetap, posisi halaman yang presisi, dan instruksi layout bergaya PDF tidak dapat dipertahankan secara konsisten. Nomor halaman, widow, orphan, dan pembungkusan baris bervariasi tergantung pada reading system dan pengaturan font pengguna.

Ekstensi AsciiDoc yang kompleks, converter khusus, diagram tersemat, macro yang tidak didukung, dan pemformatan khusus PDF mungkin memerlukan penyesuaian manual. Hasilkan file diagram sebelum konversi dan gunakan path relatif untuk semua resource lokal.

Buka hasilnya di setidaknya satu pembaca EPUB dan periksa daftar isi, hierarki judul, tautan, blok kode, tabel, gambar, dan karakter khusus. Untuk validasi tingkat paket, jalankan EPUBCheck:

epubcheck book.epub

Perbaiki resource yang hilang, XHTML tidak valid, kesalahan metadata, dan peringatan navigasi sebelum mendistribusikan file.