批量上线 SOP
用
pnpm+scripts/import-docs.ts将 Markdown 目录转成 Docusaurus 文档站。
快速流程
pnpm installpnpm import-docs(默认读取../../lhqs-docs/做饭指南,会清空docs目录后写入)pnpm start本地预览pnpm build生成静态站点
参数说明
--source:Markdown 源文件夹,建议传绝对路径。--target:输出目录,默认docs。--slugBase:可选,给 slug 增加前缀(例如多站点并存时)。
注意事项
- README 中的目录请指向具体文件,避免链接到纯文件夹。
- 新增文档直接放进源目录即可,导入脚本会自动补充 frontmatter(
id/title/sidebar_label/slug)。 - 如需保留手写的特殊页面,请在导入前备份;脚本会清空目标目录。