Konverter online gratis AD ke DOCBOOK

Apa itu format AD

Dalam kategori Text files, AD umumnya mengidentifikasi file sumber AsciiDoc. File AsciiDoc berisi markup teks biasa untuk heading, daftar, tabel, tautan, gambar, admonition, source code, dan metadata dokumen; sintaks yang sama juga umum disimpan dengan ekstensi .adoc atau .asciidoc.

File dengan ekstensi .ad dibuat atau diedit menggunakan AsciiDoc processors, Asciidoctor, dan text editor biasa. Ekstensi tersebut saja tidak menjamin processor atau versi sintaks yang digunakan, jadi periksa baris pertama untuk atribut seperti :doctype:, :toc:, atau include directives sebelum melakukan konversi.

Apa itu format DOCBOOK

DocBook adalah vocabulary XML untuk dokumentasi teknis terstruktur. DocBook merepresentasikan elemen dokumen seperti chapter, section, paragraf, prosedur, tabel, citation, program listing, dan cross-reference secara independen dari layout halaman akhir.

DocBook sesuai digunakan ketika publishing pipeline memakai tool seperti xsltproc, Jing, Saxon, atau DocBook stylesheets untuk menghasilkan HTML, PDF, EPUB, atau manual pages. Struktur XML-nya juga memudahkan validation, indexing, dan transformasi format berikutnya dibandingkan menggunakan markup yang berorientasi pada presentasi.

Cara mengonversi AD ke DOCBOOK

Asciidoctor adalah desktop conversion tool yang paling langsung karena dapat membaca AsciiDoc dan menyertakan DocBook backend.

1. Instal Asciidoctor menggunakan package manager sistem operasi Anda atau Ruby gem, lalu verifikasi dengan asciidoctor --version.
2. Tempatkan source file dan image, included file, atau attribute file yang direferensikan di relative path yang diharapkan.
3. Jalankan asciidoctor -b docbook5 -o output.xml input.ad. Opsi -b docbook5 memilih DocBook 5 XML, sedangkan -o menetapkan nama output file.
4. Untuk workflow DocBook 4, gunakan asciidoctor -b docbook -o output.xml input.ad jika backend tersebut tersedia dalam versi yang diinstal.
5. Validasi hasilnya dengan DocBook schema atau validation command yang diwajibkan oleh publishing system Anda. Buka output.xml di XML-aware editor untuk memeriksa include yang belum terselesaikan, image path yang rusak, dan attribute yang tidak valid.

Untuk konversi grafis tanpa menginstal software, upload file AD ke 101convert.com, pilih DOCBOOK sebagai target format, lalu download XML yang dihasilkan. Cara ini sesuai untuk file satu kali ketika sumber menggunakan fitur AsciiDoc standar dan tidak bergantung pada local include file.

Pertimbangan kualitas dan kompatibilitas

Markup AsciiDoc tidak selalu dapat dipetakan dengan sempurna ke DocBook ketika sumber menggunakan custom extension, backend-specific attribute, passthrough block, macro, atau embedded script. Tinjau admonition, tabel, callout, footnote, cross-reference, dan source-code listing setelah konversi.

Relative image dan directive include:: memerlukan akses ke struktur direktori asli; converter yang hanya menerima file utama mungkin menghilangkan resource tersebut atau meninggalkan reference yang belum terselesaikan. Output DocBook adalah XML, bukan PDF atau halaman web yang sudah selesai, jadi terapkan DocBook stylesheet yang sesuai atau downstream publishing tool setelahnya.