关于 - 网站变更历史
2026/11/21大约 6 分钟
关于 - 网站变更历史
新的修订写在最上面。文章内容的增补仍记在 内容更新清单,读者反馈的单页修正仍记在 网站问题修正。
2026-11-21 切换 vuepress-theme-hope,改为博客形式
主题从默认主题换成 vuepress-theme-hope,侧边栏改为按目录自动生成,首页改为博客首页。文章目录和链接地址不变。
依赖
- 只用 npm 管理依赖:删除
yarn.lock,重新生成package-lock.json。 - 版本精确锁定,不带
^:vuepress与@vuepress/bundler-vite为2.0.0-rc.31,vuepress-theme-hope为2.0.0-rc.110,plugin-slimsearch为2.0.0-rc.137,plugin-baidu-analytics为2.0.0-rc.135。hope 的 rc.110 要求核心 rc.31,因此核心从先前统一的 rc.32 回退一版。 - 主题自带的插件不再单独安装,
package.json中原有的默认主题和各插件依赖已移除。 - 删除未使用的
markdown-it-toc、markdown-it-table-of-contents、@mdit-vue/plugin-toc。 - 升级脚本
docs:update-package改为npx vp-update,原来的yarn dlx在 yarn 1 上无法运行。
侧边栏
- 新增
docs/.vuepress/config/sidebar/auto.ts,按目录生成侧边栏。sidebar/zh.ts只声明栏目分组和对应目录,zh_detail.ts(约 1080 行)删除。 - 文章顺序写在各篇 frontmatter 的
order中,按 10 递增,方便日后插入。侧边栏标题需要与正文标题不同时写shortTitle。 - 不进侧边栏的页面写
index: false,共 50 篇,主要是未完成的数据结构页和 MySQL 基础中的部分篇目。 - 迁移前后逐栏对比条目和顺序,634 个条目一致。
导航栏
- 顶栏恢复为平铺的 16 项:✿导航、C++、数据库、算法、编程四大件、开发|测试、架构、方法论、工具|部署、项目、文章、读书笔记、成长、前端、日常使用、关于。11-09 收成 7 组的改动撤回。
- 下拉条目由侧边栏分组生成,链接指向每组目录对应的概述页。
- 原有 3 个 404 入口改为指向现有概述页:排序、Vue2、Vue3。
博客功能
- 首页使用
BlogHome布局:上方为 12 个栏目卡片,下方为按日期排序的文章列表,侧边显示作者信息、分类和标签。 - 新增文章列表
/posts/(站点已有「文章」栏目/article/,因此不用默认地址),以及分类/category/、标签/tag/、时间线/timeline/。 - 693 篇文章补上
date,日期取自旧仓库 cpp-notes 的提交历史。按标题匹配 569 篇,按内容匹配 49 篇;仅存在于本仓库的 77 篇取本仓库首次提交的日期。 - 按所在目录为文章补上
category和tag,现有 14 个分类、51 个标签。148 篇补上description,用于列表摘要和搜索引擎。 - 栏目概述页(112 篇)和未完成页面写
article: false,不出现在文章列表中。 - 42 篇未完成的文章标记
wip: true,页面顶部显示「施工中」提示,由docs/.vuepress/layouts/Layout.vue实现。
搜索、SEO 与阅读体验
- 原来只能搜标题,现在改用 slimsearch 全文搜索,支持中文正文。
- 由主题生成 sitemap(695 个地址)和 SEO 元信息,主机名为
https://stibel.icu。 - 文章标题下方显示日期、分类、标签和阅读时间。
- 主题自带的以下功能默认开启:代码块复制按钮、上一篇/下一篇、图片点击放大,以及指向 GitHub 的「编辑此页」链接(
klc407073648/stibel仓库main分支的docs/目录)。 - 已写好 Giscus 评论配置,但仓库尚未开启 Discussions、尚未安装 giscus 应用。
config.ts中的repoId、categoryId填好后评论才会启用。 - 主题会把 frontmatter 标题显示为页面标题,正文第一个
# 标题因此用样式隐藏,避免重复。
链接修正
构建时链接检查的警告从 14 条降为 0 条。原因多是文件改为英文名或换了目录之后,引用处没有跟着改。
- Redis 概览的 8 个链接改到现在的
basic/、advance/、application/目录。 - ElasticSearch 4 篇中的中文文件名链接改为
install.md、cluster-deployment.md。 - 《数据密集型应用》读书笔记的 7 个章节链接补上
data_process/目录。book_note/SUMMARY.md的链接全部改到现有章节,删掉误挂在 Effective C++ 下的 muduo 链接。 - 数据结构、Tars 中的失效链接改到现有页面。
- 页内锚点:重构第 3 章的「不完美的类库」、分布式事务开头的目录改为与实际标题一致。SQL 权限表改为链接到 MySQL 官方文档,Apollo 部署的两处锚点改为链接到 Apollo 官方部署指南。
清理
- 删除英文站点:
docs/en/、nav/en*.ts、sidebar/en*.ts。 - 删除
sidebar/shared.ts(整份是注释掉的 VuePress 1 示例)和docs/.gitignore。 - 根目录
.gitignore补齐:node_modules、.temp、.cache、dist、npm/yarn 日志、.specstory/、.vscode/、.DS_Store。 client.ts原来是空配置,现在用于注册上面的Layout.vue。- 样式改为 hope 主题的写法:版心宽度和首页宽度改在
palette.scss中设置,正文字号、行高和各级标题大小改为作用于#markdown-content。
本次未处理
- 正文中的
[[toc]]和主题右侧的目录内容重复。 - 面包屑显示目录原名(如 Cplusplus / Basic),因为各目录没有
README.md。 - 自动生成的标签未逐篇人工检查;没有设置置顶(
sticky)或推荐(star)文章。 - 构建时 shiki 对少数代码块的未知语言有提示,这些提示在本次修改前就有。
2026-11-09 站点框架整理
整理导航、旧链接和 VuePress 配置,不调整文章目录,也不拆 v1/v2。
导航
- 顶栏收成 7 组:导航、基础、数据、工程、笔记、日常、关于。
- 分组下的条目改为由侧边栏生成,删除单独维护的
docs/.vuepress/config/nav/zh_detail.ts。 - 前端入口与
guide/vue-overview对齐。 - 「日常使用 / 常用软件」的前缀从
doc/改为software/。 - 侧边栏移除只有标题、没有正文的页面:栈、队列、哈希表、二叉搜索树、AVL、红黑树、Trie,以及空白的「产品相关」。
- 「计算机组成」仅余一篇未完成概述,侧边栏标题标为「编写中」。
链接与正文
- 将正文和导航地图中的旧路径
/md/...改到当前页面,包括 C++ 新特性、开发库、排序、分布式理论、读书笔记和项目地图。 return 局部变量以 C++ 知识点 为正文,文章目录中的同题页面改为指向该篇。docs/cplusplus/func/并入cplusplus/function/,新增 可重入与线程安全 和 volatile。- 导航地图和若干目录页中,能对应到现有文件的旧链接已改写,例如 Kubernetes 基础应用、微服务注册发现、MySQL 存储过程与事务、SQL 使用技巧、hmdp 学习项目。
配置
- 版心使用
--content-width: 1200px。 - 首页图和 logo 使用
docs/.vuepress/public/sea.png。 - SEO 主机名改为
https://stibel.icu。 - 移除未接入的博客、PWA、版权、水印和 DocSearch。回到顶部沿用主题自带能力。
- 删除 VuePress 1 残留的
enhanceApp.js、markdown.js。英文导航文件保留,但未接入当前构建。 - 根目录
README.md改为项目说明。.gitignore不再忽略 lock 文件。
本次未处理
docs/中的压缩包和 PDF 仍留在仓库内。- Redis 概览、ElasticSearch 中使用中文文件名的链接,以及
docs/book_note/SUMMARY.md,构建时仍有断链警告。 - 前端笔记里的
<<< @/md/...仍是旧引用写法,对应源文件不在当前目录。
