pages cms

صفحات CMS

Pages CMS هو نظام إدارة المحتوى مفتوح المصدر لـ GitHub. إنه مناسب بشكل خاص لمولدات المواقع الثابتة (على سبيل المثال Jekyll ، Next.js ، Vuepress ، Hugo).

يوفر واجهة سهلة الاستخدام لتحرير محتوى موقع الويب الخاص بك أو التطبيق مباشرة على Github.

شاهد العرض التوضيحي ▶

الوثائق

انتقل إلى pagescms.org/docs.

بنيت مع

• Next.js
• Tailwind CSS
• Shadcn/UI
• رذاذ
• Vercel
• TURSO
• إعادة الالتحاق

استخدم عبر الإنترنت

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

يتطابق هذا الإصدار عبر الإنترنت مع ما هو موجود في هذا الريبو ، ولكن يمكنك أيضًا تثبيت الإصدار الخاص بك محليًا أو نشره (مجانًا) على Vercel بعد الخطوات أدناه.

تثبيت ونشر

إنشاء تطبيق github

سواء كنت تقوم بتثبيت صفحات CMS محليًا أو تنشرها عبر الإنترنت ، فستحتاج إلى تطبيق GitHub.

يمكنك إما إنشاءه ضمن حسابك الشخصي (https://github.com/settings/apps) أو تحت إحدى منظماتك (https://github.com/organizations//settings/apps).

ستحتاج إلى ملء المعلومات التالية:

• اسم تطبيق GitHub : استخدم "صفحات CMS" أو أي شيء تعتقد أنه مناسب (على سبيل المثال "صفحات CMS (dev)").
• عنوان URL للصفحة الرئيسية : كل ما تريد ، سيفعل https://pagescms.org.
• تحديد المستخدمين وتفويضهم :
  • عنوان URL للاتصال: عنوان URL لـ /api/auth/github :
    • http://localhost:3000/api/auth/github للتنمية ،
    • شيء مثل https://my-vercel-url.vercel.app/api/auth/github (أو أي مجال مخصص تستخدمه) إذا كنت تنشر على Vercel.
  • تنتهي صلاحية رموز ترخيص المستخدم: لا.
  • طلب ترخيص المستخدم (OAUTH) أثناء التثبيت: نعم.
  • تمكين تدفق الجهاز: لا.
• ما بعد التثبيت :
  • عنوان URL (اختياري): اترك فارغًا.
  • إعادة التوجيه على التحديث: لا.
• webhook :
  • نشط: نعم.
  • عنوان URL Webhook: عنوان URL (العام) لـ /api/webhook/github :
    • للتنمية ، ستحتاج إلى استخدام شيء مثل Ngrok. ستنتهي بشيء مثل https://your-unique-subdomain.ngrok-free.app/api/webhook/github .
    • شيء مثل https://my-vercel-url.vercel.app/api/webhook/github (أو أي مجال مخصص تستخدمه) إذا كنت تنشر على Vercel.
  • السر: قم بإنشاء سلسلة عشوائية (على سبيل المثال مع openssl rand -base64 32 على MacOS/Linux)
• أذونات :
  • أذونات المستودع:
    • الإدارة: اقرأ واكتب
    • المحتويات: اقرأ واكتب
    • البيانات الوصفية: اقرأ فقط
  • أذونات المنظمة: لا شيء.
  • أذونات الحساب: لا شيء.
• اشترك في الأحداث :
  • هدف التثبيت
  • مستودع (ربما ستحتاج إلى إضافة هذا بعد إنشاء تطبيق GitHub)
• أين يمكن تثبيت تطبيق github هذا؟ : ستحتاج إلى تحديد "أي حساب" إلا إذا كنت تنوي استخدام الصفحات فقط على حساب الحساب الذي يتم إنشاؤه في هذا التطبيق.

متغيرات البيئة

عامل	تعليقات
CRYPTO_KEY	تستخدم لتشفير/فك تشفير الرموز الرموز github في قاعدة البيانات. على MacOS/Linux*، يمكنك استخدام openssl rand -base64 32 .
GITHUB_APP_ID	معرف تطبيق GitHub من صفحة تفاصيل تطبيق GitHub.
GITHUB_APP_NAME	يجب أن يكون اسم الجهاز لتطبيق github الخاص بك (مثل pages-cms ) ، عنوان URL لصفحة تفاصيل تطبيق GitHub.
GITHUB_APP_PRIVATE_KEY	ملف PEM يمكنك تنزيل upong إنشاء تطبيق GitHub.
GITHUB_APP_WEBHOOK_SECRET	السر الذي اخترته لصالح الويب الخاص بك. يتم استخدام هذا لضمان أن الطلب قادم من Github.
GITHUB_APP_CLIENT_ID	معرف عميل تطبيق GitHub من صفحة تفاصيل تطبيق GitHub.
GITHUB_APP_CLIENT_SECRET	سرية عميل تطبيق GitHub تقوم بإنشائها على صفحة تفاصيل تطبيق TheGithub.
RESEND_API_KEY	ستحصل على ذلك عندما تقوم بإنشاء حساب (مجاني) لإعادة الالتحاق بالتعامل مع رسائل البريد الإلكتروني.
SQLITE_URL	file:./local.db للتنمية ، libsql://pages-cms-username.turso.io على سبيل المثال إذا كنت تستخدم Turso (يجب عليك ، Turso رائعة).
SQLITE_AUTH_TOKEN	اترك فارغًا للتطوير ، وإلا استخدم الرمز المميز الذي توفره Turso (إذا كان هذا هو ما تستخدمه).
BASE_URL	خياري . إذا كنت تنتشر في Vercel أو العمل محليًا ، فلن تحتاج إلى ذلك. إذا كنت تنشر في مكان آخر ، فستحتاج إلى تحديد عنوان URL الأساسي للتطبيق (على سبيل المثال https://mycustomdomain.com ).

التنمية المحلية

نحن نفترض أنك قمت بالفعل بإنشاء تطبيق GitHub ولديك نفق تشغيل لـ GitHub App Webhook (باستخدام NGROK على سبيل المثال):

1. تثبيت التبعيات : npm install
2. قم بتحديث متغيرات البيئة الخاصة بك : انسخ .env.example إلى .env وملء القيم وفقًا لإعدادك (انظر القسم أعلاه).
3. قم بإنشاء قاعدة البيانات : npm run db:migrate
4. تشغيله : npm run dev

نشر على Vercel

1. قم بإنشاء قاعدة بيانات SQLite : أوصي باستخدام Turso ، لأنها مجانية (ورائعة جدًا)

2. نشر إلى Vercel : في هذه المرحلة ، لديك خياران:

   1. إنشاء شوكة : شوكة pages-cms/pages-cms في حسابك ونشر هذا الشوكة. سيتيح لك ذلك الحصول على التحديثات. تأكد من تحديد جميع متغيرات البيئة المذكورة أعلاه .

   2. استخدم زر النشر :

3. قم بتحديث تطبيق GitHub Oauth الخاص بك : ربما ستحتاج إلى العودة إلى إعدادات تطبيق GitHub لتحديث بعض الإعدادات بمجرد حصولك على عنوان URL (على سبيل المثال "عنوان Callback URL" و "WebHook URL").

مضيف ذاتي

هناك الكثير من الخيارات الأخرى: Fly.io ، المحيط الرقمي ، العرض ، SST ، إلخ.

رخصة

يتم إصدار كل شيء في هذا الريبو تحت رخصة معهد ماساتشوستس للتكنولوجيا.