docmd.config.json 文件是你工作区的核心配置。它控制网站样式、侧边栏层级、多语言详情和编译器选项。

1. 配置架构

JSON 是标准配置格式。这允许引擎工作池之间的高性能序列化。

但是，如果你需要动态 JavaScript 逻辑，docmd.config.js 和 docmd.config.ts 仍然完全支持。

{
  "title": "My Project",
  "url": "https://docs.myproject.com",
  "src": "docs",
  "out": "site",
  "base": "/"
}

2. 核心设置

这些顶层参数配置编译器的输入和输出基础。

3. 品牌与标识

管理你的品牌在头部和浏览器标签中的显示方式。

{
  "logo": {
    "light": "assets/images/logo-dark.png",
    "dark": "assets/images/logo-light.png",
    "href": "/",
    "alt": "Company Logo",
    "height": "32px"
  },
  "favicon": "assets/favicon.ico"
}

4. UI 布局与行为

引擎提供模块化的头部和侧边栏布局。自定义功能区域。更改搜索和深色模式切换等组件的可见性。启用或禁用面包屑。

{
  "layout": {
    "spa": true,
    "header": {
      "enabled": true
    },
    "sidebar": {
      "collapsible": true,
      "defaultCollapsed": false
    },
    "optionsMenu": {
      "position": "header",
      "components": {
        "search": true,
        "themeSwitch": true
      }
    }
  }
}

有关完整的视觉自定义选项，请参阅布局和 UI 区域指南。

5. 核心引擎功能

微调解析器处理内容文件的方式。

{
  "minify": true,
  "autoTitleFromH1": true,
  "copyCode": true,
  "pageNavigation": true,
  "markdown": {
    "breaks": true
  }
}