Konverter online gratis ASCIIDOC ke ORG

Apa itu format ASCIIDOC

AsciiDoc adalah format markup teks biasa untuk dokumentasi teknis, manual, file README, buku, dan situs web. File biasanya menggunakan ekstensi .adoc atau .asciidoc dan dibuat menggunakan Asciidoctor, prosesor AsciiDoc asli, sistem dokumentasi seperti Antora, atau editor teks apa pun.

AsciiDoc mendukung heading hierarkis, atribut, referensi silang, tabel, admonition, listing source code, gambar, include, conditional, dan ekstensi blok. Sintaksnya lebih ekspresif daripada markup ringan dasar, tetapi beberapa fitur tersebut tidak memiliki padanan langsung di Org.

Apa itu format ORG

Org adalah format markup teks biasa yang terkait dengan Emacs Org mode. File Org menggunakan ekstensi .org dan menggabungkan heading terstruktur dengan status TODO, tag, properti, tabel, source block, tautan, sitasi, penjadwalan, dan data agenda.

Org berguna ketika dokumen hasil konversi akan diedit di Emacs, dikueri dengan agenda Org atau alat pencarian, diekspor ke HTML atau PDF, atau dikelola sebagai bagian dari proyek literate-programming. Sintaks heading-nya menggunakan tanda bintang, source block menggunakan #+BEGIN_SRC dan #+END_SRC, dan tautan menggunakan notasi tanda kurung siku bergaya Org.

Cara mengonversi ASCIIDOC ke ORG

Alur kerja desktop yang paling andal adalah Asciidoctor yang diikuti oleh Pandoc. Asciidoctor menyelesaikan sintaks dan include AsciiDoc, sedangkan Pandoc mengonversi struktur DocBook yang dihasilkan ke Org.

1. Instal Asciidoctor dan Pandoc menggunakan package yang sesuai untuk sistem operasi Anda.
2. Dari direktori yang berisi file sumber, buat DocBook dan pipe hasilnya ke Pandoc:

asciidoctor -b docbook5 -o - input.adoc | pandoc -f docbook -t org -o output.org

Perintah tersebut membaca input.adoc, menulis output DocBook dari Asciidoctor ke standard output, dan menyimpan hasil Org sebagai output.org. Ganti nama file sesuai kebutuhan; gunakan direktori kerja yang sama ketika dokumen berisi path gambar atau include relatif.

Untuk alur kerja multi-tahap, simpan file perantara agar Anda dapat memeriksanya:

asciidoctor -b docbook5 -o intermediate.xml input.adoc
pandoc -f docbook -t org intermediate.xml -o output.org

Buka output.org di Emacs dan periksa level heading, tautan, nama source language, tabel, path gambar, serta metadata Org apa pun yang perlu ditambahkan secara manual. Untuk konversi tanpa instalasi, gunakan konverter gratis di 101convert.com dan unduh file .org yang dihasilkan.

Keterbatasan kualitas dan kompatibilitas

Konten struktural biasanya dikonversi dengan baik, tetapi atribut AsciiDoc, bagian conditional, custom role, blok passthrough, ekstensi diagram, dan macro khusus prosesor mungkin dihilangkan atau dikurangi menjadi teks biasa. Asciidoctor memperluas include standar selama perintah pertama, tetapi file yang disertakan harus tersedia dan direferensikan menggunakan path relatif yang dapat digunakan.

Admonition dan blok bergaya AsciiDoc mungkin tidak dapat dipetakan ke konstruksi Org native; tinjau kembali setelah konversi. Tabel mungkin memerlukan penyelarasan atau penulisan ulang secara manual, dan referensi gambar tetap bergantung pada file aset asli. DocBook adalah representasi perantara, sehingga gaya AsciiDoc dan perilaku khusus backend tidak dipertahankan secara persis.

Jika sumber menggunakan ekstensi Asciidoctor khusus, konversikan sampel yang representatif terlebih dahulu dan bandingkan file Org yang dihasilkan dengan file asli sebelum memproses kumpulan dokumen yang lebih besar.