موضوع Jekyll بسيط ونظيف وسريع الاستجابة للأكاديميين. إذا أعجبك الموضوع، أعطه نجمة!
هل تريد معرفة المزيد عن جيكل؟ تحقق من هذا البرنامج التعليمي. لماذا جيكل؟ اقرأ مشاركة مدونة أندريه كارباثي!
للحصول على شرح عملي حول تركيب al-folio، شاهد هذا الفيديو التعليمي الرائع الذي أعده أحد أعضاء المجتمع! ؟ ؟
الطريقة المفضلة لاستخدام هذا القالب هي النقر فوق استخدام هذا القالب أعلى قائمة الملفات. ثم قم بإنشاء مستودع جديد على github.com:<your-username>/<your-repo-name>
. إذا كنت تخطط لتحميل موقعك على <your-github-username>.github.io
، فلاحظ أن اسم المستودع الخاص بك يجب أن يكون <your-github-username>.github.io
أو <your-github-orgname>.github.io
كما هو مذكور في مستندات صفحات GitHub. لمزيد من المعلومات حول كيفية نشر موقعك، راجع قسم النشر أدناه. بعد إنشاء المستودع الجديد، ما عليك سوى تنزيله على جهازك:
$ git clone [email protected]: < your-username > / < your-repo-name > .git
$ cd < your-repo-name >
يعد استخدام Docker لتثبيت تبعيات Jekyll وRuby هو أسهل طريقة.
يتعين عليك اتخاذ الخطوات التالية لتشغيل al-folio
على جهازك المحلي:
$ docker compose pull
$ docker compose up
لاحظ أنه عند تشغيله لأول مرة، سيتم تنزيل صورة عامل إرساء بحجم 400 ميجابايت أو نحو ذلك.
الآن، لا تتردد في تخصيص المظهر كيفما تشاء (لا تنس تغيير الاسم!). بعد الانتهاء، يمكنك استخدام نفس الأمر ( docker compose up
) لعرض صفحة الويب بكل التغييرات التي أجريتها. تأكد أيضًا من الالتزام بالتغييرات النهائية.
لتغيير رقم المنفذ، يمكنك تحرير ملف
docker-compose.yml
.
ملحوظة: هذا الأسلوب ضروري فقط إذا كنت ترغب في إنشاء إصدار قديم أو مخصص جدًا من al-folio.
قم ببناء وتشغيل صورة عامل إرساء جديدة باستخدام:
$ docker compose up --build
إذا كنت تريد تحديث jekyll، أو تثبيت حزم روبي جديدة، وما إلى ذلك، فكل ما عليك فعله هو إنشاء الصورة مرة أخرى باستخدام وسيطة
--force-recreate
في نهاية الأمر السابق! سيتم تنزيل Ruby وJekyll وتثبيت جميع حزم Ruby مرة أخرى من البداية.
إذا كنت تريد استخدام إصدار معين من عامل الإرساء، فيمكنك القيام بذلك عن طريق تغيير latest
علامة إلى your_version
في docker-compose.yaml
. على سبيل المثال، ربما تكون قد أنشأت موقع الويب الخاص بك على v0.10.0
وتريد الالتزام بذلك.
بافتراض أن لديك Ruby وBundler مثبتين على نظامك ( تلميح: لسهولة إدارة جواهر Ruby، فكر في استخدام rbenv )، وأيضًا Python وpip ( تلميح: لسهولة إدارة حزم python، فكر في استخدام بيئة افتراضية، مثل venv أو conda إذا كنت ستستخدم jupyter
فقط، فيمكنك استخدام pipx .
$ bundle install
# assuming pip is your Python package manager
$ pip install jupyter
$ bundle exec jekyll serve --lsi
الآن، لا تتردد في تخصيص المظهر كيفما تشاء (لا تنس تغيير الاسم!). بعد الانتهاء، قم بتنفيذ التغييرات النهائية.
يعد نشر موقع الويب الخاص بك على صفحات GitHub هو الخيار الأكثر شيوعًا. بدءًا من الإصدار v0.3.5، سيقوم al-folio بإعادة نشر صفحة الويب الخاصة بك تلقائيًا في كل مرة تقوم فيها بإدخال تغييرات جديدة على مستودعك!
لصفحات الويب الشخصية والمؤسسية:
<your-github-username>.github.io
أو <your-github-orgname>.github.io
._config.yml
، قم بتعيين url
على https://<your-github-username>.github.io
واترك baseurl
فارغًا.<your-github-username>.github.io
.لصفحات المشروع:
_config.yml
، قم بتعيين url
على https://<your-github-username>.github.io
و baseurl
على /<your-repository-name>/
.<your-github-username>.github.io/<your-repository-name>/
.لتمكين النشر التلقائي:
master
، فيجب أن يحتوي مستودعك الآن على فرع gh-pages
تم إنشاؤه حديثًا.gh-pages
( NOT to master
). لمزيد من التفاصيل، راجع تكوين مصدر نشر لموقع صفحات GitHub الخاص بك. إذا احتفظت بموقعك في فرع آخر، فافتح .github/workflows/deploy.yml
في الفرع الذي تحتفظ بموقعك عليه وقم بتغيير الفروع على->push-> والفروع على->pull_request->إلى الفرع الذي تحتفظ فيه بموقعك على الويب على. سيؤدي هذا إلى تشغيل الإجراء عند السحب/الدفع على هذا الفرع. سيقوم الإجراء بعد ذلك بنشر موقع الويب على الفرع الذي تم تشغيله منه.
إذا كنت بحاجة إلى إعادة نشر موقع الويب الخاص بك يدويًا على صفحات GitHub، فانتقل إلى الإجراءات، وانقر على "نشر" في الشريط الجانبي الأيسر، ثم "تشغيل سير العمل".
إذا قررت عدم استخدام صفحات GitHub واستضافة صفحتك في مكان آخر، فما عليك سوى تشغيل:
$ bundle exec jekyll build --lsi
والتي سوف (تعيد) إنشاء صفحة الويب الثابتة في _site/
المجلد. ثم قم ببساطة بنسخ محتويات الدليل _site/
إلى خادم الاستضافة الخاص بك.
إذا كنت تريد أيضًا إزالة فئات CSS غير المستخدمة من ملفك، فقم بتشغيل:
$ purgecss -c purgecss.config.js
والتي ستستبدل ملفات css الموجودة في المجلد _site/assets/css/
بملفات css التي تم مسحها.
ملاحظة: تأكد من ضبط حقلي url
و baseurl
بشكل صحيح في _config.yml
قبل إنشاء صفحة الويب. إذا كنت تنشر صفحة الويب الخاصة بك على your-domain.com/your-project/
، فيجب عليك تعيين url: your-domain.com
و baseurl: /your-project/
. إذا كنت تقوم بالنشر مباشرةً على your-domain.com
، فاترك baseurl
فارغًا.
ملاحظة: لا تحاول استخدام هذه الطريقة إلا إذا كنت تعرف ما تفعله (تأكد من أنك على دراية بمصادر النشر). يسمح هذا الأسلوب بوضع الكود المصدري لموقع الويب في مستودع واحد وإصدار النشر في مستودع مختلف.
لنفترض أن مصدر النشر لموقع الويب الخاص بك هو دليل فرعي publishing-source
لمستودع بإصدار git تم استنساخه ضمن $HOME/repo/
. بالنسبة لموقع مستخدم، قد يكون هذا شيئًا مثل $HOME/<user>.github.io
.
أولاً، من دليل النشر، قم بمراجعة فرع git الذي يستضيف مصدر النشر الخاص بك.
ثم من مصادر موقع الويب dir (عادةً ما يكون نسخة شوكة al-folio الخاصة بك):
$ bundle exec jekyll build --lsi --destination $HOME /repo/publishing-source
سيؤدي هذا إلى توجيه jekyll لنشر موقع الويب ضمن $HOME/repo/publishing-source
.
ملاحظة: سيقوم Jekyll بتنظيف $HOME/repo/publishing-source
قبل البناء!
الاقتباس أدناه مأخوذ مباشرة من مستندات تكوين jekyll:
يتم تنظيف مجلدات الوجهة عند إنشاء الموقع
يتم تنظيف محتويات
<destination>
تلقائيًا، بشكل افتراضي، عند إنشاء الموقع. ستتم إزالة الملفات أو المجلدات التي لم يتم إنشاؤها بواسطة موقعك. يمكن الاحتفاظ ببعض الملفات عن طريق تحديدها ضمن توجيه التكوين<keep_files>
.لا تستخدم موقعًا مهمًا لـ
<destination>
؛ بدلاً من ذلك، استخدمها كمنطقة مرحلية وانسخ الملفات من هناك إلى خادم الويب الخاص بك.
إذا كان $HOME/repo/publishing-source
يحتوي على ملفات تريد أن يتركها jekyll دون تغيير، فحددها ضمن keep_files
في _config.yml
. في تكوينه الافتراضي، سيقوم al-folio بنسخ الملف README.md
ذي المستوى الأعلى إلى مصدر النشر. إذا كنت تريد تغيير هذا السلوك، أضف README.md
ضمن exclude
في _config.yml
.
ملاحظة: لا تقم بتشغيل jekyll clean
في مستودع مصدر النشر الخاص بك لأن ذلك سيؤدي إلى حذف الدليل بأكمله، بغض النظر عن محتوى keep_files
في _config.yml
.
إذا قمت بتثبيت al-folio كما هو موضح أعلاه، فيمكنك تكوين إجراء GitHub لمزامنة مستودعك تلقائيًا مع أحدث إصدار من السمة.
انتقل إلى الإعدادات -> الإجراءات -> عام -> أذونات سير العمل، وامنح أذونات القراءة والكتابة لإجراءات GitHub، وحدد "السماح لإجراءات GitHub بإنشاء طلبات السحب والموافقة عليها"، واحفظ تغييراتك.
ثم انتقل إلى الإجراءات -> سير العمل الجديد -> قم بإعداد سير العمل بنفسك، وقم بإعداد سير العمل التالي وتنفيذ التغييرات:
name : Sync from template
on :
# cronjob trigger
schedule :
- cron : " 0 0 1 * * "
# manual trigger
workflow_dispatch :
jobs :
repo-sync :
runs-on : ubuntu-latest
steps :
# To use this repository's private action, you must check out the repository
- name : Checkout
uses : actions/checkout@v3
- name : actions-template-sync
uses : AndreasAugustin/[email protected]
with :
github_token : ${{ secrets.GITHUB_TOKEN }}
source_repo_path : alshedivat/al-folio
upstream_branch : master
ستتلقى طلب سحب داخل المستودع الخاص بك إذا كانت هناك بعض التغييرات المتوفرة في القالب.
هناك خيار آخر وهو تحديث التعليمات البرمجية يدويًا باتباع الخطوات التالية:
# Assuming the current directory is <your-repo-name>
$ git remote add upstream https://github.com/alshedivat/al-folio.git
$ git fetch upstream
$ git rebase v0.9.0
إذا قمت بتخصيص إصدار سابق على نطاق واسع، فقد يكون من الصعب ترقيته. لا يزال بإمكانك اتباع الخطوات المذكورة أعلاه، ولكن قد يؤدي git rebase
إلى تعارضات دمج يجب حلها. راجع دليل git rebase وكيفية حل التعارضات لمزيد من المعلومات. إذا كانت عملية إعادة التأسيس معقدة للغاية، فنوصي بإعادة تثبيت الإصدار الجديد من السمة من البداية ومنفذها على المحتوى الخاص بك والتغييرات من الإصدار السابق يدويًا.
فيما يلي بعض الأسئلة المتداولة. إذا كان لديك سؤال مختلف، يرجى طرحه باستخدام المناقشات.
س: بعد أن أقوم بإنشاء مستودع جديد من هذا القالب وإعداد الريبو، أحصل على خطأ في النشر. أليس من المفترض أن يتم نشر موقع الويب بشكل صحيح تلقائيًا؟
ج: نعم، إذا كنت تستخدم الإصدار v0.3.5
أو إصدار أحدث، فسيتم إعادة نشر موقع الويب تلقائيًا وبشكل صحيح مباشرة بعد التزامك الأول. يرجى إجراء بعض التغييرات (على سبيل المثال، تغيير معلومات موقع الويب الخاص بك في _config.yml
)، والالتزام، والدفع. تأكد من اتباع تعليمات النشر في القسم السابق. (المسألة ذات الصلة: 209.)
س: أنا أستخدم نطاقًا مخصصًا (على سبيل المثال، foo.com
). يصبح المجال المخصص الخاص بي فارغًا في إعدادات المستودع بعد كل عملية نشر. كيف أصلح ذلك؟
ج: أنت بحاجة إلى إضافة ملف CNAME
إلى الفرع master
أو source
لمستودعك. يجب أن يحتوي الملف على اسم المجال المخصص الخاص بك. (المسألة ذات الصلة: 130.)
س: صفحتي على الويب تعمل محليًا. ولكن بعد النشر، يفشل في الإنشاء ويطرح Unknown tag 'toc'
. كيف أصلح ذلك؟
ج: تأكد من اتباع تعليمات النشر في القسم السابق. يجب عليك تعيين فرع النشر على gh-pages
. (المسألة ذات الصلة: 1438.)
س: صفحتي على الويب تعمل محليًا. ولكن بعد النشر، لا يتم عرضه بشكل صحيح (لم يتم تحميل CSS وJS بشكل صحيح). كيف أصلح ذلك؟
ج: تأكد من تحديد مساري url
و baseurl
بشكل صحيح في _config.yml
. قم بتعيين url
على https://<your-github-username>.github.io
أو على https://<your.custom.domain>
إذا كنت تستخدم مجالًا مخصصًا. إذا كنت تقوم بنشر موقع ويب شخصي أو مؤسسي، فاترك baseurl
فارغًا. إذا كنت تقوم بنشر صفحة مشروع، فقم بتعيين baseurl: /<your-project-name>/
. إذا تم تنفيذ جميع الخطوات السابقة بشكل صحيح، فكل ما ينقص هو أن يتمكن متصفحك من جلب ورقة أنماط الموقع مرة أخرى.
س: تغذية الذرة لا تعمل. لماذا؟
ج: تأكد من تحديد مساري url
و baseurl
بشكل صحيح في _config.yml
. يعمل ملحق RSS Feed مع الحقول التي تم إعدادها بشكل صحيح: title
وعنوان url
description
author
. تأكد من ملئها بالطريقة المناسبة وحاول مرة أخرى.
س: موقعي لا يعمل عندما أقوم بتمكين related_blog_posts
. لماذا؟
ج: من المحتمل أن يكون هذا بسبب البرنامج الإضافي للمصنف، والذي يستخدم لحساب المنشورات ذات الصلة. إذا كان الخطأ ينص على Liquid Exception: Zero vectors can not be normalized...
، فهذا يعني أنه لا يمكن حساب المنشورات ذات الصلة لمنشور معين. يحدث هذا عادةً بسبب مشاركات المدونة الفارغة أو البسيطة التي لا تحتوي على كلمات ذات معنى (أي كلمات التوقف فقط) أو حتى أحرف محددة استخدمتها في مشاركاتك. أيضًا، يتم حساب التفاضل والتكامل للمشاركات المشابهة لكل post
، وهو ما يعني كل صفحة تستخدم layout: post
، بما في ذلك الإعلانات. لتغيير هذا السلوك، ما عليك سوى إضافة related_posts: false
إلى الصفحة الأولى من الصفحة التي لا تريد عرض المنشورات ذات الصلة عليها.
س: عند محاولة النشر، يتم طلب بيانات اعتماد تسجيل الدخول إلى github، وقد قام github بتعطيل مصادقة كلمة المرور ويتم الخروج مع حدوث خطأ. كيفية إصلاح؟
ج: افتح ملف .git/config باستخدام المحرر المفضل لديك. قم بتغيير جزء https
من متغير url
إلى ssh
. حاول النشر مرة أخرى.
يتم إنشاء صفحة منشوراتك تلقائيًا من قائمة مراجع BibTex الخاصة بك. ما عليك سوى تحرير _bibliography/papers.bib
. يمكنك أيضًا إضافة ملفات *.bib
جديدة وتخصيص مظهر منشوراتك كما تريد عن طريق تحرير _pages/publications.md
.
في المنشورات، يتم تعريف إدخال المؤلف الخاص بك من خلال مصفوفة السلسلة scholar:last_name
وstring array scholar:first_name
في _config.yml
:
scholar :
last_name : [Einstein]
first_name : [Albert, A.]
إذا كان الإدخال يتطابق مع نموذج واحد من أسماء العائلة والأسماء الأولى، فسيتم وضع خط تحته. احتفظ بالمعلومات التعريفية عن المؤلفين المشاركين في _data/coauthors.yml
وسيقوم Jekyll بإدراج روابط إلى صفحات الويب الخاصة بهم تلقائيًا. تنسيق بيانات المؤلف المشارك في _data/coauthors.yml
هو كما يلي،
" Adams " :
- firstname : ["Edwin", "E.", "E. P.", "Edwin Plimpton"]
url : https://en.wikipedia.org/wiki/Edwin_Plimpton_Adams
" Podolsky " :
- firstname : ["Boris", "B.", "B. Y.", "Boris Yakovlevich"]
url : https://en.wikipedia.org/wiki/Boris_Podolsky
" Rosen " :
- firstname : ["Nathan", "N."]
url : https://en.wikipedia.org/wiki/Nathan_Rosen
" Bach " :
- firstname : ["Johann Sebastian", "J. S."]
url : https://en.wikipedia.org/wiki/Johann_Sebastian_Bach
- firstname : ["Carl Philipp Emanuel", "C. P. E."]
url : https://en.wikipedia.org/wiki/Carl_Philipp_Emanuel_Bach
إذا كان الإدخال يطابق إحدى مجموعات الأسماء الأخيرة والأسماء الأولى، فسيتم تمييزه وربطه بعنوان URL المقدم.
هناك العديد من الكلمات الأساسية المخصصة لـ bibtex التي يمكنك استخدامها للتأثير على كيفية عرض الإدخالات على صفحة الويب:
abbr
: يضيف اختصارًا إلى يسار الإدخال. يمكنك إضافة روابط إليها عن طريق إنشاء ملفvenue.yaml في مجلد _data وإضافة الإدخالات المطابقة.abstract
: يضيف زر "Abs" الذي يقوم بتوسيع حقل النص المخفي عند النقر عليه لإظهار النص الملخصarxiv
: يضيف رابطًا إلى موقع Arxiv (ملاحظة: أضف معرف arxiv هنا فقط - يتم إنشاء الرابط تلقائيًا)bibtex_show
: يضيف زر "Bib" الذي يعمل على توسيع حقل النص المخفي مع إدخال المراجع الكاملةhtml
: يقوم بإدراج زر "HTML" لإعادة التوجيه إلى الرابط المحدد من قبل المستخدمpdf
: يضيف زر "PDF" لإعادة التوجيه إلى ملف محدد (إذا لم يتم تحديد رابط كامل، فسيتم افتراض وضع الملف في الدليل /assets/pdf/)supp
: إضافة زر "Supp" إلى ملف محدد (إذا لم يتم تحديد رابط كامل، فسيتم افتراض وضع الملف في الدليل /assets/pdf/)blog
: يضيف زر "مدونة" لإعادة التوجيه إلى الرابط المحددcode
: يضيف زر "الرمز" لإعادة التوجيه إلى الرابط المحددposter
: يضيف زر "ملصق" لإعادة التوجيه إلى ملف محدد (إذا لم يتم تحديد رابط كامل، فسيتم افتراض وضع الملف في الدليل /assets/pdf/)slides
: يضيف زر "الشرائح" لإعادة التوجيه إلى ملف محدد (إذا لم يتم تحديد رابط كامل، فسيتم افتراض وضع الملف في الدليل /assets/pdf/)website
: يضيف زر "موقع الويب" لإعادة التوجيه إلى الرابط المحددaltmetric
: يضيف شارة Altmetric (ملاحظة: إذا تم توفير DOI، فما عليك سوى استخدام true
، وإلا أضف معرف القياس البديل هنا فقط - يتم إنشاء الرابط تلقائيًا)dimensions
: تضيف شارة الأبعاد (ملاحظة: إذا تم توفير DOI أو PMID، فما عليك سوى استخدام true
، وإلا أضف معرف الأبعاد هنا فقط - يتم إنشاء الرابط تلقائيًا)يمكنك تنفيذ الأزرار الخاصة بك عن طريق تحرير ملف bib.html.
ينفذ موضوع Jekyll هذا collections
للسماح لك بتقسيم عملك إلى فئات. يأتي الموضوع مع مجموعتين افتراضيتين: news
projects
. يتم عرض العناصر من مجموعة news
تلقائيًا على الصفحة الرئيسية. يتم عرض العناصر من مجموعة projects
على شبكة سريعة الاستجابة في صفحة المشاريع.
يمكنك بسهولة إنشاء مجموعاتك أو تطبيقاتك أو قصصك القصيرة أو دوراتك التدريبية أو أيًا كان عملك الإبداعي. للقيام بذلك، قم بتحرير المجموعات في ملف _config.yml
، وقم بإنشاء مجلد مناظر، وقم بإنشاء صفحة مقصودة لمجموعتك، مشابهة لـ _pages/projects.md
.
يأتي al-folio بتخطيطات أنيقة للصفحات ومنشورات المدونات.
يتيح لك الموضوع إنشاء منشورات مدونة بأسلوب distill.pub:
لمزيد من التفاصيل حول كيفية إنشاء منشورات ذات نمط مقطر باستخدام علامات <d-*>
، يرجى الرجوع إلى المثال.
يدعم al-folio التنضيد السريع للرياضيات من خلال MathJax وتسليط الضوء على بناء جملة التعليمات البرمجية باستخدام أسلوب GitHub:
أصبح تنسيق الصور بسيطًا باستخدام نظام شبكة Bootstrap. أنشئ شبكات جميلة بسهولة ضمن منشورات مدونتك وصفحات مشروعك:
يستخدم al-folio إحصائيات github-readme-stats وgithub-profile-trophy لعرض مستودعات GitHub وإحصائيات المستخدم على صفحة /repositories/
.
قم بتحرير _data/repositories.yml
وقم بتغيير قوائم github_users
و github_repos
لتضمين ملف تعريف GitHub الخاص بك والمستودعات في صفحة /repositories/
.
يمكنك أيضًا استخدام الرموز التالية لعرض ذلك في أي صفحات أخرى.
<!-- code for GitHub users -->
{% if site.data.repositories.github_users %}
< div class =" repositories d-flex flex-wrap flex-md-row flex-column justify-content-between align-items-center " >
{% for user in site.data.repositories.github_users %}
{% include repository/repo_user.html username=user %}
{% endfor %}
</ div >
{% endif %}
<!-- code for GitHub trophies -->
{% if site.repo_trophies.enabled %}
{% for user in site.data.repositories.github_users %}
{% if site.data.repositories.github_users.size > 1 %}
< h4 > {{ user }} </ h4 >
{% endif %}
< div class =" repositories d-flex flex-wrap flex-md-row flex-column justify-content-between align-items-center " >
{% include repository/repo_trophies.html username=user %}
</ div >
{% endfor %}
{% endif %}
<!-- code for GitHub repositories -->
{% if site.data.repositories.github_repos %}
< div class =" repositories d-flex flex-wrap flex-md-row flex-column justify-content-between align-items-center " >
{% for repo in site.data.repositories.github_repos %}
{% include repository/repo.html repository=repo %}
{% endfor %}
</ div >
{% endif %}
تم اختيار مجموعة متنوعة من ألوان السمات الجميلة لتختار من بينها. الافتراضي هو اللون الأرجواني، ولكن يمكنك تغييره بسرعة عن طريق تحرير متغير --global-theme-color
في ملف _sass/_themes.scss
. يتم سرد متغيرات الألوان الأخرى هناك أيضًا. يمكن العثور على خيارات ألوان سمة المخزون المتاحة على _sass/_variables.scss
. يمكنك أيضًا إضافة الألوان الخاصة بك إلى هذا الملف مع تعيين اسم لكل منها لسهولة الاستخدام عبر القالب.
يدعم al-folio معاينة الصور على وسائل التواصل الاجتماعي. لتمكين هذه الوظيفة، ستحتاج إلى ضبط serve_og_meta
على true
في _config.yml
الخاص بك. بمجرد الانتهاء من ذلك، ستتضمن جميع صفحات موقعك بيانات Open Graph في عنصر رأس HTML.
ستحتاج بعد ذلك إلى تكوين الصورة التي سيتم عرضها في معاينات الوسائط الاجتماعية لموقعك. يمكن تكوين ذلك على أساس كل صفحة، عن طريق تعيين متغير الصفحة og_image
. إذا لم يتم تعيين هذا المتغير لصفحة فردية، فسوف يعود المظهر إلى متغير og_image
على مستوى الموقع، والذي يمكن تكوينه في _config.yml
الخاص بك. في كل من الحالات الخاصة بالصفحة وعلى مستوى الموقع، يحتاج المتغير og_image
إلى الاحتفاظ بعنوان URL للصورة التي ترغب في عرضها في معاينات الوسائط الاجتماعية.
يقوم بإنشاء موجز Atom (يشبه RSS) لمشاركاتك، وهو مفيد لقراء Atom وRSS. يمكن الوصول إلى الخلاصة ببساطة عن طريق الكتابة بعد صفحتك الرئيسية /feed.xml
. على سبيل المثال، بافتراض أن نقطة تحميل موقع الويب الخاص بك هي المجلد الرئيسي، يمكنك كتابة yourusername.github.io/feed.xml
افتراضيًا، سيكون هناك قسم منشورات ذات صلة أسفل منشورات المدونة. يتم إنشاؤها عن طريق تحديد أحدث المنشورات max_related
والتي تشارك علامات min_common_tags
على الأقل مع المنشور الحالي. إذا كنت لا ترغب في عرض المنشورات ذات الصلة بمنشور معين، فما عليك سوى إضافة related_posts: false
إلى مقدمة المنشور. إذا كنت تريد تعطيله لجميع المنشورات، فما عليك سوى تعيين enabled
إلى خطأ في قسم related_blog_posts
في _config.yml
.
المساهمات في آل فوليو هي موضع ترحيب كبير! قبل البدء، يرجى إلقاء نظرة على الإرشادات.
إذا كنت ترغب في تحسين التوثيق، أو إضافة صفحة الويب الخاصة بك إلى القائمة أدناه، أو إصلاح خطأ أو عدم تناسق بسيط، فلا تتردد في إرسال العلاقات العامة مباشرة إلى master
بالنسبة للمشكلات/الأخطاء أو طلبات الميزات الأكثر تعقيدًا، يرجى فتح مشكلة باستخدام القالب المناسب.
نرحب بالمساهمين الأكثر نشاطًا لدينا للانضمام إلى فريق المشرفين. إذا كنت مهتما، يرجى التواصل!
مروان | روهان ديب ساركار | أمير بورمند | جورج |
مصنوعة من contrib.rocks.
الموضوع متاح كمصدر مفتوح بموجب شروط ترخيص MIT.
في الأصل، كانت al-folio مبنية على موضوع *folio (الذي نشرته Lia Bogoev وبموجب ترخيص MIT). منذ ذلك الحين، تمت إعادة كتابة الأنماط بالكامل والعديد من الميزات الإضافية الرائعة.