[!NOTE] Versión Archivada: Esta chuleta cubre Middleman v3. Para instalaciones más recientes, consulta la documentación de Middleman v4+.
Middleman es un generador de sitios estáticos escrito en Ruby que utiliza estándares modernos de desarrollo web.
Configuración (config.rb)
Directorios y Recursos (Assets)
set :css_dir, "stylesheets"
set :js_dir, "javascripts"
set :images_dir, "images"
# Etiquetas de dimensiones automáticas en helper image_tag
activate :automatic_image_sizes
Integración con Compass
compass_config do |config|
config.output_style = :compact
end
Enrutamiento de Páginas y Layouts
# Desactivar layout para plantillas HTML o XML sin procesar
page "/sitemap.xml", layout: false
# Asignar layout alternativo
page "/admin/*", layout: :admin_layout
# Agrupar múltiples rutas bajo un mismo layout
with_layout :docs do
page "/guides/*"
page "/api/*"
end
# Páginas proxy simuladas
page "/about.html", proxy: "/template-page.html" do
@page_title = "About Us"
end
Helpers Personalizados
helpers do
def format_currency(amount)
"$%.2f" % amount
end
end
Configuración de Compilación (Build)
Optimizar recursos solo al ejecutar middleman build:
configure :build do
activate :minify_css
activate :minify_javascript
activate :cache_buster
activate :relative_assets
# Prefijar recursos con ruta CDN personalizada
# set :http_path, "https://cdn.example.com/"
end