Snabbreferens

Middleman 3 fusklapp

En snabb referensguide för Middleman v3: konfiguration av statisk webbplatsgenerator, Compass, layoutrouting och byggoptimeringar.

· Publicerad

[!NOTE] Arkiverad version: Denna fusklapp täcker Middleman v3. För nyare installationer, se dokumentationen för Middleman v4+.

Middleman är en generator för statiska webbplatser skriven i Ruby som använder moderna webbutvecklingsstandarder.

Konfiguration (config.rb)

Kataloger & Resurser (Assets)

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

# Automatiska bilddimensioner i image_tag-helpern
activate :automatic_image_sizes

Compass-integration

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

Sidrouting & Layouter

# Inaktivera layout för råa HTML- eller XML-mallar
page "/sitemap.xml", layout: false

# Tilldela alternativ layout
page "/admin/*", layout: :admin_layout

# Gruppera flera sökvägar under en layout
with_layout :docs do
  page "/guides/*"
  page "/api/*"
end

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

Anpassade helpers

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

Byggkonfiguration

Optimera endast resurser vid körning av middleman build:

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

  # Prefix för resurser med anpassad CDN-sökväg
  # set :http_path, "https://cdn.example.com/"
end

Referenser

Relaterade ämnen