Konverter online gratis ASCIIDOC ke TYP

Typst memerlukan dokumen sumber dalam format markup .typ, sementara banyak proyek dokumentasi ditulis sebagai file .adoc atau .asciidoc. Mengonversi di antara keduanya memungkinkan Anda menggunakan kembali dokumentasi terstruktur dalam workflow publikasi Typst tanpa membuat ulang setiap heading, daftar, dan referensi secara manual.

Apa itu format ASCIIDOC

AsciiDoc adalah format markup plain-text untuk dokumentasi teknis, manual, file README, buku, dan halaman web. File biasanya menggunakan .adoc atau .asciidoc; Asciidoctor dan Asciidoctor.js membuat dan memprosesnya. Format ini mendukung heading, daftar, tabel, blok source-code, cross-reference, atribut, include, admonition, gambar, dan metadata dokumen.

Apa itu format TYP

Dalam kategori file Text, .typ menunjukkan markup sumber Typst. Typst adalah sistem typesetting yang compilernya mengubah file sumber menjadi PDF dan output hasil render lainnya. File TYP menggabungkan sintaks sumber yang mudah dibaca dengan instruksi layout untuk heading, figure, tabel, sitasi, pengaturan halaman, dan function yang dapat digunakan kembali. File ini berguna ketika workflow tujuan menggunakan compiler Typst, bukan renderer AsciiDoc atau toolchain LaTeX.

Cara sebenarnya mengonversi ASCIIDOC ke TYP

Rute otomatis yang paling andal adalah Asciidoctor ke DocBook XML, lalu Pandoc ke Typst. Instal Asciidoctor dan rilis Pandoc terbaru, lalu jalankan:

asciidoctor -b docbook5 -o document.xml document.adoc
pandoc -f docbook -t typst -o document.typ document.xml

Ganti document.adoc dengan nama file sumber. Perintah pertama memperluas struktur AsciiDoc menjadi DocBook; perintah kedua memetakan elemen DocBook ke markup Typst. Compile hasilnya dengan:

typst compile document.typ

Untuk file AsciiDoc yang bergantung pada atribut, tetapkan atribut tersebut selama konversi, misalnya:

asciidoctor -a revnumber=2.0 -a showtitle -b docbook5 -o document.xml document.adoc

Anda juga dapat menggunakan converter gratis di 101convert.com tanpa menginstal software: pilih format sumber ASCIIDOC, upload file, pilih TYP, lalu simpan hasil yang telah dikonversi.

Keterbatasan kualitas dan kompatibilitas

Ini adalah penerjemahan markup, bukan perubahan format pada tingkat byte. Heading dasar, paragraf, emphasis, daftar, tabel, blok kode, dan banyak link biasanya dapat ditransfer dengan baik, tetapi atribut AsciiDoc, konten kondisional, role kustom, macro, extension, include, dan blok diagram mungkin memerlukan penulisan ulang secara manual di Typst.

Resolve include dan buat asset eksternal sebelum konversi jika memungkinkan. Periksa path gambar, lebar tabel, sitasi, pengaturan halaman, dan cross-reference dalam file .typ yang dihasilkan. Pandoc mungkin mempertahankan konten sekaligus mengubah semantik layout, jadi compile file tersebut dengan Typst dan periksa PDF hasil render, bukan hanya mengandalkan source yang telah dikonversi.