文档与博客
Docusaurus 文档与博客共存:docs 用于结构化内容,blog 用于更新与动态。
文档 (docs)
- 放置于
docs/,默认路由/docs/...。 - 侧边栏由
sidebars.js管理,支持自动/手动。 - 支持版本化:
npm run docusaurus docs:version 1.0.0。
博客 (blog)
- 放置于
blog/,默认路由/blog/...。 - frontmatter 支持
authors、tags、description、date等。 - 可关闭博客:在
docusaurus.config.js中移除 blog 插件。
导航与布局
- 在
docusaurus.config.js的navbar配置文档、博客入口。 - 可为文档/博客定制不同的布局与侧边栏。
小贴士
- 用博客发布版本更新、变更日志;文档保持稳定结构。
- 对公共 API/SDK,建议开启 docs 版本化;博客用于迁移指南与公告。***
