so simple theme

موضوع Jekyll بسيط جدًا

So Simple هو موضوع Jekyll بسيط لكلماتك وصورك. بنيت لتوفير:

• مجموعة متنوعة من التخطيطات مع الطباعة النظيفة والقابلة للقراءة.
• ترميز Microformats لجعل محتوى المنشور قابلاً للقراءة والاكتشاف بواسطة الآلة.
• تعليقات Disqus ودعم Google Analytics.
• أفضل ممارسات تحسين محركات البحث (SEO) عبر علامة Jekyll SEO.
• خيارات لتخصيص السمة وجعلها خاصة بك.

تعرف على الجديد في سجل التغيير. وثائق الإصدار الثاني .

صفحات العينة

وصف
منشور به صورة بطل كبيرة.	معاينة	مصدر
منشور يحتوي على مجموعة متنوعة من عناصر HTML الشائعة يوضح كيفية تصميم السمة لها.	معاينة	مصدر
مشاركة تعرض الكود المميز.	معاينة	مصدر
منشور يعرض صورًا بمحاذاة متنوعة.	معاينة	مصدر
جميع المشاركات مجمعة حسب السنة.	معاينة	مصدر
جميع المشاركات مجمعة حسب الفئة.	معاينة	مصدر
جميع المشاركات مجمعة حسب العلامة.	معاينة	مصدر
صفحة الفئة.	معاينة	مصدر
قائمة الوثائق في عرض الشبكة.	معاينة	مصدر

يمكن عرض منشورات عينة إضافية على الموقع التجريبي. يمكن العثور على الملفات المصدر لهذه (والموقع التجريبي بأكمله) في مجلد /docs .

تثبيت

إذا كنت تقوم بتشغيل Jekyll v3.5+ وتستضيف نفسك بنفسك، فيمكنك تثبيت السمة بسرعة كجوهرة روبي. إذا كنت تستضيف صفحات GitHub، فيمكنك التثبيت كموضوع بعيد أو نسخ جميع ملفات السمات مباشرة (انظر الهيكل أدناه) إلى مشروعك.

طريقة روبي جوهرة

1. أضف هذا السطر إلى Gemfile الخاص بموقع Jekyll (أو قم بإنشاء واحد):

    gem "jekyll-theme-so-simple"

2. أضف هذا السطر إلى ملف _config.yml الخاص بموقع Jekyll:

    theme : jekyll-theme-so-simple

3. ثم قم بتشغيل Bundler لتثبيت جوهرة السمة وتبعياتها:

    bundle install
   

طريقة صفحات جيثب

أضافت صفحات GitHub الدعم الكامل لأي سمة مستضافة على GitHub.

1. استبدل gem "jekyll" بـ:

    gem "github-pages" , group : :jekyll_plugins

2. قم بتشغيل bundle update وتحقق من تثبيت جميع الأحجار الكريمة بشكل صحيح.

3. قم بإضافة remote_theme: "mmistakes/[email protected]" إلى ملف _config.yml الخاص بك. قم بإزالة أي theme: أو remote_theme: الإدخالات.

---

ملاحظة: يجب أن يكون موقع Jekyll الخاص بك قابلاً للعرض على الفور على http://USERNAME.github.io. إذا لم يكن الأمر كذلك، فيمكنك فرض إعادة البناء عن طريق دفع الالتزامات الفارغة إلى GitHub (انظر أدناه لمزيد من التفاصيل).

إذا كنت تستضيف العديد من المواقع المستندة إلى Jekyll تحت نفس اسم مستخدم GitHub، فسيتعين عليك استخدام صفحات المشروع بدلاً من صفحات المستخدم. تقوم بشكل أساسي بإعادة تسمية الريبو إلى شيء آخر غير USERNAME.github.io وإنشاء فرع gh-pages خارج master . لمزيد من التفاصيل حول كيفية عمل ذلك، راجع وثائق GitHub.

إزالة غير الضرورية

إذا قمت بتقسيم أو تنزيل مستودع so-simple-theme فيمكنك إزالة الملفات والمجلدات التالية بأمان:

• .github
• docs
• example
• .editorconfig
• .gitattributes
• banner.js
• CHANGELOG.md
• Gemfile
• jekyll-theme-so-simple.gemspec
• package.json
• Rakefile
• README.md
• README-OLD.md
• screenshot.png

الترقية

إذا كنت تستخدم Ruby Gem أو إصدارات السمات البعيدة من So Simple، فإن الترقية تكون غير مؤلمة إلى حد ما.

للتحقق من الإصدار الذي تستخدمه حاليًا، اعرض مصدر موقعك الذي تم إنشاؤه ويجب عليك شيئًا مشابهًا لما يلي:

 <!--
    So Simple Jekyll Theme 3.0.0
    Copyright 2013-2018 Michael Rose - mademistakes.com | @mmistakes
    Free for personal and commercial use under the MIT license
    https://github.com/mmistakes/so-simple-theme/blob/master/LICENSE
-->

سيكون هذا في أعلى كل ملف .html و /assets/css/main.css و /assets/js/main.js .

روبي جوهرة

ما عليك سوى تشغيل bundle update إذا كنت تستخدم Bundler (لديك Gemfile ) أو gem update jekyll-theme-so-simple إذا لم تكن كذلك.

الموضوع البعيد

تأكد من أن لديك أحدث إصدار تم تعيينه في _config.yml

 remote_theme: "mmistakes/[email protected]"

ملاحظة: إذا تم حذف @xxx ، فسيتم استخدام الفرع master الحالي للقالب. يُنصح بـ "قفل" remote_theme في إصدار محدد لتجنب إدخال تغييرات جذرية على موقعك.

تتطلب الخطوة التالية إعادة بناء موقع صفحات GitHub الخاص بك حتى يتمكن من سحب آخر تحديثات السمات. يمكن تحقيق ذلك عن طريق زيادة الالتزام بمستودع GitHub الخاص بك.

سيؤدي الالتزام الفارغ إلى إنجاز المهمة أيضًا إذا لم يكن لديك أي شيء تدفعه في الوقت الحالي:

 git commit --allow-empty -m "Force rebuild of site"

استخدم جيت

إذا كنت ترغب في تحقيق أقصى استفادة من سير عمل Jekyll + GitHub Pages، فستحتاج إلى استخدام Git. لسحب تحديثات السمات يدويًا، يجب عليك أولاً التأكد من وجود جهاز تحكم عن بعد للمصدر. إذا قمت بتشعب الريبو الخاص بالموضوع، فمن المحتمل أن تبدأ.

للتحقق مرة أخرى، قم بتشغيل git remote -v وتحقق من أنه يمكنك الجلب من origin https://github.com/mmistakes/so-simple-theme.git .

لإضافته يمكنك القيام بما يلي:

 git remote add upstream https://github.com/mmistakes/so-simple-theme.git

هدم التحديثات

يمكنك الآن سحب أي التزامات تم إجراؤها على الفرع master للسمة باستخدام:

 git pull upstream master

اعتمادًا على مقدار التخصيصات التي أجريتها بعد التفرع، من المحتمل أن تكون هناك تعارضات دمج. تعامل مع أي ملفات متعارضة تضع علامات Git عليها، وقم بتنظيم التغييرات التي ترغب في الاحتفاظ بها، ثم قم بتنفيذها.

تحديث الملفات يدويا

هناك طريقة أخرى للتعامل مع التحديثات وهي تنزيل السمة --- واستبدال التخطيطات والتضمينات والأصول بالتخطيطات الأحدث يدويًا. للتأكد من عدم تفويت أي تغييرات، قم بمراجعة سجل الالتزام الخاص بالموضوع لمعرفة ما تغير.

فيما يلي قائمة مرجعية سريعة بالمجلدات/الملفات المهمة التي يجب أن تضعها في الاعتبار:

اسم
_layouts	استبدال الكل. قم بتطبيق التعديلات إذا قمت بتخصيص أي تخطيطات.
_includes	استبدال الكل. قم بتطبيق التعديلات إذا قمت بتخصيص أي تضمينات.
assets	استبدال الكل. قم بتطبيق التعديلات إذا قمت بتخصيص أوراق الأنماط أو البرامج النصية.
_sass	استبدال الكل. قم بتطبيق التعديلات إذا قمت بتخصيص أجزاء Sass.
_data/navigation.yml	آمنة للحفاظ عليها. التحقق من عدم وجود تغييرات أو إضافات هيكلية كبيرة.
_data/text.yml	آمنة للحفاظ عليها. التحقق من عدم وجود تغييرات أو إضافات هيكلية كبيرة.
_config.yml	آمنة للحفاظ عليها. التحقق من عدم وجود تغييرات أو إضافات هيكلية كبيرة.

---

ملاحظة: إذا كنت لا ترى الإصدار الأحدث، فتأكد من مسح ذاكرة التخزين المؤقت للمتصفح وCDN. اعتمادًا على بيئة الاستضافة لديك، قد يتم تخزين الإصدارات القديمة من /assets/css/main.css أو /assets/js/main.min.js أو ملفات *.html في ذاكرة التخزين المؤقت.

بناء

يتم وضع التخطيطات والأجزاء وأجزاء Sass وملفات البيانات في مواقعها الافتراضية. يمكن العثور على أوراق الأنماط والبرامج النصية في assets ، وبعض الملفات المتعلقة بالتطوير في الدليل الجذر للمشروع.

يرجى ملاحظة: إذا قمت بتثبيت So Simple عبر Ruby Gem أو طرق السمة البعيدة، فستكون ملفات السمات الموجودة في /_layouts و /_includes و /_sass و /assets مفقودة من مشروعك. هذا أمر طبيعي حيث أنها مجمعة مع جوهرة jekyll-theme-so-simple .

 ├── _data               # data files
|  ├── navigation.yml   # navigation bar links
|  └── text.yml         # theme text
├── _includes           # theme includes
├── _layouts            # theme layouts (see below for usage)
├── _sass               # Sass partials
├── assets
|  ├── css
|  |  └── main.scss
|  └── js
|     └── main.min.js
├── _config.yml         # sample configuration
└── index.md            # sample home page (recent posts/not paginated)

البدء من جديد

بعد إنشاء ملف Gemfile وتثبيت السمة، ستحتاج إلى إضافة الملفات التالية وتعديلها:

• _config.yml
• /_data/navigation.yml
• /_data/text.yml
• index.md

ملاحظة: راجع وثائق ترقيم الصفحات أدناه للحصول على إرشادات حول كيفية تمكينها على الصفحة الرئيسية.

بدءًا من jekyll new

سيؤدي استخدام الأمر jekyll new إلى تشغيله بشكل أسرع.

قم بتحرير ملفات Gemfile و_ _config.yml باتباع دليل التثبيت أعلاه ودليل التكوين أدناه، ثم قم بإنشاء _data/text.yml وفقًا للتعليمات السابقة.

تكوين

يتم تكوين العناصر على مستوى الموقع ( locale ، title ، description ، url ، logo ، author ، وما إلى ذلك) في _config.yml الخاص بمشروعك. راجع تكوين المثال في هذا الريبو للحصول على مرجع إضافي.

اسم	وصف	مثال
locale	اللغة الأساسية للموقع.	"en-us"
title	عنوان الموقع.	"My Awesome Site"
description	وصف قصير.	"This is my site, it is awesome."
baseurl	يُستخدم لاختبار موقع الويب تحت نفس عنوان URL الأساسي الذي سيتم نشره عليه.	/my-base-path
url	عنوان URL الكامل لموقعك.	"https://your-site.com"
logo	المسار إلى شعار على مستوى الموقع يُستخدم في إعلان التسمية الرئيسية.	/images/your-logo.png

جلد الموقع

تتوفر ثلاثة أشكال (افتراضية وخفيفة وداكنة) لتغيير لوحة ألوان السمة.

default.css	light.css	dark.css

 skin : " /assets/css/skins/default.css "
skin : " /assets/css/skins/light.css "
skin : " /assets/css/skins/dark.css "

لاستخدام مظهر مخصص غير تلك المتوفرة:

1. انسخ وأعد تسمية /assets/css/skins/default.scss إلى الريبو المحلي الخاص بك.
2. تجاوز وتخصيص متغيرات Sass كما تراه مناسبًا.
3. قم بتحديث مسار skin في _config.yml للإشارة إلى ملف .css الجديد هذا.

لغة الموقع

يتم استخدام site.locale للإعلان عن اللغة الأساسية لكل صفحة ويب داخل الموقع.

على سبيل المثال: الإعدادات المحلية: "en-US" تقوم بتعيين سمة lang للموقع على نكهة اللغة الإنجليزية في الولايات المتحدة، في حين أن en-GB ستكون لنمط اللغة الإنجليزية في المملكة المتحدة. تعد رموز البلدان اختيارية كما أن locale: "en" مقبولة أيضًا. للعثور على رموز اللغة والبلد الخاصة بك، راجع هذا الجدول المرجعي.

يعد تعيين اللغة بشكل صحيح أمرًا مهمًا لربط النص المترجم الموجود في ملف البيانات النصي.

ملحوظة: السمة الافتراضية هي النص باللغة الإنجليزية ( en , en-US , en-GB ). إذا قمت بتغيير اللغة في _config.yml إلى شيء آخر فتأكد من إضافة مفتاح اللغة المقابل والنص المترجم إلى _data/text.yml .

عنوان URL للموقع

اسم المضيف والبروتوكول الأساسي لموقعك. إذا كنت تستضيف باستخدام صفحات GitHub، فسيكون هذا شيئًا مثل url: "https://github.io.mmistakes" أو url: "https://your-site.com" إذا كان لديك اسم مجال مخصص.

تفرض صفحات GitHub الآن https:// على المواقع الجديدة، لذا ضع في اعتبارك ذلك عند تعيين عنوان URL الخاص بك لتجنب تحذيرات المحتوى المختلط.

ملحوظة: يتجاوز Jekyll قيمة عنوان url بـ http://localhost:4000 عند تشغيل jekyll serve محليًا في التطوير. إذا كنت تريد تجنب هذا السلوك، فاضبط JEKYLL_ENV=production لإجبار البيئة على الإنتاج.

عنوان URL الأساسي للموقع

يسبب هذا الخيار كل أنواع الارتباك في مجتمع Jekyll. إذا كنت لا تستضيف موقعك كصفحة مشروع GitHub أو في مجلد فرعي (على سبيل المثال، /blog )، فلا تعبث به.

في حالة الموقع التجريبي So Simple ، يتم استضافته على GitHub على https://mmistakes.github.io/so-simple-theme. لتعيين هذا المسار الأساسي بشكل صحيح، سأستخدم url: "https://mmistakes.github.io" و baseurl: "/so-simple-theme" .

لمزيد من المعلومات حول كيفية استخدام site.url و site.baseurl بشكل صحيح على النحو المقصود من قبل مشرفي Jekyll، راجع مشاركة Parker Moore حول هذا الموضوع.

ملحوظة: عند استخدام baseurl تذكر تضمينه كجزء من الرابط ومسارات الأصول في المحتوى الخاص بك. قيم url: و baseurl: "/blog" ستجعل موقعك المحلي مرئيًا على http://localhost:4000/blog وليس http://localhost:4000. يمكنك إما إضافة جميع مسارات الأصول والروابط الداخلية الخاصة بك مسبقًا باستخدام {{ site.baseurl }} أو استخدام Jekyll's relative_url .

لاستخدام قيم الأمثلة الموجودة أعلى مسار الصورة التالي لـ {{ '/images/my-image.jpg' | relative_url }} سيتم إخراج {{ '/images/my-image.jpg' | relative_url }} بشكل صحيح كـ http://localhost:4000/blog/images/my-image.jpg .

بدون عامل التصفية relative_url ، سيكون مسار الأصل مفقودًا /blog وستكون لديك صورة معطلة على صفحتك.

تنسيق التاريخ

يمكنك تغيير تنسيق التاريخ الافتراضي عن طريق تحديد date_format في _config.yml . يقبل أيًا من تنسيقات التاريخ السائل القياسية.

على سبيل المثال، يمكن تغيير القيمة الافتراضية "%B %-d, %Y" كما يلي:

 date_format : " %Y-%m-%d "

وقت القراءة

تمكين مقتطفات وقت القراءة المقدرة على مستوى الموقع باستخدام read_time: true . تم تعيين 200 كقيمة افتراضية للكلمات في الدقيقة - والتي يمكن تغييرها عبر words_per_minute في ملف _config.yml الخاص بك.

 read_time : true
words_per_minute : 200

الرياضيات

تمكين MathJax (محرك عرض جافا سكريبت للرياضيات) على مستوى الموقع باستخدام

 mathjax :
  enable : true

يتيح لك خيار combo اختيار مجموعة مكونات MathJax - الإعداد الافتراضي هو "tex-svg". ويتيح لك خيار tags التحكم في ترقيم المعادلات - الاختيارات هي "ams" (افتراضي)، و"الكل"، و"لا شيء".

تكوين العينة:

 mathjax :
  enable : true             # MathJax equations, e.g. true, false (default)
  combo : " tex-svg "         # "tex-svg" (default), "tex-mml-chtml", etc.
  tags : " ams "              # "none", "ams" (default), "all"

خطوط جوجل

استخدم خطوط Google بسهولة في جميع أنحاء موقعك عن طريق استبدال name الخط weights وفقًا لذلك. أزواج الخطوط المقترحة هي كما يلي:

 google_fonts :
  - name : " Source Sans Pro "
    weights : " 400,400i,700,700i "
  - name : " Lora "
    weights : " 400,400i,700,700i "

ملاحظة: إذا تم استخدام عائلات خطوط أخرى، فتأكد من إضافة متغيرات SCSS التالية ثم تجاوزها في /assets/css/main.scss بقيم font-family التي يوفرها Google.

 $serif-font-family : " Lora " , serif ;
$sans-serif-font-family : " Source Sans Pro " , sans-serif ;
$monospace-font-family : Menlo, Consolas, Monaco, " Courier New " , Courier ,
  monospace ;

$base-font-family : $sans-serif-font-family ;
$headline-font-family : $sans-serif-font-family ;
$title-font-family : $serif-font-family ;
$description-font-family : $serif-font-family ;
$meta-font-family : $serif-font-family ;

راجع وثائق ورقة الأنماط أدناه للحصول على مزيد من المعلومات حول تجاوز المتغيرات الافتراضية للقالب.

ترقيم الصفحات

قم بتقسيم القائمة الرئيسية للمقالات الموجودة على الصفحة الرئيسية عبر صفحات متعددة عن طريق تمكين ترقيم الصفحات.

1. قم بتضمين المكوّن الإضافي jekyll-paginate في Gemfile الخاص بك.

    group :jekyll_plugins do
     gem "jekyll-paginate"
   end

2. أضف jekyll-paginate إلى مصفوفة plugins ( gems ​​سابقًا) في ملف _config.yml الخاص بك وإعدادات ترقيم الصفحات التالية:

    paginate : 10  # amount of posts to show per page
   paginate_path : /page:num/

3. أنشئ index.html (أو أعد تسمية index.md ) في جذر مشروعك وأضف الأمر الأمامي التالي:

    layout : home
   paginate : true

يبحث

لفهرسة المحتوى الكامل لمستنداتك لاستخدامها في صفحة بحث، قم بتعيين search_full_content على true في _config.yml :

 search_full_content : true

ملاحظة: ستؤدي الكميات الكبيرة من المنشورات إلى زيادة حجم فهرس البحث، مما يؤثر على أداء تحميل الصفحة. يؤدي تعيين search_full_content إلى false (الافتراضي) إلى تقييد الفهرسة على أول 50 كلمة من محتوى النص.

صفحات التصنيف

افتراضيًا، لا يتم ربط الفئة والعلامات المضافة إلى المنشور بصفحات أرشيف التصنيف. لتمكين هذا السلوك والارتباط بالصفحات التي تحتوي على منشورات مجمعة حسب الفئة أو العلامة، أضف ما يلي:

 category_archive_path : " /categories/# "
tag_archive_path : " /tags/# "

يجب أن تحاكي هذه المسارات الروابط الدائمة المستخدمة لصفحات أرشيف الفئات والعلامات الخاصة بك. يعد # الموجود في النهاية ضروريًا لاستهداف قسم التصنيف الصحيح في الصفحات.

على سبيل المثال، إذا كنت تريد إنشاء categories.md باستخدام الأمر الأمامي التالي:

 title : Categories Archive
layout : categories
permalink : /foo/

ستحتاج إلى تغيير category_archive_path إلى "/foo/# حتى تعمل روابط الفئات بشكل صحيح.

ملاحظة: يمكنك إنشاء صفحات مخصصة للفئات والعلامات يدويًا باستخدام layout: category و layout: tag . أو استخدم المكونات الإضافية مثل jekyll-archives أو jekyll-paginate-v2 لإنشاءها تلقائيًا.

التعليقات (عبر Disqus)

إذا كان لديك حساب Disqus ، يمكنك إظهار قسم التعليقات أسفل كل مشاركة.

لتمكين تعليقات Disqus، أضف اسم Disqus المختصر إلى ملف _config.yml الخاص بمشروعك:

 disqus :
  shortname : my_disqus_shortname

تظهر التعليقات فقط في الإنتاج عندما يتم إنشاؤها باستخدام قيمة البيئة التالية: JEKYLL_ENV=production لتجنب تلويث حساب Disqus الخاص بك بمحتوى localhost .

إذا كنت لا ترغب في عرض التعليقات لمنشور معين، فيمكنك تعطيلها عن طريق إضافة comments: false في مقدمة هذا المنشور.

تحليلات جوجل

لتمكين Google Analytics ، أضف معرف التتبع الخاص بك إلى _config.yml كما يلي:

 google_analytics : UA-NNNNNNNN-N

كما هو الحال مع تعليقات Disqus أعلاه، لن يظهر البرنامج النصي لتتبع Google Analytics إلا في الإنتاج عند استخدام قيمة البيئة التالية: JEKYLL_ENV=production .

آخر

لمزيد من خيارات التكوين تأكد من مراجعة الوثائق الخاصة بـ: jekyll-seo-tag و jekyll-feed و jekyll-paginate و jekyll-sitemap .

---

التخطيطات

يوفر هذا المظهر التخطيطات التالية، والتي يمكنك استخدامها عن طريق تعيين الجزء الأمامي layout في كل صفحة، على النحو التالي:

---
layout : name
---

layout: default

يتعامل هذا التخطيط مع كافة العناصر الأساسية للصفحة، حيث يضع محتوى الصفحة بين عناصر التسمية الرئيسية والتذييل. ترث جميع التخطيطات الأخرى هذا التصميم وتوفر تصميمًا وميزات إضافية داخل الكتلة {{ content }} .

layout: post

يستوعب هذا التخطيط المادة الأمامية التالية:

اسم	يكتب	وصف
image	خيط	المسار إلى صورة كبيرة مرتبطة بالمنشور. يُستخدم أيضًا مع OpenGraph وبطاقات Twitter والصورة المصغرة لخلاصة الموقع إذا تم تمكينها. أحجام الصور المقترحة
image.path	خيط	نفس ما ورد أعلاه. يُستخدم عندما يلزم تعيين صورة thumbnail أو caption لكائن image أيضًا.
image.caption	خيط	يصف الصورة أو يقدم الائتمان. مسموح بتخفيض السعر.
author	كائن أو سلسلة	حدد name مؤلف المنشور، picture ، twitter ، أو links ، وما إلى ذلك.
comments	منطقية	تعطيل التعليقات comments: false .
share	منطقية	أضف روابط المشاركة الاجتماعية إلى منشور به share: true .

مثال على صورة المشاركة:

 image :
  path : /images/post-image-lg.jpg
  thumbnail : /images/post-image-th.jpg
  caption : " Photo credit [Unsplash](https://unsplash.com/) "

ملحوظة: تم إهمال المادة الأمامية image.feature ، لدعم علامة jekyll-seo-tag بشكل كامل. إذا كنت لا تستخدم thumbnail أو caption فيمكن تعيين صورة المنشور بشكل أكثر دقة image: /images/your-post-image.jpg .

مثال لمؤلف المشاركة:

 # post specific author data if different from what is set in _config.yml
author :
  name : John Doe
  picture : /images/john-doe.jpg
  twitter : johndoe

ملاحظة: يمكن مركزية معلومات المؤلف في _data/authors.yml عن طريق القيام بما يلي في مقدمة المستند:

 author : johndoe

باستخدام مفتاح المؤلف المقابل في _data/authors.yml :

 johndoe :
  name : John Doe
  picture : /images/john-doe.jpg
  twitter : johndoe

ملحوظة: الحجم الموصى به author.picture هو 150 x 150 بكسل.

روابط المؤلف

لتحديد الروابط التي تظهر في الشريط الجانبي للمؤلف، استخدم مفتاح authors.links في _config.yml أو /_data/authors.yml .

اسم	وصف
title	يصف الارتباط. غير مرئية، وتستخدم لأغراض إمكانية الوصول.
url	عنوان URL الذي يشير إليه الرابط.
icon	يتوافق مع أيقونة Font Awesome، على سبيل المثال، fab fa-twitter-square .

مثال:

 author :
  links :
    - title : Twitter
      url : https://twitter.com/username
      icon : fab fa-twitter-square
    - title : Instagram
      url : https://instagram.com/username
      icon : fab fa-instagram
    - title : GitHub
      url : https://github.com/username
      icon : fab fa-github-square

ملاحظة: لتعطيل روابط المؤلف بشكل كامل، استخدم:

 author :
  links : false

layout: page

بصريًا، يبدو هذا التخطيط وكأنه layout: post ، مع الاختلافات التالية.

• يتم حذف الشريط الجانبي للمؤلف وتعريف الصفحة (تاريخ النشر والفئات والعلامات).
• الصفحة أقل اتساعًا بسبب حذف الشريط الجانبي.
• تم حذف تعليقات Disqus.
• تم حذف روابط التنقل للنشر التالي/السابق.

يشكل تخطيط الصفحة الأساس للعديد من التخطيطات الأخرى مثل home ، posts ، categories ، tags ، collection ، category ، tag ، search .

layout: home

يستوعب هذا التخطيط نفس المادة الأمامية مثل layout: page ، مع إضافة ما يلي:

 paginate : true  # enables pagination loop, see section above for additional setup
entries_layout : # list (default), grid

عندما لا يتم تمكين ترقيم الصفحات، فإن الصفحة الافتراضية تعرض أحدث 10 مشاركات. لتغيير كمية المشاركات المعروضة، قم بتعيين قيمة حدية عن طريق إضافة ما يلي إلى الصفحة الأمامية للصفحة.

 posts_limit : 5

بشكل افتراضي، يتم عرض المشاركات في عرض القائمة. للتغيير إلى طريقة عرض الشبكة، قم بإضافة entries_layout: grid إلى المادة الأمامية للصفحة.

layout: posts

يعرض هذا التخطيط جميع المنشورات المجمعة حسب سنة نشرها. إنه يستوعب نفس المادة الأمامية مثل layout: page .

بشكل افتراضي، يتم عرض المشاركات في عرض القائمة. للتغيير إلى طريقة عرض الشبكة، قم بإضافة entries_layout: grid إلى المادة الأمامية للصفحة.

layout: categories

يعرض هذا التخطيط جميع فئات المشاركات المجمعة. إنه يستوعب نفس المادة الأمامية مثل layout: page .

بشكل افتراضي، يتم عرض المشاركات في عرض القائمة. للتغيير إلى طريقة عرض الشبكة، قم بإضافة entries_layout: grid إلى المادة الأمامية للصفحة.

layout: tags

يعرض هذا التخطيط جميع المشاركات المجمعة حسب العلامة. إنه يستوعب نفس المادة الأمامية مثل layout: page .

بشكل افتراضي، يتم عرض المشاركات في عرض القائمة. للتغيير إلى طريقة عرض الشبكة، قم بإضافة entries_layout: grid إلى المادة الأمامية للصفحة.

layout: collection

يعرض هذا التخطيط جميع المستندات المجمعة حسب مجموعة معينة. وهي تستوعب نفس المادة الأمامية مثل layout: page مع إضافة ما يلي:

 collection : # collection name
entries_layout : # list (default), grid
show_excerpts : # true (default), false
sort_by : # date (default) title
sort_order : # forward (default), reverse

لإنشاء صفحة تعرض جميع المستندات الموجودة في مجموعة recipes ، يمكنك إنشاء recipes.md في جذر مشروعك وإضافة هذه المقدمة:

 title : Recipes
layout : collection
permalink : /recipes/
collection : recipes

بشكل افتراضي، يتم عرض المستندات في عرض القائمة. للتغيير إلى طريقة عرض الشبكة، قم بإضافة entries_layout: grid إلى المادة الأمامية للصفحة. إذا كنت تريد فرز المجموعة حسب العنوان، أضف sort_by: title . إذا كنت تريد الفرز العكسي، أضف sort_order: reverse . إذا كنت تبحث ببساطة عن قائمة تعرض عناوين الوصفات (بدون مقتطفات)، أضف show_excerpts: false .

layout: category

يعرض هذا التخطيط جميع المشاركات المجمعة حسب فئة معينة. وهي تستوعب نفس المادة الأمامية مثل layout: page مع إضافة ما يلي:

 taxonomy : # category name
entries_layout : # list (default), grid

بشكل افتراضي، يتم عرض المشاركات في عرض القائمة. للتغيير إلى طريقة عرض الشبكة، قم بإضافة entries_layout: grid إلى المادة الأمامية للصفحة.

لإنشاء صفحة تعرض جميع المنشورات المخصصة للفئة foo يمكنك إنشاء foo.md في جذر مشروعك وإضافة هذه المسألة الأمامية:

 title : Foo
layout : category
permalink : /categories/foo/
taxonomy : foo

layout: tag

يعرض هذا التخطيط جميع المشاركات المجمعة حسب علامة محددة. وهي تستوعب نفس المادة الأمامية مثل layout: page مع إضافة ما يلي:

 taxonomy : # tag name
entries_layout : # list (default), grid

بشكل افتراضي، يتم عرض المشاركات في عرض القائمة. للتغيير إلى طريقة عرض الشبكة، قم بإضافة entries_layout: grid إلى المادة الأمامية للصفحة.

لإنشاء صفحة تعرض جميع المنشورات المخصصة للعلامة foo bar يمكنك إنشاء foo-bar.md في جذر مشروعك وإضافة هذه المسألة الأمامية:

 title : Foo Bar
layout : tag
permalink : /tags/foo-bar/
taxonomy : foo bar

layout: search

يعرض هذا التخطيط نموذج بحث ويعرض الصفحات ذات الصلة بناءً على الاستعلام.

فهرس محتوى الصفحة: title excerpt content (عند التمكين) categories tags وعنوان url .

إذا كنت ترغب في استبعاد صفحات/منشورات محددة من فهرس البحث، فاضبط علامة البحث على false في المقدمة.

 search : false

لفهرسة المحتوى الكامل لمستنداتك، قم بتعيين search_full_content على true في _config.yml :

 search_full_content : true

ملاحظة: ستؤدي الكميات الكبيرة من المنشورات إلى زيادة حجم فهرس البحث، مما يؤثر على أداء تحميل الصفحة. يؤدي تعيين search_full_content إلى false (الافتراضي) إلى تقييد الفهرسة على أول 50 كلمة من محتوى النص.

الصور

أحجام الصور المقترحة بالبكسل هي كما يلي:

صورة	وصف	مقاس
site.logo	الشعار على مستوى الموقع المستخدم في إعلان التسمية الرئيسية.	200 x 200
page.image.path	صورة مستند كبيرة بالعرض الكامل.	الصور الطويلة ستدفع المحتوى إلى أسفل الصفحة. يعد 1600 x 600 حجمًا جيدًا للأرض الوسطى.
page.image	اختصار لـ page.image.path عند استخدامه بمفرده (بدون thumbnail أو caption أو متغيرات أخرى).	نفس page.image.path
page.image.thumbnail	صورة وثيقة صغيرة تستخدم في عرض الشبكة.	400 x 200
author.picture	صورة المؤلف في الشريط الجانبي للنشر.	150 x 150

نص الموضوع

لتغيير النص الموجود في القالب، انسخ الملف /_data/text.yml التالي وقم بتخصيصه حسب الضرورة.

عند إضافة نصوص جديدة، تأكد من مطابقة المفاتيح لرموز اللغة/البلد، التي يمكن استخدامها للموقع site.locale .

ملاحة

لتحديد الصفحات المرتبطة في شريط التنقل العلوي:

1. قم بإنشاء ملف /_data/navigation.yml .

2. أضف الصفحات بالترتيب الذي تريد ظهورها به:

   - title : Posts
     url : /posts/
   - title : Categories
     url : /categories/
   - title : External Page
     url : https://whatever-site.com/page.html
   - title : Search
     url : /search/

ملاحظة: قد تؤدي العناوين الطويلة أو الروابط العديدة إلى تقسيم شريط التنقل إلى أسطر متعددة، خاصة على الشاشات الصغيرة. ضع ذلك في الاعتبار أثناء تطوير التنقل الأساسي لموقعك.

مؤلف

يتم استخدام معلومات المؤلف كبيانات وصفية للنشر "بواسطة الأسطر" ونشر حقل creator لبطاقات ملخص Twitter مع المقدمة التالية في _config.yml :

 author :
  name : John Doe
  twitter : johndoetwitter
  picture : /images/johndoe.png

يمكن تجاوز معلومات المؤلف على مستوى الموقع في مقدمة المستند بنفس الطريقة:

 author :
  name : Jane Doe
  twitter : janedoetwitter
  picture : /images/janedoe.png

أو عن طريق تحديد المفتاح المقابل في مقدمة المستند، الموجود في site.data.authors . على سبيل المثال، لديك ما يلي في مقدمة المستند:

 author : megaman

ولديك ما يلي في _data/authors.yml :

 megaman :
  name : Mega Man
  twitter : megamantwitter
  picture : /images/megaman.png

drlight :
  name : Dr. Light
  twitter : drlighttwitter
  picture : /images/drlight.png

حاليًا، يتم استخدام author.picture فقط في layout: post . الحجم الموصى به هو 150 x 150 بكسل.

تذييل

يمكن تخصيص روابط التذييل ونص حقوق النشر.

روابط التذييل

يتم تعيين روابط التذييل في _config.yml ضمن مفتاح footer_links .

اسم	وصف
title	يصف الارتباط. غير مرئية، وتستخدم لأغراض إمكانية الوصول.
url	عنوان URL الذي يشير إليه الرابط.
icon	يتوافق مع أيقونة Font Awesome 5، على سبيل المثال، fab fa-twitter-square .

أمثلة:

 footer_links :
  - title : Twitter
    url : https://twitter.com/username
    icon : fab fa-twitter-square
  - title : GitHub
    url : https://github.com/mmistakes
    icon : fab fa-github-square
  - title : Feed
    url : atom.xml
    icon : fas fa-rss-square

ملاحظة: لتعطيل روابط التذييل بشكل كامل، استخدم footer_links: false .

نص حقوق التأليف والنشر

بشكل افتراضي، تُدرج حقوق الطبع والنشر العام الحالي و site.title والكلمات "Powered by Jekyll & So Simple." لتغيير هذا، قم بإضافة copyright إلى _config.yml الخاص بك على النحو التالي (يُسمح بتخفيض السعر):

 copyright : " This site is made with <3 by *me, myself, and I*. " 

مساعدين

يمكنك التفكير في مساعدي Jekyll هؤلاء كرموز قصيرة. نظرًا لأن صفحات GitHub لا تسمح بمعظم المكونات الإضافية --- فقد تم إيقاف العلامات المخصصة. بدلاً من ذلك، تتضمن روافع الموضوع القيام بشيء مماثل.

تضمين سريع الاستجابة

قم بتضمين مقطع فيديو من YouTube/Vimeo أو أي محتوى iframe آخر يتناسب حجمه مع عرض المحتوى الأصلي.

المعلمة	مطلوب	وصف
url	نعم	عنوان URL للفيديو أو iframe، على سبيل المثال، https://www.youtube.com/watch?v=-PVofD2A9t8
ratio	خياري	نسبة محتوى الفيديو أو iframe. 21:9 ، 16:9 ، 4:3 ، 1:1 . إذا لم يتم تعيين نسبة 16:9 يتم استخدامها.

مثال:

{% include responsive-embed url="https://www.youtube.com/watch?v=-PVofD2A9t8" ratio="16:9" %}

جدول المحتويات

لتضمين جدول محتويات تم إنشاؤه تلقائيًا للمقالات والصفحات، قم بإضافة المساعد التالي حيث تريد أن يظهر.

{% include toc %}

دليل الهجرة

يعد So Simple 3 بمثابة إعادة كتابة رئيسية للموضوع بأكمله. تم تلخيص أبرز التغييرات أدناه، تليها تغييرات أكثر تحديدًا.

من الآمن أن نقول أنك ربما ترغب في التخلص من جميع ملفات _layouts و _includes و _sass و .css و .js من الإصدار الثاني واستخدام إما Ruby Gem أو خيارات تثبيت السمة البعيدة.

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

• تم إهمال "طريقة Fork" لصالح تثبيت/ترقية السمة عبر جوهرة أو سمة بعيدة.
• تمت إعادة بناء جميع _layouts _includes _sass وJavaScript.
• يستخدم site.url و site.baseurl بشكل صحيح للاستفادة من المرشحات relative_url و absolute_url .
• تم استبدال /_includes/open-graph.html المخصص بـ jekyll-seo-tag .
• التحكم الكامل في الروابط والأيقونات المستخدمة في الشريط الجانبي للمؤلف والتذييل.
• تم استبدال العلامات والمقالات وصفحات المدونة بتخطيطات جديدة ( tags posts ) لتسهيل الاستخدام.
• تمت إزالة صفحة 404.md
• تم استبدال ملف تغذية atom.xml المخصص بملف jekyll-feed .
• تمت إزالة ملفات favicon.ico و favicon.png الافتراضية.
• تم استبدال بحث JSON البسيط بـ Lunr .
• تم استبدال النافذة المنبثقة الرائعة بـ Lity .
• تمت إزالة FitVids.JS.

دعم المتصفح

• تمت كتابة CSS مع وضع المتصفحات الحديثة في الاعتبار. حيث تم استخدام الإجراءات الاحتياطية الممكنة للتخطيطات القائمة على float حتى لا تبدو الأمور معطلة جدًا في المتصفحات التي لا تدعم display: grid والمربع المرن.

تغييرات التكوين

التغييرات المحلية

تم تغيير التنسيق من en_US (مع الشرطة السفلية) إلى en-US مع واصلة.

تغييرات المالك

أصبح site.owner الآن site.author لتقديم دعم أفضل لعلامة jekyll-seo وjekyll-feed.

الإصدار 2	v3
site.owner.name	site.author.name
site.owner.avatar	site.author.picture
site.owner.email	site.author.email
site.owner.twitter	site.twitter
site.owner.google.analytics	تم إهماله واستبداله بعلامة jekyll-seo
site.owner.bing-verify	تم إهماله واستبداله بعلامة jekyll-seo

تغييرات تحليلات جوجل

أصبح site.owner.google.analytics الآن site.google_analytics . انظر الوثائق لمزيد من المعلومات.

تغييرات تعليقات Disqus

أصبح site.owner.disqus-shortname الآن site.disqus.shortname . انظر الوثائق مزيد من المعلومات.

لتعطيل التعليقات على منشور معين، قم بإضافة comments: false إلى الصفحة الأولى منه.

البحث عن التغييرات

تمت إعادة تسمية search_omit إلى search . لاستبعاد منشور أو صفحة من البحث، قم بإضافة search: false إلى مؤخرتها بدلاً من ذلك.

تغييرات الصورة

عند تعيين مسارات صور لأشياء مثل site.logo و page.image.path و author.picture وما إلى ذلك، فإنها تتطلب الآن مسارًا نسبيًا أو مطلقًا كاملاً.

في So Simple v2، تم وضع جميع الصور في /images/ وتعيينها في المقدمة باستخدام اسم الملف فقط. لكي يتم تحميل الصور بشكل صحيح، تحتاج الآن إلى إضافة /images/ ... إذا كنت تقوم بتخزين الصور هناك، على سبيل المثال، /images/your-image.jpg .

لدعم مكونات Jekyll الإضافية بشكل أفضل، مثل jekyll-seo-tag، وjekyll-feed، وjekyll-sitemap، تمت إعادة تسمية معظم مفاتيح image . اضبط المادة الأمامية في جميع منشوراتك وصفحاتك وفقًا لذلك.

الإصدار 2	v3
image.feature	image.path
image.thumb	image.thumbnail
image.credit	image.caption (يُسمح بتخفيض السعر)
image.creditlink	تم إهمال استخدام **image.caption** بدلاً من ذلك

منشور يحتوي على المادة الأمامية v2 التالية:

 image :
  feature : feature-image-filename.jpg
  thumb : thumb-image-filename.jpg
  credit : Michael Rose
  creditlink : https://mademistakes.com

سيتم تحويلها إلى المادة الأمامية v3 التالية:

 image :
  path : /images/feature-image-filename.jpg
  thumbnail : /images/thumb-image-filename.jpg
  caption : " [Michael Rose](https://mademistakes) "

تغييرات التنمية

• تم استبدال مهام Grunt بنصوص npm النصية.

خطوة بخطوة

خطوات تقريبية لترحيل شوكة So Simple v2 للأسهم (بدون تعديلات) إلى الأحدث.

1. قم بإزالة _includes/ و _layouts/ و _sass/ و jshintrc و Gruntfile.js و search.json .

2. قم بتحرير Gemfile إما لطرق تثبيت Ruby Gem أو GitHub Pages واتبع هذه التعليمات.

3. أضف خطوط Google التالية إلى _config.yml :

    google_fonts :
     - name : " Source Sans Pro "
       weights : " 400,400i,700,700i "
     - name : " Lora "
       weights : " 400,400i,700,700i "

4. قم بتحرير _config.yml مع إيلاء اهتمام وثيق لتلك المفاتيح التي تمت إعادة تسميتها أو التي لها متطلبات مسار نسبية جديدة. locale logo owner أماكن جيدة للبدء.

5. أعد تسمية جميع مثيلات image.feature و image.thumb و image.credit في المنشورات/الصفحات الملتزمة بتغييرات الصورة أعلاه.

6. قم بإزالة محتوى النص في index.html وقم بتغيير layout: page إلى layout: home . قم بتكوين ترقيم الصفحات إذا لزم الأمر.

7. قم بإزالة محتوى النص في /search/index.md وقم بتغيير layout: page إلى layout: search .

8. قم بإزالة محتوى النص في /tags/index.md وقم بتغيير layout: page إلى layout: tags .

9. قم بإزالة محتوى النص في /articles/index.md وقم بتغيير layout: page إلى layout: category وأضف taxonomy: articles .

10. قم بإزالة محتوى النص في /body/index.md وقم بتغيير layout: page إلى layout: category وإضافة taxonomy: blog .

11. أعد تسمية المادة الأمامية modified في المنشورات/الصفحات إلى last_modified_at لتحسين التكافؤ مع المكونات الإضافية التي تدعمها.

12. أضف tag_archive_path: "/tags/#" إلى _config.yml لتنشيط روابط العلامات في الشريط الجانبي للنشر.

13. أعد تسمية avatar إلى picture في _data/authors.yml (وفي أي منشورات/صفحات في المقدمة)، وقم بتحرير المسارات الملتصقة بتغييرات مسار الصورة أعلاه.

---

التخصيص

عند التثبيت كجوهرة روبي أو سمة بعيدة، فإن ملفات السمات الأساسية ( _layouts ، _includes ، _sass ، assets ، وما إلى ذلك) ستكون غائبة عن مشروعك.

يمكن تجاوز البنية والنمط والبرامج النصية الافتراضية لهذا المظهر وتخصيصها بالطريقتين التاليتين:

تجاوز التضمين والتخطيطات

يمكن تجاوز ملفات السمات عن طريق وضع ملف بنفس الاسم في دليل _includes أو _layouts الخاص بمشروعك. على سبيل المثال:

• لإضافة زر مشاركة اجتماعية آخر إلى _includes/social-share.html ، قم بإنشاء دليل _includes في مشروعك، وانسخ _includes/social-share.html من مجلد الأحجار الكريمة الخاص بـ So Simple إلى <your_project>/_includes وقم بتحرير هذا الملف.

نصيحة احترافية: لتحديد موقع ملفات السمة على جهاز الكمبيوتر الخاص بك، قم بتشغيل bundle show jekyll-theme-so-simple . يؤدي هذا إلى إرجاع موقع ملفات السمات المستندة إلى الأحجار الكريمة.

يأتي الموضوع مع ملفين للمساعدة في إدخال العلامات والمحتوى المخصص في مواقع محددة مسبقًا.

	وصف
_includes/head-custom.html	تم إدراجه داخل عنصر <head> لإضافة البيانات التعريفية والأيقونات المفضلة وما إلى ذلك.
_includes/footer-custom.html	تم إدراجه داخل عنصر <footer> قبل البرامج النصية للموقع ومعلومات حقوق الطبع والنشر.

تخصيص ساس (SCSS)

لتجاوز Sass الافتراضي (الموجود في دليل _sass الخاص بالقالب)، قم بأحد الإجراءات التالية:

1. انسخ مباشرةً من جوهرة So Simple

   • انتقل إلى دليل تثبيت الأحجار الكريمة So Simple المحلي (قم بتشغيل bundle show jekyll-theme-so-simple للحصول على المسار إليه).
   • انسخ محتويات /assets/css/main.scss من هناك إلى <your_project> .
   • قم بتخصيص ما تريده داخل <your_project>/assets/css/main.scss .

2. نسخ من هذا الريبو.

   • انسخ محتويات الأصول/css/main.scss إلى <your_project> .
   • قم بتخصيص ما تريده داخل <your_project/assets/css/main.scss .

ملاحظة: لتخصيص أجزاء Sass الفعلية المجمعة في الجوهرة، ستحتاج إلى نسخ المحتويات الكاملة لدليل _sass إلى <your_project> . نظرًا للطريقة التي يستورد بها Jekyll حاليًا هذه الملفات، فكل شيء أو لا شيء. لن يعمل تجاوز جزء Sass جزئيًا (أو اثنين) مثل _includes و _layouts .

لإجراء تعديلات أساسية على نمط السمة، يمكن تجاوز متغيرات Sass عن طريق إضافتها إلى <your_project>/assets/css/main.scss . على سبيل المثال، لتغيير لون التمييز المستخدم في القالب، قم بإضافة ما يلي قبل جميع أسطر @import :

 $accent-color : tomato ;

تخصيص جافا سكريبت

لتجاوز JavaScript الافتراضي المضمن في القالب، قم بأحد الإجراءات التالية:

1. انسخ مباشرةً من جوهرة So Simple

   • انتقل إلى دليل تثبيت الأحجار الكريمة So Simple المحلي (قم بتشغيل bundle show jekyll-theme-so-simple للحصول على المسار إليه).
   • انسخ محتويات /assets/js/main.js من هناك إلى <your_project> .
   • قم بتخصيص ما تريده داخل <your_project>/assets/js/main.js .

2. نسخ من هذا الريبو.

   • انسخ محتويات /assets/js/main.js إلى <your_project> .
   • قم بتخصيص ما تريده داخل <your_project>/assets/js/main.js .

تم إنشاء ملف /assets/js/main.min.js الخاص بالقالب من مكونات jQuery الإضافية والبرامج النصية الأخرى الموجودة في /assets/js/ .

 ├── assets
|  ├── js
|  |  ├── lunr                             # Lunr search plugin
|  |  |   ├── lunr.xx.js                   # Lunr language plugins
|  |  |   ├── ...
|  |  |   ├── lunr.min.js
|  |  |   └── lunr.stemmer.support.min.js
|  |  ├── plugins
|  |  |   ├── jquery.smooth-scroll.min.js  # make same-page links scroll smoothly
|  |  |   ├── lity.min.js                  # responsive lightbox
|  |  |   └── table-of-contents.js         # table of contents toggle
|  |  ├── main.js                          # jQuery plugin settings and other scripts
|  |  ├── main.min.js                      # concatenated and minified scripts
|  |  ├── search-data.json                 # search index used by Lunr

لتعديل أو إضافة البرامج النصية الخاصة بك، قم بتضمينها في assets/js/main.js ثم أعد البناء باستخدام npm run build:js . انظر أدناه لمزيد من التفاصيل.

إذا قمت بإضافة نصوص برمجية إضافية إلى /assets/js/plugins/ وترغب في ربطها مع النصوص الأخرى، فتأكد من تحديث النص uglify في package.json . وينطبق الشيء نفسه على البرامج النصية التي تقوم بإزالتها.

يمكنك أيضًا إضافة برامج نصية إلى عناصر <head> أو عناصر </body> عن طريق إضافة مسارات إلى المصفوفات التالية في _config.yml .

مثال:

 head_scripts :
  - https://code.jquery.com/jquery-3.2.1.min.js
  - /assets/js/your-custom-head-script.js
footer_scripts :
  - /assets/js/your-custom-footer-script.js

ملاحظة: إذا قمت بتعيين مسارات إلى footer_scripts فسيتم إلغاء تنشيط ملف /assets/js/main.min.js الخاص بالقالب. يتضمن هذا البرنامج النصي مكونات إضافية ونصوصًا برمجية أخرى ستتوقف عن العمل ما لم تقم بإضافتها على وجه التحديد إلى مصفوفة footer_scripts .

أيقونات الخط رهيبة

يستخدم الموضوع إصدار Font Awesome SVG مع إصدار JS للأيقونات. المواقع البارزة التي تظهر فيها هذه الرموز موجودة في الشريط الجانبي للمؤلف وروابط التذييل.

---

تطوير

لإعداد بيئتك لتطوير هذا الموضوع:

1. استنساخ هذا الريبو
2. cd إلى /example وقم بتشغيل bundle install .

لاختبار السمة محليًا أثناء إجراء تغييرات عليها:

1. cd في المجلد الجذر للريبو (على سبيل المثال jekyll-theme-so-simple ).
2. قم بتشغيل bundle exec rake preview وافتح متصفحك على http://localhost:4000/example/ .

يؤدي هذا إلى تشغيل خادم Jekyll باستخدام ملفات السمة ومحتويات الدليل example/ . عند إجراء التعديلات، قم بتحديث المتصفح الخاص بك لرؤية أي تغييرات.

جافا سكريبت بناء البرنامج النصي

في محاولة لتقليل التبعيات، يتم استخدام مجموعة من البرامج النصية npm لإنشاء main.min.js بدلاً من مشغلي المهام مثل Gulp أو Grunt. إذا كانت هذه الأدوات هي أسلوبك المفضل، فاستخدمها بدلاً من ذلك بكل الوسائل.

للبدء:

1. قم بتثبيت Node.js.
2. cd إلى جذر مشروعك.
3. قم بتثبيت كافة التبعيات عن طريق تشغيل تثبيت npm.

ملاحظة: إذا قمت بالترقية من إصدار سابق للسمة، فتأكد من نسخها عبر package.json قبل تشغيل npm install . قد تحتاج أيضًا إلى إزالة دليل node_modules الخاص بك أيضًا.

إذا سارت الأمور على ما يرام، فإن تنفيذ npm run build:js سيؤدي إلى ضغط/تسلسل main.js وجميع البرامج النصية للمكونات الإضافية في /assets/js/main.min.js .

المساهمة

وجدت خطأ مطبعي في الوثائق؟ طلب ميزة أو إصلاح الخلل؟ ابحث في الإصدارات المفتوحة والمغلقة قبل إرسال أي مشكلة لتجنب التكرار.

نقدر أيضًا طلبات السحب. إذا كانت هذه هي المرة الأولى لك، فقد يكون من المفيد القراءة على GitHub Flow.

إذا كانت مساهمتك تضيف أو تغير سلوك السمة، فتأكد من تحديث الوثائق و/أو نموذج المحتوى. توجد الوثائق في README.md بينما توجد نماذج المنشورات والصفحات والمجموعات في مجلدات docs example .

سحب الطلبات

عند تقديم طلب السحب:

1. استنساخ الريبو.
2. أنشئ فرعًا خارج master وأعطه اسمًا ذا معنى (على سبيل المثال، my-awesome-new-feature ).
3. افتح طلب سحب على GitHub ووصف المشكلة التي يحلها.

---

الاعتمادات

الخالق

مايكل روز

• https://mademistakes.com
• https://twitter.com/mmitakes
• https://github.com/mmitakes

أيقونات + صور تجريبية:

• الخط رائع
• WeGraphics
• أونسبلاش

آخر:

• جيكل
• نقطة توقف
• مسج
• مسج التمرير السلس
• ليتي
• لونر

---

رخصة

رخصة معهد ماساتشوستس للتكنولوجيا (MIT)

حقوق الطبع والنشر (ج) 2013-2019 لمايكل روز والمساهمين

يُمنح الإذن مجانًا لأي شخص يحصل على نسخة من هذا البرنامج وملفات الوثائق المرتبطة به ("البرنامج")، للتعامل في البرنامج دون قيود، بما في ذلك، على سبيل المثال لا الحصر، حقوق الاستخدام والنسخ والتعديل والدمج. ونشر و/أو توزيع وترخيص من الباطن و/أو بيع نسخ من البرنامج، والسماح للأشخاص الذين تم توفير البرنامج لهم بالقيام بذلك، وفقًا للشروط التالية:

يجب تضمين إشعار حقوق الطبع والنشر أعلاه وإشعار الإذن هذا في جميع النسخ أو الأجزاء الكبيرة من البرنامج.

يتم توفير البرنامج "كما هو"، دون أي ضمان من أي نوع، صريحًا أو ضمنيًا، بما في ذلك، على سبيل المثال لا الحصر، ضمانات القابلية للتسويق والملاءمة لغرض معين وعدم الانتهاك. لا يتحمل المؤلفون أو أصحاب حقوق الطبع والنشر بأي حال من الأحوال المسؤولية عن أي مطالبة أو أضرار أو مسؤولية أخرى، سواء في إجراء العقد أو الضرر أو غير ذلك، الناشئة عن أو خارج أو فيما يتعلق بالبرنامج أو الاستخدام أو المعاملات الأخرى في برمجة.

يشتمل So Simple على Font Awesome، حقوق الطبع والنشر (c) لعام 2017 لصالح Dave Gandy. يتم توزيع Font Awesome بموجب شروط SIL OFL 1.1 وترخيص MIT.

يتضمن So Simple صورًا من Unsplash.

يتضمن So Simple صورًا من WeGraphics

بسيطة للغاية تتضمن نقطة التوقف. يتم توزيع نقطة التوقف بموجب شروط تراخيص MIT/GPL.

يتضمن SO Simple Sokery Smooth Scroll ، حقوق الطبع والنشر (C) 2017 Karl Swedberg. يتم توزيع التمرير السلس jQuery بموجب شروط ترخيص MIT.

يتضمن SO Simple Lunr ، حقوق الطبع والنشر (C) 2017 Oliver Nightingale. يتم توزيع LUNR بموجب شروط ترخيص معهد ماساتشوستس للتكنولوجيا.

يتضمن SO Simple Lity ، حقوق الطبع والنشر (C) 2015-2016 ، Jan Sorgalla. يتم توزيع Lity بموجب شروط ترخيص MIT] (http://opensource.org/licenses/mit).

يتضمن SO Simple Togle Toggle ، حقوق الطبع والنشر (C) 2017 Timothy B. Smith. يتم توزيع تبديل جدول المحتويات بموجب شروط ترخيص معهد ماساتشوستس للتكنولوجيا] (http://opensource.org/licenses/mit).