配置指南

环境变量

项目根目录下的 .env.example 包含所有可用的环境变量模板。复制为 .env 后按需修改：

cp .env.example .env

变量说明

站点配置

根目录 config.json 控制站点全局配置：

{
  "siteName": "Your Site Name",
  "nav": [
    { "label": "Blog", "href": "/blog" },
    { "label": "Docs", "href": "/docs" }
  ]
}

修改 siteName 即可更改站点名称，nav 数组定义顶部导航菜单项。

导航配置

src/config/navigation.ts 定义了固定的导航项结构，包括顶部导航栏和移动端菜单中的链接。修改此文件可以自定义导航菜单。

品牌配置

src/config/branding.ts 管理品牌相关设置：

• 站点名称：显示在导航栏和页脚的站点名
• Logo：站点 logo 配置

修改此文件以替换为你自己的品牌标识。

作者配置

src/config/authors.ts 定义了作者注册表。每位作者包含以下信息：

• 唯一标识（slug）
• 显示名称
• 头像 URL
• 简介
• 社交链接

博客文章的 frontmatter 中通过 author 字段引用作者 slug。

分类配置

src/config/categories/ 目录下管理全局分类注册表，跨模块（博客、导航等）共用。分类支持 i18n 标签，可在后台分类管理界面维护。

主题样式

src/app/global.css 中定义了 CSS 变量，控制全站的颜色、间距等视觉风格。项目采用 Tailwind CSS，配合 shadcn/ui 风格组件体系。

主要可定制项：

• 主色调和强调色
• 暗色模式颜色
• 圆角、阴影等设计令牌
• 字体配置

修改 CSS 变量即可快速调整全站视觉风格，无需逐个修改组件。