网站维护日志

网站配置

文档组织结构

• 文档
  • 标题从h1开始；
• 文件夹
  • 每个文件夹内部都有一个index.md文件，用来进行索引；
  • 不需要READEME文件，如果想要此文件，就以 综述 等替代；
  • 文件夹可以嵌套；

侧边栏目录

• 自动生成，不用维护sidebar；
• 侧边栏顺序按照字母序排列；
• 使用的组件是：https://vitepress-sidebar.cdget.com/zhHans/
  • 可配置；
  • 支持多级文档树的侧边栏的自动化生成；
  • 功能强大；

添加广告位

fsdfa

添加评论功能

调整全局样式

调整大纲样式

工作流

ci 的使用

如果 master 分支下的 blog 文件夹发生变更，就会触发以下 job：

• 检出 vongdefu.github.io 仓库到服务器本地；
• 把 blog 文件夹中的内容，同步至 vongdefu.github.io/docs 文件夹内；
• 同步完成后自动提交至 vongdefu.github.io 仓库；

后续如果需要添加文档，只需要修改三个文件内容：

1. 修改 nav；
2. 在 sidebar 文件夹内创建一个 ts 文件；
3. 在 sidebar.ts 文件中补充 ts 的配置；

背景

可能会有其他的项目，其他项目也可能会有一些文档，这个时候想要把这些项目中的文档，也集成到个人网站中。

操作过程

主要思路是，在本网站中添加导航栏和侧边栏的配置，然后由其他项目中自行设置导航栏和侧边栏的具体细节内容。步骤如下：

1. 修改 vongdefu.github.io 仓库中的 nav.ts 和 sidebar.ts ；
2. 给 vongdefu-sourcecode-hub 仓库添加对应的 navbar 和 sidebar 配置；
3. 配置 vongdefu-sourcecode-hub 仓库的 ci ，只要完成 docs 目录同步到 vongdefu.github.io 仓库的功能即可；