[Middleman 3] Middleman: Asset Pipeline に関連する helper

memo.

パスまわりで混乱して後ではまりそうな気もするので、調べた内容をまとめておきます。
検証していない。
Middleman でも Rails のようにテンプレートヘルパーが利用できて、以前にいくつか確認しました。

• Middleman: テンプレートヘルパ
• Middleman: 公式サイトで紹介されている機能を確認する | deadwood

先ほど見つけたこちらが一覧できて分かりやすかったです。

• Ruby – MiddleMan入門 – Qiita

image-url, font-url

公式ドキュメントの最後の方にちらっとこのように書いてあります。

*.scss ファイルの中で利用できるヘルパがあります:

• image-path(), image-url()
• font-path(), font-url()

よくよく見てみると、SASS や Compass で利用していたヘルパーと同じように動くよう。

• Compass URL Helpers | Compass Documentation
• Sass-based Configuration Options | Compass Documentation

このあたりも relative_assets を有効化する必要がありそう。

#Use relative URLs
activate :relative_assets

• Compass/Middleman image-url isn’t working – Stack Overflow

Middleman にも関連してくるので、compass_config の外で有効化しておく感じでしょうか。

• Middleman: Asset Pipeline | deadwood

:asset_hash

公式ドキュメントの最後の最後にこのように書いてあります。

image-url のような Sprockets パスヘルパは Middleman のサイトマップにフックされるので, その他の拡張( :asset_hash のような) もスタイルシートに影響します。

asset_cache_buster ですが、おそらく Compass とぶつからないように勝手に配慮してくれるはず。

• Configuration Reference | Compass Documentation
• 仕事で使うcompass設定いろいろ | september creator

こういう形で動くようです。

• Ruby – middlemanのasset_hashをscssやjsで使う方法 – Qiita

JavaScript を .erb にすると asset_path が使えるとか、:asset_host というものがあるとかもこちらで紹介されていました。