miyohideの日記

技術的なメモなどを記しています

2018年12月18日(火)

Middleman

急遽静的Webページを作ることになった。元々あるPukiWikiのデータを移行するのが目的。JekyllにするかMiddlemanにするかでちょっと悩んだけれども、

  • Jekyllの日付ベースのサイト構成は今回のケースには合わないのではないか?

という判断の元、今回はMiddlemanにすることにした。

使用バージョン

今回使用したのは4.2.1。

インストール

何はともあれインストール。

$ gem install middleman

でOK。

Middleman: Installation

サイトの作成

次にプロジェクトページを作る。

$ 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

という記述をし、Gemfilegem 'redcarpet'を追加してbundle installすればOK。記事のフィアル名をhoge.html.mdとかにするとMarkdownとして解析される。

Middleman: Template Engine Options

リリース

HTMLを吐かせるのは

$ middleman build

でOK。

Middleman: Build & Deploy

雑感

ドキュメントがかなり整備されているので特に戸惑うことなくサクサク進むことができた。

このあとはレイアウトページを作る必要があるのだが、もらったレイアウトがTableレイアウトなのではてさてどうしようかなと思っているところ。