seagl.github.io

سي جي إل

هذا هو الكود المصدري لموقع ويب يتم تقديمه على https://seagl.org.

يستخدم Jekyll كمولد موقع ثابت مع صفحات GitHub.

يتم عرض الموقع تلقائيًا عندما يتم دفع التعليمات البرمجية إلى المستودع المشترك في GitHub.

بشكل أساسي، خطوات تحديث الموقع (لنشر منشور مدونة جديد، على سبيل المثال)، هي:

1. شوكة/استنساخ المستودع،
2. قم بإجراء تغييراتك،
3. اختبر تغييراتك،
4. إرسال طلب سحب (PR) للتغييرات،
5. بمجرد دمج العلاقات العامة، سيتم نشر التغييرات الخاصة بك مباشرة

هناك تعليمات لكل خطوة من هذه الخطوات أدناه. تفترض التعليمات أن شخصًا لديه خبرة أقل في git/GitHub/التقنية يقوم بتنفيذ العمل. ويمكن لأولئك الذين لديهم خبرة أكبر أن يستنتجوا ذلك وفقًا لذلك. :-)

شوكة/استنساخ المستودع

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

لتفرع المستودع:

1. انقر فوق الشوكة في أعلى الصفحة.
2. حدد الحساب/المؤسسة الوجهة لنسخة الريبو.
3. انتظر حتى يتم نسخ كل شيء.

فويلا! هذا كل ما في الأمر.

قم بإجراء التغييرات الخاصة بك

إذا كنت تضيف منشورًا جديدًا للمدونة، فيرجى اتباع قواعد اسم الملف التالية:

• ضع جميع منشورات المدونة في دليل _posts .
• ابدأ اسم الملف بتاريخ بتنسيق YYYY-MM-DD . يعد هذا أمرًا مهمًا للغاية لأنه يتحكم في الترتيب الذي يعرض به موقع الويب منشورات المدونة.
  • ملاحظة مفيدة : سيعرض موقع الويب منشورات مؤرخة حتى التاريخ الحالي. يتيح لك هذا جدولة المنشورات مسبقًا، ولكنه يعني أيضًا أن المنشورات المؤرخة في المستقبل لن تظهر إلا إذا استخدمت --future عند اختبار تغييراتك. في الوقت الحالي، يُطلب أيضًا تشغيل إعادة بناء الموقع في التاريخ المحدد أو بعده حتى يظهر المنشور. يمكن القيام بذلك باستخدام: git commit -m 'rebuild pages' --allow-empty && git push origin main أو عن طريق إجراء أي تغيير فعلي على الموقع.
• اتبع التاريخ بشرطة ( - ) ثم عنوان المنشور مفصول بشرطة. لا يتم عرض هذا العنوان. انها مجرد تسمية الملف. يرجى جعلها مختصرة ولكن وصفية.
• استخدم ملحق اسم الملف .md للإشارة إلى أن المنشور مؤلف بتنسيق Markdown. (ويرجى إنشاء منشورات باستخدام Markdown فقط)

بموجب هذه القواعد، يمكن أن يكون لمقالة المدونة التي تعلن عن افتتاح CFP لعام 2017 اسم ملف:

 2017-06-19-CFP-open.md

الرجاء أيضًا إضافة ما يلي في أعلى ملفك:

 ---
layout: post
title: 'Example Title'
status: publish
type: post
published: true
categories: news
tags: '2013'
---

قم بتعيين title لعنوان مشاركة مدونتك وتحرير tags لتضمين سنة المؤتمر التي يرتبط بها المنشور (فارغ في حالة عدم وجوده). يرجى ترك بقية القيم كما هي.

بالنسبة لمحتوى الملف الفعلي، يمكنك إجراء تغييراتك إما في واجهة ويب GitHub أو على جهازك المحلي.

على جيثب

1. انتقل إلى الدليل الذي يوجد به الملف الذي ترغب في تعديله أو إضافته (ربما _posts ).
2. لإنشاء ملف جديد:
   • انقر فوق Create a new file
   • قم بتسمية ملفك (وفقًا للتعليمات المذكورة أعلاه إذا كان منشور مدونة)
3. قم بإجراء التغييرات الخاصة بك
   • لإنشاء ملف جديد:
     • انقر فوق Create a new file
     • أدخل اسم ملف (وفقًا للتعليمات المذكورة أعلاه إذا كانت مشاركة مدونة)
   • لتحرير ملف موجود:
     • انقر على الملف لتحديده
     • انقر على أيقونة القلم الرصاص الصغيرة
   • وفي كلتا الحالتين، يمكنك الآن تحرير الملف في واجهة الويب.
4. قم بإجراء تغييراتك باستخدام نموذج Commit changes الموجود أسفل واجهة التحرير.
   • أدخل عنوانًا مختصرًا ولكن وصفيًا مثل "إضافة إعلان افتتاح CFP لعام 2017".
   • أدخل وصفا تفصيليا. إذا كنت تعمل على مشكلة ما، يرجى الإشارة إلى رقم المشكلة هنا. استخدم علامة التجزئة ( # ) متبوعة برقم الإصدار ( #74 ). سيتم ربط هذا تلقائيًا في طلب السحب، وهو أمر مفيد حقًا.

على جهازك المحلي

سيتم تحديده لاحقًا (يفترض أن أولئك الذين يستخدمون git على أجهزتهم المحلية يعرفون ذلك بالفعل؛ سيتم ملؤه لاحقًا)

1. استنساخ شوكة الخاص بك
2. قم بإجراء التغييرات (إضافة و/أو تحرير الملفات)
3. أعد تغييراتك إلى مفترقك

اختبر تغييراتك

يرجى اختبار جميع التغييرات محليًا قبل الدفع إلى GitHub.

خادم التنمية المحلية

سيؤدي بدء تشغيل خادم تطوير محلي إلى إتاحة نسختك من الموقع على http://localhost:4000. هناك عدة طرق لتشغيل الخادم. اختر ما يناسبك!

الخيار 1: المعدن العاري

التبعيات:

• روبي
• المجمع

الإعداد لمرة واحدة:

bundle install

بدء الخادم:

bundle exec jekyll serve --watch

لمعاينة المنشورات ذات التاريخ المستقبلي وغير المنشورة، أضف --future --unpublished إلى الأمر أعلاه.

الخيار 2: في حاويات

التبعيات:

• Docker (أو Podman؛ استبدل docker بـ podman )

الإعداد لمرة واحدة:

docker build --tag ' seagldev ' ' . '

بدء الخادم:

docker run --rm --interactive --tty --publish ' 4000:4000 ' --volume " $PWD :/usr/src/app " ' seagldev '

لمعاينة المنشورات ذات التاريخ المستقبلي وغير المنشورة، أضف --future --unpublished في نهاية الأمر أعلاه.

أرسل طلب سحب (PR) للتغييرات

يمكنك إما إرسال العلاقات العامة في واجهة GitHub أو من جهازك المحلي.

على جيثب

1. في متصفحك، انتقل إلى شوكة Seagl.github.io repo.
2. انقر فوق علامة التبويب Pull requests .
3. انقر فوق New pull request button .
4. يدرك GitHub أن الريبو الخاص بك هو عبارة عن شوكة ويفترض أن تكون العلاقات العامة هي الفرع الرئيسي لشوكة الطلب الخاصة بك مقابل الفرع الرئيسي لـ seagl.github.io. الاحتمالات جيدة جدًا وهذا ما تريده. إذا لم يكن الأمر كذلك، فستعرف ما يكفي لإدراك ذلك. :-)
5. انقر فوق Create pull request .
6. أدخل عنوانًا مختصرًا ولكن وصفيًا مثل "إضافة إعلان افتتاح CFP لعام 2017".
7. أدخل وصفا تفصيليا. إذا كنت تعمل على مشكلة ما، يرجى الإشارة إلى رقم المشكلة هنا. استخدم علامة التجزئة ( # ) متبوعة برقم الإصدار ( #74 ). سيتم ربط هذا تلقائيًا في طلب السحب، وهو أمر مفيد حقًا.
8. حدد [Allow edits from maintainers](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/allowing-changes-to-a-pull-request-branch-created-from-a-fork) حتى يتمكن أعضاء الفريق الآخرون من إجراء التعديلات، إذا لزم الأمر.
9. انقر فوق Create pull request .

على جهازك المحلي

سيتم تحديده لاحقًا (يفترض أن أولئك الذين يستخدمون git على أجهزتهم المحلية يعرفون ذلك بالفعل؛ سيتم ملؤه لاحقًا)

سيتم نشر التغييرات الخاصة بك مباشرة

الآن يجب على شخص ما (ربما أنت، إذا كان لديك هذا المستوى من الوصول إلى الريبو) مراجعة طلب السحب الخاص بك ثم دمجه.

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

ملاحظة مفيدة : لن يؤدي الدمج نفسه إلى إعادة بناء الموقع. لإعادة بناء الموقع، تحتاج إلى دفع التزام فارغ كما يلي:

git commit --allow-empty -m " Rebuild the site, please " && git push

كيفية إضافة الصور إلى المشاركات

أضف صورتك إلى دليل img/posts/ ، ثم استخدم Markdown التالي:

 ![ Example description ] ( /img/posts/example.jpg )

نصائح:

• لمحاذاة الصورة إلى الجانب، قم بإضافة فئة align-left أو align-right :

   ![ Example description ] ( /img/posts/example.jpg ) {:.align-left}

• من أجل أوقات تحميل الصفحة، قم بتغيير حجم الصور إلى حجم معقول قبل استخدامها في المنشور.

أرشيف المؤتمرات السابقة

تتم أرشفة المؤتمرات السابقة بشكل ثابت كمجموعات Jekyll:

• archive-conferences
• archive-sessions

لإنشاء أرشيف لسنة معينة، قم أولاً باستيراد البيانات من الجدول—

bundle exec rake import[2020]

- ثم قم بتحرير ملفات الأرشيف يدويًا إذا كانت هناك حاجة لأي تصحيحات.