[!NOTE] Versione archiviata: Questa guida riguarda Middleman v3. Per installazioni più recenti, fare riferimento alla documentazione di Middleman v4+.
Middleman è un generatore di siti statici scritto in Ruby che utilizza gli standard moderni di sviluppo web.
Configurazione (config.rb)
Directory e Asset
set :css_dir, "stylesheets"
set :js_dir, "javascripts"
set :images_dir, "images"
# Dimensioni automatiche delle immagini nel tag helper
activate :automatic_image_sizes
Integrazione con Compass
compass_config do |config|
config.output_style = :compact
end
Routing di pagine e layout
# Disabilita layout per template HTML o XML grezzi
page "/sitemap.xml", layout: false
# Assegna layout alternativo
page "/admin/*", layout: :admin_layout
# Raggruppa più percorsi sotto un unico layout
with_layout :docs do
page "/guides/*"
page "/api/*"
end
# Pagine proxy simulate
page "/about.html", proxy: "/template-page.html" do
@page_title = "About Us"
end
Helper personalizzati
helpers do
def format_currency(amount)
"$%.2f" % amount
end
end
Configurazione di Build
Ottimizza gli asset solo durante l'esecuzione di middleman build:
configure :build do
activate :minify_css
activate :minify_javascript
activate :cache_buster
activate :relative_assets
# Prefisso degli asset con percorso CDN personalizzato
# set :http_path, "https://cdn.example.com/"
end