站点配置

站点的主要设置集中在 docs/.vitepress/config.mts。

基本信息

修改标题、描述和语言：

export default defineConfig({
  lang: 'zh-CN',
  title: '你的站点名称',
  description: '一句清楚的站点介绍'
})

导航栏

在 themeConfig.nav 中维护顶部导航：

nav: [
  { text: '首页', link: '/' },
  { text: '指南', link: '/guide/getting-started' }
]

侧边栏

侧边栏支持按路径分组。内容增多后，可以为不同栏目配置独立目录：

sidebar: {
  '/guide/': [
    {
      text: '开始使用',
      items: [
        { text: '快速开始', link: '/guide/getting-started' }
      ]
    }
  ]
}

自定义样式

颜色、字体和组件细节位于 docs/.vitepress/theme/custom.css。优先覆盖 VitePress 提供的 CSS 变量，后续升级会更轻松。

Netlify 发布

仓库根目录的 netlify.toml 已经写好构建命令和发布目录。连接仓库后无需重复填写。