主题定制

OpenManual 提供简洁的主题定制方案，通过 theme 配置字段调整站点外观。

主色调

通过 primaryHue 色相值调整品牌色。色相值范围为 0-360：

{
  "theme": {
    "primaryHue": 250
  }
}

默认启用暗色模式，可以通过配置关闭：

{
  "theme": {
    "darkMode": false
  }
}

{
  "theme": {
    "primaryHue": 250,
    "darkMode": true
  }
}

字段	类型	默认值	说明
`primaryHue`	number	—	主色调色相值（0-360）
`darkMode`	boolean	`true`	是否启用暗色模式

将自定义静态资源（如 Logo、Favicon）放在 public 目录中：

my-docs/
├── openmanual.json
├── content/
└── public/
    ├── logo.svg
    └── favicon.ico

在配置中引用：

{
  "navbar": {
    "logo": "/logo.svg"
  }
}

如果需要为 Light 和 Dark 模式使用不同的 Logo，可以使用对象形式配置：

{
  "navbar": {
    "logo": {
      "light": "/logo-light.svg",
      "dark": "/logo-dark.svg"
    }
  }
}

当 light 和 dark 路径不同时，导航栏会渲染两个 <img> 标签，利用 Tailwind 的 dark:hidden / hidden dark:block 自动切换显示。

如果未提供自定义 Logo 图片，OpenManual 会根据站点名称自动生成 SVG Logo。Dark 模式下会使用暖色调文字（#E8E0D4），与暗色主题背景协调。