Konverter online gratis ASCIIDOC ke TEXTILE

Apa itu format ASCIIDOC

AsciiDoc adalah format markup ringan yang disimpan sebagai teks biasa, biasanya dengan ekstensi .adoc atau .asciidoc. Format ini mendukung judul dokumen, bagian, admonition, tabel, referensi silang, atribut, daftar kode sumber, gambar, dan include.

File dibuat dan diproses oleh Asciidoctor, prosesor AsciiDoc lama, AsciidocFX, Antora, dan editor teks. Proyek dokumentasi, file README, manual, catatan rilis, dan file sumber situs statis umumnya menggunakannya. Sintaks AsciiDoc berbeda-beda di antara implementasi, dan ekstensi Asciidoctor dapat menambahkan fitur yang bukan bagian dari format dasar.

Apa itu format TEXTILE

Textile adalah bahasa markup teks biasa yang digunakan oleh beberapa wiki, sistem manajemen konten, alat penerbitan, dan aplikasi web lama. Sintaksnya menggunakan penanda singkat seperti h1. Heading untuk heading, *bold* untuk teks tebal, _italic_ untuk teks miring, dan "link text":https://example.com untuk tautan.

Textile tetap berguna ketika aplikasi tujuan memiliki parser Textile tetapi tidak mendukung AsciiDoc. Karena berupa teks biasa, file yang dikonversi dapat diedit dengan editor teks apa pun dan dikelola versinya tanpa format dokumen biner. Implementasi Textile berbeda-beda dalam dukungan terhadap tabel, atribut, catatan kaki, dan sintaks yang diperluas.

Cara sebenarnya mengonversi ASCIIDOC ke TEXTILE

Untuk konversi cepat tanpa menginstal software, gunakan converter di 101convert.com: unggah file .adoc atau .asciidoc, pilih TEXTILE sebagai format output, mulai konversi, lalu unduh file .textile yang dihasilkan.

Untuk konversi lokal yang dapat diulang, gunakan Asciidoctor untuk membuat DocBook XML dan Pandoc untuk membuat Textile. Pandoc tidak selalu dapat mengurai setiap dialek AsciiDoc secara langsung, sehingga rute dua tahap ini memberikan tanggung jawab kepada Asciidoctor untuk menafsirkan sintaks sumber.

1. Instal Asciidoctor dan Pandoc menggunakan metode package yang sesuai untuk sistem operasi Anda.
2. Buka terminal di direktori yang berisi file sumber.
3. Jalankan asciidoctor -b docbook5 -o intermediate.xml input.adoc. Ganti input.adoc dengan nama file sebenarnya. Gunakan input.asciidoc jika itu adalah ekstensi sumber.
4. Konversikan dokumen perantara dengan pandoc -f docbook -t textile intermediate.xml -o output.textile.
5. Buka output.textile di editor teks atau impor ke aplikasi Textile tujuan, lalu periksa hasil yang dirender.

Jika sumber menggunakan include lokal, jalankan Asciidoctor dari direktori proyek agar path relatif dapat di-resolve dengan benar. Misalnya, asciidoctor -b docbook5 -o intermediate.xml chapters/index.adoc mungkin memerlukan path include dan atribut proyek agar tersedia dari direktori kerja tersebut.

Batasan kualitas dan kompatibilitas

Langkah DocBook perantara dapat mengubah detail presentasi. Atribut AsciiDoc, blok kondisional, role kustom, ekstensi, gaya admonition, referensi silang yang tidak terselesaikan, dan macro khusus prosesor mungkin dihilangkan atau direpresentasikan secara berbeda dalam Textile.

Periksa tabel, daftar bertingkat, pemformatan inline, gambar, catatan kaki, anchor, blok kode sumber, dan tautan setelah konversi. Gambar biasanya direferensikan berdasarkan path, bukan disematkan, jadi salin file gambar dan pertahankan struktur direktori relatif. Renderer Textile mungkin tidak mendukung setiap fitur yang dihasilkan oleh Pandoc; konstruksi yang tidak didukung dapat muncul sebagai markup yang di-escape atau paragraf biasa.

Simpan file AsciiDoc asli sebagai sumber utama. Edit output Textile hanya jika sistem tujuan memerlukan penyesuaian satu kali, karena pengulangan konversi akan menimpa perubahan tersebut.