Konverter online gratis AD ke RST

RST diperlukan oleh sistem dokumentasi seperti Sphinx dan Docutils, sementara file AD mungkin merupakan dokumen plain-text lama atau ekspor teks khusus aplikasi. Mengonversinya membuat konten yang dapat dibaca menjadi dapat digunakan dalam dokumentasi berbasis RST, version control, dan static-site build.

Apa itu format AD

AD bukan format teks standar tunggal. Ekstensi ini digunakan oleh berbagai alat dokumentasi lama, aplikasi khusus, dan program ekspor plain-text. Program pembuatnya menentukan apakah file tersebut berisi paragraf biasa, record terstruktur, markup, tabel, atau command khusus aplikasi.

Buka file tersebut terlebih dahulu dalam text editor. Jika berisi teks yang dapat dibaca serta heading, daftar, atau markup yang dikenali, file biasanya dapat diadaptasi ke RST. Jika berisi data biner atau control character yang tidak dapat dibaca, identifikasi aplikasi asalnya dan lakukan ekspor dari program tersebut ke plain text, HTML, atau format terdokumentasi lainnya sebelum melakukan konversi.

Apa itu format RST

RST, atau reStructuredText, adalah format lightweight markup yang digunakan oleh Docutils, Sphinx, dan proyek dokumentasi Python. Format ini merepresentasikan heading dengan garis bawah, daftar dengan indentation, link dengan target eksplisit, literal code dengan indentation, dan directive seperti .. note::.

RST tetap dapat dibaca sebagai plain text dan bekerja dengan baik bersama Git, code review, automated documentation build, cross-reference, tabel, serta output HTML atau PDF yang dibuat secara otomatis. Format ini lebih sesuai jika sistem tujuan secara khusus menerima reStructuredText, bukan Markdown atau HTML.

Cara benar-benar mengonversi AD ke RST

1. Buat backup file source.ad asli.
2. Buka file tersebut dalam editor yang mendukung UTF-8 seperti Visual Studio Code, Notepad++, atau plain-text editor lainnya. Pastikan character encoding dan hapus application header yang bukan bagian dari dokumen.
3. Identifikasi struktur AD: baris judul, paragraf, daftar, tabel, link, bagian code, dan gambar yang disematkan. Tidak ada AD parser universal, sehingga syntax sumber harus ditafsirkan sebelum dapat dipetakan ke RST.
4. Tulis ulang heading menggunakan karakter garis bawah dengan panjang yang sesuai dengan heading. Contoh:
   Installation ============ Install the package with:: pip install package-name
5. Konversikan daftar sederhana ke marker RST seperti * item atau #. numbered item. Berikan indentation yang konsisten pada baris lanjutan.
6. Ganti link, field, dan directive khusus AD dengan padanan RST. Gunakan .. image:: filename.png untuk gambar dan .. code-block:: python untuk code dengan syntax highlighting.
7. Simpan hasilnya sebagai output.rst menggunakan encoding UTF-8.
8. Build atau validasi hasilnya dengan Docutils atau Sphinx. Proyek Sphinx dapat diperiksa dengan sphinx-build -b html . _build/html; error konversi dan directive yang tidak valid akan muncul dalam output build.

Untuk file AD sederhana yang berisi paragraf biasa, built-in converter di 101convert.com dapat mengonversi file secara online dan gratis tanpa menginstal software. Tinjau RST yang dihasilkan setelahnya karena konversi otomatis tidak dapat secara andal mengenali markup AD khusus aplikasi.

Jika file AD sebenarnya berisi konten yang menyerupai Markdown, Pandoc dapat melakukan konversi syntax setelah format input dikonfirmasi: pandoc source.ad -f markdown -t rst -o output.rst. Jangan gunakan -f markdown hanya karena ekstensinya adalah .ad; opsi tersebut benar hanya jika isi file mengikuti syntax Markdown.

Keterbatasan kualitas dan kompatibilitas

Paragraf biasa dan daftar dasar biasanya dapat ditransfer dengan sedikit kehilangan. Level heading, nested list, tabel, inline formatting, anchor, gambar, dan custom AD command memerlukan pemeriksaan manual karena RST mengekspresikannya dengan cara yang berbeda.

RST memperlakukan indentation sebagai syntax. Spasi yang salah dapat mengubah daftar, literal block, atau directive, dan tabel mungkin gagal dibuat jika pemisah kolomnya tidak konsisten. Periksa karakter non-ASCII, path gambar relatif, link eksternal, footnote, dan metadata AD apa pun setelah konversi.

Mengganti nama .ad menjadi .rst tidak mengonversi konten. Tindakan ini hanya mengubah nama file dan dapat menyebabkan Docutils atau Sphinx melaporkan error parsing.