kramdown

kramdown jest wolna biblioteka Ruby, które mogą być używane do analizowania nadzbiór Markdown & nbsp;. To jest napisane w Ruby, obsługuje standardowe Markdown (z niewielkimi zmianami) i różne rozszerzenia, które zostały spopularyzowane przez PHP Markdown Dodatkowy i Maruku.
Jest to prawdopodobnie najszybszy konwerter czystej Ruby Markdown dostępny (listopad 2009), jest 5x szybciej niż Maruku i około 10x szybciej niż BlueFeather.
Składnia kramdown opiera się na promocji cenowych, bardzo łatwe do napisania, łatwy do odczytu znaczników do pisania dokumentów HTML w postaci zwykłego tekstu. Ponieważ podstawową składni Markdown ma pewne wady, wdrożeń (szczególnie Extra pakiet PHP Markdown) próbowali pokonać to braki z dodatkowej składni. kramdown obsługuje wszystkie funkcje oryginalnego składni Markdown (choć z niewielkimi korektami), jak i nowsze funkcje zaimplementowane w dodatkowym pakiecie PHP Markdown i Maruku.
Sposób użycia:
Pakiet kramdown udostępnia dwa sposoby na użytkowanie:
* W bibliotece
& Nbsp; kramdown wykorzystuje zasadniczo ten sam interfejs API jak RedCloth, BlueCloth i Maruku:
& Nbsp; wymagają "kramdown"
& Nbsp; Kramdown :: Document.new (tekst) .to_html
& Nbsp; drugi parametr do nowego połączenia jest hash opcji do (de) aktywacja pewnych funkcji. Aby uzyskać więcej informacji, zajrzyj do dokumentacji API.
* Jako zastosowanie
& Nbsp; Razem z biblioteką plików binarnych nazywa kramdown jest dostarczany, który może być użyty do konwersji tekstu w składni kramdown do HTML. Czyta albo z plików podanych jako argumenty wiersza poleceń lub ze standardowego wejścia. Na przykład:
& Nbsp; ścieżka kramdown / do / kramdown / doc / syntax.page

Co nowego w tym wydaniu:

• 2-moll zmiany:
• Dodane parser dla GitHub Flavored Markdown (GH # 68 rozwiązuje Arne Brasseur, która dostarczyła początkowe realizacji)
• atrybuty HTML są teraz wyjście dla linii poziomych,

Poprawki
• 5 błędów:
• prawidłowe kodowanie na ciąg wynik jest ustawiony, nawet jeżeli opcja szablon jest używany,
• Poprawiono GH 72, GH # 74: Wszystkie sposoby ustawienia ID nagłówka teraz się tą samą logiką, która jest zgodna z identyfikatorami HTML (poza tym, że kropki nie są dozwolone) (poprawki zgłoszone i wstępne Matti Schneider),
• Poprawiono GH # 73: Domyślny szablon HTML ma teraz DOCTYPE i ustawia kodowanie poprawnie (wstępne poprawki Simon Lydell)
• Poprawiono GH # 67: adresy URL elementów łączących teraz uciekł w konwerterze LaTeX, aby uniknąć problemów (poprawki przez Henning Perl)
• Poprawiono GH # 70: Każda wersja stringex biblioteki jest teraz (zgłoszony przez Szymona Lydell)

Co nowego w wersji 1.1.0:

• 2 niewielkie zmiany:

Znaczniki
• Przypis mogą być teraz wielokrotnie (postanawia GH 62 i GH # 63 przez Theodore Pak, który dostarczył początkową poprawkę)
• Pakiet skrót LaTeX jest obecnie wykorzystywane do skrótów (postanawia GH nr 55 przez Tima Besard dawcy pierwotnej poprawki)

Poprawki
• 3 błędów:
• Poprawiono GH # 60: Liczby są obecnie uznawane oprócz znaków słownych przy konwersji podkreślenia (plaster Trevora Wennblom)
• Poprawiono GH # 66: elementy HTML, i są teraz przeliczone prawidłowo przez konwerter LaTeX (poprawka Henning Perl)
• Poprawiono GH # 57: Lepsza obsługa inteligentny cytat kiedy podkreślenia są bezpośrednio przed lub po cudzysłowie (zgłaszane przez Billa Tozier)

Co jest nowe w wersji 1.0.2:

• Strona testy został zaktualizowany do obejmują czasy względne W odniesienia tak, że jest możliwe, aby lepiej ocenić wydajność kramdown (żądanie postmodern).
• kramdown Wiki zawiera teraz listę bibliotek, które rozciągają kramdown (pomysł od postmodernizmu).

Co nowego w wersji 1.0.0:

• 4 niewielkie zmiany:
• Nowe transliterated_header_ids opcja dla transliterating tekst nagłówka na ASCII przed wygenerowaniem ID nagłówka, który jest przydatny do języka jak Wietnamczyków (stała GH # 35, na wniosek Ky Anh)
• cudzysłów podmiot & quot; Teraz przechodzi na jego odpowiednik znaków podczas entity_output = as_char.
• Ostrzeżenie jest teraz wyjście dla IALS / ALDS nie zawierają atrybut Definition.
• Wyjście HTML przypis zmienił użyć klasy zamiast rel osiągnąć (X) HTML4 / 5 kompatybilność

Poprawki
• 3 błędów:
• Poprawiono GH # 38: Kodowanie problemu na 1.9 / 2.0 z powodu niezgodnych kodowania - ciąg źródłowy jest teraz zamienione na UTF-8 przed analizą i przekształcony z powrotem po konwersji (zgłoszony przez Szymona Lydell)
• Poprawiono RF # 29647: Skróty z nie słowo pierwszego znaku na początku tekstu z wyjątkiem ołowiu (zgłoszone przez Stephan Dale)
• Poprawiono RF # 29704: ID podane na nagłówkach typu ATX, nie zawsze były poprawnie wykrywane (zgłoszony przez Kyle Barbour)

Co nowego w wersji 0.14.2:

• 1 drobne zmiany:
• Nowe link_defs opcja dla-określających wcześniej definicji łącza
• 1 bug fix:
• Środki pozyskane błędy nagłówków ATX bez tekstu,

Co nowego w wersji 0.14.1:

• Tylko elementy HTML, które nie mogą zawierać korpus ( podobne) są przesyłane w tej formie, wszystkie inne elementy teraz używać wyraźnego znacznika zamykającego (rozwiązuje między innymi kwestii rzeczy)
• Określanie blok lal przed listy definicji działa poprawnie,
• Naprawiono błąd GH # 30: Puste ciało do definicji w liście definicji prowadzi do wyjątku (zgłoszone przez Mark Johnson)

Co nowego w wersji 0.14.0:

• 2 duże zmiany:
• język Kod jest teraz określona poprzez .language-CODELANG zamiast lang = "CODELANG"
• Zaimplementowano wsparcie dla ustawień języka na linii kodu ogrodzonym bloku startowym (wstępne poprawki przez Bran)
• 1 drobne zmiany:
• Nagłówki z identyfikatora można zapobiec pokazując w spisie treści, przypisując im klasy .no_toc (poprawki przez Tima Bates)
• 1 bug fix:
• numeryczna, a nie podmioty HTML symboliczne są teraz domyślnie awaryjna (Łata autorstwa Gioele Barabucci)

Co nowego w wersji 0.13.5:

• 2 niewielkie zmiany:
• atrybutów HTML bez wartości są teraz obsługiwane (poprawki błędów RF # 29490 zgłoszone przez Nat Welch)
• atrybutów HTML nazwy są teraz zawsze konwertowane na małe litery dla spójności

Poprawki
• 5 błędów:
• Poprawiono # method_missing dokumentu przyjęcia snake_cased nazwę klasy (poprawki przez tomykaira)
• Naprawiono problem z brakuje stałej REXML Ruby 1.8.6 na starszej wersji (zgłaszane przez Dave Everitt)
• Naprawiono błąd RF # 29520: Ważny inline oświadczenie matematyka nie powoduje już blok matematyki (zgłoszone przez Gioele Barabucci)
• Naprawiono błąd RF # 29521: wyjście HTML matematyka jest teraz zawsze XHTML kompatybilny (zgłoszone przez Gioele Barabucci)
• Puste atrybuty id są teraz obsługiwane lepiej konwertery HTML i kramdown (zgłoszonych przez Jorg Sommer)
• 1 Dokumentacja poprawka:
• Poprawiono niepoprawne opcje oświadczenie w przykładzie na szybkiej stronie odniesienia (zgłoszone przez Jorg Sommer)

Co nowego w wersji 0.13.4:

• Dodano konwerter, który wydobywa TOC dokumentu (wniosek Brendan Hay). Należy pamiętać, że jest to przydatne tylko w przypadku korzystania kramdown jako biblioteka!
• Poprawiono literówki: Należy --output i nie --ouput (Łata autorstwa postmodernizmu)
• Poprawiono poprawnie konwerter HTML do wyjścia puste znaczniki rozpiętości (płatkowe John croisant)
• Naprawiono błąd RF # 29350: analizowaniem tagów HTML z niedopasowane razie teraz działa,
• Naprawiono błąd RF # 29426: Treść tagów stylu jest traktowany jako surowego tekstu teraz
• konwerter HTML używa teraz rel zamiast obr być HTML5 kompatybilny (poprawka Joe Fiorini)
• Naprawiono Ruby 1.9.3 związane ostrzeżenia
• Poprawiono parser HTML do pracy wokół zmian realizacji Array # w Ruby 1.9.3 delete_if

Wymagania :

• Ruby