Middlemanを試してみた

静的サイトジェネレータの一つであるMiddlemanを使う機会があったのでメモ。

Jekyllやら、Octpressやら、黒い画面を使わない（らしい）Phestやら色々ありますが、今回は~~なんとなく~~Middlemanにしました。

Rubyの記法も何となく覚えられるので一石二鳥…なのだろうか。

Middlemanについて

RubyのフレームワークのSinatoraベースで作られていて、ERBだけじゃなくてHAMLやらSlimやらStylusやらSASSやらCofeescriptやら色々対応しているみたいです。
この辺りは他の静的ジェネレータでも恐らく一緒でしょうか？（使ったこと無いので分かりませんが…）

YAMLベースでテンプレート側に変数を渡す事が出来るので、プログラマブルに構築する際は結構便利な気がします。

ちなみに、インストールから初期設定については日本語ドキュメントが充実していて、公式サイトでかなり丁寧にかかれていますので、そこで事足りると思います。

後は個人的に詰まった所。

特に設定をしない場合は、ページリンクや読込のパスが絶対パスになりますが、最終的に公開する際にサブディレクトリにアップロードしたい時には面倒なことになるので、相対パスにしたい時があるかと思います。

そんな時もconfig.rbに二行加えるだけ。

# リンクを相対化
set :relative_links, true
# ファイル読込を相対化
activate :relative_assets

テキストリンクを作成する際は、

<%= link_to 'Link Text', '/path/to.html' %>

のように記述しますが、aタグ内に色々詰め込みたい時には不便です。
だからといって直にHTMLタグでパスを書いてしまってはジェネレータを使う利点が損なわれてしまうので、調べてみたところ下記のような記法がるようです。

<% link_to '/path/to.html' do %>
aタグ内に入れたい要素
<% end %>

同じような構造のHTMLを作る時に便利なパーシャルですが、PHPのrequireみたいに変数を引き継ぐわけではありません。むしろ、コチラの挙動が普通でしょうか？
ということで、partialに追記することで渡せます。

下記のように記述すると、 source/path/_to.erb に、foo という変数名で、 bar の値を引き継ぎます

<%= partial "path/to", :locals => { :foo => bar } %>

しかし、公式サイトにしっかり記載がありました。~~ちゃんとよく読みましょう。~~