kramdown

kramdown este o bibliotecă gratuit Ruby, care poate fi folosit pentru parsarea un superset de Markdown. & Nbsp; este complet scris în Ruby, susține Markdown standard, (cu unele modificări minore) și diverse extensii care au fost făcute populare prin reduceri PHP Pachetul Extra și Maruku.
Acesta este, probabil, cel mai rapid convertorul pur-Ruby Markdown disponibil (noiembrie 2009), fiind 5x mai repede decât Maruku și despre 10 ori mai rapid decât BlueFeather.
Sintaxa kramdown se bazează pe Markdown, o marcare foarte usor de a scrie, usor de citit pentru a scrie documente HTML în text simplu. Având în vedere că sintaxa Markdown de bază are unele neajunsuri, implementari (în special pachetul Extra PHP Markdown) au încercat să depășească acest neajunsurile cu sintaxa suplimentar. kramdown suporta toate caracteristicile de sintaxa Markdown inițial (deși cu unele corecturi minore), precum și unele facilitati noi implementate în pachetul Extra PHP Markdown și Maruku.
Utilizare:
Pachetul kramdown oferă două moduri de utilizare a acestuia:
* Ca o bibliotecă
& Nbsp; kramdown utilizează în esență același ca și API RedCloth, BlueCloth și Maruku:
& Nbsp; cere "kramdown"
& Nbsp; Kramdown :: Document.new (text) .to_html
& Nbsp; în al doilea rând parametru la noul apel este un hash optiuni (de) activarea anumitor funcții. Pentru mai multe informații au o privire la documentația API.
* Ca o cerere
& Nbsp; Odată cu biblioteca depune o kramdown binar denumit fost expediat, care poate fi folosit pentru a converti textul în sintaxa kramdown de HTML. Ori citește din fișierele specificate ca argumentele liniei de comandă sau de la intrarea standard. De exemplu:
& Nbsp; cale kramdown / a / kramdown / doc / syntax.page

Ce este nou în această versiune:

• 2 minore Modificări:
• Adăugat un parser de Github aromatizat Markdown (rezolvă GH # 68 de Arne Brasseur care a furnizat punerea în aplicare inițială)
• atributele HTML sunt acum de ieșire pentru linii orizontale

Stabilește
• 5 bug:
• codificarea corectă pe șirul rezultat este acum setată chiar și atunci când se folosește opțiunea șablon
• fixă ​​GH # 72, # 74 GH: Toate moduri de a seta un ID antet acum urmează aceeași schemă, care este în conformitate cu ID-uri HTML (cu excepția puncte nu sunt permise) (raportate si patch inițială de Matti Schneider)
• fixă ​​GH # 73: Șablonul implicit HTML are acum un DOCTYPE și stabilește codificarea corect (patch inițială de Simon Lydell)
• fixă ​​GH # 67: URL-uri de elemente de legătură sunt acum scăpat în convertorul LaTeX pentru a evita problemele (patch de Henning Perl)
• fixă ​​GH # 70: Orice versiune a bibliotecii stringex este suportat (raportate de Simon Lydell)

Ce este nou în versiunea 1.1.0:

• 2 modificări minore:

Markeri
• Nota de subsol poate fi acum repetată (rezolvă GH # 62 și # 63 GH de Theodore Pak care a furnizat plasturele inițială)
• Pachetul Acronimul LaTeX este acum folosit pentru abrevierile (rezolvă GH # 55 de Tim Besard care a furnizat plasturele inițială)

Stabilește
• 3 bug:
• fixă ​​GH # 60: Numerele sunt acum recunoscute în plus față de caractere sugerate la conversia de subliniere (patch cu Trevor Wennblom)
• fix GH # 66: elemente HTML, și sunt acum convertite în mod corect de către convertorul LaTeX (patch de Henning Perl)
• fixă ​​GH # 57: Mai bine de manipulare citat inteligent atunci când subliniere sunt direct după sau înainte de ghilimele (raportate de Bill Tozier)

Ce este nou în versiunea 1.0.2:

• Pagina teste a fost actualizat pentru a include ori relative în referință, astfel încât este posibil să se evalueze mai bine performanța de kramdown (solicitate de postmoderna).
• kramdown Wiki conține acum o listă de biblioteci care se extind kramdown (idee de postmoderna).

Ce este nou în versiunea 1.0.0:

• 4 modificări minore:
• Noi transliterated_header_ids opțiune pentru transliterating de text în afara în ASCII înainte de a genera un ID antet care este util pentru limba vietnameză ca (fix GH # 35, solicitat de Kỳ Anh)
• ghilimele Entitatea & quot; acum se transformă la echivalentul său caracter, atunci când entity_output = as_char.
• Un avertisment este acum de ieșire pentru IALS / ALDs care nu conțin atribuie defintion.
• ieșire HTML nota de subsol este modificat pentru a utiliza clasă în loc de rel de a realiza (X) HTML4 / 5 compatibilitate

Stabilește
• 3 bug:
• fixă ​​GH # 38: Encoding problemă pe 1,9 / 2,0 cauza codificări incompatibile - șirul sursă este acum transformat în UTF-8 înainte de parsarea și convertit înapoi după conversie (raportate de Simon Lydell)
• fix RF # 29647: Abrevieri cu caractere non-verbală primul caracter la începutul textului duce la excepție (raportate de Stephan Dale)
• fix RF # 29704: ID specificate pe anteturile de stil ATX nu au fost întotdeauna detectate corect (raportate de Kyle Barbour)

Ce este nou în versiunea 0.14.2:

• 1 modificare minoră:
• Noi link_defs opțiune pentru definiții link pre definesc-

Fix
• 1 bug:
• erori fixe ridicate pe antetele ATX fără text

Ce este nou în versiunea 0.14.1:

• Numai elemente HTML care nu trebuie să conțină un corp ( ca) sunt scoase în această formă, toate celelalte elemente folosesc acum un tag de închidere explicit (rezolvă printre alte aspecte lucruri cu)
• Specificarea un bloc IAL înainte o listă definiție acum funcționează corect
• Fixed bug GH # 30: corp gol de o definiție într-o listă definiție conduce la o excepție (raportate de Mark Johnson)

Ce este nou în versiunea 0.14.0:

• 2 schimbări majore:
• limba Codul este acum specificat prin .language-CODELANG în loc de lang = "CODELANG '
• suport Implementat de stabilire limbă pe cod imprejmuita cu gard linia bloc de pornire (patch inițială de Bran)
• 1 modificare minoră:
• Cap cu un act de identitate poate fi prevenită din arate în TOC prin atribuirea clasa .no_toc de a le (patch de Tim Bates)

Fix
• 1 bug:
• Numeric în loc de entități HTML simbolice sunt acum implicit alternativ (patch de Gioele Barabucci)

Ce este nou în versiunea 0.13.5:

• 2 modificări minore:
• HTML atribute fără valori sunt acum suportate (fixat bug RF # 29490 raportate de către Nat Welch)
• HTML atribute nume sunt acum mereu convertite în litere mici pentru consecvență

Stabilește
• 5 bug:
• fixă ​​Document # method_missing de a accepta nume de clasă snake_cased (patch de tomykaira)
• Problema fixe cu lipsă constant REXML pe Ruby versiune mai veche 1.8.6 (raportate de Dave Everitt)
• Fixed bug RF # 29520: Declarație de matematică valid inline nu atrage bloc matematica mai (raportate de Gioele Barabucci)
• Fixed bug RF # 29521: HTML matematica de ieșire este acum întotdeauna XHTML compatibil (raportate de Gioele Barabucci)
• ID atribute goale sunt acum gestionate mai bine de convertoare HTML și kramdown (raportate de Jorg Sommer)

Fix
• 1 documentație:
• fixă ​​declarație opțiuni incorecte în exemplul de la pagina rapid (raportate de Jorg Sommer)

Ce este nou în versiunea 0.13.4:

• Adaugata un convertor care extrage TOC a unui document (solicitate de Brendan Hay). Rețineți că aceasta este doar util dacă utilizați kramdown ca o bibliotecă!
• fix o greșeală de scriere: Ar trebui să fie --output și nu --ouput (patch de postmoderna)
• Convertor HTML fixată la ieșire corect tag-uri etalon goale (patch-uri de Ioan Croisant)
• Fixed bug RF # 29350: Parsing de tag-uri HTML cu caz nepotrivite lucreaza acum
• Fixed bug RF # 29426: Conținutul de tag-uri de stil este tratată ca text crud acum
• Convertor HTML juca acum rel în loc de rev a fi HTML5 compatibile (patch cu Joe Fiorini)
• fix Ruby 1.9.3 avertismente legate
• parser HTML fixă ​​de a lucra în jurul valorii de o schimbare de punere în aplicare a Array # delete_if în Ruby 1.9.3

Cerințe :

• Ruby