GFramework/docs/.vitepress/config.mts

import { defineConfig } from 'vitepress'

export default defineConfig({
  title: 'GFramework',
  description: '面向游戏开发场景的模块化 C# 框架',

  /** GitHub Pages / 子路径部署 */
  base: '/GFramework/',

  /** 多语言 */
  locales: {
    root: {
      label: '简体中文',
      lang: 'zh-CN',
      link: '/zh-CN/',

      themeConfig: {
        logo: '/logo-icon.png',

        search: {
          provider: 'local',
          options: {
            translations: {
              button: {
                buttonText: '搜索文档',
                buttonAriaLabel: '搜索文档'
              },
              modal: {
                noResultsText: '无法找到相关结果',
                resetButtonTitle: '清除查询条件',
                footer: {
                  selectText: '选择',
                  navigateText: '切换',
                  closeText: '关闭'
                }
              }
            }
          }
        },

        nav: [
          { text: '首页', link: '/zh-CN/' },
          { text: '入门指南', link: '/zh-CN/getting-started/installation' },
          { text: 'Core', link: '/zh-CN/core/overview' },
          { text: 'Game', link: '/zh-CN/game/overview' },
          { text: 'Godot', link: '/zh-CN/godot/overview' },
          { text: '源码生成器', link: '/zh-CN/source-generators/overview' },
          { text: '教程', link: '/zh-CN/tutorials/basic-tutorial' },
          { text: 'API参考', link: '/zh-CN/api-reference/core-api' }
        ],

        sidebar: {
          '/zh-CN/getting-started/': [
            {
              text: '入门指南',
              items: [
                { text: '安装配置', link: '/zh-CN/getting-started/installation' },
                { text: '快速开始', link: '/zh-CN/getting-started/quick-start' },
                { text: '架构概览', link: '/zh-CN/getting-started/architecture-overview' }
              ]
            }
          ],

          '/zh-CN/core/': [
            {
              text: 'Core 核心框架',
              items: [
                { text: '概览', link: '/zh-CN/core/overview' },
                { text: '架构组件', link: '/zh-CN/core/architecture/architecture' },
                { text: '命令查询系统', link: '/zh-CN/core/command-query/commands' },
                { text: '事件系统', link: '/zh-CN/core/events/event-bus' },
                { text: '属性系统', link: '/zh-CN/core/property/bindable-property' },
                { text: '工具类', link: '/zh-CN/core/utilities/ioc-container' }
              ]
            }
          ],

          '/zh-CN/game/': [
            {
              text: 'Game 游戏模块',
              items: [
                { text: '概览', link: '/zh-CN/game/overview' },
                { text: '模块系统', link: '/zh-CN/game/modules/architecture-modules' },
                { text: '存储系统', link: '/zh-CN/game/storage/scoped-storage' },
                { text: '资源管理', link: '/zh-CN/game/assets/asset-catalog' },
                { text: '序列化', link: '/zh-CN/game/serialization/json-serializer' }
              ]
            }
          ],

          '/zh-CN/godot/': [
            {
              text: 'Godot 集成',
              items: [
                { text: '概览', link: '/zh-CN/godot/overview' },
                { text: '集成指南', link: '/zh-CN/godot/integration/architecture-integration' },
                { text: '节点扩展', link: '/zh-CN/godot/node-extensions/node-extensions' },
                { text: '对象池', link: '/zh-CN/godot/pooling/node-pool' },
                { text: '日志系统', link: '/zh-CN/godot/logging/godot-logger' }
              ]
            }
          ],

          '/zh-CN/source-generators/': [
            {
              text: '源码生成器',
              items: [
                { text: '概览', link: '/zh-CN/source-generators/overview' },
                { text: '日志生成器', link: '/zh-CN/source-generators/logging-generator' },
                { text: '枚举扩展', link: '/zh-CN/source-generators/enum-extensions' },
                { text: '规则生成器', link: '/zh-CN/source-generators/rule-generator' }
              ]
            }
          ],

          '/zh-CN/tutorials/': [
            {
              text: '教程',
              items: [
                { text: '基础教程', link: '/zh-CN/tutorials/basic-tutorial' },
                { text: '高级模式', link: '/zh-CN/tutorials/advanced-patterns' },
                { text: '最佳实践', link: '/zh-CN/tutorials/best-practices' }
              ]
            }
          ],

          '/zh-CN/api-reference/': [
            {
              text: 'API 参考',
              items: [
                { text: 'Core API', link: '/zh-CN/api-reference/core-api' },
                { text: 'Game API', link: '/zh-CN/api-reference/game-api' },
                { text: 'Godot API', link: '/zh-CN/api-reference/godot-api' },
                { text: '生成器 API', link: '/zh-CN/api-reference/generators-api' }
              ]
            }
          ]
        },

        socialLinks: [
          { icon: 'github', link: 'https://github.com/GeWuYou/GFramework' }
        ],

        footer: {
          message: '基于 Apache 2.0 许可证发布',
          copyright: 'Copyright © 2026 GeWuYou'
        },

        outlineTitle: '页面导航',
        lastUpdatedText: '最后更新于',
        darkModeSwitchLabel: '主题',
        sidebarMenuLabel: '菜单',
        returnToTopLabel: '回到顶部',

        docFooter: {
          prev: '上一页',
          next: '下一页'
        }
      }
    }
  }
})