大约 3 分钟
有。11 月 21 日日志里写的「本次未处理」都还在,另外还有几处会直接碰到读者。按影响从大到小:
先改这些
- 正文目录和右侧大纲重复。 大约 470 篇文章开头都有
[[toc]],主题右侧已经有大纲。在docs/.vuepress/styles/index.scss里隐藏正文里的目录即可,不必逐篇删。 - 首页通知还指向旧仓库。
docs/.vuepress/config.ts里「github地址」仍是klc407073648/cpp-notes,站点仓库已经是stibel。这是每个打开首页的人都会看到的。 - Vue2 笔记的代码引用是断的。
docs/front/vue/vue2/下约 17 篇文章,以及docs/about/me/content-style.md,还在用<<< @/md/...。这些源文件不在当前目录里,对应示例在docs/front/vue/code/vue_basic.zip里,页面上显示不出来。 - 博客列表几乎没有摘要。 配置里
excerpt: false,只有大约 148 篇写了description。首页文章流多数只有标题。把excerpt设成一个字数(例如 120)后,没写摘要的文章会自动截一段正文。
接着处理
- 面包屑是英文目录名。 例如
Cplusplus / Basic。除了站点首页和 Robot Framework 那一页,各目录都没有README.md,主题只能拿文件夹名来显示。给每个栏目目录补一个只含中文标题的README.md,面包屑就会变成「C++ / 基础」。 - 仓库里还放着压缩包和 PDF。 已纳入 git 的大约有十几份,其中
docs/interview.zip约 12MB,Redis 资料约 10MB,两份华为 NETCONF PDF 合计约 18MB,另外还有node_modules.zip。docs/.vuepress/dist/daily_use.zip约 302MB,已被.gitignore忽略,只占本地磁盘。这些文件不会改善阅读,克隆和检出都会变慢。酷壳、华为的 PDF 也不适合继续放在仓库里。 - 根目录
README.md还是旧说明。 里面仍写着用 yarn,以及已经删除的docs/.vuepress/config/sidebar/zh_detail.ts。实际依赖用 npm,侧边栏由sidebar/zh.ts加auto.ts生成。package.json的包名还是ai-for-everyone,sass-embedded和vue仍带^,和其余精确锁定的版本不一致。
可以后做
- 首页文章只按旧日期排。 日期来自 cpp-notes 的提交历史,没有任何
sticky或star。时间线顶部不一定是现在想让人先看的文章,挑几篇入口文置顶即可。 - 标签是按目录自动生成的。 14 个分类、51 个标签,和分类高度重合,还没逐篇看过。不影响构建,只影响标签页好不好用。
- 评论还没接上。 Giscus 的
repoId、categoryId仍是空的,要先在klc407073648/stibel打开 Discussions 并安装 giscus,填进config.ts才会出现。 - 构建时 shiki 对少数代码块语言的提示还在。 日志里已说明,这次迁移之前就有,只影响高亮,不产生断链。
顶栏 16 项是 11 月 21 日故意从 7 组改回去的,窄屏会挤,但不必再收一轮。
通知链接、隐藏正文目录、打开自动摘要、改根目录说明,这四件改动小。需要的话我可以直接改。
