网站阶段更新：从内容归档到阅读体验

这两天 qqqzj@Crane 做了一轮比较密集的维护，已经不只是“能放文章”的第一版了。现在它更像一个可以长期写、长期查、长期扩展的个人学习档案。

这次主要更新有几块。

内容和发布方式#

网站现在采用 private 源码仓库和 public 发布仓库分离的方式维护。源码、草稿、Markdown 原文、构建脚本都留在 private 仓库里；public 仓库只放构建后的静态网页文件。

这样公开访问者看到的是网站本身，而不是整个写作工程。以后新增文章时，只需要在 private 仓库里写 Markdown，再构建发布即可。

文章、附件和预览#

我把数学分析、线性代数、普物实验和普物 I 期中复习资料整理进了 Notes。Markdown 作为正文，PDF 或模板文件作为附件提供下载和预览。

这对学习笔记很重要：文章不是只展示一小段摘要，而是可以进入详情页完整阅读；需要原文件时，也能直接下载对应 PDF、Markdown 模板或配套 CSS。

阅读体验#

长文章现在有更完整的阅读支持：

• 详情页会生成文章目录。
• 桌面端目录可以悬浮在侧边，并随着阅读位置高亮当前章节。
• 页面顶部有阅读进度条。
• Markdown 支持定理、证明、例题、注意等提示块。
• 一些原本写在反引号里的物理公式，也会被识别并交给 MathJax 渲染。

这些改动主要是为了让数学和物理这种长篇复习提纲更容易读，不会一滚到底就找不到自己在哪。

搜索、分类和归档#

首页的搜索现在不只是搜标题，也会匹配标签、分类、摘要和正文文本。Notes 区会按标签自动生成分栏，比如数学、普物实验、普物 I。

文章源码也重新整理了目录结构：

posts/
  news/
  life/
  notes/
    math/
    physics/

以后如果继续写编程、深度学习或其他方向的笔记，也可以继续往 posts/notes/ 下面分目录。这样文章变多以后，源码不会堆成一团。

主题和视觉#

网站加入了白天、黑夜、自动三档主题。自动模式会跟随系统深浅色，黑夜模式也重新调整了首屏的可见度，不会把标题和统计卡片压得太暗。

顶部主题按钮现在默认只显示一个入口，鼠标悬停、键盘聚焦或点击时再展开三个选项。角色图片也预留了真实双形态素材接口：如果以后放入对应的白天/黑夜素材，网站会自动切换；没有素材时就回退到默认图，不用滤镜强行伪装。

SEO 和订阅#

构建脚本现在会生成静态文章详情页、sitemap.xml、rss.xml、robots.txt 和 404.html。首页也会在编译时注入文章预览和链接，让搜索引擎在不运行 JavaScript 的情况下也能读到内容。

RSS 订阅也已经可用。以后发布新文章时，订阅源会一起更新。

写作工作流#

现在有新文章脚手架，可以用命令快速生成带 front matter 的 Markdown 文件，并自动加入 posts/index.json。脚手架会根据 category 和 tag 自动选择目录，比如数学笔记进入 posts/notes/math/，动态进入 posts/news/。

这轮更新之后，网站的维护方式清楚了很多：写作、构建、发布、索引、归档都各有位置。接下来要做的事情，就是慢慢把内容写进去，让这个站点真的长成一个属于自己的知识和生活档案。