Konverter online gratis ASCIIDOC ke HTML

File AsciiDoc perlu dikonversi ketika dokumentasi harus dibuka di browser web, dipublikasikan di situs web, atau diberikan ke sistem yang menerima HTML, bukan source markup. HTML mempertahankan heading, list, link, tabel, blok kode, dan struktur lainnya dalam format yang dapat langsung dilihat.

Apa itu format ASCIIDOC

AsciiDoc adalah format markup teks biasa untuk dokumen terstruktur seperti dokumentasi software, manual, file README, artikel, dan spesifikasi teknis. Penulis menandai struktur dengan sintaks yang mudah dibaca untuk heading, list, link, admonition, tabel, source code, gambar, dan referensi silang.

Ekstensi nama file yang umum adalah .adoc, .asciidoc, dan terkadang .asc. File dibuat atau diedit menggunakan text editor biasa dan tool dokumentasi termasuk Asciidoctor, Asciidoctor.js, dan Antora. File AsciiDoc adalah source markup, sehingga browser akan menampilkan karakter pemformatannya, bukan merender struktur dokumen yang dimaksud.

Apa itu format HTML

HTML adalah format markup yang diinterpretasikan oleh browser web dan digunakan oleh situs web, portal dokumentasi, sistem manajemen konten, serta workflow terkait email. Konversi HTML mengubah struktur AsciiDoc menjadi elemen seperti <h1>, <p>, <ul>, <table>, dan <pre>.

HTML cocok ketika penerima memerlukan tampilan melalui browser, dokumentasi yang dapat dicari, konten yang dapat disalin, atau file yang dapat disematkan ke halaman web. Hasilnya dapat mencakup styling CSS, referensi gambar, aset syntax highlighting, dan link ke halaman lain yang dihasilkan.

Cara mengonversi ASCIIDOC ke HTML

Menggunakan Asciidoctor

1. Install Ruby dan processor Asciidoctor, lalu jalankan gem install asciidoctor.
2. Buka terminal di direktori yang berisi source file.
3. Konversikan dengan asciidoctor input.adoc -o output.html. Ganti nama file dengan nama source dan tujuan yang sebenarnya.
4. Buka output.html di browser dan periksa heading, link, tabel, blok kode, serta gambar.

Untuk menghasilkan HTML tertanam yang sesuai untuk disisipkan ke halaman lain, gunakan asciidoctor -e input.adoc -o fragment.html. Untuk menerapkan stylesheet, berikan lokasinya dengan atribut Asciidoctor seperti asciidoctor -a stylesheet=site.css input.adoc -o output.html.

Menggunakan konverter online

Anda dapat mengonversi file secara gratis di situs web 101convert.com tanpa menginstall software. Upload file AsciiDoc, pilih HTML sebagai format output jika diperlukan, mulai konversi, lalu download file yang dihasilkan. Periksa gambar yang ditautkan dan file yang disertakan setelah download karena konversi berbasis browser mungkin tidak dapat mengakses path lokal yang dirujuk oleh source.

Pertimbangan kualitas dan kompatibilitas

Dokumen AsciiDoc dapat merujuk ke gambar, menyertakan source file lain, memuat atribut, dan menggunakan ekstensi khusus. Konversi Asciidoctor lokal biasanya lebih disarankan ketika dependensi tersebut penting karena konverter dapat dijalankan dari direktori project yang benar dan menggunakan atribut yang dimaksud.

Simpan gambar dan file CSS yang dirujuk di lokasi relatif yang diharapkan, atau perbarui path yang dihasilkan sebelum dipublikasikan. File HTML dapat berisi link ke aset terpisah, bukan menyematkannya, sehingga memindahkan file HTML saja dapat menyebabkan gambar tidak ditemukan atau output tanpa styling.

Macro khusus, ekstensi yang tidak didukung, include yang hilang, dan atribut dokumen yang salah dapat menghasilkan output yang tidak lengkap. Uji HTML yang dihasilkan di browser target atau sistem publikasi, terutama ketika source menggunakan syntax highlighting, link antardokumen, atau karakter non-ASCII.