[!NOTE] Version archivée: Cet aide-mémoire couvre Middleman v3. Pour les versions plus récentes, consultez la documentation de Middleman v4+.
Middleman est un générateur de sites statiques écrit en Ruby utilisant les standards modernes du développement web.
Configuration (config.rb)
Répertoires et Assets
set :css_dir, "stylesheets"
set :js_dir, "javascripts"
set :images_dir, "images"
# Dimensions automatiques sur le helper image_tag
activate :automatic_image_sizes
Intégration de Compass
compass_config do |config|
config.output_style = :compact
end
Routage de pages & Layouts
# Désactiver le layout pour les templates HTML ou XML bruts
page "/sitemap.xml", layout: false
# Assigner un layout alternatif
page "/admin/*", layout: :admin_layout
# Regrouper plusieurs chemins sous un même layout
with_layout :docs do
page "/guides/*"
page "/api/*"
end
# Pages proxy virtuelles
page "/about.html", proxy: "/template-page.html" do
@page_title = "About Us"
end
Helpers personnalisés
helpers do
def format_currency(amount)
"$%.2f" % amount
end
end
Configuration de build
Optimiser les assets uniquement lors de l'exécution de middleman build :
configure :build do
activate :minify_css
activate :minify_javascript
activate :cache_buster
activate :relative_assets
# Préfixer les assets avec une URL CDN personnalisée
# set :http_path, "https://cdn.example.com/"
end