Site Migration Log（网站迁移与更新记录）

Updated: 2026-04-12（更新日期）

本文记录个人主页从旧站点结构迁移到当前 mdBook 结构的过程，以及目前已经完成的主要调整，便于后续继续维护。

迁移背景

原仓库基于旧的 GitHub Pages / Jekyll 风格模板，内容里混有不少并不属于个人主页的模板残留。当前版本已经将站点重构为更适合长期写作和文档整理的 mdBook 结构，目标是：

用统一的文档站方式管理技术内容、Mabinogi 记录和 Maintenance（维护）文档
保留清晰的左侧章节导航和右侧页内目录
让个人主页更适合持续写文章，而不是一次性作品集

当前结构

当前内容主要位于 src/ 下：

about.md：关于页，同时作为站点主入口
blog/：Guides（技术分享） 与 Thoughts（技术杂谈）
notes/：Mabinogi 分区
maintenance/：迁移记录与 Maintenance（维护）文档
archive.md：Archive（内容归档）页面
SUMMARY.md：左侧导航目录定义

主题相关定制位于 theme/：

custom.css：站点样式覆盖
page-toc.js：右侧页内目录生成逻辑
giscus.js：评论区注入逻辑
root-redirect.js：根路径跳转逻辑
sidebar-numbering.js：左侧目录编号重写逻辑

已完成的迁移工作

1. 站点框架迁移

从旧模板切换到 mdBook
清理不属于个人主页的模板残留内容
统一为文档站结构，而不是传统博客首页加碎片化页面

2. 导航重组

将首页和关于页合并为 About
左侧导航改为站点章节入口，不再混入文章内部标题
当前主分区整理为 Tech Notes（技术笔记） / Mabinogi / Maintenance（维护） / Archive（归档）
Tech Notes（技术笔记） 下包含 Guides（技术分享） 和 Thoughts（技术杂谈）
Archive（内容归档） 移动到了左侧导航最下方

3. 页面布局调整

布局整体参考 theajack.github.io/rust 的文档站形式
左侧保留书籍式目录导航
右侧目录根据当前 Markdown 标题自动生成
右侧目录固定在页面右侧，滚动时高亮当前标题
页面底部翻页箭头调整为更接近目标文档站的形式

4. 评论系统迁移

原仓库使用 giscus
当前站点已经将评论区迁移到 mdBook
评论区会在页面正文底部自动插入，无需每篇文章单独写脚本
About 页面评论已映射回旧主页历史线程

更新记录

2026-04-12：统一导航命名为英文在前、中文补充的形式，并清理结构说明里不再使用的 projects/ 相关表述

本地预览与构建

构建

mdbook build

本地预览

mdbook serve 在当前 Windows 环境下有端口绑定问题时，可以使用：

mdbook build
python -m http.server 3000 --directory book

然后访问：

http://127.0.0.1:3000/

后续可继续优化的方向

继续打磨顶部菜单栏与正文宽度比例
为项目页补更统一的封面或摘要结构
继续清理历史内容中的乱码和旧文案
为常用文章模板补统一的写作骨架

备注

这份文档用于记录站点迁移和界面调整过程。后续如果还有结构性修改，建议继续直接追加到这里。