ورقة غش Middleman 3

[!NOTE] إصدار مؤرشف: تغطي هذه الورقة الإصدار Middleman v3. للمشاريع الأحدث، راجع وثائق Middleman v4+.

Middleman هو مولد مواقع ثابتة مكتوب بلغة Ruby يوفر أفضل معايير واختصارات تطوير الويب الحديثة.

الإعدادات (config.rb)

المجلدات والأصول (Directories & Assets)

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

# صفحات وكيلة وهمية (Fake proxy pages)
page "/about.html", proxy: "/template-page.html" do
  @page_title = "About Us"
end

---

دوال المساعدة المخصصة (Custom 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

---

مراجع

• مولد المواقع الثابتة Middleman