九月份博客版本更新时，升级了 Vuepress 版本导致对 NodeJS 版本要求提高了，为此不得不去升级主机的 NodeJS。曾经提到过把博客的自动编译工作放在容器里执行，文档编译相关的依赖从主机转移到了容器。不同的 Node 版本，使用不同容器即可，不需要在主机中安装多个版本的 NodeJS 或被迫限制在某个固定的版本。
act_runner 容器这篇 文章里提到过如何在主机环境中注册 act_runner 并使用 Gitea Actions 自动部署博客，现在需要将这些行为搬到 Docker 容器中完成。
博客代码仓库与文章仓库是两个独立的版本仓库，博客仓库通过子模块的方式来引用文章仓库。把博客的代码（Vuepress）和文章放一起，会更简单——不用折腾 @vuepress/plugin-git 问题，也不需要推送子仓库之后再去更新主仓库。
但是个人习惯上，还是倾向于将应用与数据分离开来。更新文章即关注博文的编辑与发布；而功能或 UI 上的改进即为博客版本的迭代。二者之间不具有强关联性——如果想换一个博客框架的话，只要保证新框架具有相似的功能集（Markdown 文件的静态编译功能）就好了，没有的话也可以自己开发；可能的话，网友替换掉子模块后，便能得到一个文章内容不同克隆体。
当前网站的文章、博客代码和其他的项目代码都由自己在云端部署的 Gitea 服务管理。如果某一天阿里云「跪」了，那么我所有数据也就全体「升天」。因此 Gitea 服务的备份工作显得格外重要。
Github 很多时候访问不了，有时候想要拉取一些代码，就特别麻烦。需要安装 Git 都还好说，但代码下载不下来就难受了。Gitee 和 GitCode 需要迎合市场需求，掺杂了不需要的东西也不好用（做代理不错）。
所以就目前来看，比较好的方案还是私有化部署 Gitea。GitLab 太大，云服务器配置低容不下，况且它其中的功能对于个人以及小型企业来说非必须的。
优先基础需求使用起来，然后再根据使用时的反馈，发现问题再解决问题。依此不停地迭代，直到达成自己期望的样子。
如果搭建好完整的 CI/CD 系统，迭代流程会相当丝滑，只要把重心放在设计和编码上就好。如果再配合上 AI 工作流，那效果或许会非常棒。
这里的本地部署，指的是部署到家庭的 Nas 主机上，操作系统使用的是 Rock Linux 8.9 （最新 10.0 了，后面找机会迁移到 9.6 ）。
Vuepress Theme Hope 主题默认启用文章分类功能，该功能通过 FrontMatter 中的 category 字段来识别不同类别。如果我希望为文章添加分类就需要维护每篇文章的 category 字段。如果我将这篇文章放在 Web 分类下，一个月后忘记自己设置过 Web 分类，需要翻阅过去的内容，要么重新命名一个 「前端」分类。
代码块组件主要用于显示 Vagrantfile 模版，而 Vagrantfile 中的实际内容其实是 Ruby 脚本。使用 highlight.js 对模版内容进行高亮展示能够提供更好的用户体验。另外还需要拷贝模版和下载模版的需求。
安装 highlight.js 和 @highlightjs/vue-plugin
yarn add highlight.js @highlightjs/vue-plugin网络教程和一些书籍上提供的组件库多以 Element Plus 为主。了解 TailwindCSS 之后发现它更符合我的品味，另外还发现了 Tailwind Plus 替代 —— Shadcn-Vue。
图标库使用 AI 推荐 lucide-vue-next，话又说回来 Shadcn-Vue 自带的也许省事儿点。
TailwindCSS 提供一组原子化的 CSS 样式类来构建复杂的 UI 组件，这些原子化的样式涵盖了布局、字体、动画、交互和响应式布局，还有主题配置等等内容。用得好的话，会非常强。
根据官方文档，使用 Vue3 脚手架能够很轻松地搭建起 Vue 项目。唯一遇到的问题就是 yarn 对 node module 处理方式上的问题（如果使用其他包管理工具请忽略）。
yarn4+ 默认使用 PnP 模式来处理 node modules ，但是这样在执行 package.json 的脚本和 IDE 错误提示都存在问题。最简单的解决方法就是——在项目根目录下添加 .yarnrc.yml 文件并添内容如下：
nodeLinker: node-modulesvboxes-ui 是 vboxes 服务的网页 UI 负责展示从 vboxes 服务请求到的环境数据。而 vboxes 通过分析目录下的所有 .box 文件并将其归类到不同的环境当中去，然后提供不同的接口供网页的数据查询与展示、Vagrant CLI 的数据请求和 .box 文件下载。
vboxe-ui 采用的是 Vue3 框架，配合 Schade-Vue 和 TailwindCSS 的组件与样式创建的一个简单前端网页，目前还处在开发中。
完整项目开发周期可能持续一个月以上，设置一些关键节点能够很好的维持项目的推进。比如完成 vboxes 关键接口或完成 vboxe-ui 创建（等待接口测试）等等。设置节点也方便记录与总结。一口气完成中大型的项目的开发目前来看有点吃力，不仅考验耐力也考验体力[汗]。
在此之前博客关于页内容始终是空白的，刚好自己也有查看博客改进记录的想法。「Vuepress Theme Hope」主题中的时间线功能仅展示文章发布历史，但是我希望能够看到博客修改记录（也就是 Git 提交历史），方便我快速浏览整个网站所做的修改。虽然 Gitea 本来就可以查看历史，但是把需要关注的内容收集到一块岂不更好？同时还能填补关于页的空白，何乐不为？
在 .vuepress 目录里创建 plugins 目录用于存放所有的插件目录（目前只有一个）。然后创建 git-history 目录，这个目录里所有文件便是该插件的全部内容了。完成后的目录结构如下：