simplest jekyll

أبسط jekyll

تم تخفيض موقع قائم على جائزة Jekyll على صفحات GH ، إلى صفحة واحدة من المحتوى مع موضوع

معاينة

عن

هذا هو قالب ومشروع تجريبي مباشر. إنه يوضح مدى قلة الاحتياجات التي تحتاجها إلى الإعداد للحصول على موقع jekyll على صفحات GH.

• INDEX.MD
  • للصفحة الرئيسية - الصفحة الوحيدة في هذه الحالة.
  • إذا تركت هذه الصفحة ، فسيتم استخدام README.md كصفحتك الرئيسية.
• _config.yml
  • اضبط السمة - التي تتعامل مع التصميم والتصميم.
  • تمكين jekyll sitemap plugin - تمكينه في gemfile لا يكفي. لاحظ أنه سيتم تمكين الإضافات الأخرى لك مثل Frontmatter الاختياري.
  • تم ترك القيم القياسية الأخرى مثل baseurl title description خارج التكوين. عند البناء على صفحات GH ، سيتم استنتاجها من قبل GH GEM GEM.
• Gemfile
  • لا يتم استخدام هذا بالفعل بواسطة صفحات GH ، ولكنه يسمح لك بتثبيت موضوع Jekyll محليًا باستخدام Bundler.
  • استخدم github-pages Github واحدة إذا كنت ترغب في مطابقة جميع الأحجار الكريمة على صفحات GH (والتي يمكن أن تكون ثقيلة للتثبيت).
  • احذف هذا الملف إذا لم تكن بحاجة إلى تشغيل موقعك محليًا.

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

كيفية استخدام هذا المشروع

يثبت

1. انقر فوق استخدام هذا القالب لإنشاء ريبو جديد في حسابك الخاص. يمكنك ترك الاسم على أنه simplest-jekyll .
2. تمكين صفحات github في إعدادات الريبو الخاصة بك. اختر العمل من master Branch وخيار / المسار.
3. تحقق من علامة تبويب البيئة الخاصة بـ Repo لمعرفة متى يتم النشر.
4. انقر فوق عرض النشر لرؤية الموقع المباشر. على سبيل المثال https://michaelcurrin.github.io/simplest-jekyll/

لاحظ أن /simplest-jekyll/index.html متاح على الفور ولكن يستغرق الأمر بضع دقائق حتى تصنع صفحات Github /simplest-jekyll/ متاح.

تخصيص

• قم بتحديث README.md بتفاصيلك الخاصة. لا يتم استخدام هذا بالفعل في الموقع المنشور ولكنه مرئي محليًا وعلى Github.
• موضوعات
  • قم بتحرير السمة في _config.yml إذا كنت تريد موضوعًا آخر.
  • يمكنك أيضًا استخدام قسم صفحات GitHub في إعدادات الريبو للمعاينة بصريًا.
  • لاحظ فقط الموضوعات التي تدعمها صفحات GitHub تتم تغطية (حوالي 10) ولكن إذا كنت تستخدم حقل Remote_Theme في التكوين الخاص بك ، يمكنك الرجوع إلى المزيد من الموضوعات.
  • لتثبيت وتشغيل محليًا ، ستحتاج إلى التأكد من أن Gemfile تغطي السمة المستخدمة في التكوين.
• كما هو الحال مع معظم مواقع Jekyll ، يتم استخدام index.md كصفحة منزلية.
  • لديها المادة الأمامية في الأعلى بحيث سيتم تطبيق أي سائل.
  • قم بتحرير ملف index.md الخاص بك بمحتوىك الخاص كـ HTML أو Markdown.
  • يمكنك إعادة تسميته إلى index.html إذا كنت تريد فقط HTML عادي.
  • يمكنك إزالة المادة الأمامية في الأعلى لإزالة تنسيق السائل وأي موضوع.
• إذا كنت ترغب في ذلك ، فأضف المزيد من الصفحات في الجذر وكسر أي HTML مشترك مثل الرأس أو الرأس أو شريط القنوات إلى مجلد _includes أو مجلد _layouts (لا يتم تغطيته في نطاق هذا المشروع ولكنهما شائعان لمشاريع Jekyll).
• انظر المستندات والدروس التعليمية على موقع Jekyll لمزيد من المعلومات.
• اختياريا تشغيل jekyll محليا:
  • تثبيت Ruby و Bundler.
  • قم بتثبيت GEMS Project - Jekyll و Theme GEM.
  • قم بتشغيل خادم Jekyll Dev.
  • للحصول على تعليمات أكمل ، انظر Docs of Jekyll Blog Demo. ستحتاج إلى إضافة Makefile لمطابقة تلك الأوامر.

المشاريع ذات الصلة

• - المدونة الافتراضية التي تم إنشاؤها مع Jekyll CLI. باستخدام موضوع ، محتوى ، إعداد النمط ، الأحجار الكريمة ، و makefile.
• - باستخدام jekyll 4 ، موضوع ، إجراءات github ، وصفحات github.
• - الحد الأدنى من موقع jekyll مع موضوع ولكن لا gemfile.

رخصة

صدر تحت معهد ماساتشوستس للتكنولوجيا من قبل michaelcurrin.