Szybka pomoc

Ściągawka z Middleman 3

Szybki przewodnik po Middleman v3: konfiguracja generatora stron statycznych, Compass, potoki zasobów, szablony i optymalizacja buildu.

· Opublikowano

[!NOTE] Wersja zarchiwizowana: Ta ściągawka dotyczy Middleman v3. W przypadku nowszych instalacji zapoznaj się z dokumentacją Middleman v4+.

Middleman to generator stron statycznych napisany w Ruby, korzystający z nowoczesnych standardów tworzenia stron.

Konfiguracja (config.rb)

Katalogi i zasoby (Assets)

set :css_dir, "stylesheets"
set :js_dir, "javascripts"
set :images_dir, "images"

# Automatyczne wymiary obrazów w helperze image_tag
activate :automatic_image_sizes

Integracja z Compass

compass_config do |config|
  config.output_style = :compact
end

Routing stron i szablony (Layouts)

# Wyłączenie layoutu dla szablonów HTML lub XML
page "/sitemap.xml", layout: false

# Przypisanie alternatywnego layoutu
page "/admin/*", layout: :admin_layout

# Grupowanie wielu ścieżek pod jednym layoutem
with_layout :docs do
  page "/guides/*"
  page "/api/*"
end

# Wirtualne strony proxy
page "/about.html", proxy: "/template-page.html" do
  @page_title = "About Us"
end

Własne helpery

helpers do
  def format_currency(amount)
    "$%.2f" % amount
  end
end

Konfiguracja buildu

Optymalizacja zasobów tylko podczas wykonywania middleman build:

configure :build do
  activate :minify_css
  activate :minify_javascript
  activate :cache_buster
  activate :relative_assets

  # Prefiksowanie ścieżki zasobów własnym CDN
  # set :http_path, "https://cdn.example.com/"
end

Materiały referencyjne

Powiązane tematy