📚 VitePress 博客完全指南 #

import { defineConfig } from 'vitepress'

export default defineConfig({
  // 🌐 网站基本信息
  title: 'WYTX AI Knowledge',          // 浏览器标签页标题
  description: '个人技术博客与知识分享',  // 网站描述
  lang: 'zh-CN',                       // 语言设置
  
  // 🎨 主题配置
  themeConfig: {
    // 网站标题（左上角显示）
    siteTitle: 'WYTX 博客',
    
    // 🧭 导航栏配置
    nav: [
      { text: '首页', link: '/' },
      { text: '文章', link: '/posts/' },
      { text: '技术', link: '/tech/' },
      { text: '关于', link: '/about' }
    ],
    
    // 📋 侧边栏配置
    sidebar: {
      '/posts/': [
        {
          text: '文章列表',
          items: [
            { text: '文章标题', link: '/posts/article-file-name' }
          ]
        }
      ]
    },
    
    // 🔗 社交链接
    socialLinks: [
      { icon: 'github', link: 'https://github.com/wenyantongxue' }
    ]
  }
})

// 浏览器标签页标题
title: '你的博客名称',

// 左上角显示的标题
themeConfig: {
  siteTitle: '你的博客'
}

nav: [
  { text: '首页', link: '/' },
  { text: '博客', link: '/posts/' },
  
  // 下拉菜单
  {
    text: '分类',
    items: [
      { text: '前端技术', link: '/frontend/' },
      { text: '后端技术', link: '/backend/' },
      { text: '工具推荐', link: '/tools/' }
    ]
  },
  
  // 外部链接
  { text: 'GitHub', link: 'https://github.com/your-username' }
]

sidebar: {
  // 文章页面的侧边栏
  '/posts/': [
    {
      text: '最新文章',
      collapsed: false,  // 是否默认折叠
      items: [
        { text: '文章1', link: '/posts/article1' },
        { text: '文章2', link: '/posts/article2' }
      ]
    }
  ],
  
  // 技术页面的侧边栏
  '/tech/': [
    {
      text: '技术分享',
      items: [
        { text: 'Vue 教程', link: '/tech/vue' },
        { text: 'React 教程', link: '/tech/react' }
      ]
    }
  ]
}

socialLinks: [
  { icon: 'github', link: 'https://github.com/your-username' },
  { icon: 'twitter', link: 'https://twitter.com/your-username' },
  { icon: 'linkedin', link: 'https://linkedin.com/in/your-username' },
  
  // 自定义图标
  {
    icon: {
      svg: '<svg>...</svg>'  // 你的 SVG 图标代码
    },
    link: 'https://your-custom-link.com'
  }
]

export default defineConfig({
  head: [
    ['link', { rel: 'icon', href: '/favicon.ico' }],
    ['meta', { name: 'author', content: 'WYTX' }],
    ['meta', { property: 'og:title', content: 'WYTX 博客' }]
  ]
})

export default defineConfig({
  themeConfig: {
    // 首页英雄区域
    hero: {
      name: 'WYTX',
      text: 'AI Knowledge Blog',
      tagline: '分享技术，记录生活',
      image: '/avatar.jpg',
      actions: [
        { theme: 'brand', text: '开始阅读', link: '/posts/' },
        { theme: 'alt', text: '关于我', link: '/about' }
      ]
    }
  }
})

// ✅ 正确：使用正确的类型
nav: [
  { text: '首页', link: '/' }  // text 和 link 都是必需的
]

// ❌ 错误：缺少必需属性
nav: [
  { text: '首页' }  // 缺少 link 属性
]

// ✅ 正确：数组语法
nav: [
  { text: '首页', link: '/' },
  { text: '博客', link: '/posts/' }
]

// ✅ 正确：对象语法
sidebar: {
  '/posts/': [...]
}

// ✅ 推荐：使用单引号
siteTitle: 'WYTX 博客'

// ✅ 也可以：使用双引号
siteTitle: "WYTX 博客"

// 保持一致性很重要！

// 文件路径：docs/posts/my-article.md
// 链接应该是：/posts/my-article

{ text: '我的文章', link: '/posts/my-article' }

export default defineConfig({
  base: '/',          // 如果部署在根目录
  base: '/blog/',     // 如果部署在子目录
})

export default defineConfig({
  // 启用构建缓存
  cacheDir: '.vitepress/cache',
  
  // 压缩输出
  build: {
    minify: true
  },
  
  // 图片优化
  markdown: {
    image: {
      lazyLoading: true
    }
  }
})

export default defineConfig({
  head: [
    ['meta', { name: 'keywords', content: '技术博客,Vue,JavaScript,前端' }],
    ['meta', { name: 'author', content: 'WYTX' }],
    ['meta', { property: 'og:type', content: 'website' }],
    ['meta', { property: 'og:locale', content: 'zh_CN' }]
  ]
})