giscus

Система за коментари, базирана на GitHub Discussions. Позволете на посетителите да оставят коментари и реакции на вашия уебсайт чрез GitHub! Силно вдъхновена от utterances.

• Отворен код. 🌏
• Без проследяване, без реклами, винаги безплатна. 📡 🚫
• Не е необходима база данни. Всички данни се съхраняват в GitHub Discussions. :octocat:
• Поддържа персонализирани теми! 🌗
• Поддържа множество езици. 🌐
• Изключително конфигурируема. 🔧
• Автоматично извлича нови коментари и редакции от GitHub. 🔃
• Може да се хоства самостоятелно! 🤳

Забележка giscus все още е в активна разработка. GitHub също активно разработва Discussions и неговото API. Следователно някои функции на giscus може да се променят или да спрат да работят с времето.

Как работи

Когато giscus се зареди, GitHub Discussions API за търсене се използва за намиране на дискусията, свързана със страницата, въз основа на избрано съответствие (URL, pathname, <title> и т.н.). Ако не може да бъде намерена съответстваща дискусия, ботът на giscus автоматично ще създаде дискусия при първия път, когато някой остави коментар или реакция.

За да коментират, посетителите трябва да разрешат на приложението giscus да публикува от тяхно име, използвайки GitHub OAuth процеса. Алтернативно, посетителите могат да коментират директно в GitHub дискусията. Можете да модерирате коментарите в GitHub.

Ако използвате giscus, обмислете да дадете звезда 🌟 на giscus в GitHub и да добавите темата giscus към вашето хранилище! 🎉

Разширена употреба

Можете да добавите допълнителни конфигурации (напр. разрешаване на специфични origins), като следвате ръководството за разширена употреба.

За да използвате giscus с React, Vue или Svelte, вижте библиотеката с компоненти на giscus.

Мигриране

Ако преди сте използвали други системи, които използват GitHub Issues (напр. utterances, gitalk), можете да конвертирате съществуващите issues в дискусии. След конвертирането просто се уверете, че съответствието между заглавията на дискусиите и страниците е правилно, и giscus автоматично ще използва дискусиите.

Сайтове използващи giscus

• laymonage.com
• os.phil-opp.com
• Stats and R
• Tech Debt Burndown Podcast
• и много други!

Допринасяне

Вижте CONTRIBUTING.md

Това README е достъпно на:

• ‎العربية
• Беларуская
• български
• Català
• Čeština
• Dansk
• Deutsch
• English
• Esperanto
• Español
• Euskera
• فارسی
• Français
• Ελληνικά
• Srpsko-Hrvatski (BCMS)
• עברית
• Magyar
• Indonesia
• Italiano
• 日本語
• ភាសាខ្មែរ
• 한국어
• Nederlands
• Polski
• Português
• Română
• Русский
• ภาษาไทย
• Türkçe
• Tiếng Việt
• Українська
• O'zbek
• 简体中文
• 繁體中文
• 香港繁體