官网 https://docusaurus.io/zh-CN/

    快速构建以内容为核心的最佳网站 🧐 Docusaurus 是一款静态站点生成器。 我们释放了 React 的全部潜能，搭建了这款带有快速的客户端导航且交互性极佳的单页应用。 即开即用的文档功能不仅仅局限于文档本身，还可用于创建任何类型的网站（个人网站、产品网站、博客、营销着陆页等）。

    star 27k 2021-10-24

    竞品对比 https://docusaurus.io/zh-CN/docs#comparison-with-other-tools

    简单不复杂，react体系，单页

    特点不难理解：mdx/react/ssg/jamstack

    1. npm init docusaurus [folderName] classic
    2. # -- skip-install
    3. # --typescript

    项目就自动建立并跑起来了。

    观察目录结构：

    • 区分 blog 和 docs
    • 其中 docs 里的文档如果需要排序修改 sidebars.js 自定义侧边栏顺序。
    • src/pages相当于页面模板

    看脚本 scripts

    • start 启动开发模式 docusaurus start
    • build 构建模式 docusaurus build