موضوع هوغو يو

يو

موقع تجريبي | سجل التغيير

Yue عبارة عن سمة Hugo بسيطة ومتعددة اللغات وقابلة للتخصيص، ومناسبة للتدوين.

لقطات الشاشة

قد تكون لقطات الشاشة قديمة، لذا من الأفضل زيارة الموقع التجريبي.

الوضع الخفيف على سطح المكتب

الوضع المظلم على سطح المكتب

وضع الضوء على الهاتف المحمول

الوضع المظلم على الهاتف المحمول

سمات

• الحد الأدنى من المظهر

• سهل التثبيت (مع تثبيت Git وHugo، يمكنك إنشاء موقع ويب في بضع ثوانٍ)

• وثائق مفصلة

• الوضع المظلم التلقائي

• متعدد اللغات

• قائمة الترجمة في صفحة واحدة

• محدد اللغة (انتقل إلى الصفحة المقابلة أو الصفحة الرئيسية)

• مؤلفين متعددين

• جدول المحتويات (قابل للطي، يتم إنشاؤه فقط عند توفره)

• تاريخ التعديل على الصفحة الرئيسية والصفحة الفردية وصفحة القسم وصفحة الفصل الدراسي

• تنسيق التاريخ المخصص

• ترقيم الصفحات على الصفحة الرئيسية وصفحة القسم

• النص الكامل آر إس إس

• العلامات والفئات

• إشعار حقوق الطبع والنشر (يمكن تعيين المؤلف والسنة)

• رابط آر إس إس

• رابط ربط العنوان

• الهاتف المحمول أولاً وسريع الاستجابة

• SCSS

• تحسين محرك البحث

• بيانات جزئية

• الوصف التعريفي

• افتح الرسم البياني

• عدد الصفحات للأقسام ( /posts/ ، /tags/ ، وما إلى ذلك)

• التخصيص

• الرمز المفضل

• الأنماط (SCSS)

• المحتويات (HTML)

لمعرفة جميع الميزات، تحقق من Hugo.yaml (التكوين الافتراضي) وexampleSite/hugo.yaml (تكوين الموقع التجريبي).

ابدأ

ثَبَّتَ

قم بتثبيت Git وأحدث إصدار من Hugo.

 # إنشاء موقع websitegit init my-websitecd my-website# تثبيت إضافة وحدة themegit الفرعية --عمق=1 https://github.com/CyrusYip/hugo-theme-yue theme/hugo-theme-yue
git Commit --message "add theme"# إنشاء محتوى تجريبي cp --recursive theme/hugo-theme-yue/exampleSite/* .# خادم Previewhugo

الآن لدينا webiste التجريبي العمل. يحتوي دليل content على المحتوى، و hugo.yaml هو ملف التكوين. لا تتردد في اللعب معهم.

تحديث الموضوع

 مؤتمر نزع السلاح موقع الويب الخاص بي
تحديث الوحدة الفرعية لـ git --remote

من المستحسن قراءة CHANGELOG.md قبل تحديث السمة.

يمكنك الاشتراك في التحديثات وسجل التغيير في مجمع الخلاصات (على سبيل المثال Inoreader).

• التحديثات: https://github.com/CyrusYip/hugo-theme-yue/commits/main.atom

• سجل التغيير: https://github.com/CyrusYip/hugo-theme-yue/commits/main/CHANGELOG.md.atom

موقع استنساخ

تحتاج إلى استخدام خيارات إضافية عند استنساخ مشروع موقع الويب الخاص بك.

 git clone --recurse-submodules --shallow-submodules [email protected]:your-user-name/my-website.git

نشر

بعد إعداد موقع الويب، ربما ترغب في استضافته على الإنترنت. هناك العديد من الطرق للقيام بذلك، راجع الاستضافة والنشر | هوغو. إذا كنت لا تعرف ماذا تختار، فيمكنك البدء من Netlify، راجع المضيف على Netlify | هوغو.

تأكد من تغيير عنوان URL الأساسي إلى اسم النطاق الخاص بك (على سبيل المثال https://my-cool-domain.org/ ) في hugo.yaml .

 -baseURL: https://yue.cyrusyip.org/+baseURL: https://my-cool-domain.org/

أمر البناء الموصى به:

 هوغو --gc --minify

--gc يزيل ملفات ذاكرة التخزين المؤقت غير المستخدمة، و --minify يقلل حجم موقع الويب (HTML بشكل أساسي).

الاستخدام

إنشاء مشاركة جديدة.

hugo new content content/en/posts/my-first-post.md

لمعرفة المزيد حول الاستخدام، راجع:

• الاستخدام الأساسي | هوغو

• هيكل الدليل | هوغو

التكوين

يتم إدراج الإعدادات في exampleSite/hugo.yaml (تكوين الموقع التجريبي) وhugo.yaml (التكوين الافتراضي، الذي تم استيراده بواسطة السابق).

في جذر مشروع موقع الويب الخاص بك، يعد hugo.yaml هو ملف التكوين، وهو نسخة من exampleSite/hugo.yaml.

لمعرفة التكوين، راجع تكوين Hugo | هوغو.

وضع متعدد اللغات

اللغات المدعومة:

• en : الإنجليزية

• fr : الفرنسية

• zh-CN : الصينية المبسطة

لإنشاء موقع ويب متعدد اللغات، راجع الوضع متعدد اللغات | هوغو وexampleSite/hugo.yaml.

توجد ملفات الترجمة في دليل i18n و data/i18n.yaml. المساهمات للغات إضافية هي موضع ترحيب.

للمساهمة بلغة جديدة:

1. قم بإنشاء ملف لغة (على سبيل المثال، fr.yaml للغة الفرنسية) في دليل i18n.

2. انسخ محتوى i18n/en.yaml إلى الملف الجديد.

3. قم بإزالة جميع التعليقات ( # ... ) وترجم المحتوى.

4. قم بترجمة المحتوى الموجود في data/i18n.yaml أيضًا.

إذا كنت ترغب في الاستمرار في المساهمة في الترجمة، يمكنك الحصول على أحدث التغييرات من خلال الاشتراك في موجز i18n/en.yaml (https://github.com/CyrusYip/hugo-theme-yue/commits/main/i18n/en.yaml) .atom) باستخدام قارئ RSS.

عنوان العلامات والفئات

إذا لم يكن موقع الويب الخاص بك باللغة الإنجليزية، فمن المحتمل أنك تريد تخصيص عنوان /tags و /categories .

على سبيل المثال، لتخصيص عنوان /tags لموقع الويب zh-CN ، قم بإنشاء content/zh-CN/tags/_index.md وأضف المحتوى التالي إلى الملف.

---
title: Chinese Tags
---

تخصيص

يتيح لك Yue تخصيص الأيقونة المفضلة والأنماط (SCSS) والمحتويات (HTML).

الرمز المفضل

Favicon هو الرمز الموجود بجوار العنوان في علامة تبويب المتصفح. لاستخدام الأيقونة المفضلة لديك، ضع favicon.ico ضمن الدليل static . يمكنك إنشاء favicon.ico على مولدات favicon.ico عبر الإنترنت.

الأنماط (SCSS)

يستخدم Yue SCSS (libsass) لإضافة الأنماط. جميع الملفات موجودة في الأصول/scss. لتخصيص الأنماط، قم بإنشاء assets/scss/_style-start.scss و assets/scss/_style-end.scss .

يتم تطبيق _style-start.scss أولاً، ويمكنك تجاوز المتغيرات في هذا الملف.

 حجم الخط الأساسي $: 15 بكسل؛

تم تطبيق _style-end.scss أخيرًا، ويمكنك إضافة أنماط في هذا الملف.

Vanilla CSS صالح أيضًا في SCSS.

مراجع:

• CSS: أوراق الأنماط المتتالية | MDN

• ساس: أساسيات ساس

• هيكل الدليل | هوغو

المحتويات (HTML)

يمكنك إنشاء هذه الملفات لإدراج كود HTML.

• layouts/partials/head/head-start.html

• layouts/partials/head/head-end.html

• layouts/partials/single/single-end.html

• layouts/partials/body/body-end.html

head-start.html

تتم إضافة head-start.html بالقرب من بداية عنصر .

حالات الاستخدام:

• التحميل المسبق للبرامج النصية

• تحميل البرامج النصية

• تحميل الأنماط

فيما يلي مثال على البرامج النصية للتحميل المسبق:

head-end.html

تتم إضافة head-end.html إلى نهاية العنصر .

حالات الاستخدام:

• تحميل البرامج النصية

• تحميل الأنماط

فيما يلي مثال على إضافة Google Analytics والبرنامج النصي المحلي:

 {{ مع الموارد.احصل على "js/my-script" .js" | js.Build }} {{ end }}

Single-end.html

تتم إضافة single-end.html إلى نهاية العنصر

في المنشور.

حالات الاستخدام:

• خدمات التعليق، على سبيل المثال Disqus وgiscus

فيما يلي مثال لإضافة Giscus:

 {{ لغة $ := "" }}
{{- /*
الحل البديل لـ LanguagePrefix الصغيرة،
راجع https://github.com/gohugoio/hugo/issues/9404
*/ - }}
{{ إذا كان موقع مكافئ.LanguagePrefix "/zh-cn" }}
  {{ $language = "zh-CN" }}
{{ آخر }}
  {{ $language = "ar" }}
{{ النهاية }

قائمة خدمات التعليقات: التعليقات | هوغو.

body-end.html

تتم إضافة body-end.html إلى نهاية العنصر .

حالات الاستخدام:

• تحميل البرامج النصية بشكل حيوي

يدعم

للإبلاغ عن الأخطاء، أرسل مشكلة. لطرح الأسئلة، ابدأ المناقشة.

مزيد من القراءة

لدى Hugo العديد من الميزات، اقرأ وثائق Hugo لتتعلم.

سجل التغيير

راجع CHANGELOG.md.

تطوير

يستخدم هذا المشروع Hugo-bin - npm لإدارة إصدار Hugo. المتطلب السابق: Node.js وnpm.

استنساخ هذا المستودع.

 تثبيت npm
تشغيل npm نظيف: الخادم: مشترك

هناك أوامر مفيدة أخرى مدرجة في package.json. لاستخدام إصدار Hugo الموصى به، قم بتشغيل npx hugo .

---

إذا لم يكن Node.js وnpm مثبتين لديك، فما عليك سوى تثبيت الإصدار المدرج في package.json.

 "hugo-bin": { "buildTags": "extensive", "version": "x.yyy.z"},

يجب تحديث CHANGELOG.md في كل التزام.

مواقع الويب التي تم إنشاؤها باستخدام Yue

إذا كنت تستخدم Yue وتمت استضافة الكود المصدري لموقعك على GitHub، فيمكنك إضافة موضوع hugo-theme-yue إلى مستودعك.

رابط إلى موضوع hugo-theme-yue .

شكر وتقدير

لقد تعلمت الكثير من العديد من المشاريع. شكرا لكم أيها المطورين.

• Hugo-xmin (الحد الأدنى من القوالب)

• هوغو-موضوع-جين (قالب RSS)

• Hugo-theme-zen (محدد اللغة)

• هوغو-موضوع-جروفبوكس (اللون)

• جروف بوكس ​​(لون)

• Hugo-theme-stack (الكود المصدر والوثائق والتكوين)

• Hugo-PaperMod (الكود المصدري والوثائق والتكوين)

رخصة

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