ورقة غش Jekyll على GitHub Pages

مرجع سريع لإعداد ونشر مواقع Jekyll الساكنة على استضافة GitHub Pages.

بنية المجلدات

.
├── _config.yml       # إعدادات الموقع
├── _includes/        # مقتطفات قوالب قابلة لإعادة الاستخدام
├── _layouts/         # تخطيطات الصفحات الأساسية
├── _posts/           # مقالات المدونة (YYYY-MM-DD-title.md)
├── _sass/            # جزئيات أنماط SASS / SCSS
├── assets/           # الصور والأنماط المترجمة وJS
└── index.md          # محتوى الصفحة الرئيسية

الإعداد (_config.yml)

title: My Documentation
description: Quick reference cheatsheets
baseurl: "/my-repo"
url: "https://username.github.io"

# اعتماديات GitHub Pages
plugins:
  - jekyll-feed
  - jekyll-seo-tag
  - jekyll-sitemap

markdown: kramdown
theme: minima

ترويسة Frontmatter

---
layout: post
title: "Getting Started with Jekyll"
date: 2026-10-25 12:00:00 +0000
categories: [development, tools]
tags: [jekyll, static-site]
---

أدوات قوالب Liquid المساعدة

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

{{ site.title }}
{{ page.title }}
{{ content }}

الشرطيات والحلقات

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

<ul>
  {% for post in site.posts limit:5 %}
    <li><a href="{{ post.url | relative_url }}">{{ post.title }}</a></li>
  {% endfor %}
</ul>

الاختبار المحلي

# تثبيت الاعتماديات
bundle install

# تشغيل خادم التطوير المحلي مع التحديث التلقائي
bundle exec jekyll serve --livereload