Zhongke's Personal Wiki

本仓库保存个人 Wiki 的内容与构建配置，使用 Quarto 生成静态网站，并通过 GitHub Pages 自动部署。

网站入口

访问 Zhongke's Personal Wiki

仓库内容

• index.md：网站首页。
• wiki/：当前维护的 Wiki 页面。
• old/：从旧版 Wiki 迁移的历史页面。
• _quarto.yml：网站结构与 Quarto 构建配置。
• .github/workflows/pages.yml：GitHub Pages 自动构建和部署流程。

在本地安装 Quarto 后，可以使用以下命令预览或构建网站：

quarto preview
quarto render

构建产物保存在 _site/ 目录。

日期与时区

站点通过 _environment 将默认渲染时区设为 Asia/Shanghai（北京时间，UTC+8），CI 使用相同设置。文章的 date 可保存带时区的完整发布时间，例如 2026-09-05T01:39:38+08:00；页面和列表显示北京时间，RSS 的 GMT 时间仍指向同一实际时刻。只填写日期的旧文章按站点时区解释。

本机已设置的 TZ 环境变量会覆盖 Quarto 的项目默认值。需要与线上结果一致时，使用 TZ=Asia/Shanghai quarto render 或先取消其他 TZ 设置。修改 _environment 会触发完整构建，更新缓存中的页面和订阅源。

评论

文章和 Wiki 内容页通过 Giscus 提供评论， 评论保存在本仓库的 Announcements Discussions 分类中，发表评论需要登录 GitHub。 首页、专题目录、许可页和 404 页面不显示评论；其他页面可在 YAML frontmatter 中 设置 comments: false 单独关闭。

评论脚本集中在 _includes/giscus.html，由 _filters/giscus.lua 加入 HTML 正文末尾。 直接嵌入脚本是为了保留 Quarto 1.10 内置模板未传递的严格匹配和懒加载参数。 评论按 pathname 关联页面，修改文章路径时需要同步迁移对应的讨论关联。

版权与许可

除另有说明以及引用的第三方内容外，本仓库的原创内容采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 （CC BY-NC-SA 4.0）发布。

转载或改编时必须注明来源，不得用于商业目的；公开发布改编内容时，必须继续采用相同许可协议。第三方内容的权利仍归其原权利人所有。

安全问题

请按照 SECURITY.md 中的方式私下报告安全问题。