[!NOTE] Versiune arhivată: Această fișă de referință acoperă Middleman v3. Pentru versiuni mai noi, consultați documentația Middleman v4+.
Middleman este un generator de site-uri statice scris în Ruby, utilizând standardele moderne de dezvoltare web.
Configurare (config.rb)
Directoare și Resurse (Assets)
set :css_dir, "stylesheets"
set :js_dir, "javascripts"
set :images_dir, "images"
# Dimensiuni automate ale imaginilor în helperul image_tag
activate :automatic_image_sizes
Integrare cu Compass
compass_config do |config|
config.output_style = :compact
end
Rutarea paginilor și Layout-uri
# Dezactivare layout pentru șabloane HTML sau XML brute
page "/sitemap.xml", layout: false
# Alocare layout alternativ
page "/admin/*", layout: :admin_layout
# Grupare căi multiple sub un singur layout
with_layout :docs do
page "/guides/*"
page "/api/*"
end
# Pagini proxy simulate
page "/about.html", proxy: "/template-page.html" do
@page_title = "About Us"
end
Helperi personalizați
helpers do
def format_currency(amount)
"$%.2f" % amount
end
end
Configurarea compilării (Build)
Optimizarea resurselor doar la rularea middleman build:
configure :build do
activate :minify_css
activate :minify_javascript
activate :cache_buster
activate :relative_assets
# Prefixare resurse cu cale CDN personalizată
# set :http_path, "https://cdn.example.com/"
end