[!NOTE] Архивная версия: Эта шпаргалка описывает Middleman v3. Для новых установок обратитесь к документации Middleman v4+.
Middleman — это генератор статических сайтов на Ruby, использующий современные подходы веб-разработки.
Конфигурация (config.rb)
Директории и ассеты
set :css_dir, "stylesheets"
set :js_dir, "javascripts"
set :images_dir, "images"
# Автоматические атрибуты размеров изображений в хелпере image_tag
activate :automatic_image_sizes
Интеграция с Compass
compass_config do |config|
config.output_style = :compact
end
Маршрутизация страниц и макеты (Layouts)
# Отключить макет для чистого HTML или XML
page "/sitemap.xml", layout: false
# Назначить альтернативный макет
page "/admin/*", layout: :admin_layout
# Сгруппировать несколько путей под одним макетом
with_layout :docs do
page "/guides/*"
page "/api/*"
end
# Прокси-страницы на основе шаблонов
page "/about.html", proxy: "/template-page.html" do
@page_title = "About Us"
end
Пользовательские хелперы
helpers do
def format_currency(amount)
"$%.2f" % amount
end
end
Конфигурация сборки (Build)
Оптимизация ассетов только при выполнении команды middleman build:
configure :build do
activate :minify_css
activate :minify_javascript
activate :cache_buster
activate :relative_assets
# Префикс путей ассетов для CDN
# set :http_path, "https://cdn.example.com/"
end