Konverter online gratis ASCIIDOC ke ODT

File ASCIIDOC praktis untuk dokumentasi yang dikelola dengan source control, tetapi banyak aplikasi office memerlukan format OpenDocument Text untuk pengeditan atau distribusi. Mengonversinya ke ODT akan mempertahankan dokumen sebagai file pengolah kata yang dapat diedit dan dibuka oleh LibreOffice serta program lain yang kompatibel dengan OpenDocument.

Apa itu format ASCIIDOC

AsciiDoc adalah format markup ringan untuk menulis dokumen terstruktur dalam teks biasa. Penulis menggunakan markup seperti judul, daftar, tautan, tabel, admonition, blok source code, dan atribut, alih-alih menyimpan pemformatan secara langsung dalam file pengolah kata.

File biasanya menggunakan ekstensi .adoc atau .asciidoc. Asciidoctor dan Asciidoc membuat serta memproses file ini, dan file tersebut sering digunakan dalam dokumentasi software, file README, manual teknis, serta repositori dokumentasi yang dikelola dengan Git.

Apa itu format ODT

ODT adalah format OpenDocument Text, yaitu format dokumen berbasis ZIP yang ditetapkan oleh standar OpenDocument. Format ini menyimpan teks yang dapat diedit, style paragraf dan karakter, tabel, gambar, metadata, serta informasi tata letak halaman.

LibreOffice Writer dapat membuka dan mengedit file ODT secara langsung; Apache OpenOffice dan aplikasi lain yang kompatibel dengan OpenDocument juga dapat membacanya. ODT berguna ketika penerima memerlukan dokumen berpaginasi dengan pemformatan yang dapat diedit, bukan source markup.

Cara sebenarnya mengonversi ASCIIDOC ke ODT

Workflow desktop yang paling andal menggunakan Asciidoctor untuk menghasilkan DocBook XML, kemudian Pandoc untuk membuat file ODT.

1. Instal Asciidoctor dan Pandoc. Dengan Ruby yang sudah terinstal, Asciidoctor dapat diinstal menggunakan gem install asciidoctor; instal Pandoc dari paket desktop resminya untuk sistem operasi Anda.
2. Buka terminal di direktori yang berisi file sumber.
3. Konversi source AsciiDoc ke DocBook 5 XML:
   asciidoctor -b docbook5 -o intermediate.xml input.adoc
4. Konversi file XML perantara ke ODT:
   pandoc -f docbook -t odt intermediate.xml -o output.odt
5. Buka output.odt di LibreOffice Writer dan periksa judul, tabel, gambar, pemisah halaman, catatan kaki, serta blok kode.

Untuk file AsciiDoc yang berisi gambar atau file yang disertakan, jalankan perintah dari direktori sumber agar path relatif dapat ditentukan dengan benar. Jika source menggunakan atribut, teruskan atribut tersebut ke Asciidoctor dengan opsi seperti -a toc= atau definisikan atribut tersebut di header dokumen.

Jika Anda tidak ingin menginstal software, Anda dapat mengonversi file secara gratis di 101convert.com menggunakan konverternya untuk ASCIIDOC ke ODT.

Keterbatasan kualitas dan kompatibilitas

Konversi melewati dua model format, sehingga fitur khusus AsciiDoc mungkin tidak dipetakan secara persis ke ODT. Judul, paragraf, penekanan, daftar, tautan, tabel, gambar, dan blok kode dasar umumnya dapat ditransfer, sedangkan role yang kompleks, tema Asciidoctor khusus, ekstensi, konten kondisional, makro, dan styling admonition tingkat lanjut mungkin memerlukan penyesuaian manual.

Source AsciiDoc menjelaskan struktur; ODT juga memerlukan style halaman, font, margin, header, footer, dan pagination. Pandoc menerapkan default dokumennya sendiri, jadi periksa hasilnya di LibreOffice dan ubah style alih-alih mengandalkan tampilan AsciiDoc asli. Sematkan atau instal font yang diperlukan sebelum ekspor final jika pagination yang konsisten penting.

Simpan XML perantara hingga validasi selesai. XML tersebut membantu mengidentifikasi apakah masalah berasal dari tahap parsing Asciidoctor atau ODT writer milik Pandoc.