template/docs/.vitepress/config.ts

import { defineConfig } from 'vitepress';
import { MermaidMarkdown, MermaidPlugin } from 'vitepress-plugin-mermaid';
import { join } from 'path';

// https://vitepress.dev/reference/site-config
export default defineConfig({
    title: 'HTML5 魔塔样板 V2.B',
    description: 'HTML5 魔塔样板 V2.B 帮助文档',
    base: '/_docs/',
    markdown: {
        math: true,
        config(md) {
            md.use(MermaidMarkdown);
        }
    },
    outDir: join(process.cwd(), 'public', '_docs'),
    themeConfig: {
        // https://vitepress.dev/reference/default-theme-config
        outline: [2, 3],
        nav: [
            { text: '中级教程', link: '/intermediate/data-vs-render' },
            { text: '高级教程', link: '/advanced/' }
        ],
        sidebar: {
            '/intermediate/': [
                {
                    text: '中级教程',
                    collapsed: false,
                    items: [
                        {
                            text: '概念与导航',
                            collapsed: false,
                            items: [
                                {
                                    text: '数据端与渲染端',
                                    link: '/intermediate/data-vs-render'
                                },
                                {
                                    text: 'src 导览',
                                    link: '/intermediate/src-tour'
                                },
                                {
                                    text: '代码基础',
                                    link: '/intermediate/code-basics'
                                },
                                { text: '钩子', link: '/intermediate/hooks' }
                            ]
                        },
                        {
                            text: '基础接口',
                            collapsed: false,
                            items: [
                                {
                                    text: '数据端总览',
                                    link: '/intermediate/data-state-overview'
                                },
                                {
                                    text: '勇士属性',
                                    link: '/intermediate/hero-attribute'
                                },
                                {
                                    text: '勇士道具',
                                    link: '/intermediate/hero-items'
                                },
                                {
                                    text: '勇士装备',
                                    link: '/intermediate/hero-equipment'
                                },
                                {
                                    text: '勇士位置',
                                    link: '/intermediate/hero-location'
                                },
                                {
                                    text: '地图结构',
                                    link: '/intermediate/map-structure'
                                },
                                {
                                    text: '地图图块',
                                    link: '/intermediate/map-tiles'
                                },
                                {
                                    text: '图块存储',
                                    link: '/intermediate/tile-store'
                                },
                                {
                                    text: 'Flag 变量',
                                    link: '/intermediate/flags'
                                }
                            ]
                        },
                        {
                            text: '战斗',
                            collapsed: false,
                            items: [
                                {
                                    text: '战斗总览',
                                    link: '/intermediate/combat-overview'
                                },
                                {
                                    text: '怪物特殊属性',
                                    link: '/intermediate/enemy-specials'
                                },
                                {
                                    text: '光环',
                                    link: '/intermediate/enemy-aura'
                                },
                                {
                                    text: '查询效果',
                                    link: '/intermediate/enemy-query'
                                },
                                {
                                    text: '最终属性',
                                    link: '/intermediate/enemy-final'
                                },
                                {
                                    text: '伤害计算',
                                    link: '/intermediate/enemy-calculator'
                                },
                                {
                                    text: '地图伤害',
                                    link: '/intermediate/enemy-map-damage'
                                },
                                {
                                    text: '战斗脚本',
                                    link: '/intermediate/enemy-combat-script'
                                },
                                {
                                    text: '状态钩子',
                                    link: '/intermediate/enemy-status-hooks'
                                }
                            ]
                        },
                        {
                            text: '其他',
                            collapsed: false,
                            items: [
                                {
                                    text: '自定义事件',
                                    link: '/intermediate/events'
                                },
                                {
                                    text: '录像指令',
                                    link: '/intermediate/replay-commands'
                                },
                                {
                                    text: '数据插件',
                                    link: '/intermediate/data-plugins'
                                }
                            ]
                        }
                    ]
                }
            ],
            '/advanced/': [
                {
                    text: '高级 I · 扩展基础',
                    collapsed: false,
                    items: [
                        { text: '高级 I 导览', link: '/advanced/' },
                        {
                            text: '声明式 vs 命令式接口',
                            link: '/advanced/declarative-vs-imperative'
                        },
                        {
                            text: '插件系统',
                            link: '/advanced/plugin-system'
                        },
                        {
                            text: '可存档内容',
                            link: '/advanced/saveable-content'
                        },
                        {
                            text: '录像一致性',
                            link: '/advanced/replay-consistency'
                        },
                        {
                            text: 'data-common 的 Store',
                            link: '/advanced/data-stores'
                        },
                        {
                            text: '钩子深入',
                            link: '/advanced/hooks-in-depth'
                        }
                    ]
                },
                {
                    text: '高级 II · 系统实现',
                    collapsed: true,
                    items: []
                },
                {
                    text: '高级 III · 原理与架构',
                    collapsed: true,
                    items: []
                }
            ]
        },
        socialLinks: [
            { icon: 'github', link: 'https://github.com/unanmed/HumanBreak' }
        ],
        search: {
            provider: 'local',
            options: {
                locales: {
                    zh: {
                        translations: {
                            button: {
                                buttonText: '搜索文档',
                                buttonAriaLabel: '搜索文档'
                            },
                            modal: {
                                noResultsText: '无法找到相关结果',
                                resetButtonTitle: '清除查询条件',
                                footer: {
                                    selectText: '选择',
                                    navigateText: '切换'
                                }
                            }
                        }
                    }
                }
            }
        }
    },
    locales: {
        root: {
            lang: 'zh',
            label: '中文'
        }
    },
    vite: {
        // @ts-expect-error 类型错误
        plugins: [MermaidPlugin()],
        optimizeDeps: {
            include: ['mermaid']
        },
        ssr: {
            noExternal: ['mermaid']
        }
    }
});