kramdown

kramdown est une bibliothèque libre Ruby qui peut être utilisé pour analyser un sur-ensemble du format Markdown & nbsp;. Il est entièrement écrit en Ruby, soutient Markdown standard (avec quelques modifications mineures) et diverses extensions qui ont été rendu populaire par le PHP Markdown package supplémentaire et Maruku.
Ce est probablement le plus rapide convertisseur pur Ruby Markdown disponibles (Novembre 2009), étant 5x plus rapide que Maruku et environ 10x plus rapide que bluefeather.
La syntaxe de kramdown est basée sur Markdown, un très facile à écrire, facile à lire balisage pour la rédaction de documents HTML en texte brut. Depuis la syntaxe Markdown base comporte quelques lacunes, les implémentations (notamment le paquet supplémentaire PHP Markdown) ont essayé de surmonter cette lacunes avec la syntaxe supplémentaire. kramdown supporte toutes les fonctionnalités de la syntaxe Markdown originale (quoique avec quelques corrections mineures) ainsi que de nouvelles fonctionnalités mises en œuvre dans le paquet supplémentaire PHP Markdown et Maruku.
Utilisation:
Le paquet de kramdown fournit deux manières pour l'utiliser:
* Comme une bibliothèque
& Nbsp; kramdown utilise essentiellement la même API que RedCloth, BlueCloth et Maruku:
& Nbsp; require 'kramdown'
& Nbsp; Kramdown :: Document.new (texte) .to_html
& Nbsp; Le deuxième paramètre au nouvel appel est un hachage d'options pour (dés) activer certaines fonctions. Pour plus d'informations jeter un oeil à la documentation de l'API.
* Comme une application
& Nbsp; En collaboration avec la bibliothèque dépose une kramdown binaire appelé est embarquée, qui peut être utilisé pour convertir le texte en syntaxe kramdown au format HTML. Il lit soit à partir des fichiers spécifiés comme arguments de ligne de commande ou depuis l'entrée standard. Par exemple:
& Nbsp; chemin de kramdown / à / kramdown / doc / syntax.page

Quoi de neuf dans cette version:

• 2 mineure changements:
• Ajout d'un analyseur syntaxique pour Github aromatisés Markdown (GH décide # 68 par Arne Brasseur qui a fourni la mise en œuvre initiale)
• attributs HTML sont maintenant sortie pour les lignes horizontales

Correctifs
• 5 de bugs:
• Le codage correct sur la chaîne de résultat est maintenant réglée même si l'option de modèle est utilisé
• Correction GH # 72, GH # 74: Tous les moyens de définir un en-tête ID désormais suivre le même schéma qui est compatible avec des ID HTML (sauf que les points ne sont pas autorisés) (rapporté et le patch initial par Matti Schneider)
• Correction GH # 73: Le modèle HTML par défaut a maintenant un DOCTYPE et définit correctement le codage (patch initial par Simon Lydell)
• Correction GH # 67: URL d'éléments de liaison sont désormais échappé dans le convertisseur de LaTeX pour éviter les problèmes (patch par Henning Perl)
• Correction GH # 70: Toute version de la bibliothèque stringex est maintenant supporté (rapporté par Simon Lydell)

Ce qui est nouveau dans la version 1.1.0:

• 2 changements mineurs:

Marqueurs
• Footnote peuvent maintenant être répétées (GH décide # 62 et # 63 GH par Theodore Pak qui a fourni le patch initial)
• Le paquet acronyme LaTeX est maintenant utilisé pour les abréviations (GH décide # 55 par Tim Besard qui a fourni le patch initial)

Correctifs
• 3 de bugs:
• Correction GH # 60: Les chiffres sont maintenant reconnus dans plus de caractères de texte lors de la conversion de soulignement (patch par Trevor Wennblom)
• Correction GH N ° 66: les éléments HTML, et sont maintenant convertis correctement par le convertisseur de LaTeX (patch par Henning Perl)
• Correction GH # 57: la manipulation de devis puce Mieux quand soulignement sont directement après ou avant les guillemets (rapporté par le projet de loi Tozier)

Qu'est-ce que de nouveaux dans la version 1.0.2:

temps relatifs

• La page des essais a été mis à jour pour inclure l'indice de référence de sorte qu'il est possible de mieux évaluer la performance de kramdown (demandé par postmoderne).
• Le kramdown Wiki contient maintenant une liste des bibliothèques qui se étendent kramdown (idée en postmoderne).

Ce qui est nouveau dans la version 1.0.0:

• 4 changements mineurs:
• Nouveaux transliterated_header_ids d'options pour la translittération du texte d'en-tête en ASCII avant de générer un ID de tête qui est utile pour la langue comme vietnamien (GH fixe # 35, demandée par Kỳ Anh)
• L'entité guillemet & quot; maintenant est converti en son équivalent de caractères lorsque entity_output = as_char.
• Un avertissement est maintenant sortie pour LAI / ALD qui contiennent pas attribuent defintion.
• sortie de la note de HTML est modifié pour utiliser classe au lieu de rel pour atteindre (X) HTML4 5 compatibilité /

Correctifs
• 3 de bugs:
• Correction GH # 38: Codage problème sur 1,9 / 2,0 en raison de codages incompatibles - la chaîne source est maintenant converti en UTF-8 avant l'analyse et reconverti après la conversion (rapporté par Simon Lydell)
• Correction RF n ° 29647: abréviations avec non-mot premier caractère au début du texte principal d'une exception (rapporté par Stephan Dale)
• Correction RF n ° 29704: ID spécifié sur les en-têtes de style atx ne étaient pas toujours correctement détecté (rapporté par Kyle Barbour)

Ce qui est nouveau dans la version 0.14.2:

• une modification mineure:
• Nouveaux link_defs d'options pour les définitions pré-définissant lien
• une correction d'un bug:
• erreurs soulevées fixes sur les en-têtes atx sans texte

Ce qui est nouveau dans la version 0.14.1:

• éléments HTML Seuls doivent pas contenir un corps ( etc.) sont émis sous cette forme, tous les autres éléments utilisent maintenant une balise de fermeture explicite (résout entre autres questions de choses avec)
• Spécifier un bloc IAL avant une liste de définition fonctionne désormais correctement
• Correction d'un bug GH # 30: corps vide pour une définition dans une liste de définition conduit à une exception (rapporté par Mark Johnson)

Ce qui est nouveau dans la version 0.14.0:

• 2 changements majeurs:
• Langue de code est maintenant spécifié via .language-codelangue lieu de lang = 'codelangue'
• Ajout du support pour la mise sur le code langue clôturé ligne bloc de départ (patch initial de Bran)
• une modification mineure:
• En-têtes avec un ID peuvent être empêchés de montrer dans le TOC en attribuant la classe .no_toc à eux (patch par Tim Bates)
• une correction d'un bug:
• numérique au lieu d'entités HTML symboliques sont maintenant les secours par défaut (patch par Gioele Barabucci)

Ce qui est nouveau dans la version 0.13.5:

• 2 changements mineurs:
• attributs HTML sans valeurs sont maintenant supportés (corrections bogue # 29490 RF rapporté par Nat Welch)
• attributs HTML noms sont maintenant toujours convertis en minuscules de cohérence

Correctifs
• 5 de bugs:
• Correction Document # method_missing d'accepter nom de classe snake_cased (patch par tomykaira)
• Correction d'un problème avec manquant constante de REXML sur Ruby ancienne version 1.8.6 (rapporté par Dave Everitt)
• Correction d'un bug RF # 29520: inline Valable énoncé de mathématiques ne déclenche pas plus bloc de mathématiques (rapporté par Gioele Barabucci)
• Correction d'un bug RF # 29521: sortie de mathématiques HTML est maintenant toujours compatible XHTML (rapporté par Gioele Barabucci)
• attributs id vides sont maintenant mieux gérées par les convertisseurs HTML et kramdown (rapportés par Jorg Sommer)
• une documentation fix:
• Correction déclaration options invalides dans l'exemple à la page de référence rapide (rapporté par Jorg Sommer)

Ce qui est nouveau dans la version 0.13.4:

• Ajout d'un convertisseur qui extrait la table des matières d'un document (demandé par Brendan Hay). Notez que ce ne est utile que si vous utilisez kramdown comme une bibliothèque!
• Correction d'une faute: Il faut --output et non --ouput (patch par postmoderne)
• convertisseur HTML fixe à portée correctement sortie balises vides (patch par John Croisant)
• Correction d'un bug RF # 29350: Parsing des balises HTML avec étui dépareillés travaille maintenant
• Correction d'un bug RF # 29426: Contenu de balises de style est traité comme du texte brut maintenant
• convertisseur HTML utilise désormais rel lieu de rev être compatible HTML5 (patch par Joe Fiorini)
• Rubis fixe 1.9.3 avertissements liés
• parseur HTML fixe de travailler autour d'un changement de tableau # delete_if de mise en œuvre en Ruby 1.9.3

Exigences :

• Ruby