create static site

إنشاء موقع ثابت

إنشاء مواقع ويب ثابتة بدون تكوين البناء.

ملخص

 npx create-static-site my-site --template hugo
cd my-site
npm start

(يأتي npx مع npm 5.2+ والإصدارات الأحدث)

ثم افتح http://localhost:3000/ لرؤية تطبيقك.

إنشاء موقع ثابت

ستحتاج إلى Node >= 6 على جهاز التطوير المحلي الخاص بك . يمكنك استخدام nvm (macOS/Linux) أو nvm-windows لتبديل إصدارات Node بسهولة بين المشاريع المختلفة.

لإنشاء تطبيق جديد، قم بتشغيل:

npx create-static-site my-site --template [template]

استبدل [template] إما بـ hugo أو jekyll .

سيقوم بإنشاء دليل يسمى my-site داخل المجلد الحالي.
داخل هذا الدليل، سيتم إنشاء بنية المشروع الأولية وتثبيت التبعيات المتعدية:

 my-site
├── LICENSE
├── node_modules
├── package.json
├── README.md
├── static-scripts.config.js
├── .browserslistrc
├── .eslintrc.yml
├── .gitignore
├── .postcssrc.js
├── .stylelintrc.yml
├── site/ # Depends on the static site generator
└── src/
    ├── css/
    │   ├── styles.css
    │   └── imports
    │       └── resets.css
    ├── img/
    │   └── svg/
    │       ├── bitbucket.svg
    │       ├── github.svg
    │       └── gitlab.svg
    └── js/
        ├── scripts.js
        └── imports/
            └── index.js

لا يوجد أي تكوين أو بنية مجلدات معقدة، فقط الملفات التي تحتاجها لإنشاء موقعك.
بمجرد الانتهاء من التثبيت، يمكنك فتح مجلد المشروع الخاص بك:

 cd my-site

داخل المشروع الذي تم إنشاؤه حديثًا، يمكنك تشغيل بعض الأوامر المضمنة:

npm start أو yarn start

سيحتاج مستخدمو Jekyll إلى تشغيل bundle install أولاً

تشغيل التطبيق في وضع التطوير.
افتح http://localhost:3000 لمشاهدته في المتصفح.

سيتم إعادة تحميل الصفحة تلقائيًا إذا قمت بإجراء تغييرات على الكود.

npm build أو yarn build

يبني موقع الإنتاج إلى المجلد dist .

فلسفة

• تبعية واحدة: هناك تبعية بناء واحدة فقط. يستخدم Webpack، وBabel، وESLint، وPostCSS، وغيرها من المشاريع الرائعة، ولكنه يوفر تجربة منظمة متماسكة فوقها.

• لا يوجد تكوين مطلوب: لا تحتاج إلى تكوين أي شيء. يتم التعامل مع التكوين الجيد بشكل معقول لكل من إصدارات التطوير والإنتاج حتى تتمكن من التركيز على كتابة التعليمات البرمجية.

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

ما هو مدرج؟

ستحتوي بيئتك على كل ما تحتاجه لإنشاء موقع ويب ثابت وحديث:

• مولد موقع ثابت (Jekyll أو Hugo)
• إضافات اللغة خارج ES6، مثل عامل انتشار الكائن.
• البادئة التلقائية لـ CSS
• تحديثات خالية من المتاعب للأدوات المذكورة أعلاه مع تبعية واحدة.

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

المواقع الثابتة

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

مولدات المواقع الثابتة هي الطريقة الحديثة لبناء المواقع الثابتة. يقومون بتحويل ملفات المحتوى البسيطة المستندة إلى النص إلى ملفات ثابتة جاهزة للويب.

إنها رائعة للمطورين لأنها سريعة للغاية، ومصممة للعمل مع التحكم في الإصدار، ولا تتطلب سوى القليل من الإعداد أو لا تتطلب أي إعداد مقارنة بحلول CMS المتجانسة الحالية مثل Wordpress.

حاليًا، يدعم create-static-site اثنين من مولدات المواقع الثابتة:

• Jekyll هو منشئ موقع ثابت مكتوب بلغة Ruby وتم إنشاؤه بواسطة مؤسس GitHub، Tom Preston Werner.
• Hugo هو منشئ المواقع الثابتة المكتوب بلغة GoLang والذي أنشأه Steve Francia.

المساهمة

نود أن نساعدك في create-static-site ! راجع CONTRIBUTING.md لمزيد من المعلومات حول ما نبحث عنه وكيفية البدء.

المساهمين

شكرًا لهؤلاء الأشخاص الرائعين (مفتاح الرموز التعبيرية):

chrisdmacrae ؟ ؟ ؟ ؟ ؟ ✅	com.ncphillips ؟ ؟ ؟ ؟ ؟ ️ ؟	بريان كلاين ؟ ؟	سكوت جالانت ؟ ؟	دي جي ؟	سيباستيان إنجلز ؟ ؟	آدم ؟

يتبع هذا المشروع مواصفات جميع المساهمين. المساهمات من أي نوع موضع ترحيب!

شكر وتقدير

هذا المشروع مستوحى بشكل كبير من مشروع إنشاء التطبيق الرائع.