TL;DR

  • Giscus는 GitHub Discussions를 기반으로 하는 무료 오픈소스 댓글 시스템임.
  • 댓글을 저장할 공개 GitHub 저장소를 만들고 Giscus 앱을 설치해야 함.
  • 저장소 설정의 Settings > Optional Features에서 Discussions를 활성화해야 함.
  • Giscus 웹사이트에서 설정값을 복사해 Hugo 댓글 레이아웃에 적용해야 함.
  • 댓글이 표시되지 않으면 레이아웃 파일 위치를 바꾸거나 테마 설정을 확인해야 함.

저장소 설정

  • 댓글을 호스팅할 공개 GitHub 저장소를 만든 뒤 GitHub Marketplace에서 Giscus 앱을 찾아 설치함.
  • 저장소의 Settings > Optional Features로 이동해 Discussions를 선택함.

Giscus 설정

  • 위 단계를 마친 뒤 Giscus 웹사이트에서 설정값을 확인하고 복사함.
  • config.yml 또는 config.toml에서 댓글 기능을 활성화하고, layout/partials/comments/comments.html에 Giscus 스크립트를 저장함.
  • 스크립트는 저장소와 저장소 ID, 카테고리와 카테고리 ID, 페이지 경로 기반 매핑, 반응 버튼, 메타데이터, 입력창 위치, 테마, 언어, 지연 로딩 설정을 포함함.
  • 스크립트의 data-repo, data-repo-id, data-category, data-category-id 값을 복사한 설정값으로 교체함.
  • 댓글이 표시되지 않으면 comments.html을 layout/partials/comments.html로 옮기거나 테마 설정을 확인함.
  • 스크립트 주소는 https://giscus.app/client.js임.