قالب أولي لإنشاء مواقع ويب سريعة للغاية باستخدام Ghost & Gatsby
العرض التوضيحي: https://gatsby.ghost.org/
# With Gatsby CLI
gatsby new gatsby-starter-ghost https://github.com/TryGhost/gatsby-starter-ghost.git
# From Source
git clone https://github.com/TryGhost/gatsby-starter-ghost.git
cd gatsby-starter-ghost
ثم قم بتثبيت التبعيات
yarn
ابدأ تشغيل خادم التطوير. لديك الآن موقع Gatsby يسحب المحتوى من Ghost مقطوعة الرأس.
gatsby develop
افتراضيًا، سيقوم المبتدئ بملء المحتوى من تثبيت Ghost الافتراضي الموجود على https://gatsby.ghost.io.
لاستخدام التثبيت الخاص بك، ستحتاج إلى تحرير ملف التكوين .ghost.json
باستخدام بيانات الاعتماد الخاصة بك. قم بتغيير قيمة apiUrl
إلى عنوان URL لموقع Ghost الخاص بك. بالنسبة لعملاء Ghost(Pro)، هذا هو عنوان URL الخاص بـ Ghost الذي ينتهي بـ .ghost.io
، وبالنسبة للأشخاص الذين يستخدمون الإصدار المستضاف ذاتيًا من Ghost، فهو نفس عنوان URL المستخدم للوصول إلى موقعك.
بعد ذلك، قم بتحديث قيمة contentApiKey
إلى مفتاح مرتبط بموقع Ghost. يمكن توفير المفتاح عن طريق إنشاء تكامل داخل Ghost Admin. انتقل إلى عمليات التكامل وانقر على "إضافة تكامل جديد". قم بتسمية التكامل بشكل مناسب وانقر فوق "إنشاء".
أخيرًا، قم بتكوين عنوان URL المطلوب في siteConfig.js
، بحيث يتم إنشاء الروابط (مثل الروابط الأساسية) بشكل صحيح. يمكنك أيضًا تحديث القيم الافتراضية الأخرى، مثل postsPerPage
في هذا الملف.
لاستخدام هذا المبدئ بدون مشاكل، يجب أن يكون تثبيت Ghost لديك على الإصدار 2.10.0
على الأقل.
إصدار Ghost الافتراضي المستخدم لهذا المبتدئ هو 5.x
. إذا كان تثبيت Ghost الخاص بك على إصدار أقل، فسوف تحتاج إلى تمرير خاصية version
في إعدادات .ghost.json
الخاصة بك:
الشبح >=2.10.0 <5.0.0
{
"apiUrl" : " https://gatsby.ghost.io " ,
"contentApiKey" : " 9cc5c67c358edfdd81455149d0 " ,
"version" : " v4.0 "
}
الشبح >=5.0.0
{
"apiUrl" : " https://gatsby.ghost.io " ,
"contentApiKey" : " 9cc5c67c358edfdd81455149d0 "
}
يحتوي المبدئ على ثلاثة ملفات تكوين مخصصة للنشر مع Netlify. ملف netlify.toml
لإعدادات البناء، وملف /static/_headers
مع تعيين رؤوس الأمان الافتراضية لجميع المسارات، و /static/_redirects
لتعيين عمليات إعادة توجيه المجال المخصص لـ Netlify.
للنشر في حساب Netlify الخاص بك، اضغط على الزر أدناه.
لا تعتبر مفاتيح Content API عمومًا معلومات حساسة، فهي موجودة بحيث يمكن تغييرها في حالة إساءة الاستخدام؛ لذا فإن معظم الأشخاص يلتزمون به مباشرة في ملف التكوين .ghost.json
الخاص بهم. إذا كنت تفضل الاحتفاظ بهذه المعلومات خارج المستودع الخاص بك، فيمكنك إزالة هذا التكوين وتعيين متغيرات Netlify ENV لإصدارات الإنتاج بدلاً من ذلك.
بمجرد النشر، يمكنك إعداد Ghost + Netlify Integration لاستخدام خطافات النشر من Ghost لتشغيل عمليات إعادة بناء Netlify. بهذه الطريقة، في أي وقت تتغير فيه البيانات في Ghost، سيتم إعادة بناء موقعك على Netlify.
يمكنك تعطيل الواجهة الأمامية الافتراضية لموضوع Ghost Handlebars عن طريق تمكين علامة Make this site private
ضمن إعدادات Ghost الخاصة بك. يؤدي ذلك إلى تمكين الحماية بكلمة مرور أمام تثبيت Ghost وتعيين <meta name="robots" content="noindex" />
بحيث تصبح واجهة Gatsby الأمامية مصدر الحقيقة لتحسين محركات البحث.
# Run a production build, locally
gatsby build
# Serve a production build, locally
gatsby serve
يستخدم develop
Gatsby تكوين development
في .ghost.json
- بينما يستخدم build
Gatsby تكوين production
.
حقوق الطبع والنشر (ج) 2013-2025 لمؤسسة Ghost Foundation - تم إصدارها بموجب ترخيص MIT.