本地运行项目

安装 nodejs

nodejs需要 18.0 以上版本，可以通过node -v查看版本号，如果没有，自行下载安装

install 依赖

执行命令 npm i 或者 yarn

run 运行

npm run start:dev运行 dev 环境,npm run start:prod运行 prod 环境，环境差别在于src/pageData.js中配置的入口文件， 项目启动成功后可以在浏览器地址localhost:3000实时预览修改效果。

入口配置

新增加目录需要在docusaurus.config.ts中增加配置 plugins 子项

 plugins: [
    [
      "@docusaurus/plugin-content-docs",
      {
        id: "guide",
        path: "guide",
        routeBasePath: "guide",
        sidebarPath: "./sidebars.ts",
        remarkPlugins: [remarkMath],
        rehypePlugins: [rehypeKatex],
      },
    ],
    require.resolve("./plugin/index.js"),
  ],

如果需要在首页增加入口，需要在pageData.js中增加配置信息

打包

特殊格式错误只能在打包时发现，最好在本地执行npm run build:dev测试能否正常打包，如果不行，查看 log 并修改问题

发布

一般提交 commit 到 dev 或者 merge 到 master 会自动发布，需要 10 到 20 分钟，如果没有发布成功，可以到https://devops.mthreads.com/dashboard/app/list/d 查看发布日志，排查问题