import { defineConfig } from 'vitepress'

/**
 * 复制为 `{软件}.application/help/.vitepress/config.mts` 后按软件改 title / sidebar。
 *
 * - base: './' + mpa: true → 相对路径产物，避免 SPA hydration/路由问题
 * - docs:build 须跑 scripts/fix-relative-paths.mjs 扫掉残留 /assets/
 * - 预览：npm run docs:preview（serve dist）；或 http-server dist
 * - 若用 http-server . 打开 /dist/，相对路径下资源会解析到 /dist/assets/
 * - 勿用 file:// 双击（部分浏览器仍限制模块/字体）
 */
export default defineConfig({
  title: '{软件显示名} 操作手册',
  description: '{软件显示名}用户操作手册',
  lang: 'zh-CN',
  base: './',
  mpa: true,
  outDir: './dist',
  cleanUrls: false,
  ignoreDeadLinks: true,
  srcExclude: ['**/demo-case/**', '**/node_modules/**', '**/dist/**'],
  vite: {
    experimental: {
      renderBuiltUrl() {
        return { relative: true }
      }
    }
  },
  themeConfig: {
    nav: [{ text: '首页', link: '/index.html' }],
    sidebar: [
      {
        text: '操作手册',
        items: [
          { text: '索引', link: '/index.html' },
          // { text: '场景-示例', link: '/场景-示例.html' },
        ]
      }
    ],
    outline: { label: '本页目录', level: [2, 3] },
    docFooter: { prev: '上一篇', next: '下一篇' }
  }
})