docmd 采用"镜像与映射"的方式来处理资源。这确保了您的本地开发路径与生产构建保持一致。

目录结构

默认情况下，docmd 会在项目根目录查找 assets/ 文件夹。

my-docs/
  ├── assets/          # 源资源
  │   ├── css/
  │   ├── js/
  │   └── images/
  ├── docs/            # 内容
  ├── docmd.config.json
  └── site/            # 构建输出（自动镜像）

自动复制

当您运行 npx @docmd/core build 或 npx @docmd/core dev 时：

1. 镜像逻辑：您的 assets/ 文件夹的全部内容会递归地复制到 site/assets/。
2. 稳定性：我们使用强化的复制引擎，并具备自动重试机制，以防止在 macOS 和现代 SSD 上出现"File Busy"或"ENOENT"错误。
3. 引用：您应该始终使用根相对路径从 Markdown 或配置中引用资源：

   ![Logo](/assets/images/logo.png)
   

自定义 CSS 与 JS 集成

要将您的资源链接到每个页面，请将它们添加到主题配置中：

{
  "theme": {
    "customCss": ["/assets/css/branding.css"]
  },
  "customJs": ["/assets/js/utils.js"]
}