Γρήγορη αναφορά

Συνοπτικός οδηγός Middleman 3

Ένας γρήγορος οδηγός αναφοράς για το Middleman v3: ρύθμιση γεννήτριας στατικών ιστοτόπων, Compass, διατάξεις και βελτιστοποιήσεις δόμησης.

· Δημοσιεύτηκε

[!NOTE] Αρχειοθετημένη έκδοση: Αυτός ο οδηγός καλύπτει το Middleman v3. Για νεότερες εγκαταστάσεις, ανατρέξτε στην τεκμηρίωση του Middleman v4+.

Το Middleman είναι μια γεννήτρια στατικών ιστοσελίδων γραμμένη σε Ruby χρησιμοποιώντας σύγχρονα πρότυπα ανάπτυξης ιστού.

Ρύθμιση παραμέτρων (config.rb)

Κατάλογοι & Στοιχεία (Assets)

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

# Αυτόματες διαστάσεις εικόνας στο image_tag helper
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

# Εικονικές σελίδες proxy
page "/about.html", proxy: "/template-page.html" do
  @page_title = "About Us"
end

Προσαρμοσμένοι βοηθοί (Helpers)

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

Ρύθμιση Δόμησης (Build Configuration)

Βελτιστοποίηση στοιχείων μόνο κατά την εκτέλεση του 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

Πηγές & Αναφορές

Σχετικά θέματα