غيسكوس giscus

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

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

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

كيف يعمل

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

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

اﻹعدادات

اللغة

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

المستودع

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

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

المستودع:

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

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

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

عنوان النقاش يحتوى على 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 من صفحة التضمين.

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

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

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

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

الترحيل

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

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

المساهمة

اطلع على CONTRIBUTING.md