kramdown

。

kramdownはのマークダウン＆NBSPスーパーセットを解析するために使用することができる無料のRubyのライブラリがあり、それは完全にRubyで書かれている、PHP Markdownのことで人気が行われている（いくつかのマイナーな変更を加えた）標準Markdownを、様々な拡張機能をサポートしていますエクストラパッケージとMaruku。
それは5倍Marukuより速く、BlueFeatherより約10倍高速である、おそらく最速純粋-ルビーマークダウンコンバータ（2009年11月）である。
kramdown構文はプレーンテキストでHTML文書を書くためのマークアップを読みやすいマークダウン、書くのは非常に簡単、に基づいています。基本的な記法の構文はいくつかの欠点を有しているため、実装が（特にPHP Markdownのエクストラパッケージ）は、追加の構文でこの欠点を克服しようとした。 kramdownは（いくつかのマイナーな修正ではあるが）、元のマークダウン構文だけでなく、PHP MarkdownをエクストラパッケージとMarukuに実装され新しい機能のすべての機能をサポートしています。
の使用方法：の
kramdownパッケージには、それを使用するための2つの方法を提供します：
*ライブラリとして
＆NBSP; kramdownはRedCloth、BlueClothとMarukuと基本的に同じAPIを使用しています。
＆NBSP; 'kramdown'を必要と
＆NBSP; Kramdown :: Document.new（テキスト）.to_html
＆NBSP;新しいコールの2番目のパラメータは、特定の機能を活性化するためのハッシュオプション（デ）である。詳細については、APIドキュメントを見てください。
*アプリケーションとして
＆NBSP;ライブラリはHTMLにkramdown構文でテキストを変換するために使用することができて出荷され、バイナリと呼ばれるkramdownを提出一緒に。これは、コマンドライン引数として指定したファイルまたは標準入力から読み込みます。例えば：
＆NBSP; kramdownパス/に/ kramdown / DOC / syntax.page

の何が新しいの今回のリリースで：

• 2マイナー変更内容：
• Githubの風味マークダウン（初期実装を提供したアルネBrasseurによってGH＃68を解決します）
のためのパーサを追加しました
• HTML属性が今水平線のために出力されます。
• 5のバグ修正：

テンプレートオプションを使用すると、
• は結果の文字列に正しいエンコーディングが今でも設​​定されてます。
• 固定のGH＃72、GH第74位：ヘッダIDを設定するには、すべての方法は、現在のHTMLのID（ドットが許可されていないことを除いて）（報告され、マッティ·シュナイダーによる最初のパッチ）に準拠している同じスキームます
• 固定たGH＃73：デフォルトのHTMLテンプレートは今DOCTYPEがあり、正しくエンコードを設定します（サイモンLydellによる初期パッチ）

<李は>固定GH第67位：リンク要素のURLは現在、の問題（ヘニングのPerlによるパッチ）を回避するために、LaTeXのコンバータでエスケープされます
• 固定GH第70位：stringexライブラリのすべてのバージョンがサポートされました（サイモンLydellによる報告）します。

のバージョン1.1.0でのの新機能：

• 2小変更：
• 脚注マーカーは現在、
（初期パッチを提供しセオドア朴によってGH＃62とGH＃63を解決します）を繰り返すことができる
• LaTeXの頭字語パッケージは今（初期パッチを提供しティムBesardによってGH＃55を解決します）
略語のために使用されている
• 3のバグ修正：
• 固定たGH＃60：（トレバーWennblomによってパッチ）アンダースコアに変換するときに番号が今単語文字に加えて、認識されます。

、HTML要素、そして今LaTeXのコンバータ（ヘニングのPerlによるパッチ）によって正しく変換されます：
• はGH＃66を修正
• 固定たGH＃57：アンダースコアは（ビルTozierによる報告）後、または引用符の前に直接あるより良いスマートクォート取り扱います。

テストページは相対時間を含むように更新されました。

のバージョン1.0.2でのの新機能であるベンチマークでは、より良い（ポストモダンが要求）kramdownのパフォーマンスを測定することが可能であるようにします。

• kramdownウィキは今kramdown（ポストモダンによるアイデア）を拡張するライブラリのリストが含まれます。

のバージョン1.0.0でのの新機能：

• 4軽微な変更：

ベトナム語のような言語に便利ですヘッダIDを生成する前にASCIIにヘッダーテキストをtransliteratingための
• 新しいオプションtransliterated_header_ids（固定たGH＃35、KYアンによって要求された）
• 引用符エンティティ＆QUOT。今、その文字と同等に変換されるときにentity_output = as_charます。
• 警告は今それぞれで独立の属性ではないが含まれIALS / ALDSが出力されます。
• のHTML脚注出力を達成するために代わりにRELのクラスを使用するように変更されている（X）HTML4 / 5互換ます。
• 3のバグ修正：
• 固定GH第38位：1.9 / 2.0互換性がないため、エンコーディングに上問題のエンコーディング - ソース文字列は、現在解析する前にUTF-8に変換し、変換した後に再度変換されます（サイモンLydellによる報告）します。
• 固定のRF＃の29647：（ステファンデールによる報告）例外のテキストリードの開始時に非単語の最初の文字と略語ます。
• 固定のRF＃の29704：ID ATXスタイルヘッダーに指定され、常に正確に検出されなかった（カイルバーバーによる報告）します。

のバージョン0.14.2のの新機能：

• 1マイナーチェンジ：

事前定義リンク定義のための
• 新しいオプションlink_defsます。
• 1バグ修正：
• テキストなしのATXヘッダーの上に固定された発生したエラーます。

の何がバージョン0.14.1のの新しいです：ボディを含めることはできません。

• のみHTML要素（この形式で出力されます）のように、他のすべての要素は現在、明示的な終了タグ（と他のものの問題の中で解決します）します。
を使用
• 定義リストが正常に動作する前にブロックIALを指定します。
• 固定バグのGH＃30：（マーク·ジョンソンによる報告）例外の定義リストのリードで定義するための空の身体ます。

のバージョン0.14.0のの新機能：

• 2主な変更点：
• コード言語は現在.language-CODELANGの代わりにLANG = 'CODELANG'
を介して指定されている
• （ブランによって初期パッチ）をフェンスで囲まれたコードブロックスタートライン上の言語を設定するための実装をサポートします。
• 1マイナーチェンジ：
• IDを持つヘッダは彼ら（ティム·ベイツによるパッチ）
に.no_tocクラスを割り当てることによって、TOCに表示することを防止することができる
• 1バグ修正：

代わりにシンボリックHTMLエンティティの
• 数値は、デフォルトのフォールバック（Gioele Barabucciによるパッチ）
である

のバージョン0.13.5のの新機能：

• 2小変更：

値がサポートされるようになりましたことなく、
• はHTML属性（ナット·ウェルチによって報告された修正のバグのRF＃29490）
• はHTMLは名前は今、常に一貫性のために小文字に変換されている属性がします。
• 5のバグ修正：

snake_casedクラス名（tomykairaによるパッチ）します​​。を受け入れるために
• 固定ドキュメント＃のmethod_missing
• （デイブエベリットによる報告）古いルビー1.8.6バージョンのREXMLを一定に不足している問題を修正します。
• 固定バグのRF＃29520：有効なインライン数学文は（Gioele Barabucciによる報告）もはや数学のブロックをトリガしません。
• 固定バグのRF＃の29521：HTML数学出力は今常にXHTML互換（Gioele Barabucciによる報告）します。
• 空のid属性は、現在（ヨルグ·ソマーによる報告）HTMLとkramdownコンバータによって、より良い処理されます。
• 1のドキュメントを修正した。
• （ヨルグ·ソマーによる報告）クイック·リファレンス·ページの例で修正された無効なoptionsステートメントます。

のバージョン0.13.4のの新機能：

• ドキュメントの目次を抽出し、コンバータを追加しました（ブレンダン·ヘイによって要求された）。あなたはライブラリとしてkramdown使用している場合、これはのみ有用であることに注意してください！
• 固定タイプミス：それは--outputと--ouputないでする必要があります（ポストモダンによるパッチ）
• 固定HTMLコンバータに正しく出力空のspanタグ（ジョンCroisantによるパッチ）
• は固定バグのRF＃29350：一致しない場合にHTMLタグの構文解析が動作するようになりました。
• 固定バグのRF＃29426：スタイルのタグのコンテンツは現在生のテキストとして扱われます。
• HTMLコンバータは現在、HTML5互換（ジョーFioriniによるパッチ）であるとREVの代わりにRELを使用しています。
• 固定のRuby 1.9.3に関する警告します。

ルビー1.9.3ます。のArray＃のdelete_ifの実装の変更を回避する
• 固定HTMLパーサー

の要件の

• ルビーます。