GitHub Discussions로 작동하는 댓글 시스템입니다. 방문자가 GitHub를 통해 웹사이트에 댓글과 반응을 남기게 해보세요! utterances에서 큰 영감을 받았습니다.
- 오픈 소스입니다. 🌏
- 사용자 추적도, 광고도 없습니다. 항상 무료입니다. 📡 🚫
- 데이터베이스가 필요없습니다. 모든 데이터는 GitHub Discussions에 저장됩니다.
- 커스텀 테마 제작을 지원합니다! 🌗
- 여러 언어를 지원합니다. 🌐
- 여러 설정을 제공합니다. 🔧
- 자동으로 GitHub에서 새로운 코멘트와 수정사항을 반영합니다. 🔃
- 셀프 호스팅이 가능합니다! 🤳
주의:
giscus는 여전히 활발하게 개발되고 있습니다. GitHub에서도 Discussions와 그 API를 활발하게 개발하고 있습니다. 따라서 시간이 지나면서 giscus의 일부 기능이 작동하지 않거나 변경될 수 있습니다.
giscus가 로드되면, GitHub Discussions 검색 API를 사용하여 선택된 매핑 방법(URL, pathname
, <title>
, etc.)에 따라 페이지와 연관된 Discussion을 찾습니다. 일치하는 discussion이 없으면 giscus 봇은 누군가 처음으로 댓글이나 반응을 남길 때 자동으로 discussion을 생성합니다.
댓글을 남기기 위해, 방문자는 GitHub OAuth를 이용하여 giscus app이 자신을 대신하여 게시할 수 있도록 권한을 부여해야합니다. 또는 방문자가 GitHub Discussion에서 직접 댓글을 달 수도 있습니다. GitHub에서 댓글을 관리할 수 있습니다.
giscus를 사용하신다면, GitHub에서 giscus를 🌟 별표하신 후에 giscus
를 자신의 저장소 토픽에 추가해 주세요! 🎉
고급 사용법 가이드를 따라서 추가적인 설정(예를 들면, 특정 origin 허가하기)을 할 수 있습니다.
React, Vue, 또는 Svelte와 함께 giscus를 사용하고 싶다면, giscus component library를 확인해보세요.
GitHub Issues를 활용한 다른 시스템(예를 들면, utterances, gitalk)을 사용하고 있다면 이미 생성된 issue를 discussion으로 변환할 수 있습니다. 변환 후 discussion의 제목과 페이지 간의 매핑이 올바른지 확인하기만 하면 giscus가 자동으로 해당 discussion을 사용합니다.
CONTRIBUTING.md를 참고하세요.
이 README는 다음 언어로도 제공됩니다. :