judaicalink site

موقع جوديكا لينك

تم إنشاء الموقع باستخدام Hugo. Hugo هو منشئ مواقع ثابتة، يستخدم مواقع Markdown والقوالب لتجميع مواقع الويب الثابتة.

ما هو JudaicaLink؟

تثبيت

استنساخ المشروع: git clone https://github.com/judaicalink/judaicalink-site.git .

انتقل إلى الدليل: cd judaicalink-site .

قم بتثبيت Hugo (انظر أدناه).

ويندوز

ما عليك سوى تنزيل ملف Hugo القابل للتنفيذ (الإصدار المستخدم حاليًا على الخادم: 0.104.3).

يجب عليك إضافة Hugo في متغيرات البيئة الخاصة بك ضمن PATH:

على سبيل المثال: C:UsersYourNamehugo_0.31.1_Windows-64bit

للتحقق من نجاح التثبيت، يمكنك كتابة hugo help في موجه الأوامر الخاص بك. يجب أن تحصل على رد يحتوي على عدة أوامر يستطيع Hugo تنفيذها.

-> للحصول على توجيهات أكثر تفصيلاً، راجع دليل Hugo الذي يوفر دليل التثبيت الشامل للنوافذ

في موجه الأوامر، انتقل إلى الدليل الرئيسي للمستودع المستنسخ (حيث يوجد ملف README.md) وقم بتنفيذ الأمر hugo server .

على سبيل المثال: C:UsersYourNamejudaicalink-site>hugo server

بعد ذلك، يمكنك تصفح الموقع محليًا تحت http://localhost:1313

لينكس

أوبونتو: sudo apt update && sudo apt install hugo .

القوس: sudo pacman -S hugo .

فيدورا، ريدهات: sudo pacman -S hugo

تحقق من التثبيت باستخدام: hugo --version .

أوكس

قم بتثبيت Hugo مع brew install hugo .

تحقق من التثبيت باستخدام: hugo --version .

جري

قم بخدمة Hugo مباشرة على جهازك المحلي مع hugo serve . يفتح خادم الويب. تحقق من المحطة لمعرفة الرابط والمسار.

تحقق أيضًا من الأخطاء.

تجميع

إذا كنت تريد تجميع المصدر وإنشاء موقع مباشر، فما عليك سوى تشغيل hugo .

يؤدي هذا إلى إنشاء الملفات static والمجلد public .

إذا كنت تريد تجميع المواقع في مجلد معين، فما عليك سوى استخدام: hugo -d <your-destination> .

يمكنك الآن خدمة الصفحات باستخدام خادم ويب مثل Apache2 أو NGINX.

إما أن تقوم بنسخ المجلدات public static إلى دليل العرض أو إضافة الدلائل في sites-available إلى توجيه الموقع.

لا تقم بخدمة المجلد static أيضًا.

تحديث الموقع

ما عليك سوى إحضار أحدث إصدار من الموقع وسحبه، git fetch و git pull . تجميع الموقع مرة أخرى.

صورة عامل الميناء

إذا كنت ترغب في إنشاء صورة عامل إرساء، فاستنسخ المستودع وقم بتشغيل docker build -t judaicalink-site . في الدليل الجذر للمستودع.

لتشغيل الصورة، استخدم docker run -d -p 80:80 judaicalink-site .

استكشاف الأخطاء وإصلاحها

تحقق مما إذا كان بناء جملة Markdown صحيحًا.

راقب وحدة التحكم بحثًا عن الأخطاء إذا لم تظهر التغييرات كما هو متوقع.

قم بخدمة الموقع محليًا وتحقق من التغييرات.

امسح ذاكرة التخزين المؤقت للمتصفح الخاص بك.

أخيراً

عند الانتهاء، أرسل تغييراتك إلى مستودعك المتشعب وأرسل طلب السحب.