kramdown

kramdown er en gratis Ruby bibliotek som kan brukes for parsing et overordnet sett Markdown. & Nbsp; Det er helt skrevet i Ruby, støtter standard Markdown (med noen mindre modifikasjoner) og ulike utvidelser som har blitt gjort populært av PHP Markdown ekstra pakke og Maruku.
Det er trolig den raskeste ren-Ruby Markdown omformer tilgjengelig (November 2009), blir 5x raskere enn Maruku og ca 10x raskere enn BlueFeather.
Den kramdown syntaksen er basert på Markdown, en veldig lett å skrive, lett å lese markering for å skrive HTML-dokumenter i ren tekst. Siden grunnMarkDown syntaks har noen svakheter, har implementeringer (spesielt PHP Markdown Extra pakken) prøvde å overvinne denne svakhetene med ekstra syntaks. kramdown støtter alle funksjonene i den opprinnelige Markdown syntaks (riktignok med noen mindre endringer) samt nyere funksjoner implementert i PHP Markdown Extra pakke og Maruku.
Bruk:
Den kramdown pakken inneholder to måter for å bruke det:
* Som et bibliotek
& Nbsp; kramdown bruker i utgangspunktet den samme API som RedCloth, BlueCloth og Maruku:
& Nbsp; kreve 'kramdown'
& Nbsp; Kramdown :: Document.new (tekst) .to_html
& Nbsp; Den andre parameteren til den nye samtalen er en opsjons hasj for (de) aktivere visse funksjoner. For mer informasjon ta en titt på API-dokumentasjon.
* Som en søknad
& Nbsp; Sammen med biblioteket filer en binær kalt kramdown leveres som kan brukes til å konvertere tekst i kramdown syntaks til HTML. Det enten leser fra filene som er angitt som kommandolinjeargumentene eller fra standard input. For eksempel:
& Nbsp; kramdown sti / til / kramdown / doc / syntax.page

Hva er nytt i denne utgaven:

• 2 mindre endringer:
• Lagt til en parser for Github Flavored Markdown (løser GH # 68 av Arne Brasseur som leverte den første implementeringen)
• HTML-attributter er nå utgang for horisontale linjer
• 5 feilrettinger:
• Riktig koding på resultatet strengen er nå satt selv når alternativet malen er brukt
• Fast GH # 72, GH # 74: Alle måter å sette en header ID nå følger den samme ordningen som er kompatibel med HTML-IDer (bortsett fra at prikkene er ikke tillatt) (rapportert og innledende patch av Matti Schneider)
• Fast GH # 73: Standard HTML-mal har nå en DOCTYPE og setter koding riktig (initial patch av Simon Lydell)
• Fast GH # 67: nettadressene til lenkeelementer er nå flyktet i LaTeX converter å unngå problemer (patch av Henning Perl)
• Fast GH # 70: Enhver versjon av stringex bibliotek er nå støttet (rapportert av Simon Lydell)

Hva er nytt i versjon 1.1.0:

• to mindre endringer:
• Fotnote markører kan nå gjentas (løser GH # 62 og GH # 63 av Theodore Pak som leverte den første patch)
• LaTeX akronym pakken brukes nå for forkortelser (løser GH # 55 av Tim Besard som leverte den første patch)
• 3 feilrettinger:
• Fast GH # 60: Tall er nå anerkjent i tillegg til ord tegn ved konvertering strek (patch av Trevor Wennblom)
• Fast GH # 66: HTML-elementer, og er nå omgjort riktig av LaTeX konverter (patch av Henning Perl)
• Fast GH # 57: Bedre smart sitat håndtering når strek er rett etter eller før anførselstegn (rapportert av Bill Tozier)

Hva er nytt i versjon 1.0.2:

• Den tester siden har blitt oppdatert til å inkludere relative ganger i referanse slik at det er mulig å bedre måle ytelsen til kramdown (spurt av postmoderne).
• kramdown Wiki inneholder nå en liste over biblioteker som strekker kramdown (ide av postmoderne).

Hva er nytt i versjon 1.0.0:

• 4 mindre endringer:
• Nye opsjons transliterated_header_ids for trans header tekst i ASCII før du genererer en header ID som er nyttig for språk som vietnamesisk (fast GH # 35, spurt av Ky Anh)
• Den anførselstegn enhet & quot; nå blir konvertert til sin karakter tilsvarende når entity_output = as_char.
• er en advarsel nå utgang for IALs / aids som inneholder ikke attributt defintion.
• HTML fotnote utgang er endret til å bruke klasse i stedet for rel å oppnå (X) HTML4 / 5 kompatibilitet
• 3 feilrettinger:
• Fast GH # 38: Koding problem på 1.9 / 2.0 på grunn av inkompatible kodinger - kilden strengen er nå konvertert til UTF-8 før parsing og konverteres tilbake etter konvertering (rapportert av Simon Lydell)
• Fast RF # 29647: Forkortelser med ikke-ord første tegnet på begynnelsen av teksten fører til unntak (rapportert av Stephan Dale)
• Fast RF # 29704: ID spesifisert på atx stil overskrifter ble ikke alltid korrekt registrert (rapportert av Kyle Barbour)

Hva er nytt i versjon 0.14.2:

• en mindre endring:
• Nye opsjons link_defs for forhåndsdefinerende kobling definisjoner
• en bug fix:
• Faste hevet feil på ATX-overskrifter uten tekst

Hva er nytt i versjon 0.14.1:

• Kun HTML-elementer som må ikke inneholde en kropp ( lignende) er utgang i dette skjemaet, alle andre elementer nå bruke en eksplisitt avsluttende koden (løser blant annet problemer med)
• Angi en blokk IAL før en definisjon liste fungerer nå riktig
• Fast bug GH # 30: Empty kroppen for en definisjon på en definisjon liste fører til et unntak (rapportert av Mark Johnson)

Hva er nytt i versjon 0.14.0:

• 2 store endringer:
• Kodespråk er nå spesifisert via .language-CODELANG stedet for lang = 'CODELANG'
• implementert støtte for å sette språk på inngjerdet kodeblokk startstreken (initial patch av Bran)
• en mindre endring:
• hoder med en ID kan forhindres fra å vises i innholdsfortegnelsen ved å tilordne den .no_toc klasse til dem (patch av Tim Bates)
• en bug fix:
• Numerisk stedet for symbolske HTML enheter er nå standard fallback (patch av Gioele Barabucci)

Hva er nytt i versjon 0.13.5:

• to mindre endringer:
• HTML-attributter uten verdier støttes nå (fikser bug RF # 29490 rapportert av Nat Welch)
• HTML-attributter navnene er nå alltid konvertert til små bokstaver for konsistens
• 5 feilrettinger:
• Fast Document # method_missing å akseptere snake_cased klassenavnet (patch etter tomykaira)
• Fast problem med manglende REXML konstant på eldre Ruby 1.8.6-versjonen (rapportert av Dave Everitt)
• Fast bug RF # 29520: Gyldig inline matematikk uttalelsen ikke utløser matematikk blokk lenger (rapportert av Gioele Barabucci)
• Fast bug RF # 29521: HTML matematikk produksjonen er nå alltid XHTML-kompatibel (rapportert av Gioele Barabucci)
• Tomme id attributter blir nå håndtert bedre av HTML og kramdown omformere (rapportert av Jorg Sommer)
• en dokumentasjon fix:
• Fast ugyldige alternativer uttalelse i eksempel på rask referanseside (rapportert av Jorg Sommer)

Hva er nytt i versjon 0.13.4:

• Lagt til en omformer som trekker ut innholdsfortegnelsen i et dokument (spurt av Brendan Hay). Merk at dette er bare nyttig hvis du bruker kramdown som et bibliotek!
• Fikset en skrivefeil: Det bør Output og ikke --ouput (patch av postmoderne)
• Fast HTML omformer til riktig utgang tomme span tags (patch av John Croisant)
• Fast bug RF # 29350: Parsing av HTML-tagger med feilaktige tilfellet fungerer nå
• Fast bug RF # 29426: Innhold av stil tags behandles som rå tekst nå
• HTML-konvertering bruker nå rel i stedet for rev å være HTML5-kompatibel (patch av Joe Fiorini)
• Fast Ruby 1.9.3 relaterte advarsler
• Fast HTML-parser for å omgå en implementering endring av Array # delete_if i Ruby 1.9.3

Krav :

• Ruby