Middleman
急遽静的Webページを作ることになった。元々あるPukiWikiのデータを移行するのが目的。JekyllにするかMiddlemanにするかでちょっと悩んだけれども、
- Jekyllの日付ベースのサイト構成は今回のケースには合わないのではないか?
という判断の元、今回はMiddlemanにすることにした。
使用バージョン
今回使用したのは4.2.1。
インストール
何はともあれインストール。
$ gem install middleman
でOK。
サイトの作成
次にプロジェクトページを作る。
$ middleman init プロジェクト名
でプロジェクト名のディレクトリができ、そこにGemfile
やらconfig.rb
などが作られる。
Middleman: Starting a New Site
記事を書いていく
source
ディレクトリ以下に記事やレイアウト、CSSなどを書いていく形。
Middleman: Directory Structure
記事はデフォルトではerbで書くようだが、Markdownでも書ける。config.rb
に
set :markdown_engine, :redcarpet set :markdown, :fenced_code_blocks => true, :smartypants => true
という記述をし、Gemfile
にgem 'redcarpet'
を追加してbundle install
すればOK。記事のフィアル名をhoge.html.md
とかにするとMarkdownとして解析される。
Middleman: Template Engine Options
リリース
HTMLを吐かせるのは
$ middleman build
でOK。
雑感
ドキュメントがかなり整備されているので特に戸惑うことなくサクサク進むことができた。
このあとはレイアウトページを作る必要があるのだが、もらったレイアウトがTableレイアウトなのではてさてどうしようかなと思っているところ。