مرجع سريع

ورقة غش مولد المواقع الساكنة Jekyll

دليل مرجعي شامل لـ Jekyll: بنية المجلدات، وترويسة YAML الأمامية، ووسوم وفلاتر Liquid، والمتغيرات، والمجموعات، وإعداد GitHub Pages.

· تاريخ النشر

Jekyll هو مولد مواقع ساكنة موجه للمدونات ومكتوب بلغة Ruby، ويشغل خدمة GitHub Pages.

تخطيط المجلدات

├── _config.yml      # الإعدادات العامة للموقع
├── _drafts/         # مسودات المقالات غير المنشورة
├── _includes/       # مقاطع قوالب قابلة لإعادة الاستخدام
├── _layouts/        # أغلفة تخطيط الصفحات والمقالات
├── _posts/          # المقالات المنشورة (YYYY-MM-DD-title.md)
├── _data/           # ملفات بيانات JSON/YAML منظمة
├── _site/           # مخرجات HTML الساكنة المبنية
└── index.md         # ملف الصفحة الرئيسية

ترويسة YAML الأمامية

---
layout: post
title: "Announcing Version 2.0"
date: 2026-11-08 10:00:00 +0800
categories: news tech
tags: [release, ruby]
published: true
---

صياغة قوالب Liquid

الإخراج والمتغيرات

{{ site.title }}
{{ page.title }}
{{ content }}
{{ post.date | date: "%B %d, %Y" }}

التحكم بالتدفق والتكرار

{% if page.comments %}
  {% include comments.html %}
{% endif %}

{% for post in site.posts limit:5 %}
  <h2><a href="{{ post.url }}">{{ post.title }}</a></h2>
  <p>{{ post.excerpt }}</p>
{% endfor %}

الفلاتر الشائعة

الفلتر الوصف المثال
date: "%Y-%m-%d" تنسيق الطابع الزمني {{ page.date | date: "%Y" }}
truncate: 100 اقتطاع النص مع علامة الحذف {{ post.content | truncate: 100 }}
strip_html إزالة كافة وسوم HTML {{ post.content | strip_html }}
jsonify تحويل البيانات إلى نص JSON {{ site.data.authors | jsonify }}
markdownify تحويل Markdown إلى HTML {{ text | markdownify }}

مرجع المتغيرات العامة

  • site.posts: قائمة زمنية عكسية لجميع المقالات.
  • site.pages: قائمة جميع الصفحات الساكنة.
  • site.html_pages: مجموعة فرعية من site.pages تنتج HTML.
  • site.data: بيانات خام محملة من ملفات _data/*.yml.
  • site.time: الطابع الزمني لعملية البناء الحالية.

المراجع

موضوعات ذات صلة