blog
初めての Middleman シリーズ初めてのMiddleman：Markdown EngineをkramdownからRedcarpetに切り替える
この記事は書かれてから1年以上経過しており、内容が古い場合があります。
今回はMarkdownEngineをデフォルトのkramdownからRedcarpetに切り替えてみたいと思います。kramdownはCustom attribute（idやclass, title等）を付けられるのが最大の利点でRedcarpetではできないのですが、Githubと同じ記法で書けることを優先する場合、Redcarpetを使う方も多いようです。
Skeletonを用意する
とりあえず適当にSkeletonを用意します。
$ middleman init redcarpet.middleman --template=middleman-blog.skeleton
Gemfile
Gemfileにredcarpetを加えて$ bundle installします。
gem 'redcarpet'
config.rb
ここからがMarkdown Engineを切り替える指定になります。set :markdown_engine, :kramdownをコメントアウトし、下の2行を追加します。
# set :markdown_engine, :kramdown
set :markdown_engine, :redcarpet
set :markdown, :fenced_code_blocks => true, :smartypants => true, :with_toc_data => true, :tables => true, :autolink => true, :gh_blockcode => true
set :markdown_engine, :redcarpetでredcarpetを有効化し、set :markdown, :...でredcarpetのオプションを有効にします。オプションはgithubを参照。
これでredcarpetが使えるようになります。
次回：初めてのMiddleman：RedcarpetとMiddleman::Rougeを使ったシンタックスハイライト
参考
シリーズ
- 初めてのMiddleman：rbenv, bundler 環境でMiddlemanを使ったHello World
- 初めてのMiddleman：レイアウト機能でレイアウトとコンテンツを分離する
- 初めてのMiddleman：パーシャルを使ったコンテンツのモジュール化
- 初めてのMiddleman：SCSSのコンパイルとテンプレートの基礎
- 初めてのMiddleman：Sass MixinライブラリのBourbon, Neatを導入してみる
- 初めてのMiddleman：データファイルとデータファイルを使った動的ページ生成
- 初めてのMiddleman：サイトにブログ機能を追加する
- 初めてのMiddleman：Amazon S3にビルドされたファイルを同期する
- 初めてのMiddleman：HTML/CSS/JS/画像をビルド時に圧縮する
- 初めてのMiddleman：設定について
- 初めてのMiddleman：静的サイトのキャッシュとasset_hash拡張を使ったキャッシュのパージ
- 初めてのMiddleman：Middleman::S3Syncで使うAWS IAMユーザーのアクセスキー管理方法について
- 初めてのMiddleman：Helperを使ってGravatarのアイコンを表示する
- 初めてのMiddleman：アセットパイプラインを使った外部アセットファイルの読み込みと結合
- 初めてのMiddleman：Bowerを使ってjQueryなどのライブラリをロードする
- 初めてのMiddleman：スケルトンを自作する方法
- 初めてのMiddleman：Middleman Blogの記事データを使いやすく管理する方法
- 初めてのMiddleman：Middleman-blogのシングルブログを前提としたSkeletonを作った
- 初めてのMiddleman：Middleman-blogでマルチブログを試してSkeletonを作った
- 初めてのMiddleman：Markdown EngineをkramdownからRedcarpetに切り替える
- 初めてのMiddleman：RedcarpetとMiddleman::Rougeを使ったシンタックスハイライト
- 初めてのMiddleman：Middleman-Syntaxを使ったシンタックスハイライト
- 初めてのMiddleman：Middleman-Blogで記事毎に画像を管理する方法
- 初めてのMiddleman：Gulpを使ってサムネイル画像を生成する
- 初めてのMiddleman：Middleman-OGPのOGP画像指定を相対パスで設定する
- 初めてのMiddleman：Middleman-OGPでMiddleman-BLogにOGPを設定する
- 初めてのMiddleman：Middleman-Titleでタイトルタグを手軽に設定する
- 初めてのMiddleman：多言語化 - 言語ファイルの作成とヘルパーの埋め込み
- 初めてのMiddleman：Middleman-blogにカテゴリやシリーズなどのカスタムコレクションを追加する方法
- 初めてのMiddleman：Bowerで管理されているフォントファイルをインポートする