kramdown

kramdown adalah Ruby perpustakaan gratis yang dapat digunakan untuk parsing superset dari penurunan harga & nbsp;. Hal ini benar-benar ditulis dalam Ruby, mendukung penurunan harga standar (dengan beberapa modifikasi kecil) dan berbagai ekstensi yang telah dipopulerkan oleh PHP penurunan harga paket ekstra dan Maruku.
Ini mungkin adalah tercepat murni-Ruby penurunan harga konverter yang tersedia (November 2009), menjadi 5x lebih cepat dari Maruku dan sekitar 10x lebih cepat dari Bluefeather.
Sintaks kramdown didasarkan pada penurunan harga, sangat mudah untuk menulis, mudah dibaca markup untuk menulis dokumen HTML dalam teks biasa. Karena sintaks penurunan harga dasar memiliki beberapa kekurangan, implementasi (terutama paket Ekstra PHP penurunan harga) telah mencoba untuk mengatasi kekurangan ini dengan sintaks tambahan. kramdown mendukung semua fitur dari sintaks penurunan harga asli (meskipun dengan beberapa koreksi kecil) serta fitur baru dilaksanakan dalam paket Ekstra PHP penurunan harga dan Maruku.
Penggunaan:
Paket kramdown menyediakan dua cara untuk menggunakannya:
* Sebagai perpustakaan
& Nbsp; kramdown menggunakan dasarnya API yang sama seperti RedCloth, BlueCloth dan Maruku:
& Nbsp; membutuhkan 'kramdown'
& Nbsp; Kramdown :: Document.new (teks) .to_html
& Nbsp; Parameter kedua panggilan baru merupakan pilihan hash untuk (de) mengaktifkan fitur tertentu. Untuk informasi lebih lanjut lihat di dokumentasi API.
* Sebagai aplikasi
& Nbsp; Bersama dengan perpustakaan file biner disebut kramdown dikirim yang dapat digunakan untuk mengubah teks dalam sintaks kramdown ke HTML. Itu baik membaca dari file yang ditentukan sebagai argumen baris perintah atau dari input standar. Sebagai contoh:
& Nbsp; path kramdown / ke / kramdown / doc / syntax.page

Apa yang baru dalam rilis ini:

• 2 minor Perubahan:
• Ditambahkan parser untuk Github Flavored penurunan harga (menyelesaikan GH # 68 oleh Arne Brasseur yang disediakan implementasi awal)
• atribut HTML sekarang output untuk garis horizontal

Perbaikan
• 5 bug:
• Pengkodean yang benar pada string hasil sekarang sudah siap meskipun pilihan template yang digunakan
• Tetap GH # 72, GH # 74: Semua cara untuk menetapkan ID sundulan sekarang mengikuti skema yang sama yang sesuai dengan ID HTML (kecuali bahwa titik-titik yang tidak diperbolehkan) (dilaporkan dan awal Patch oleh Matti Schneider)
• Tetap GH # 73: Template HTML standar sekarang memiliki DOCTYPE dan menetapkan pengkodean dengan benar (awal Patch oleh Simon Lydell)
• Tetap GH # 67: URL elemen link yang kini melarikan diri dalam konverter LaTeX untuk menghindari masalah (Patch oleh Henning Perl)
• Tetap GH # 70: Setiap versi perpustakaan stringex sekarang didukung (dilaporkan oleh Simon Lydell)

Apa yang baru dalam versi 1.1.0:

• 2 perubahan kecil:

Penanda
• Catatan kaki sekarang dapat diulang (menyelesaikan GH # 62 dan GH # 63 oleh Theodore Pak yang disediakan patch awal)
• Paket singkatan LaTeX sekarang digunakan untuk singkatan (menyelesaikan GH # 55 oleh Tim Besard yang disediakan patch awal)

Perbaikan
• 3 bug:
• Tetap GH # 60: Nomor sekarang diakui selain karakter kata ketika mengkonversi garis bawah (Patch oleh Trevor Wennblom)
• Tetap GH # 66: elemen HTML, dan sekarang dikonversi dengan benar oleh converter LaTeX (Patch oleh Henning Perl)
• Tetap GH # 57: Lebih baik kutipan pintar penanganan ketika garis bawah yang langsung setelah atau sebelum tanda kutip (dilaporkan oleh Bill Tozier)

Apa yang baru di versi 1.0.2:

• Halaman tes telah diperbarui untuk menyertakan kali relatif dalam patokan sehingga memungkinkan untuk lebih mengukur kinerja kramdown (diminta oleh postmodern).
• kramdown Wiki sekarang berisi daftar pustaka yang memperpanjang kramdown (ide dengan postmodern).

Apa yang baru dalam versi 1.0.0:

• 4 perubahan kecil:
• transliterated_header_ids pilihan baru untuk transliterasi teks header ke ASCII sebelum menghasilkan ID sundulan yang berguna untuk bahasa seperti Vietnam (fixed GH # 35, yang diminta oleh Kỳ Anh)
• Tanda kutip entitas & quot; sekarang akan dikonversi menjadi setara karakter ketika entity_output = as_char.
• Peringatan sekarang output untuk IALS / ALDS yang berisi tidak atribut defintion.
• output HTML catatan kaki berubah untuk menggunakan kelas bukannya rel untuk mencapai (X) HTML4 / 5 kompatibilitas

Perbaikan
• 3 bug:
• Tetap GH # 38: Pengkodean masalah pada 1,9 / 2,0 karena pengkodean kompatibel - string sumber sekarang menjadi UTF-8 sebelum parsing dan diubah kembali setelah mengkonversi (dilaporkan oleh Simon Lydell)
• Tetap RF # 29647: Singkatan dengan non-kata karakter pertama di awal teks menyebabkan pengecualian (dilaporkan oleh Stephan Dale)
• Tetap RF # 29704: ID ditentukan pada gaya ATX header tidak selalu terdeteksi dengan benar (dilaporkan oleh Kyle Barbour)

Apa yang baru dalam versi 0.14.2:

• 1 perubahan kecil:
• link_defs pilihan baru untuk mendefinisikan pra definisi
• 1 bug fix:
• tetap mengangkat kesalahan pada header ATX tanpa teks

Apa yang baru dalam versi 0.14.1:

• Hanya elemen HTML yang tidak harus berisi tubuh ( sejenisnya) adalah output dalam bentuk ini, semua elemen lain sekarang menggunakan tag penutup eksplisit (menyelesaikan masalah antara lain dengan)
• Menentukan blok IAL sebelum daftar definisi sekarang bekerja dengan benar
• Fixed bug GH # 30: body Kosong untuk definisi dalam daftar definisi menyebabkan pengecualian (dilaporkan oleh Mark Johnson)

Apa yang baru dalam versi 0.14.0:

• 2 perubahan besar:
• bahasa Kode kini ditetapkan melalui .language-CODELANG bukan lang = "CODELANG '
• Diimplementasikan dukungan untuk pengaturan bahasa pada kode dipagari garis blok awal (Patch awal oleh Bran)
• 1 perubahan kecil:
• Header dengan ID dapat dicegah dari tampilan pada TOC dengan menetapkan kelas .no_toc kepada mereka (Patch oleh Tim Bates)
• 1 bug fix:
• Numeric bukan entitas HTML simbolik yang sekarang mundur default (Patch oleh Gioele Barabucci)

Apa yang baru dalam versi 0.13.5:

• 2 perubahan kecil:
• HTML atribut tanpa nilai sekarang didukung (perbaikan bug RF # 29490 dilaporkan oleh Nat Welch)
• HTML atribut nama sekarang selalu dikonversi menjadi huruf untuk konsistensi

Perbaikan
• 5 bug:
• Tetap Dokumen # method_missing untuk menerima nama kelas snake_cased (Patch oleh tomykaira)
• Tetap masalah dengan hilang REXML konstan pada yang lebih tua Ruby versi 1.8.6 (dilaporkan oleh Dave Everitt)
• Fixed bug RF # 29520: pernyataan matematika Hari inline tidak memicu blok matematika lagi (dilaporkan oleh Gioele Barabucci)
• Fixed bug RF # 29521: keluaran matematika HTML sekarang selalu XHTML kompatibel (dilaporkan oleh Gioele Barabucci)
• atribut id kosong kini ditangani baik oleh HTML dan kramdown konverter (dilaporkan oleh Jorg Sommer)
• 1 dokumentasi fix:
• Tetap pernyataan pilihan valid dalam contoh pada halaman referensi cepat (dilaporkan oleh Jorg Sommer)

Apa yang baru dalam versi 0.13.4:

• Ditambahkan converter yang ekstrak TOC dokumen (diminta oleh Brendan Hay). Catatan bahwa ini hanya berguna jika Anda menggunakan kramdown sebagai perpustakaan!
• tetap salah ketik: Perlu --output dan tidak --ouput (Patch oleh postmodern)
• Tetap converter HTML untuk benar keluaran kosong tag span (Patch oleh John Croisant)
• Fixed bug RF # 29350: Parsing tag HTML dengan kasus serasi sekarang bekerja
• Fixed bug RF # 29426: Isi tag gaya diperlakukan sebagai teks mentah sekarang
• converter HTML sekarang menggunakan rel bukannya rev menjadi HTML5 kompatibel (Patch oleh Joe Fiorini)
• Tetap Ruby 1.9.3 peringatan terkait
• Tetap parser HTML untuk bekerja di sekitar perubahan pelaksanaan Array # delete_if di Ruby 1.9.3

Persyaratan :

• Ruby