Система комментариев на основе 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 доступен на следующих языках: