kramdown

kramdown ay isang libreng Ruby library na maaaring magamit para sa pag-parse ng isang superset ng Markdown. & Nbsp; Ito ay ganap na nakasulat sa Ruby, ay sumusuporta sa standard Markdown (na may ilang menor de edad pagbabago) at iba't-ibang mga extension na nagawa sikat ng PHP Markdown Dagdag na pakete at Maruku.
Ito ay marahil ang pinakamabilis na magagamit purong-Ruby Markdown converter (Nobyembre 2009), pagiging 5x mas mabilis kaysa sa Maruku at tungkol sa 10x mas mabilis kaysa sa BlueFeather.
Ang kramdown syntax ay batay sa Markdown, isang napakadaling isulat, madaling basahin markup para sa pagsusulat ng mga dokumento HTML sa plain text. Dahil ang pangunahing Markdown syntax ay may ilang mga pagkukulang, pagpapatupad (lalo na ang PHP Markdown Dagdag na package) Sinubukan mong i-pagtagumpayan ito pagkukulang sa karagdagang syntax. kramdown ay sumusuporta sa lahat ng mga tampok ng orihinal na Markdown syntax (kahit na may ilang mga menor de edad pagwawasto) pati na rin ang mas bagong mga tampok ipinatupad sa PHP Markdown Dagdag na pakete at Maruku.
Paggamit:
Ang kramdown pakete ay nagbibigay ng dalawang mga paraan sa paggamit nito:
* Bilang isang library
& Nbsp; kramdown ay gumagamit ng isa lamang ang parehong API bilang RedCloth, BlueCloth at Maruku:
& Nbsp; ay nangangailangan ng 'kramdown'
& Nbsp; Kramdown :: Document.new (text) .to_html
& Nbsp; Ang pangalawang parameter sa bagong tawag ay isang hash pagpipilian para sa (de)-activate sa ilang mga tampok. Para sa karagdagang impormasyon tingnan sa babasahin ukol sa API.
* Bilang isang application
& Nbsp; Sama-sama sa library nagharap ng binary na tinatawag na kramdown ay ipinadala na pwedeng gamitin upang i-convert ang teksto sa kramdown syntax sa HTML. Ito ang alinman sa bumabasa mula sa mga file ng tinukoy na bilang ng mga argumento command line o mula sa standard input. Halimbawa:
& Nbsp; kramdown path / sa / kramdown / doc / syntax.page

Ano ang bagong sa paglabas:

• 2 menor de edad pagbabago:
• Nagdagdag ng pang-parse para sa Github may lasa Markdown (lumulutas .gh # 68 sa pamamagitan ng Arne Brasseur nagbigay ng paunang pagpapatupad)
• katangian ng HTML ay output para sa pahalang na linya ngayon

Pag-aayos
• 5 bug:
• Ang tamang pag-encode sa resulta string ay nakatakda na ngayon kahit na ang pagpipilian template ay ginagamit
• Mga Fixed .gh # 72, .gh # 74: Lahat ng mga paraan upang i-set ng isang header ID na ngayon sundin ang mga parehong pamamaraan na kung saan ay sumusunod sa HTML ID (maliban sa ang mga tuldok ay hindi pinahihintulutan) (naiulat at paunang patch sa pamamagitan ng Matti Schneider)
• Mga Fixed .gh # 73: Ang template ng default na HTML ay mayroon na ngayong DOCTYPE at nagtatakda ng tama ang pag-encode (paunang patch sa pamamagitan ng Simon Lydell)
• Mga Fixed .gh # 67: URL ng mga elemento na link ay nakatakas na ngayon sa LaTeX converter upang maiwasan ang mga problema (patch sa pamamagitan ng Henning Perl)
• Mga Fixed .gh # 70: Anumang bersyon ng stringex library ay suportado na ngayon (iniulat ng Simon Lydell)

Ano ang bagong sa bersyon 1.1.0:

• 2 maliit na pagbabago:
• Footnote mga marker ay maaari na ngayong paulit-ulit (lumulutas .gh # 62 at .gh # 63 sa pamamagitan ng Theodore Pak nagbigay ng paunang patch)
• Ang LaTeX acronym pakete ay ginagamit ngayon para sa mga pagdadaglat (lumulutas .gh # 55 sa pamamagitan ng Tim Besard nagbigay ng paunang patch)

Pag-aayos
• 3 bug:
• Mga Fixed .gh # 60: Numero kinikilala ngayon bilang karagdagan sa salita character kapag nagko-convert ang mga underscore (patch sa pamamagitan ng Trevor Wennblom)
• Mga Fixed .gh # 66: mga elemento ng HTML,, at ay na-convert na ngayon ng tama sa pamamagitan ng LaTeX converter (patch sa pamamagitan ng Henning Perl)
• Mga Fixed .gh # 57: Mas mahusay na pangangasiwa sa mga smart quote kapag underscore ay direkta pagkatapos o bago ang mga panipi (iniulat sa pamamagitan ng Bill Tozier)

Ano ang bagong sa bersyon 1.0.2:

• Na-update ang pahina ng pagsubok upang isama kamag-anak ulit sa benchmark upang ito ay posible upang mas mahusay na masukat ang pagganap ng kramdown (na hiniling ng postmodern).
• Naglalaman ngayon ang kramdown Wiki isang listahan ng mga aklatan na pahabain kramdown (ideya sa pamamagitan ng postmodern).

Ano ang bagong sa bersyon 1.0.0:

• 4 maliit na pagbabago:
• Bagong transliterated_header_ids na pagpipilian para sa transliterating header ng teksto sa ASCII bago pagbuo ng isang header ID na ay kapaki-pakinabang para sa wika tulad ng Vietnamese (fixed .gh # 35, hiniling ng KY Anh)
• Ang entity & quot panipi; ngayon ay makakakuha ng convert sa katumbas nito sa character kapag entity_output = as_char.
• May babala ay ang output para sa IALs / ALDs na naglalaman ng hindi ipatungkol defintion ngayon.
• HTML footnote output ay nagbago upang gamitin ang klase sa halip na rel upang makamit ang (X) HTML4 / 5 compatibility

Pag-aayos
• 3 bug:
• Mga Fixed .gh # 38: Pag-encode problema sa 1.9 / 2.0 dahil sa hindi tugmang mga pag-encode - ang pinagmulan string ay na-convert na ngayon sa UTF-8 bago sa pag-parse at convert pabalik pagkatapos ng pag-convert ng (iniulat sa pamamagitan ng Simon Lydell)
• Mga Fixed RF # 29647: abbreviation sa mga di-salita unang character sa simula ng teksto lead sa pagbubukod (iniulat sa pamamagitan ng Stephan Dale)
• Mga Fixed RF # 29704: ID na tinukoy sa estilo atx mga header ay hindi laging tama ang nakita (iniulat sa pamamagitan ng Kyle Barbour)

Ano ang bagong sa bersyon 0.14.2:

• 1 maliit na pagbabago:
• Bagong link_defs pagpipilian para sa mga pre-pagtukoy sa mga kahulugan ng link
• 1 bug fix:
• Mga Fixed itinaas ang mga error sa atx header nang walang teksto

Ano ang bagong sa bersyon 0.14.1:

• HTML elemento lamang na hindi dapat maglaman ng katawan ( tulad ng) mga output sa form na ito, na ngayong gamitin ang isang tahasang dulong tag ang lahat ng iba pang mga elemento (lumulutas sa mga iba pang mga isyu sa mga bagay na may)
• Ang pagtukoy ng isang bloke IAL bago ang isang listahan ng kahulugan gumagana nang tama ngayon
• Mga Fixed bug .gh # 30: Walang laman na katawan para sa isang kahulugan sa isang listahan ng lead kahulugan sa isang pagbubukod (iniulat ni Mark Johnson)

Ano ang bagong sa bersyon 0.14.0:

• 2 malalaking pagbabago:
• wika Code ay tinukoy sa pamamagitan ng ngayon .language-CODELANG sa halip na lang = 'CODELANG'
• Ipinatupad ng suporta para sa pagtatakda ng wika sa nabakuran bloke linya ng umpisa code (paunang patch sa pamamagitan ng Bran)
• 1 maliit na pagbabago:
• Mga header na may ID maaaring pumigil sa mula sa pagpapakita sa toc sa pamamagitan ng pagtatalaga ng mga .no_toc klase sa kanila (patch sa pamamagitan ng Tim Bates)
• 1 bug fix:
• numeric halip na symbolic mga entity HTML na ngayon ang default na fallback (patch sa pamamagitan ng Gioele Barabucci)

Ano ang bagong sa bersyon 0.13.5:

• 2 maliit na pagbabago:
• mga katangian ng HTML na walang halaga Sinusuportahan na ngayon (-aayos ng bug RF # 29490 inulat ng Nat Welch)
• mga katangian HTML pangalan ay ngayon palaging-convert sa babaan ang kaso para sa pagkakapare-pareho

Pag-aayos
• 5 bug:
• Mga Fixed Dokumento # method_missing upang tanggapin snake_cased pangalan ng klase (patch sa pamamagitan ng tomykaira)
• Mga Fixed problema sa mga nawawalang REXML pare-pareho sa mga mas lumang Ruby 1.8.6 bersyon (iniulat sa pamamagitan ng Dave Everitt)
• Mga Fixed bug RF # 29520: Wastong inline matematika pahayag ay hindi mag-trigger sa math block ngayon (iniulat sa pamamagitan ng Gioele Barabucci)
• Mga Fixed bug RF # 29521: HTML output math ngayon ay palaging XHTML tugma (iniulat sa pamamagitan ng Gioele Barabucci)
• Walang laman na mga katangian id ay mas mahusay na mapangasiwaan ngayon sa pamamagitan ng HTML at kramdown converter (iniulat sa pamamagitan ng Jörg Sommer)
• 1 dokumentasyon ng pag-aayos:
• Mga Fixed di-wastong pagpipilian pahayag sa halimbawa sa mabilis na reference na pahina (iniulat sa pamamagitan ng Jörg Sommer)

Ano ang bagong sa bersyon 0.13.4:

• Nagdagdag ng converter na extracts ang toc ng isang dokumento (hiniling ng Brendan Hay). Tandaan na ito ay kapaki-pakinabang lamang kung mong gamitin kramdown bilang isang library!
• Mga Fixed typo: Dapat itong --output at hindi --ouput (patch sa pamamagitan ng postmodern)
• Mga Fixed HTML converter upang tamang output laman span tag (patch ni John Croisant)
• Mga Fixed bug RF # 29350: pag-parse ng mga tag na HTML na may magkatugma ang kaso ay gumagana na ngayon
• Mga Fixed bug RF # 29426: Nilalaman ng estilo ng mga tag ay itinuturing na raw na teksto ngayon
• Ginagamit na ngayon ng HTML converter rel sa halip na kapita-pitagan na maging HTML5 tugma (patch sa pamamagitan ng Joe Fiorini)
• Mga Fixed Ruby 1.9.3 kaugnay na mga babala
• Mga Fixed HTML parser upang gumana sa paligid ng isang pagbabago ng pagpapatupad ng array # delete_if sa Ruby 1.9.3

Mga Kinakailangan :

• Ruby