يشرح هذا الدليل كيفية تثبيت سمة Discourse أو مكون سمة من مستودع GitHub خاص.
مستوى المستخدم المطلوب: مسؤول
ملخص
تغطي هذه الوثائق عملية تثبيت سمة Discourse أو مكون سمة من مستودع GitHub خاص. وهي تتضمن خطوات لإنشاء مفاتيح SSH واستخدامها للوصول الآمن. ستحتاج إلى صلاحية وصول مسؤول إلى كل من مثيل Discourse الخاص بك ومستودع GitHub الذي تقوم بالتثبيت منه. هذه هي الطريقة التي يمكنك بها استخدام سماتك ومكونات السمات الخاصة بك على منتدىك.
المتطلبات الأساسية
قبل البدء، تأكد من توفر ما يلي لديك:
- صلاحية وصول مسؤول إلى مثيل Discourse الخاص بك
- مستودع Git خاص يحتوي على السمة أو المكون الخاص بك
- إمكانية إضافة مفاتيح النشر (deploy keys) إلى مستودع Git الخاص بك (مستوى مسؤول/مالك)
دليل خطوة بخطوة
- انتقل إلى مستودع GitHub الخاص بك وانسخ عنوان SSH من علامة التبويب “استنساخ SSH” (Clone SSH).
2. انتقل إلى لوحة تحكم المسؤول في Discourse.
3. في الشريط الجانبي للمسؤول، انتقل إلى
المظهر (Appearance) > السمات والمكونات (Themes and components)، ثم حدد علامة التبويب السمات (Themes) أو المكونات (Components) (اعتمادًا على ما تقوم بتثبيته). 4. انقر على
تثبيت (Install) ثم اختر من مستودع git (From a git repository).
5. الصق عنوان SSH الذي نسخته من المستودع الخاص في الخطوة 1. يجب أن يكون بالتنسيق:
git@github.com:USERNAME/REPO-NAME.git.
تأكد من استخدام رابط الاستنساخ عبر SSH، وليس الرابط الذي يبدأ بـ
https
6. يتم إنشاء مفتاح SSH تلقائيًا وعرضه في مربع نص جديد.
7. انقر على أيقونة النسخ في الزاوية العلوية اليمنى من هذا المربع لنسخ مفتاح SSH الجديد. لا تنقر على تثبيت أو إغلاق هذه النافذة المنبثقة بعد.
8. انتقل الآن إلى إعدادات مستودع GitHub الخاص بك (على سبيل المثال، على GitHub، انتقل إلى
الإعدادات (Settings) > مفاتيح النشر (Deploy keys))
9. أضف مفتاح نشر جديد. ستحتاج إلى إعطائه عنوانًا مناسبًا. الصق مفتاح SSH الذي نسخته من Discourse في حقل مفتاح النشر.
10. انقر على
إضافة مفتاح (Add key) لحفظ مفتاح النشر في إعدادات مستودع Git الخاص بك.
11. عد إلى نافذة تثبيت سمة Discourse المنبثقة وانقر على زر
تثبيت (Install). يجب أن ترى الآن صفحة إعدادات السمة أو المكون الجديدة الخاصة بك.
أفضل الممارسات
- استخدم دائمًا عنوان URL الخاص بـ SSH لمستودعك، وليس عنوان HTTPS.
- حافظ على مفاتيح النشر الخاصة بك آمنة ولا تشاركها علنًا.
- قم بتحديث سماتك أو مكوناتك بانتظام لضمان حصولك على أحدث الميزات وتحديثات الأمان.
الأسئلة الشائعة
س: هل يمكنني استخدام هذه الطريقة مع موفري Git آخرين غير GitHub؟
ج: نعم، يجب أن تعمل هذه الطريقة مع أي مزود Git يدعم مفاتيح النشر أو مصادقة SSH.
س: هل سيتذكر Discourse مفتاح SSH للتحديثات المستقبلية؟
ج: نعم، سيقوم Discourse بتخزين المفتاح الخاص الذي تم إنشاؤه وسيستخدمه للوصول المستقبلي إلى مستودع Git.
س: هل يمكنني تغيير المستودع الخاص لاحقًا؟
ج: نعم، يمكنك تحديث عنوان URL للمستودع في إعدادات السمة إذا لزم الأمر.
موارد إضافية
تم إنشاء مفاتيح SSH المستخدمة في هذا الموضوع لهذه الوثائق فقط