بداية Gatsby لإنشاء مدونات من Ghost CMS مقطوعة الرأس.
قم بتحويل مدونة Ghost الخاصة بك إلى موقع ويب ثابت وسريع. يعد موضوع Gatsby هذا بديلاً أماميًا لمحرك Ghost Handlebars الذي يتميز بمظهر ومظهر Ghost Casper المحسنين. يتم الحصول على كل المحتوى من نظام Ghost CMS مقطوع الرأس.
تعبت من
gatsby-config.js
؟ قم بزيارة Blogody للحصول على حل متكامل مع العديد من الفوائد!
هل تفضل Next.js على غاتسبي؟ توجه إلى شبح cms التالي!
تحقق من البرامج التعليمية للحصول على أدلة عملية حول استخدام هذا المشروع.
العب مع العرض التوضيحي للحصول على الانطباع الأول.
تم تضمين المكونات الإضافية التالية للراحة:
اسم | إصدار | وصف |
---|---|---|
gatsby-theme-ghost-dark-mode | تبديل الوضع المظلم؟ | |
gatsby-rehype-ghost-links | إعادة كتابة روابط CMS من المطلقة إلى النسبية | |
gatsby-rehype-prismjs | تسليط الضوء على بناء الجملة مع PrismJS | |
gatsby-theme-ghost-members ؟ | اشتراكات الأعضاء |
إذا لم تكن في حاجة إليها، يمكنك إخراجها في gatsby-config.js
و package.json
مما قد يوفر لك بعض الوقت أثناء عملية الإنشاء.
يمكن دمج الميزات الإضافية عن طريق تثبيت سمات Gatsby أو المكونات الإضافية. تم اختبار المكونات الإضافية التالية للعمل مع gatsby-starter-try-ghost
:
اسم | إصدار | وصف |
---|---|---|
gatsby-rehype-inline-images ؟ | تحميل الصور المضمنة بشكل بطيء مع تمويه | |
gatsby-theme-ghost-contact | صفحة الاتصال | |
gatsby-theme-ghost-commento | نظام التعليق مع Commento | |
gatsby-theme-ghost-toc ؟ | جدول المحتويات | |
gatsby-plugin-ackee-tracker | تتبع الموقع مع Akee | |
gatsby-plugin-google-analytics | تتبع الموقع باستخدام Google Analytics |
قم بتثبيت هذا المبدئ عن طريق التشغيل
gatsby new try-ghost https://github.com/styxlab/gatsby-starter-try-ghost
تغيير الدليل
cd try-ghost
يجري
yarn develop
وقم بزيارة موقعك على http://localhost:8000
.
//siteConfig.js
module . exports = {
// Do not include a trailing slash!
siteUrl : `https://your-blog.com` ,
// Maximum number of post shown per page
// Infinite Scroll: Initial chunk of posts, subsequent posts are fetched one by one
postsPerPage : 3 ,
// This allows an alternative site title for meta data for pages.
siteTitleMeta : `Gatsby Starter Ghost CMS` ,
// This allows an site description for meta data for pages.
siteDescriptionMeta : `Turn your Ghost blog into a flaring fast static site with Gatsby` ,
// Used for App and Offline manifest e.g. Mobile Home Screen
shortTitle : `Ghost` ,
siteIcon : `favicon.png` ,
backgroundColor : `#e9e9e9` ,
themeColor : `#15171A` ,
// Include Gatsby images for lazy loading and image optimizations (default: true)
gatsbyImages : true ,
// Overwrite navigation menu (default: []), label is case sensitive
// overwriteGhostNavigation: [{ label: `Home`, url: `/` }],
} ;
في التكوين الموضح أعلاه، الحقول الأكثر أهمية التي سيتم تغييرها هي siteUrl
و siteTitleMeta
و siteDescriptionMeta
. قم بتحديث تلك على الأقل لتناسب احتياجاتك.
يتم الحصول على كل المحتوى من Ghost CMS. افتراضيًا، يتم جلب المحتوى من الموقع التجريبي على https://cms.gotsby.org
. بالتأكيد تريد مصدر المحتوى الخاص بك. هناك طريقتان لإتاحة مفاتيح المحتوى الخاصة بك. اختر الطريقة وفقًا لسيناريو البناء الخاص بك.
إذا قمت ببناء مشروعك مع مزود سحابي (مثل Gatsby، Netlify، Vercel)، فإن الخيار الأفضل هو توفير المفاتيح بمتغيرات البيئة:
مفتاح | القيمة (مثال) |
---|---|
GHOST_API_URL | http://localhost:2368 |
GHOST_CONTENT_API_KEY | 9fccdb0e4ea5b572e2e5b92942 |
يعتمد المكان الذي يمكنك تحديدها فيه على الموفر، ولكن عادةً ما تجد الخيار ضمن إعدادات الموقع. يؤدي هذا إلى تجنب نشر المفاتيح في مستودع عام وهو الأكثر أمانًا.
إذا قمت بالإنشاء محليًا أو على شبكة خاصة حيث لا يمكن للعالم الوصول إلى دليل البناء، فيمكنك إضافة ملف .ghost.json
جديد بأمان في الدليل الأساسي الخاص بك باستخدام بنية JSON التالية:
{
" development " : {
" apiUrl " : " http://localhost:2368 " ,
" contentApiKey " : " 9fccdb0e4ea5b572e2e5b92942 "
},
" production " : {
" apiUrl " : " http://localhost:2368 " ,
" contentApiKey " : " 9fccdb0e4ea5b572e2e5b92942 "
}
}
يعد هذا الملف جزءًا من .gitignore
لتجنب نشره عن طريق الخطأ إلى مستودعك العام. قم بتغيير apiUrl
و contentApiKey
لمطابقة مفاتيح Ghost CMS Content API الخاصة بك.
للحصول على أفضل نتائج لتحسين محركات البحث، يوصى بشدة بتعطيل الواجهة الأمامية الافتراضية لموضوع Ghost Handlebars عن طريق تحديد علامة جعل هذا الموقع خاصًا ضمن إعدادات مشرف Ghost. يؤدي ذلك إلى تمكين الحماية بكلمة مرور أمام تثبيت Ghost وتعيين <meta name="robots" content="noindex" />
بحيث تصبح واجهة Gatsby الأمامية هي المصدر المعتمد لمحركات البحث.
يوصى بتثبيت npm-upgrade باستخدام sudo npm install npm-upgrade -g
. قم بالتغيير إلى الدليل الأساسي وتحديث جميع الحزم باستخدام:
npm-upgrade
سيُطلب منك تحديث جميع الحزم الموجودة في ملف package.json
الخاص بك. بعد ذلك، قم بتنزيل الحزم الجديدة:
yarn
yarn clean
اكتملت الآن عملية التحديث ويمكنك بدء إنشاء جديد باستخدام yarn build
(أو yarn develop
).
الرجاء الإبلاغ عن جميع الأخطاء والمشكلات في gatsby-theme-try-ghost/issues حيث أن كل التطوير يحدث هناك.
لا ينتمي هذا المشروع إلى Gatsby أو Ghost.
حقوق الطبع والنشر (ج) لعام 2020 مملوكة لشركة styxlab - تم إصدارها بموجب ترخيص MIT.