pagefind_dcd{"url":"/posts/how-to-integrate-giscus-comments/","content":"如何​将 ​Giscus ​评论​集成​到 ​AstroPaper ​Updated​: ​12 ​Mar​, ​2025 ​| ​在​像 ​GitHub ​Pages ​这样​的​平台​上​托管​轻量​级​静态​博客​有​很多​优点​，​但​也​会​削弱​一些​互动​性​。​幸运​的​是​，​Giscus ​的​出现​提供​了​一种​在​静态​网站​上​嵌入​用户​评论​的​方式​。 ​目录​. ​Giscus ​的​工作​原理​. ​Giscus ​使用 ​GitHub ​API ​来​读取​和​存储 ​GitHub ​用户​在​仓库​关联​的 ​Discussions ​中​发表​的​评论​。 ​在​你​的​网站​上​嵌入 ​Giscus ​客户​端​脚本​包​，​配置​正确​的​仓库 ​URL​，​用户​就​可以​在​登录 ​GitHub ​后​查看​和​撰写​评论​。 ​这种​方法​是​无​服务​器​的​，​因为​评论​存储​在 ​GitHub ​上​，​并​在​客户​端​从​那里​动态​加载​，​因此​非常​适合​像 ​AstroPaper ​这样​的​静态​博客​。 ​设置 ​Giscus​. ​Giscus ​可以​很​容易​地​在 ​giscus​.​app ​上​设置​，​但​我​还是​会​简要​概述​一下​过程​。 ​前提​条件​. ​让 ​Giscus ​工作​的​前提​条件​包括​： ​仓库​是​公开​的​. ​已​安装 ​Giscus ​应用​. ​已​为​你​的​仓库​开启 ​Discussions ​功能​. ​如果​由于​任何​原因​无法​满足​这些​条件​，​很​遗憾​，​Giscus ​无法​集成​。 ​配置 ​Giscus​. ​接下​来​，​需要​配置 ​Giscus​。​在​大多​数​情况​下​，​预设​的​默认​值​已经​适用​，​只有​在​你​特定​原因​且​知道​自己​在​做​什么​时​才​应​修改​它们​。​不必​过于​担心​做​错​选择​；​你​以后​随时​可以​调整​配置​。 ​不过​，​你​需要​： ​选择​正确​的 ​UI ​语言​. ​指定​要​连接​的 ​GitHub ​仓库​，​通常​是​你​在 ​GitHub ​Pages ​上​托管​静态 ​AstroPaper ​博客​的​仓库​. ​如果​你​想​确保​没有​人​能​在 ​GitHub ​上​直接​创建​随机​评论​，​则​创建​一个 ​Announcement ​类型​的​讨论​并​设置​. ​定义​颜色​方案​. ​配置​设置​后​，​Giscus ​会​为​你​提供​一个​生成​的 ​