[!NOTE] Versão Arquivada: Esta folha de dicas cobre o Middleman v3. Para instalações mais novas, consulte a documentação do Middleman v4+.
O Middleman é um gerador de sites estáticos escrito em Ruby utilizando os padrões modernos de desenvolvimento web.
Configuração (config.rb)
Diretórios e Assets
set :css_dir, "stylesheets"
set :js_dir, "javascripts"
set :images_dir, "images"
# Dimensões automáticas de imagem no helper image_tag
activate :automatic_image_sizes
Integração com Compass
compass_config do |config|
config.output_style = :compact
end
Roteamento de Páginas e Layouts
# Desativar layout para templates HTML ou XML puros
page "/sitemap.xml", layout: false
# Atribuir layout alternativo
page "/admin/*", layout: :admin_layout
# Agrupar múltiplos caminhos sob um mesmo 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
Configuração de Build
Otimizar assets apenas ao executar middleman build:
configure :build do
activate :minify_css
activate :minify_javascript
activate :cache_buster
activate :relative_assets
# Prefixar assets com caminho CDN personalizado
# set :http_path, "https://cdn.example.com/"
end