kramdown egy ingyenes Ruby könyvtár, amely felhasználható parsolásra felülbírálja a Markdown. & Nbsp; A teljes írt Ruby, támogatja a szabványos Markdown (néhány kisebb módosításokkal) és a különböző kiterjesztések, hogy a tettek népszerűvé a PHP Markdown Extra csomag és Maruku.
Valószínűleg ez a leggyorsabb tiszta Ruby Markdown átalakító elérhető (nov 2009), hogy 5x gyorsabb, mint Maruku és kb 10x gyorsabb, mint BlueFeather.
A kramdown szintaxis alapul Markdown, nagyon könnyű írni, könnyen olvasható jelölő írásához HTML dokumentumok szöveges formában. Mivel az alapvető Markdown szintaxis van néhány hiányossága, implementáció (különösen a PHP Markdown Extra csomag) próbálta leküzdeni ezt a hiányosságot további szintaxis. kramdown támogatja az összes jellemzői az eredeti Markdown szintaxis (bár néhány kisebb korrekciók), valamint újabb funkciók alkalmazása a PHP Markdown Extra csomag és Maruku.
Használat:
A kramdown csomag kétféle módon használja:
* Mivel a könyvtár
& Nbsp; kramdown használja alapvetően ugyanaz API, mint RedCloth, BlueCloth és Maruku:
& Nbsp; igényel "kramdown"
& Nbsp; Kramdown :: Document.new (szöveg) .to_html
& Nbsp; A második paraméter az új hívás egy olyan lehetőség hash (de) aktiválja bizonyos szolgáltatásokat. További információkért tekintse meg az API dokumentációt.
* Mivel egy alkalmazás
& Nbsp; Együtt a könyvtár fájljait egy bináris nevű kramdown szállítjuk, amely felhasználható átalakítani szöveget kramdown szintaxist HTML. Ez sem olvas a fájlok megadott paramétereken vagy a szabványos bemenetről. Például:
& Nbsp; kramdown path / to / kramdown / doc / syntax.page
Mi az új ebben a kiadásban:
- 2 minor változások:
- Hozzáadás egy elemző a GitHub ízesített Markdown (megoldja GH # 68 Arne Brasseur, akitől a végrehajtás első)
- HTML attribútumai kimenet vízszintes vonalak
- 5 hibajavítások:
- A megfelelő kódolással a string kerül most meg akkor is, ha a sablon opciót használjuk
- Fix GH # 72, # 74 GH: Minden módon lehet beállítani a header ID teremteni ugyanolyan szerkezetű, amely megfelel a HTML-azonosítók (kivéve, hogy a pontok nem megengedett) (számoltak, és a kezdeti patch Matti Schneider)
- Fix GH # 73: Az alapértelmezett HTML template most egy DOCTYPE és beállítja a kódolás helyes (kezdeti patch Simon Lydell)
- Fix GH # 67: URL Link elemek most megszökött a LaTeX átalakító problémák elkerülése érdekében (patch Henning Perl)
- Fix GH # 70: Minden változata a stringex könyvtár most már támogatja (jelentése szerint Simon Lydell)
Mi az új a 1.1.0 verzió:
- 2 kisebb változások:
- lábjegyzet markerek most kell ismételni (megoldja GH # 62 és # 63 GH Theodore Pak, akitől az első tapasz)
- A LaTeX rövidítés csomag most használt rövidítések (megoldja GH # 55 Tim Besard, akitől az első tapasz)
- 3 hibajavítások:
- Fix GH # 60: A számok már megjelennek mellett szót karakter átalakítása során aláhúzás (patch Trevor Wennblom)
- Fix GH # 66: HTML elemeket, és most alakul helyesen a LaTeX konverter (patch Henning Perl)
- Fix GH # 57: Jobb smart quote kezelése során aláhúzás közvetlenül előtte vagy utána idézőjelek (jelentése szerint Bill Tozier)
Mi az új a 1.0.2 verzió:
- A tesztek az oldal frissült tartalmazza relatív alkalommal A benchmark így lehetőség van jobban felmérni a teljesítményét kramdown (által kért posztmodern).
- A kramdown Wiki most már tartalmaz egy felsorolást a könyvtárak, amelyek kiterjesztik kramdown (ötlete alapján a posztmodern).
Mi az új 1.0.0:
- 4 kisebb változások:
- Új lehetőség transliterated_header_ids a transliterating fejléc szöveget ASCII, utána a fejléc ID ami hasznos nyelv, mint a vietnami (fix GH # 35, kérte Kỳ Anh)
- A idézőjel egység & quot; Most kerül át a karakterét egyenértékű, ha entity_output = as_char.
- A figyelmeztető most kimenet iAls / ALD tartalmazó nem tulajdonítanak defintion.
- HTML lábjegyzet output úgy módosították, hogy class helyett rel elérése (X) HTML 4/5 kompatibilitás
- 3 hibajavítások:
- Fix GH # 38: kódolás problémát a 1.9 / 2.0 miatt nem kompatibilis kódolások - a forrás karakterlánc most UTF-8 elemzés előtt, és alakítja vissza konvertálás után (jelentése szerint Simon Lydell)
- Fix RF # 29647: A rövidítéseket nem szó első karaktere elején szöveget vezet kivételével (jelentése szerint Stephan Dale)
- Fix RF # 29704: ID megadott ATX stílusban fejlécek nem mindig pontosan kimutatott (jelentése szerint Kyle Barbour)
Mi az új verzióban 0.14.2:
- 1 kis változás:
- Új lehetőség link_defs előre meghatározzák linket meghatározások
- 1 hibajavítás:
- Fix felvetett hibák ATX fejlécek szöveg nélkül
Mi az új verzióban 0.14.1:
- Csak HTML elemeket, amelyek nem tartalmaznak a test ( hasonlók) kerülnek kiadásra ebben a formában, minden más elem, most már kifejezett záró tag (megoldja többek között kérdéseket)
- megadása blokk IAL előtt a definíciós lista most már helyesen működik
- Javítva GH # 30: Üres test egy meghatározást definíciós listát vezet kivétel (számoltak Mark Johnson)
Mi az új verzióban 0.14.0:
- 2 jelentős változások:
- Code nyelvi pontosításra keresztül .language-CODELANG helyett lang = "CODELANG"
- támogatását valósította beállított nyelvet, bekerített kód blokk kezdőcsapatban (kezdeti patch Bran)
- 1 kis változás:
- fejlécek azonosítóval lehet előzni megjelenjenek a tartalomjegyzékben hozzárendeljük .no_toc class nekik (patch Tim Bates)
- 1 hibajavítás:
- Numerikus helyett szimbolikus HTML entitások most az alapértelmezett visszatérés (patch Gioele Barabucci)
Mi az új verzióban 0.13.5:
- 2 kisebb változások:
- HTML attribútumok nélküli értékek már támogatja (javítások bug RF # 29490 által jelentett Nat Welch)
- HTML tulajdonságnevet mostantól mindig kisbetűssé alakítja a következetesség
- 5 hibajavítások:
- Fix Document # method_missing elfogadni snake_cased osztály nevét (patch tomykaira)
- Fix probléma a hiányzó REXML állandó régebbi Ruby 1.8.6 verzió (jelentése szerint Dave Everitt)
- Javítva RF # 29520: Érvényes inline matematikai nyilatkozatot nem váltja ki a matematika blokk már (jelentése szerint Gioele Barabucci)
- Javítva RF # 29521: HTML matematikai kimenet most mindig XHTML kompatibilis (jelentése szerint Gioele Barabucci)
- Empty id attribútumai kezelni a jobb a HTML és kramdown konverterek (számoltak Jörg Sommer)
- 1 dokumentációt fix:
- Fix érvénytelen opciók nyilatkozatot például gyors bemutató oldal (számoltak Jörg Sommer)
Mi az új verzióban 0.13.4:
- Hozzáadás a konverter, amely kibontja a TOC dokumentum (által kért Brendan Hay). Megjegyzendő, hogy ez csak akkor hasznos, ha használja kramdown mint egy könyvtár!
- Rögzített elírás: Meg kell --output és nem --ouput (patch posztmodern)
- Fix HTML átalakító helyes kimeneti üres span címkék (patch John Croisant)
- Javítva RF # 29350: Parsing a HTML tag-ek nem illő esetben működik
- Javítva RF # 29426: tartalma szerű tag kezelik nyers szöveget most
- HTML átalakító most használja rel helyett rev hogy HTML5 kompatibilis (patch Joe Fiorini)
- Fix Ruby 1.9.3 kapcsolatos figyelmeztetések
- Fix HTML értelmező a munka körül egy végrehajtási változás a Array # delete_if a Ruby 1.9.3
követelmények :
- Ruby
Hozzászólás nem található