giscus

giscus는 GitHub Discussions 기반으로 작동하는 댓글 시스템입니다.

giscus를 사용해야 하는 이유

GitHub 연동 댓글 시스템으로 이전에는 utterances를 많이 사용했습니다. 하지만 현시점에서는 utterances를 사용할 이유가 많이 사라졌습니다.

	giscus	utterances
오픈 소스	⭕	⭕
최근 업데이트	지속 업데이트 중	2년 전
게시글 반응	⭕	❌
지연 로딩	⭕	❌
기타 다국어, 댓글 정렬 등	⭕	❌
테마 개수	16+	9
	…	…

또한 giscus는 GitHub Discussions 기반이기 때문에 하나의 Repository에서 여러 사이트의 댓글을 관리할 수도 있습니다!!

giscus 적용하기

giscus 공식 사이트가 정말 친절해서 쉽게 적용할 수 있습니다.
utterances를 사용해 보셨다면 방식이 거의 유사하기 때문에 더 쉽습니다.

utterances에서 giscus로

GitHub Issue는 Discussion으로 전환이 가능하기 때문에 utterances의 댓글을 그대로 옮길 수 있습니다. 기존 댓글이 너무 많다면, 아래 링크처럼 라벨을 부여한 다음 한 번에 Discussion으로 전환할 수도 있습니다.

• Moving from utterances to giscus (shipit.dev)

심화 - 동적 테마 변화

giscus의 댓글은 기본적으로 <iframe> 형태로 로드됩니다.
따라서 단순한 테마 변경으로 giscus 테마가 같이 변경되지는 않고, 직접 giscus에 이벤트를 전달하는 방식으로 테마를 변경할 수 있습니다.

• giscus 공식 가이드
• 관련 GitHub Issue
• Material for MkDocs의 가이드