kramdown

kramdown een gratis Ruby bibliotheek die kan worden gebruikt voor het analyseren van een superset van Markdown. & Nbsp; wordt in Ruby volledig geschreven ondersteunt standaard Markdown (met enkele kleine wijzigingen) en verscheidene uitbreidingen die populair door de PHP Markdown Extra pakket en Maruku.
Het is waarschijnlijk de snelste pure-Ruby Markdown converter beschikbaar (november 2009), zijnde 5x sneller dan Maruku en ongeveer 10x sneller dan BlueFeather.
De kramdown syntaxis is gebaseerd op Markdown, een zeer eenvoudig te schrijven, makkelijk te lezen markup voor het schrijven van HTML-documenten in platte tekst. Aangezien de basis Markdown syntax heeft een aantal tekortkomingen, implementaties (vooral de PHP Markdown Extra pakket) hebben geprobeerd om deze tekortkomingen met extra syntax overwinnen. kramdown ondersteunt alle functies van de originele Markdown syntax (zij het met enkele kleine correcties) alsook nieuwere functies in de PHP Markdown Extra pakket en Maruku geïmplementeerd.
Gebruik:
De kramdown pakket biedt twee manieren voor het gebruik ervan:
* Als een bibliotheek
& Nbsp; kramdown gebruikt in principe dezelfde API als RedCloth, BlueCloth en Maruku:
& Nbsp; nodig 'kramdown'
& Nbsp; Kramdown :: Document.new (tekst) .to_html
& Nbsp; De tweede parameter om het nieuwe gesprek is een optie hash voor het (de) activeren van bepaalde functies. Voor meer informatie neem een ​​kijkje op de API-documentatie.
* Als een applicatie
& Nbsp; Samen met de bibliotheek bestanden een binaire genaamd kramdown wordt geleverd die kan worden gebruikt om tekst om te zetten in kramdown syntaxis naar HTML. Het ofwel leest van de opgegeven als de command line argumenten of van de standaard input-bestanden. Bijvoorbeeld:
& Nbsp; kramdown pad / naar / kramdown / doc / syntax.page

Wat is nieuw in deze release:

• 2 minor veranderingen:
• Voegde een parser voor Github Flavored Markdown (lost GH # 68 van Arne Brasseur, die op voorwaarde dat de initiële implementatie)
• HTML attributen zijn nu uitgang voor horizontale lijnen
• 5 bug fixes:
• De juiste codering op het resultaat snaar wordt nu zelfs instellen wanneer de optie sjabloon wordt gebruikt
• Vaste GH # 72, GH # 74: Alle manieren om een ​​header ID nu ingesteld volgen dezelfde regeling die voldoet aan de HTML-id's (met uitzondering van die punten worden niet toegelaten) (gemeld en de eerste patch van Matti Schneider)
• Vaste GH # 73: De standaard HTML sjabloon heeft nu een DOCTYPE en stelt de codering correct (oorspronkelijke patch door Simon Lydell)
• Vaste GH # 67: URL van koppeling elementen zijn nu ontsnapt in de latex converter om problemen te voorkomen (patch door Henning Perl)
• Vaste GH # 70: Elke versie van de stringex bibliotheek wordt nu ondersteund (gemeld door Simon Lydell)

Wat is nieuw in versie 1.1.0:

• 2 kleine wijzigingen:
• Voetnoot markers kunnen nu worden herhaald (lost GH # 62 en # 63 GH door Theodore Pak die de eerste patch voorzien)
• De latex afkorting pakket wordt nu gebruikt voor afkortingen (lost GH # 55 door Tim Besard die de eerste patch voorzien)
• 3 bug fixes:
• Vaste GH # 60: Nummers worden nu erkend als aanvulling op woord tekens bij het converteren underscores (patch door Trevor Wennblom)
• Vaste GH # 66: HTML-elementen, en worden nu correct omgezet door de LaTeX converter (patch door Henning Perl)
• Vaste GH # 57: Beter slimme citaat hanteren wanneer underscores zijn direct na of voor aanhalingstekens (gemeld door Bill Tozier)

Wat is nieuw in versie 1.0.2:

• heeft De pagina die testen is bijgewerkt om onder andere relatieve tijden in de benchmark zodat het mogelijk is om beter meten van de prestaties van kramdown (verzoek van postmoderne).
• De kramdown Wiki bevat nu een lijst van bibliotheken die kramdown verlengen (idee van postmoderne).

Wat is nieuw in versie 1.0.0:

• 4 kleine wijzigingen:
• Nieuwe optie transliterated_header_ids voor transliteratie koptekst in ASCII voor het genereren van een header-ID, die nuttig is voor taal zoals Vietnamese (vaste GH # 35, door Kỳ Anh gevraagd)
• De aanhalingsteken entiteit & quot; nu wordt omgezet in zijn karakter gelijkwaardig wanneer entity_output = as_char.
• Een waarschuwing is nu uitgang voor IALS / ALD's die niet defintion bevatten toeschrijven.
• HTML voetnoot uitgang wordt gewijzigd in de klas te gebruiken in plaats van de rel te bereiken (X) HTML4 / 5 compatibiliteit
• 3 bug fixes:
• Vaste GH # 38: Het coderen probleem op 1.9 / 2.0 wegens incompatibele coderingen - de bron snaar wordt nu omgezet naar UTF-8 voor het ontleden en omgezet terug na het omzetten van (gemeld door Simon Lydell)
• Vaste RF # 29647: Afkortingen met niet-woord eerste teken aan het begin van de tekst leiden tot uitzondering (gemeld door Stephan Dale)
• Vaste RF # 29704: ID opgegeven op atx stijl headers werden niet altijd correct gedetecteerd (gemeld door Kyle Barbour)

Wat is nieuw in versie 0.14.2:

• 1 kleine verandering:
• Nieuwe optie link_defs voor pre-definiëren linkbestemmingen
• 1 bug fix:
• Vaste verhoogde fouten op atx headers zonder tekst

Wat is nieuw in versie 0.14.1:

• Alleen HTML-elementen die geen lichaam moet bevatten ( dergelijke) worden uitgevoerd in deze vorm, alle andere elementen gebruiken nu een expliciete afsluitende tag (lost onder andere problemen met)
• Het specificeren van een blok IAL voordat een definitie lijst werkt nu correct
• Fixed bug GH # 30: Lege lichaam voor een definitie in een definitielijst leiden tot een uitzondering (gemeld door Mark Johnson)

Wat is nieuw in versie 0.14.0:

• 2 grote veranderingen:
• Code taal wordt nu aangegeven via .language-CODELANG in plaats van lang = "CODELANG '
• Implementatie ondersteuning voor het instellen van de taal op omheind codeblok startlijn (oorspronkelijke patch door Bran)
• 1 kleine verandering:
• Headers met een ID kan worden voorkomen dat zien in de inhoudsopgave door het toewijzen van de .no_toc klasse om ze (patch door Tim Bates)
• 1 bug fix:
• Numeriek in plaats van symbolische HTML entiteiten zijn nu de standaard fallback (patch door Gioele Barabucci)

Wat is nieuw in versie 0.13.5:

• 2 kleine wijzigingen:
• HTML attributen zonder waarden nu ondersteund (fixes bug RF # 29490 gemeld door Nat Welch)
• HTML attributen namen worden nu altijd omgezet in geval van consistentie verlagen
• 5 bug fixes:
• Vaste Document # method_missing om snake_cased klasse naam (patch door tomykaira) te aanvaarden
• Vast probleem met ontbrekende REXML constant op oudere Ruby 1.8.6 versie (gemeld door Dave Everitt)
• Fixed bug RF # 29520: Geldige inline wiskunde verklaring niet meer triggeren wiskunde blok (gemeld door Gioele Barabucci)
• Fixed bug RF # 29521: HTML wiskunde uitgang is nu altijd XHTML compatible (gemeld door Gioele Barabucci)
• Lege id attributen worden nu beter behandeld door de HTML en kramdown converters (gemeld door Jorg Sommer)
• 1 documentatie fix:
• Vaste ongeldige opties statement in bijvoorbeeld op quick reference pagina (gemeld door Jorg Sommer)

Wat is nieuw in versie 0.13.4:

• Voegde een converter die de inhoudsopgave van een document slechts uittreksels (op verzoek van Brendan Hay). Let op: dit is alleen nuttig als u kramdown gebruiken als een bibliotheek!
• Vast een typefout: Het moet worden --output en niet --ouput (patch door postmoderne)
• Vaste HTML converter te kunnen uitgang lege overspanning-tags (patch door John Croisant)
• Fixed bug RF # 29350: parseren van HTML-tags met niet-passende case werkt nu
• Fixed bug RF # 29426: Inhoud van de stijl-tags wordt behandeld als onbewerkte tekst nu
• HTML converter maakt nu gebruik van rel in plaats van rev naar HTML5 compatibele (patch door Joe Fiorini) zijn
• Vaste Ruby 1.9.3 gerelateerde waarschuwingen
• Vaste HTML parser om te werken rond een implementatie verandering van Array # delete_if in Ruby 1.9.3

Eisen

• Ruby