kramdown

kramdown è una libreria gratuita di Ruby che può essere utilizzato per l'analisi di un superset di Markdown. & Nbsp; è completamente scritto in Ruby, sostiene Markdown standard (con qualche piccola modifica) e varie estensioni che sono state fatte popolare dal PHP Markdown pacchetto Extra e Maruku.
E 'probabilmente il più veloce convertitore puro-Rubino Markdown disponibili (novembre 2009), essendo 5x più veloce di Maruku e circa 10 volte più veloce di bluefeather.
La sintassi kramdown si basa su Markdown, molto facile da scrivere, di facile lettura markup per la scrittura di documenti HTML in testo normale. Dal momento che la sintassi Markdown base ha alcune carenze, implementazioni (in particolare il pacchetto Extra PHP Markdown) hanno cercato di superare questo carenze sintassi supplementare. kramdown supporta tutte le caratteristiche della sintassi Markdown originale (anche se con alcune correzioni minori) e nuove funzionalità implementate nel pacchetto Extra PHP Markdown e Maruku.
Utilizzo:
Il pacchetto kramdown offre due modi per il suo utilizzo:
* Come una biblioteca
& Nbsp; kramdown utilizza fondamentalmente la stessa API come RedCloth, BlueCloth e Maruku:
& Nbsp; require 'kramdown'
& Nbsp; Kramdown :: Document.new (testo) .to_html
& Nbsp; Il secondo parametro per la nuova chiamata è un hash opzioni per (de) attivare determinate funzioni. Per maggiori informazioni date un'occhiata alla documentazione API.
* Come applicazione
& Nbsp; Insieme con la libreria file binario denominato kramdown viene spedito, che può essere utilizzato per convertire il testo in sintassi kramdown HTML. Si legge o dai file specificati come gli argomenti della riga di comando o dallo standard input. Ad esempio:
& Nbsp; percorso kramdown / a / kramdown / doc / syntax.page

Cosa c'è di nuovo in questa versione:

• 2 minori modifiche:
• Aggiunto un parser per Github aromatizzata Markdown (delibera GH # 68 da Arne Brasseur che ha fornito l'implementazione iniziale)
• attributi HTML sono ora in uscita per le linee orizzontali

Correzioni
• 5 bug:
• La corretta codifica sulla stringa risultato è ora impostato anche quando si utilizza l'opzione template
• GH fissa # 72, # 74 GH: Tutti i modi per impostare un ID intestazione ora seguire lo stesso schema che è compatibile con gli ID HTML (tranne che i punti non sono consentiti) (segnalato e la patch iniziale Matti Schneider)
• GH fissa # 73: Il template HTML di default ora ha un DOCTYPE e imposta correttamente la codifica (cerotto iniziale da Simon Lydell)
• GH fissa # 67: URL degli elementi di collegamento sono ormai fuggiti nel convertitore LaTeX per evitare problemi (patch da Henning Perl)
• GH fissa # 70: Qualsiasi versione della libreria stringex è ora supportato (segnalato da Simon Lydell)

Cosa c'è di nuovo nella versione 1.1.0:

• 2 lievi modifiche:

Marcatori
• Nota in calce possono essere ripetuti (risolve GH # 62 e # 63 GH da Theodore Pak che ha fornito la patch iniziale)
• Il pacchetto acronimo LaTeX è ora utilizzato per le abbreviazioni (risolve GH # 55 da Tim Besard che ha fornito la patch iniziale)

Correzioni
• 3 bug:
• GH fissa # 60: I numeri sono ora riconosciuti oltre ai caratteri di parola durante la conversione di sottolineatura (patch da Trevor Wennblom)
• GH fissa # 66: elementi HTML, e sono ora convertiti correttamente dal convertitore LaTeX (patch di Henning Perl)
• GH fissa # 57: Migliore gestione intelligente preventivo quando sottolineature sono subito dopo o prima di virgolette (segnalato da Bill Tozier)

Cosa c'è di nuovo nella versione 1.0.2:

• La pagina di test è stato aggiornato per includere i tempi relativi nel benchmark modo che sia possibile valutare meglio le prestazioni delle kramdown (richiesto da postmoderno).
• Il kramdown Wiki contiene ora un elenco di librerie che estendono kramdown (un'idea di postmoderno).

Cosa c'è di nuovo nella versione 1.0.0:

• 4 piccole modifiche:
• Nuove transliterated_header_ids option per traslitterazione testo di intestazione in ASCII prima di generare un ID di testa che è utile per la lingua come vietnamita (fisso GH # 35, richiesto da Ky Anh)
• L'entità virgoletta & quot; ora viene convertito in equivalente carattere quando entity_output = as_char.
• Un avviso è ora in uscita per IALS / ALD che non contengono attribuiscono defintion.
• uscita nota HTML viene modificata per utilizzare la classe invece di rel di raggiungere (X) HTML4 / 5 compatibilità

Correzioni
• 3 bug:
• GH fissa # 38: Codifica problema 1.9 / 2.0 a causa di codifiche incompatibili - la stringa di origine è ora convertito in UTF-8 prima di parsing e riconvertito dopo la conversione (segnalato da Simon Lydell)
• fissi RF # 29647: abbreviazioni non-word primo carattere all'inizio del piombo di testo ad eccezione (segnalato da Stephan Dale)
• fissi RF # 29704: ID specificato intestazioni stile ATX non sono stati sempre rilevato correttamente (segnalato da Kyle Barbour)

Cosa c'è di nuovo in versione 0.14.2:

• 1 piccola modifica:
• Nuove link_defs di opzione per le definizioni di collegamento-definiscono pre
• 1 bug fix:
• errori generati fissi su intestazioni ATX senza testo

Cosa c'è di nuovo in versione 0.14.1:

• Solo gli elementi HTML che non deve contenere un corpo ( come) vengono emessi in questa forma, tutti gli altri elementi ora utilizzare un tag di chiusura esplicito (risolve tra l'altro cose con)
• Specificare un blocco IAL prima di un elenco di definizioni ora funziona correttamente
• Risolto bug GH # 30: corpo vuoto per una definizione in un vantaggio lista di definizioni di un'eccezione (segnalato da Mark Johnson)

Cosa c'è di nuovo in versione 0.14.0:

• 2 importanti modifiche:
• Lingua Codice è ora specificato tramite .Language-CODELANG anziché lang = 'CODELANG'
• Implementato il supporto per l'impostazione della lingua in codice recintato linea blocco di partenza (patch iniziale da Bran)
• 1 piccola modifica:
• intestazioni con un ID può essere impedito di mostrare nel sommario assegnando classe .no_toc loro (patch da Tim Bates)
• 1 bug fix:
• numerico invece di entità HTML simbolici sono ora il fallback predefinito (patch di Gioele Barabucci)

Cosa c'è di nuovo in versione 0.13.5:

• 2 lievi modifiche:
• attributi HTML senza valori sono ora supportati (correzioni di bug RF # 29490 riportato da Nat Welch)
• attributi HTML nomi sono ora sempre convertite in minuscolo per coerenza

Correzioni
• 5 bug:
• fissi Document # method_missing per accettare il nome della classe snake_cased (patch da tomykaira)
• Corretto il problema con la mancanza costante REXML sulla più vecchia versione di Ruby 1.8.6 (riportato da Dave Everitt)
• Risolto bug RF # 29520: dichiarazione matematica inline Valid non attiva più blocco matematico (segnalato da Gioele Barabucci)
• Risolto bug RF # 29521: uscita matematica HTML è ora sempre XHTML compatibile (segnalato da Gioele Barabucci)
• attributi id vuoti sono ora gestiti meglio dai convertitori HTML e kramdown (riportati da Jorg Sommer)

Fix
• 1 Documentazione:
• opzioni non valide fisso dichiarazione in esempio sulla pagina di riferimento rapido (segnalato da Jorg Sommer)

Cosa c'è di nuovo in versione 0.13.4:

• Aggiunto un convertitore che estrae il TOC di un documento (richiesto da Brendan Hay). Si noti che questo è utile solo se si utilizza kramdown come una libreria!
• Risolto un errore di battitura: Va --output e non --ouput (patch dal postmoderno)
• Convertitore HTML fisso per correttamente uscita tag span vuoti (di patch da John Croisant)
• Corretto il bug # 29350 RF: parsing dei tag HTML con il caso non corrispondenti ora funziona
• Corretto il bug # 29426 RF: Il contenuto di tag di stile viene trattato come testo grezzo ora
• convertitore HTML utilizza ora rel invece di giri sia HTML5 compatibile (patch da Joe Fiorini)
• Risolto Rubino 1.9.3 avvisi relativi
• fissi parser HTML per aggirare un cambio implementazione di Array # delete_if in Ruby 1.9.3

Requisiti :

• Rubino