Konverter online gratis DOCX ke ADOC

Dokumen Word dikonversi ke AsciiDoc ketika dokumentasi harus disimpan di Git, ditinjau sebagai teks, atau dirender oleh sistem penerbitan AsciiDoc. Source .adoc yang dihasilkan lebih mudah dibandingkan, digabungkan, dan digunakan kembali dalam build HTML atau PDF daripada file Word.

Format DOCX

.docx adalah format default Microsoft Word dan bagian dari Office Open XML. File DOCX adalah paket ZIP yang berisi XML dan file terkait untuk teks, gaya, tabel, gambar, komentar, revisi, header, footer, dan properti dokumen.

Microsoft Word adalah editor utamanya; LibreOffice Writer, Google Docs, Apple Pages, dan banyak sistem manajemen dokumen juga dapat membuka atau mengekspor DOCX. Format ini mempertahankan tata letak dan pemformatan dokumen perkantoran dengan baik, tetapi strukturnya yang dikemas kurang cocok untuk peninjauan kontrol versi baris demi baris.

Format ADOC

.adoc umumnya mengidentifikasi file source AsciiDoc. AsciiDoc adalah teks biasa UTF-8 dengan markup untuk judul bagian, daftar, tabel, tautan, blok kode, admonition, atribut, dan referensi gambar. Ekstensi AsciiDoc umum lainnya adalah .asciidoc dan .ad.

Prosesor seperti Asciidoctor dapat merender AsciiDoc sebagai HTML, PDF, DocBook, EPUB, atau output situs dokumentasi. Gambar biasanya berupa file terpisah yang dirujuk oleh source, sehingga teks tetap mudah dibaca dan aset gambar mudah dikelola di Git.

Pastikan format yang diperlukan sebelum melakukan konversi. Beberapa produk menggunakan .adoc untuk file proprietary yang tidak terkait; konversi ini menghasilkan teks AsciiDoc, bukan format-format tersebut.

Konversi file

Untuk melakukan konversi tanpa menginstal software, unggah file DOCX ke converter di 101convert.com, pilih ADOC sebagai format output, mulai konversi, lalu unduh file .adoc yang dihasilkan. Buka file tersebut di text editor dan periksa judul, tabel, tautan, serta referensi gambar sebelum menggunakannya dalam workflow penerbitan.

Untuk konversi lokal yang dapat diulang, Pandoc membaca DOCX dan menulis AsciiDoc. Setelah menginstal Pandoc, jalankan command ini dari folder yang berisi dokumen:

pandoc input.docx --from=docx --to=asciidoc --extract-media=media --wrap=none --output=output.adoc

--extract-media=media menulis gambar tersemat ke direktori media dan membuat referensi gambar dalam output. Simpan direktori tersebut bersama file ADOC saat memindahkan atau menerbitkan dokumen. --wrap=none mencegah pemenggalan baris arbitrer, yang dapat menghasilkan diff source control yang lebih rapi.

Render hasilnya dengan Asciidoctor untuk memeriksa markup yang dihasilkan:

asciidoctor output.adoc

Ini membuat output.html, yang dapat dibuka di browser untuk ditinjau.

Batasan konversi

Konversi bergantung pada semantik dokumen, bukan tampilan visualnya. Terapkan gaya Heading bawaan Word sebelum konversi; teks yang dibuat besar atau tebal tanpa gaya heading mungkin tetap menjadi paragraf biasa.

Paragraf biasa, gaya heading, daftar, penekanan dasar, tautan, dan tabel sederhana biasanya dapat ditransfer dengan baik. Tabel gabungan atau bertingkat, lebar kolom tetap, arsiran sel, kotak teks, objek mengambang, SmartArt, persamaan, tata letak halaman yang kompleks, dan gambar yang diposisikan tidak memiliki padanan langsung dalam AsciiDoc dan memerlukan penulisan ulang manual atau penggantian dengan gambar dan markup standar.

Selesaikan perubahan terlacak sebelum konversi dan simpan komentar yang diperlukan secara terpisah. Header, footer, field nomor halaman, macro, proteksi dokumen, dan kontrol tata letak khusus Word bukanlah konten AsciiDoc yang andal; pindahkan informasi penting ke bagian dokumen biasa.

Hyperlink eksternal biasanya dikonversi dengan benar, tetapi bookmark Word dan referensi silang harus diuji setelah rendering. Untuk tautan internal yang tahan lama, tetapkan anchor AsciiDoc eksplisit seperti [[installation]] dan rujuk anchor tersebut dengan <<installation,Installation>>.