v2

landing-page

Features

• ✅ 更改默认资源路径为 ./src/
• ✅ 支持多语言: i18n
• ✅ 支持 markdown
• ✅ 支持 一键发布到 Github Pages
• ✅ 集成 naive-ui, 并修复了主题(明/暗)切换
• ✅ 集成 quasar, 参考文档: vite-plugin
  • 修复了主题(明/暗)切换
  • 修复 i18n 不生效问题, 在 Layout.vue 中更新i18n设置
  • 修复无法自动导入组件(找不到组件), 参见: .vitepress/theme/index.ts
• ✅ 集成 unplugin-vue-components
• ✅ 集成 unplugin-auto-import

FAQ

Fix: Github Pages 绑定域名问题:

• 绑定自定义域名, 无需设置 base_url(也就是 repo name)
• 但是每次发布 github pages, 都需要手动在项目设置页里, 设置 自定义域名
• 修复方法: 手动生成 CNAME 文件, 填入待解析域名, 并一起上传.

# 部署脚本中含有一行指令: 手动生成 CNAME 文件(内含有待绑定的域名)
task deploy

Development

Requirements

• ✅ vue3
• ✅ vitepress
• ✅ bun
• ✅ taskfile

Run

# install:
task install

# run:
task run

Deploy

Github Pages

自动编译+部署(Github Actions)

• 官方文档 部署指南 支持 Github actions 方式部署
• 我个人并不喜欢, 虽然方便. 浪费资源, 没必要.
• 且等待久, 比较慢. 手动编译+发布, 更快.

手动编译+部署

• 本地部署到 GitHub Pages, Github actions 的方式(浪费资源, 没必要)
• 已经写好了发布脚本.
• 如果是 fork 的本 repo, 改一下 repo-url 参数 和 deploy-branch 参数

# build + deploy:
task q 

# or: (root dir)
# task v2:q

# 自动编译 + 部署到 GitHub Pages
task deploy