غيسكوس giscus

نظام تعليقات مدعوم بواسطة مناقشات GitHub. يتيح للزوار ترك التعليقات والتفاعلات على موقعك عبر GitHub! مستوحى بشكل كبير من utterances.

مفتوح المصدر. 🌏
بدون تتبع أو إعلانات، ومجاني دائمًا. 📡 🚫
لا حاجة لقاعدة بيانات. جميع البيانات مخزنة في مناقشات GitHub.
يدعم الثيمات المخصصة! 🌗
يدعم العديد من اللغات. 🌐
قابل للتخصيص بشكل واسع. 🔧
يجلب التعليقات والتعديلات الجديدة تلقائيًا من GitHub. 🔃
يمكن استضافته ذاتيًا! 🤳

ملاحظة
غيسكوس لا يزال قيد التطوير النشط. كما أن GitHub لا يزال يطور المناقشات وواجهتها البرمجية. لذلك، قد تتعطل بعض ميزات غيسكوس أو تتغير مع مرور الوقت.

كيفية العمل

عند تحميل غيسكوس، يتم استخدام واجهة برمجة التطبيقات للبحث في مناقشات GitHub للعثور على المناقشة المرتبطة بالصفحة بناءً على طريقة الربط المختارة (مثل الرابط، pathname، <title>، إلخ). إذا لم يتم العثور على مناقشة مطابقة، سيقوم بوت غيسكوس بإنشاء مناقشة تلقائيًا عند ترك أول تعليق أو تفاعل.

للتعليق، يجب على الزوار تفويض تطبيق غيسكوس للنشر نيابة عنهم باستخدام تدفق OAuth الخاص بـ GitHub. أو بدلاً من ذلك، يمكن للزوار التعليق مباشرة على مناقشة GitHub. يمكنك الإشراف على التعليقات عبر GitHub.

اﻹعدادات

اللغة

اختر اللغة التي سيعرض بها غيسكوس. إذا لم تجد لغتك يمكنك المساهمة في الترجمة.

المستودع

اختر المستودع الذي سيتصل به غيسكوس. تأكد من:

أن المستودع عام، وإلا لن يستطيع الزوار رؤية النقاش.
أن تطبيق غيسكوس مثبت، وإلا لن يستطيع الزوار التعليق والتفاعل.
أن ميزة النقاشات مفعلة عبر تفعيلها من إعدادات المستودع.

المستودع:

مستودع جيت هب عام. هذا المستودع هو المكان الذي ستربط به جميع النقاشات.

تعيين طريقة ربط الصفحات ↔️ النقاشات

اختر كيفية الربط بين الصفحة المضمنة والنقاش المضمن.

عنوان النقاش يحتوى على pathname الصفحة

سيبحث غيسكوس على النقاش الذي يحتوى عنوانه على مكون عنوانpathname للصفحة.

عنوان النقاش يحتوى على URL الصفحة

سيبحث غيسكوس على النقاش الذي يحتوى عنوانه على رابط الصفحة.

عنوان النقاش يحتوى على عنوان <title> الصفحة

سيبحث غيسكوس على النقاش الذي يحتوى عنوانه على وسم العنوان <title> بالصفحة.

عنوان النقاش يحتوى على og:title الصفحة

سيبحث غيسكوس على النقاش الذي يحتوى عنوانه على وسم HTML <meta property="og:title"> بالصفحة.

عنوان النقاش يحتوى على كلمة محددة

سيبحث غيسكوس على النقاش الذي يحتوى عنوانه على كلمة محددة.

عدد محدد من النقاشات

سيحمل غيسكوس مناقشة محددة حسب الرقم. هذا الخيار لا يدعم اﻹنشاء التقائي للمناقشة.

استخدم المطابقة الصارمة للعنوان

تجنب عدم التطابق بسبب أسلوب البحث الغامض في جيت هب عندما تكون هناك مناقشات متعددة مع عناوين متشابهة. راجع الوثائق لمزيد من التفاصيل.

قسم المناقشة

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

ابحث عن المناقشات في هذا القسم فقط

عند البحث عن مناقشة مطابقة، سيبحث غيسكوس في هذا القسم فقط.

الميزات

اختر الميزات التي تريد تفعيلها.

تفعيل التفاعلات للمنشور الرئيسي

ستظهر التفاعلات على المنشور الرئيسي للمناقشة قبل التعليقات.

بث المعلومات الوصفية للمناقشة.

ستبث بيانات المناقشة الوصفية بشكل دوري إلى النافذة الأصلية (صفحة التضمين). ليتضح اﻷمر، فعل هذا الخيار وافتح وحدة تحكم المستعرض الخاص بك في هذه الصفحة. راجع الوثائق لمزيد من التفاصيل.

ضع مربع التعليق فوق التعليقات

سيوضع مربع كتابة التعليقات فوق التعليقات نفسها، بحيث يمكن للمستخدمين كتابة تعليق دون التمرير إلى أسفل المناقشة.

تحميل التعليقات بالتدريج

سيتم تأجيل تحميل التعليقات حتى يقوم المستخدم بالتمرير بالقرب من حاوية التعليقات. يتم ذلك عن طريق إضافة loading="lazy" إلى <iframe> العنصر.

السمة

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

تفعيل غيسكوس

أضف <script> الوسم التالي إلى قالب موقعك في المكان الذي تريد أن تظهر فيه التعليقات. إذا كان هناك عنصر ذو صنف giscus ستظهر التعليقات بداخله.

لم تقم بتكوين المستودع و / أو الفئة الخاصة بك. لن يتم عرض قيم هذه الحقول حتى تقوم بملئها.

<script src="https://giscus.app/client.js"
        data-repo="[ضع رابط المستودع هنا]"
        data-repo-id="[ضع معرف المستودع هنا]"
        data-category="[ضع اسم القسم هنا]"
        data-category-id="[ضع معرف القسم هنا]"
        data-mapping="pathname"
        data-strict="0"
        data-reactions-enabled="1"
        data-emit-metadata="0"
        data-input-position="bottom"
        data-theme="preferred_color_scheme"
        data-lang="ar"
        crossorigin="anonymous"
        async>
</script>

يمكنك تخصيص تخطيط الحاوية باستخدام محددات اﻷصناف .giscus و .giscus-frame من صفحة التضمين.

إذا كنت تستخدم غيسكوس، يُرجى تقييمنا بنجمة 🌟 على GitHub وإضافة موضوع giscus إلى مستودعك! 🎉

الاستخدام المتقدم

يمكنك إضافة إعدادات إضافية (مثل السماح بأصول معينة) من خلال دليل الاستخدام المتقدم.

لاستخدام غيسكوس مع React أو Vue أو Svelte، اطلع على مكتبة مكونات غيسكوس.

الترحيل

إذا كنت قد استخدمت سابقًا أنظمة تعتمد على قضايا GitHub (مثل utterances أو gitalk)، يمكنك تحويل القضايا الحالية إلى مناقشات. بعد التحويل، تأكد من صحة الربط بين عناوين المناقشات والصفحات، وبعدها سيستخدم غيسكوس المناقشات تلقائيًا.

مواقع تستخدم غيسكوس

المساهمة

اطلع على CONTRIBUTING.md