我的个人博客

本项目基于 VitePress 构建，并使用了 @sugarat/theme 主题。

安装与启动

1. 环境准备

请确保你的环境中已经安装了 Node.js (版本 >= 18) 和 pnpm。

# 安装 pnpm
npm i -g pnpm

2. 安装依赖

你可以使用 pnpm 或者 bun 来安装项目依赖。

# 使用 pnpm
pnpm install

# 或者使用 bun
bun install

3. 本地开发

执行以下命令启动本地开发服务器：

pnpm dev

4. 项目构建

构建用于生产环境的静态文件：

pnpm build

5. 本地预览

在本地预览构建后的产物：

pnpm serve

主题与更新

更新主题

本项目使用 @sugarat/theme 主题，要升级到最新版本，请执行：

pnpm add @sugarat/theme@latest

更新 VitePress

通常，主题包会依赖最新的 VitePress 版本。如果你需要手动更新 VitePress，可以执行：

pnpm add vitepress@latest

Github Pages 部署

① 开启 Github Pages 的 Git Actions 部署支持。

② 复制 .github/workflows/deploy.yml 文件到你的项目相同目录下（如果已有则忽略）。

③ 修改 docs/.vitepress/config.mts 里的构建配置 base。

如果你的仓库名是 username.github.io，则不需要修改 base，保持默认值 / 即可。

否则，需要将 base 修改为 "/仓库名/"。

// docs/.vitepress/config.mts
import { defineConfig } from 'vitepress'

export default defineConfig({
  // ... 其他配置
  base: '/你的仓库名/',
})

④ 推送代码到 main 分支即可触发自动部署。

如果需要进一步修改部署和构建配置，请直接编辑 .github/workflows/deploy.yml 文件。