[!NOTE] Archivierte Version: Dieser Spickzettel behandelt Middleman v3. Für neuere Installationen konsultieren Sie bitte die Middleman v4+ Dokumentation.
Middleman ist ein in Ruby geschriebener statischer Seitengenerator, der moderne Webentwicklungskonventionen nutzt.
Konfiguration (config.rb)
Verzeichnisse & Assets
set :css_dir, "stylesheets"
set :js_dir, "javascripts"
set :images_dir, "images"
# Automatische Bildabmessungen beim image_tag Helper
activate :automatic_image_sizes
Compass-Integration
compass_config do |config|
config.output_style = :compact
end
Seiten-Routing & Layouts
# Layout für reine HTML- oder XML-Templates deaktivieren
page "/sitemap.xml", layout: false
# Alternatives Layout zuweisen
page "/admin/*", layout: :admin_layout
# Mehrere Pfade unter einem Layout gruppieren
with_layout :docs do
page "/guides/*"
page "/api/*"
end
# Fake Proxy-Seiten
page "/about.html", proxy: "/template-page.html" do
@page_title = "About Us"
end
Benutzerdefinierte Helper
helpers do
def format_currency(amount)
"$%.2f" % amount
end
end
Build-Konfiguration
Assets nur beim Ausführen von middleman build optimieren:
configure :build do
activate :minify_css
activate :minify_javascript
activate :cache_buster
activate :relative_assets
# Assets mit benutzerdefiniertem CDN-Pfad voranstellen
# set :http_path, "https://cdn.example.com/"
end