Skip to main content

Intro

这个板块主要介绍 安装和优化 Docusaurus 这个技术博客框架

我们之前使用 Hexo 搭建个人博客,但是 Hexo 并不好管理大量的技术文档,因此我们使用 Docusaurus 来建站管理 技术文档和笔记。出于稳定性和安全性考虑,这里使用 Windows系统 作为搭建系统。

Docusaurus 支持多种编程语言、插图、Markdown、搜索、版本管理

优点

  • Markdown 编写,易于管理
  • 内置搜索(基于 Algolia,可自定义)
  • 支持插图(本地图片 & 远程图片)
  • 支持代码高亮(适用于 Java、C、Python 等)
  • 多层级目录和导航
  • 支持版本控制(适合不断迭代的文档)
  • 可定制 React 组件,适用于交互式文档

缺点

  • 需要 Node.js 运行环境
  • 定制化可能需要前端(React)知识