Система коментарів на основі GitHub Discussions. Дає змогу користувачам залишати свої реакції та коментарі на сайті за допомогою GitHub! Основним чином розробка була натхненна системою коментарів utterances.
- Відкритий код. 🌏
- Безкоштовно. Без відслідковування дій та банерів. 📡 🚫
- Не потребує сторонньої бази даних. Вся інформація зберігається у GitHub Discussions.
- Підтримка власних тем оформлення! 🌗
- Підтримка багатомовності. 🌐
- Можливість гнучких налаштувань. 🔧
- Автоматичне завантаження нових коментарів та змін із GitHub. 🔃
- Може використовуватися самостійно! 🤳
Note:
giscus знаходиться у фазі активної розробки. GitHub також активно розвиває Discussions та його API. Тому деякі можливості giscus можуть не працювати або з часом змінюватися.
Після завантаження giscus GitHub Discussions search API використовується для пошуку обговорень, зв'язаних із поточною сторінкою на основі вибраного типу зв'язку (URL, pathname
, <title>
, ітд.).
Якщо обговорення не було знайдене, то бот giscus автоматично створює нове обговорення, як тільки хтось створить перший коментар або реакцію.
Щоб додати новий коментар користувачі мусять пройти авторизацію giscus app для здійснення публікацій коментарів від свого імені за допомогою GitHub OAuth. Крім того, користувачі можуть залишати коментарі напряму в GitHub Discussion. Ви можете проводити модерацію цих коментарів через GitHub.
Якщо ви використовуєте giscus, поставте 🌟 giscus на GitHub будь ласка, та додайте giscus
тег у ваш репозиторій! 🎉
В giscus доступні розширені налаштування, такі як фільтрація по window.origin, ітд.
Для використання giscus із React, Vue, або Svelte зверніться до бібліотеки компонентів giscus.
Якщо ви раніше користувалися іншими системами, котрі використовували GitHub Issues (наприклад, utterances, gitalk), ви можете сконверктувати існуючі запити в дискусії. Після конвертації переконайтеся у відповідності між дискусіями та сторінками сайту, тоді giscus автоматично знайде та відобразить ці дискусії.
Деталі: CONTRIBUTING.md
Цей README також є доступним на таких мовах: