docmd 具有原生版本管理引擎。同时管理和提供项目的多个版本。引擎自动处理 URL 路由、侧边栏更新和切换逻辑。

目录组织

将文档组织到版本化的源文件夹中。常见模式是将活动版本保存在 docs/，归档版本保存在以 docs- 为前缀的目录中。

my-project/
├── docs/           # 最新版本（主版本）
├── docs-v1/        # 旧版本
├── docmd.config.json

配置

在 versions 对象中定义你的版本：

{
  "versions": {
    "current": "v2",           
    "position": "sidebar-top", 
    "all": [
      { "id": "v2", "dir": "docs",    "label": "v2.x（最新）" },
      { "id": "v1", "dir": "docs-v1", "label": "v1.x" }
    ]
  }
}

核心功能

1. 根目录 SEO（「当前」版本）

current 版本直接在输出根目录生成（例如 mysite.com/）。这确保搜索流量始终落在你最新的文档上。

2. 独立子目录

非当前版本自动构建到与其 id 匹配的子文件夹中。

• v2（当前） → mysite.com/
• v1 → mysite.com/v1/

3. 粘性切换（路径保留）

docmd 在用户切换版本时保留相对路径。如果用户正在阅读 mysite.com/getting-started 并切换到 v1，他们会自动重定向到 mysite.com/v1/getting-started（如果该页面存在）。

4. 资源隔离

每个版本继承你的全局 assets/ 目录。docmd 在构建过程中隔离它们以防止样式泄漏或冲突。

5. 版本化导航

每个版本可以维护独立的导航结构。docmd 使用级联优先级系统来解析侧边栏。

有关解析层级结构的详细信息，请参阅导航配置。

最佳实践

1. 语义化 ID：使用简洁、URL 友好的 ID，如 v1、v2 或 beta。
2. 导航结构一致：跨版本保持一致的文件夹结构，以最大化"粘性切换"。
3. 统一配置：不要为每个版本创建单独的配置文件。docmd 在单次运行中处理所有版本。