Bandingkan dan kontraskan bahasa markup ringan [tertutup]

Harap identifikasi bahasa markup ringan yang paling populer dan bandingkan kekuatan dan kelemahannya. Bahasa ini harus markup tujuan umum untuk prosa teknis, seperti untuk dokumentasi (misalnya, Haml tidak dihitung).

Lihat juga: Markdown versus ReStructuredText

Saya mengetahui tiga bahasa utama yang biasa digunakan dalam komunitas pemrograman dan teknologi yang lebih besar: Tekstil, Penurunan Harga, dan Teks Ulang. Ketiganya bisa dipelajari dalam beberapa jam atau "bersayap" dengan lembar contekan di dekatnya.

Tekstil

• Digunakan oleh Redmine dan komunitas Ruby
• 113 pertanyaan saat ini diberi tag di Stack Overflow
• Paling mirip dengan HTML, tetapi sumbernya paling tidak dapat dibaca
• Daftar bersarang termudah dari ketiga bahasa
• Tidak bisa dimengerti oleh non-programmer atau orang-orang yang tidak mengerti HTML
• Ideal untuk dokumen pendek yang kompleks (dengan tautan, daftar bersarang, kode, HTML khusus); misalnya: dokumentasi singkat, petunjuk, blog atau konten CMS
• Referensi sintaks

Penurunan harga

• Tampaknya tidak memiliki "komunitas" dalam bahasa rumah, tetapi ...
• 1274 pertanyaan dengan tag di Stack Overflow *
• Menekankan keterbacaan kode sumber, mirip dengan tradisi email
• Penyematan HTML langsung (Anda cukup mengetikkan tag)
• Tidak ada cara membuat tabel selain menyematkan HTML
• Anda sudah mengetahuinya jika Anda tahu Stack Overflow
• Mudah dipelajari jika Anda sudah mengetahui reStructuredText
• Penyamaran alamat email otomatis untuk format <address@example.com> (dengan tanda kurung siku)
• Referensi sintaks

reStructuredText (AKA ReST)

• Populer di komunitas Python
• 285 pertanyaan dengan tag di Stack Overflow
• Sedikit persnickety tentang spasi dan penyelarasan jika Anda bertanya kepada saya
• Daftar (terutama daftar bersarang) dan paragraf sepertinya selalu berkelahi
• Dapat dibaca oleh non-programmer
• Hanya format yang dapat membangun daftar isi (melalui ekstensi dalam implementasi referensi Python)
• Langsung mengonversi ke format lain seperti PDF dan XML
• Ideal untuk dokumen besar dengan banyak prosa (misalnya, alternatif untuk buku dokumen untuk panduan pengguna)
• Referensi sintaks

Anda juga dapat mempertimbangkan asciidoc

• markup yang relatif mudah dibaca
• penggunaan baris perintah langsung
• beberapa mungkin melihatnya sebagai relatif 'pilih-pilih' (vs. fleksibel) sehubungan dengan sintaks
• docbook dan (x) html keluaran

Halaman Wikipedia tentang bahasa markup ringan memiliki perbandingan yang baik antara berbagai opsi, serta menampilkan sintaks untuk penggunaan umum (judul, tebal, miring, dll.)

Saya mencoba untuk mencakup semua bahasa markup ringan di sini:

http://www.subspacefield.org/~travis/static_blog_generators.html

Seperti yang Anda lihat, ini dimulai dengan "bagaimana saya bisa membuat blog yang aman" - yaitu blog yang menghasilkan HTML statis, dan saya mendapati diri saya terjerat dalam bahasa markup, sistem template, dll.

Memperbarui

Saya hanya memfokuskan kembali pada LWML dengan implementasi python, dan semuanya ada di sini:

http://www.subspacefield.org/~travis/python_lightweight_markup_languages.html

Sejauh ini saya sudah mencoba penurunan harga dan ReST, dan saya lebih suka yang terakhir lebih baik untuk apa pun kecuali cuplikan HTML yang disematkan di halaman lain. Tabel, referensi silang, tautan tidak langsung, dll ...

untuk dokumentasi? bagaimana dengan doxygen ?
Saya telah menggunakannya untuk beberapa proyek c / c ++ yang perlu saya dokumentasikan. Bahkan Anda dapat 'menyalahgunakannya' seperti yang penulis doxygen gunakan untuk dokumentasi doxygen