Intro
这个板块主要介绍 安装和优化 Docusaurus 这个技术博客框架
我们之前使用 Hexo 搭建个人博客,但是 Hexo 并不好管理大量的技术文档,因此我们使用 Docusaurus 来建站管理 技术文档和笔记。出于稳定性和安全性考虑,这里使用 Windows系统 作为搭建系统。
Docusaurus 支持多种编程语言、插图、Markdown、搜索、版本管理
优点:
- Markdown 编写,易于管理
- 内置搜索(基于 Algolia,可自定义)
- 支持插图(本地图片 & 远程图片)
- 支持代码高亮(适用于 Java、C、Python 等)
- 多层级目录和导航
- 支持版本控制(适合不断迭代的文档)
- 可定制 React 组件,适用于交互式文档
缺点:
- 需要 Node.js 运行环境
- 定制化可能需要前端(React)知识