expressjs.com

Expressjs.com

هذا هو مستودع موقع الويب Expressjs.com. يتم استضافته مباشرة من المستودع كموقع على موقع GitHub Pages.

الإعداد المحلي

لمعاينة الموقع محليًا:

1. قم بتثبيت Ruby و Bundler إذا لم يكن لديك بالفعل.

2. تثبيت Jekyll-Redirect-from Gem:

   $ gem install jekyll-redirect-from

3. استنساخ هذا المستودع عن طريق تشغيل الأمر التالي:

   $ git clone https://github.com/expressjs/expressjs.com.git

4. انتقل إلى دليل المستودع المستنسخ وقم بتشغيل الأمر التالي:

   $ bundle install

   سوف يبحث Bundler في Gemfile التي يتم تثبيتها للأحجار الكريمة. تتضمن github-pages GEM نفس الإصدار من Jekyll والتبعيات الأخرى التي تستخدمها صفحات GitHub ، بحيث يعكس الإعداد المحلي صفحات Github بأقصى قدر ممكن.

5. قم بتشغيل Jekyll باستخدام الأمر التالي:

   $ bundle exec jekyll serve

   ثم ، قم بتحميل http: // localhost: 4000 في متصفحك.

الإعداد المحلي باستخدام Docker

نصيحة

يمكنك تشغيل make help في الحصول على معلومات مفصلة حول كيفية استخدام أوامر Make الخاصة بنا.

0. تأكد من أن لديك Docker وتثبيت.
1. تشغيل make build لبناء المشروع.
2. Run make serve to Project ، ويشمل ذلك إعادة التحميل المباشر بحيث ينعكس أي تغيير (قد يستغرق الأمر بعض الوقت ، والتحقق من السجلات).
3. قم بتشغيل make clean لإزالة صور Docker والموارد التي تم إنشاؤها.

التنسيق

يستخدم Jekyll متغيرًا من التخفيض المعروف باسم Kramdown.

يستخدم Jekyll محرك القالب السائل للتطبيق.

يمكنك استخدام كتل الكود المسيجة GFM لـ JavaScript ؛ على سبيل المثال:

 `` `JS
var express = require ('Express')
var app = express ()
app.listen (3000)
`` `

النتيجة تبدو هكذا:

 const express = require ( 'express' )
const app = express ( )
app . listen ( 3000 )

تم تعطيل بناء جملة GitHub Pages الافتراضي في _config.yml للسماح بتسليط الضوء على prism.js.

المساهمة

لا تتردد في إجراء تغييرات على ملفات القالب أو ملفات المستندات. تقع مستندات الدعم في الدلائل الخاصة بكل منها ، وتقع مستندات API تحت دليل _includes .

يرجى الاطلاع على دليل المساهمين لمزيد من المعلومات حول المساهمة في الوثائق ، بما في ذلك المعلومات حول الترجمات المساهمة.

لماذا تستخدم jekyll بدلاً من حل قائم على قائم على ذلك؟

يأتي Jekyll مدمجًا مع صفحات GitHub. نظرًا لأننا نستخدم بالفعل صفحات github لاستضافة موقع الويب ، فمن المنطقي الاستفادة من القدرات التي توفرها. الأمر كله يتعلق باستخدام الأداة الصحيحة ، للوظيفة الصحيحة ، في ظل الظروف المناسبة.