minimal
v0.2.0
الحد الأدنى هو موضوع Jekyll لصفحات GitHub. يمكنك معاينة المظهر لترى كيف يبدو، أو حتى استخدامه اليوم.
لاستخدام موضوع الحد الأدنى:
أضف ما يلي إلى _config.yml الخاص بموقعك:
remote_theme : pages-themes/[email protected]
plugins :
- jekyll-remote-theme # add this line to the plugins list if you already have one اختياريًا، إذا كنت ترغب في معاينة موقعك على جهاز الكمبيوتر الخاص بك، أضف ما يلي إلى Gemfile الخاص بموقعك:
gem "github-pages" , group : :jekyll_plugins سوف يحترم Minimal المتغيرات التالية، إذا تم تعيينها في _config.yml الخاص بموقعك:
title : [The title of your site]
description : [A short description of your site's purpose]بالإضافة إلى ذلك، يمكنك اختيار تعيين المتغيرات الاختيارية التالية:
show_downloads : ["true" or "false" (unquoted) to indicate whether to provide a download URL]
google_analytics : [Your Google Analytics tracking ID]إذا كنت ترغب في إضافة الأنماط المخصصة الخاصة بك:
/assets/css/style.scss في موقعك---
---
@import " {{ site.theme }} " ;@import ملاحظة: إذا كنت ترغب في تغيير متغيرات Sass الخاصة بالقالب، فيجب عليك تعيين قيم جديدة قبل سطر @import في ورقة الأنماط الخاصة بك.
إذا كنت ترغب في تغيير تخطيط HTML للموضوع:
favicon المخصصة، يمكنك إضافة ملفات مخصصة في مجلد _includes المحلي الخاص بك. توفر الملفات المتوفرة مع السمة نقطة بداية ويتم تضمينها بواسطة قالب التخطيط الأصلي./_layouts/default.html في موقعك أصدرت Google عدة إصدارات لرمز Google Analytics الخاص بها على مر السنين منذ إنشاء هذا الموضوع لأول مرة. إذا كنت ترغب في الاستفادة من أحدث التعليمات البرمجية، فالصقها في _includes/head-custom-google-analytics.html في موقع Jekyll الخاص بك.
تعتمد القوالب غالبًا على عناوين URL التي يوفرها GitHub، مثل الروابط إلى مستودعك أو روابط تنزيل مشروعك. إذا كنت تريد تجاوز عنوان URL افتراضي واحد أو أكثر:
{{ site.github.zip_url }} ._config.yml الخاص بموقعك. على سبيل المثال، إذا كان المتغير site.github.url ، فيمكنك إضافة ما يلي: github :
zip_url : http://example.com/download.zip
another_url : another value ملحوظة: يجب عليك إزالة site. بادئة، ويجب وضع مسافة بادئة لكل اسم متغير (بعد github. ) بمسافتين أسفل github: .
لمزيد من المعلومات، راجع وثائق متغيرات Jekyll.
راجع المشكلات المفتوحة للحصول على قائمة بالميزات المقترحة (والمشكلات المعروفة).
يهدف موضوع Minimal إلى تسهيل عملية إنشاء موقع الويب الأول (أو رقم 100) لمستخدمي GitHub Pages بسرعة وسهولة. يجب أن يلبي الموضوع الغالبية العظمى من احتياجات المستخدمين خارج الصندوق، مع مراعاة البساطة بدلاً من المرونة، وتزويد المستخدمين بفرصة الاشتراك في التعقيد الإضافي إذا كانت لديهم احتياجات محددة أو يرغبون في تخصيص تجربتهم بشكل أكبر (مثل إضافة CSS مخصص أو تعديل التخطيط الافتراضي). وينبغي أيضا أن تبدو كبيرة، ولكن هذا أمر بديهي.
هل أنت مهتم بالمساهمة في الحد الأدنى؟ نحن نحب مساعدتكم. Minimal هو مشروع مفتوح المصدر، تم إنشاؤه بمساهمة واحدة في كل مرة بواسطة مستخدمين مثلك. راجع ملف المساهمة للحصول على تعليمات حول كيفية المساهمة.
إذا كنت ترغب في معاينة السمة محليًا (على سبيل المثال، أثناء عملية اقتراح تغيير):
git clone https://github.com/pages-themes/minimal )cd في دليل الموضوعscript/bootstrap لتثبيت التبعيات الضروريةbundle exec jekyll serve لبدء خادم المعاينةlocalhost:4000 في متصفحك لمعاينة السمة يحتوي القالب على الحد الأدنى من مجموعة الاختبار، لضمان إنشاء موقع به القالب بنجاح. لإجراء الاختبارات، ما عليك سوى تشغيل script/cibuild . ستحتاج إلى تشغيل script/bootstrap مرة واحدة قبل أن يعمل البرنامج النصي للاختبار.
