For AI agents: the complete documentation index is available at https://www.tteam.icu/zh/llms.txt, the full documentation bundle is available at https://www.tteam.icu/zh/llms-full.txt, and this page is available as Markdown at https://www.tteam.icu/zh/blog/dev/%E7%AC%94%E8%AE%B0%E4%BB%8Evuepress%E8%BF%81%E7%A7%BB%E5%88%B0rspress.md.
buyfakett
  • 简体中文
      • ← 返回博客

      笔记从VuePress迁移到Rspress

      AI 总结AI 生成

      VuePress 已停止维护，VitePress 的构建速度和社区活跃度又不理想，因此笔记站最终选择了 Rspress。

      迁移并不能只改框架名。真正需要重做的是：

      1. 原来的 code-group 语法。
      2. 对外部代码块的引用。
      3. 侧边栏与导航栏的自动生成。

      Rspress 带来了更快的基于 Rust 的构建流程，但原有的这些习惯也要一起调整。

      笔记站

      我的旧版笔记是使用VuePress构建的，由于VuePress的维护者已停止维护，且存在一些bug

      我也尝试过VitePress，但它的编译速度较慢，社区活跃度也不高

      编译速度确实非常慢，因此我决定将笔记迁移到Rspress平台

      Rspress基于Rust开发，编译速度非常快，且目前社区活跃度很高

      迁移痛点

      code-group

      需要把所有的语法迁移成 "<Tab>"

      引用代码块

      之前笔记大量用到@[code](./foo.js)的语法，用这种语法引入文件并且渲染成代码块，可以保持markdown文件的整洁

      然而rspress原生并不支持这种语法, 于是我写了个插件rspress-plugin-code来支持

      自动生成侧边栏和导航栏

      让ai把原来的代码进行重构了一下，完美实现了自动生成侧边栏和导航栏