Skip to content

本来准备通过AI生成前端页面的代码,但尝试了几次生成的结构和样式都不是很满意,同时我期望文章内容以Markdown格式编写,此时VitePress+AI编程进行定制化修改就是一个不错的选择。并且其纯静态输出、无需后端的特性,可以配合GitHub Pages实现低成本快速部署。

AI编程工具:https://docs.trae.cn/ide/get-started-with-trae

https://vitepress.dev/zh/guide/getting-started

部署:GitHub Pages

python
npm add -D vitepress@next
npx vitepress init

目录结构:

python
├── docs/                 # 文档目录,VitePress 项目的主要内容
│   ├── .vitepress/      # VitePress 配置目录
│   │   ├── cache/       # 构建缓存目录
│   │   └── config.mts   # VitePress 配置文件
│   ├── api-examples.md  # API 示例文档
│   ├── index.md         # 网站首页
│   └── markdown-examples.md  # Markdown 示例文档
├── package-lock.json    # npm 依赖锁定文件
└── package.json         # 项目配置文件

需求实现

导航栏

我们期望的导航栏目录应该包含一下内容:

首页 前端 后端 其他
-Vue -Java 建站教程
-TypeScript

借助AI修改代码并生成示例md文件,发现路由配置在config.mts中,确认无误后保留修改

主页

修改主页内容,可以直接把需要修改的内容圈出,并把图片给ai分析

可以看到是通过index文件修改,调整一下具体内容,同时修改一下首页字体样式,并确认修改

python
---
# https://vitepress.dev/reference/default-theme-home-page
layout: home

hero:
  name: "ZH-Blog"
  text: "个人技术博客"
  tagline: 分享技术和个人成长
  image:
    src: /vitepress-logo-large.svg
    alt: VitePress
  actions:
    - theme: brand
      text: 网站说明
      link: /other/introduction
    - theme: alt
      text: 建站教程
      link: /other/tutorial

features:
  - title: 前端技术
    details: 记录Vue、TypeScript等前端技术的学习心得和实践经验
  - title: 后端开发
    details: 分享Java等后端技术的基础知识和进阶技巧
  - title: 技术分享
    details: 交流编程思想、工具使用和项目实战经验
---

注意点:VitePress使用 theme 目录来管理样式,所以给AI提示词最好要加上说明,否则代码容易生成错位置

搜索栏

提示词:https://vitepress.dev/zh/reference/default-theme-search 参考官方文档为网站添加搜索功能

生成代码如下

python
search: {
  provider: 'local',
  options: {
    locales: {
      zh: {
        translations: {
          button: {
            buttonText: '搜索',
            buttonAriaLabel: '搜索'
          },
          modal: {
            displayDetails: '显示详细列表',
            resetButtonTitle: '重置搜索',
            backButtonTitle: '关闭搜索',
            noResultsText: '没有结果',
            footer: {
              selectText: '选择',
              selectKeyAriaLabel: '输入',
              navigateText: '导航',
              navigateUpKeyAriaLabel: '上箭头',
              navigateDownKeyAriaLabel: '下箭头',
              closeText: '关闭',
              closeKeyAriaLabel: 'Esc'
            }
          }
        }
      }
    }
  }
}

验证:

侧边栏更新

python
    sidebar: [
      {
        text: '前端',
        items: [
          {
            text: 'TypeScript',
            link: '/frontend/typescript'
          },
          {
            text: 'Vue3',
            link: '/frontend/Vue3'
          }
        ]
      },
      {
        text: '后端',
        items: [
          {
            text: 'Java',
            link: '/backend/java'
          }
        ]
      },
      {
        text: '其他',
        items: [
          {
            text: 'introduction',
            link: '/other/introduction'
          },
          {
            text: '建站教程',
            link: '/other/tutorial'
          }
        ]
      }
    ],

修改gitHub链接

部署到github page