مجموعة أدوات البدء الأساسية للمواقع الثابتة المبنية على Gatsby.js.
ابدأ في التطوير.
انتقل إلى دليل موقعك الجديد وابدأ تشغيله.
cd my-site/
gatsby develop
افتح الكود المصدري وابدأ في التحرير!
موقعك يعمل الآن على http://localhost:8000
!
ملاحظة: سترى أيضًا رابطًا ثانيًا: http://localhost:8000/___graphql
. هذه أداة يمكنك استخدامها لتجربة الاستعلام عن بياناتك. تعرف على المزيد حول استخدام هذه الأداة في برنامج Gatsby التعليمي.
افتح دليل my-site
في محرر التعليمات البرمجية الذي تختاره وقم بتحرير src/pages/index.js
. احفظ تغييراتك وسيتم تحديث المتصفح في الوقت الفعلي!
نظرة سريعة على الملفات والأدلة ذات المستوى الأعلى التي ستراها في مشروع Gatsby.
.
├── node_modules
├── src
├── .gitignore
├── .prettierrc
├── gatsby-browser.js
├── gatsby-config.js
├── gatsby-node.js
├── gatsby-ssr.js
├── LICENSE
├── package-lock.json
├── package.json
├── README.md
└── yarn.lock
/node_modules
: يحتوي هذا الدليل على كافة وحدات التعليمات البرمجية التي يعتمد عليها مشروعك (حزم npm) التي يتم تثبيتها تلقائيًا.
/src
: سيحتوي هذا الدليل على كافة التعليمات البرمجية المتعلقة بما ستراه في الواجهة الأمامية لموقعك (ما تراه في المتصفح) مثل رأس موقعك أو قالب الصفحة. src
هو اصطلاح لـ "الكود المصدري".
.gitignore
: يخبر هذا الملف git بالملفات التي يجب ألا يتتبعها/لا يحتفظ بسجل إصدارات لها.
.prettierrc
: هذا ملف تكوين لـ Prettier. Prettier هي أداة للمساعدة في الحفاظ على اتساق تنسيق التعليمات البرمجية الخاصة بك.
gatsby-browser.js
: هذا الملف هو المكان الذي يتوقع Gatsby العثور فيه على أي استخدام لواجهات برمجة تطبيقات متصفح Gatsby (إن وجدت). تسمح هذه بتخصيص/تمديد إعدادات Gatsby الافتراضية التي تؤثر على المتصفح.
gatsby-config.js
: هذا هو ملف التكوين الرئيسي لموقع Gatsby. هذا هو المكان الذي يمكنك فيه تحديد معلومات حول موقعك (بيانات التعريف) مثل عنوان الموقع ووصفه، ومكونات Gatsby الإضافية التي ترغب في تضمينها، وما إلى ذلك. (راجع مستندات التكوين لمزيد من التفاصيل).
gatsby-node.js
: هذا الملف هو المكان الذي يتوقع Gatsby العثور فيه على أي استخدام لواجهات برمجة تطبيقات Gatsby Node (إن وجدت). تسمح هذه بتخصيص/تمديد إعدادات Gatsby الافتراضية التي تؤثر على أجزاء من عملية إنشاء الموقع.
gatsby-ssr.js
: هذا الملف هو المكان الذي يتوقع Gatsby العثور فيه على أي استخدام لواجهات برمجة تطبيقات العرض من جانب خادم Gatsby (إن وجدت). تسمح هذه بتخصيص إعدادات Gatsby الافتراضية التي تؤثر على العرض من جانب الخادم.
LICENSE
: تم ترخيص Gatsby بموجب ترخيص MIT.
package-lock.json
(انظر package.json
أدناه أولاً). هذا ملف يتم إنشاؤه تلقائيًا استنادًا إلى الإصدارات الدقيقة لتبعيات npm التي تم تثبيتها لمشروعك. (لن تقوم بتغيير هذا الملف مباشرة).
package.json
: ملف واضح لمشاريع Node.js، والذي يتضمن أشياء مثل البيانات الوصفية (اسم المشروع، المؤلف، إلخ). هذا البيان هو كيف يعرف npm الحزم التي يجب تثبيتها لمشروعك.
README.md
: ملف نصي يحتوي على معلومات مرجعية مفيدة حول مشروعك.
yarn.lock
: Yarn هو مدير حزم بديل لـ npm. يمكنك استخدام الغزل أو npm، على الرغم من أن جميع مستندات Gatsby تشير إلى npm. يخدم هذا الملف بشكل أساسي نفس غرض package-lock.json
، فقط لنظام إدارة حزم مختلف.
للنشر يمكنك استخدام Gitlab CI. يوجد في المشروع ملفان - نموذج .gitlab-ci.yml
ونشر S3 .gitlab-ci-s3.yml
.