跳到主要内容

批量上线 SOP

pnpm + scripts/import-docs.ts 将 Markdown 目录转成 Docusaurus 文档站。

快速流程

  1. pnpm install
  2. pnpm import-docs(默认读取 ../../lhqs-docs/做饭指南,会清空 docs 目录后写入)
  3. pnpm start 本地预览
  4. pnpm build 生成静态站点

参数说明

  • --source:Markdown 源文件夹,建议传绝对路径。
  • --target:输出目录,默认 docs
  • --slugBase:可选,给 slug 增加前缀(例如多站点并存时)。

注意事项

  • README 中的目录请指向具体文件,避免链接到纯文件夹。
  • 新增文档直接放进源目录即可,导入脚本会自动补充 frontmatter(id/title/sidebar_label/slug)。
  • 如需保留手写的特殊页面,请在导入前备份;脚本会清空目标目录。