快速开始
本指南将帮助您快速开始使用 Mizuki 主题。
在开始使用 Mizuki 之前，您需要确保系统满足以下要求：
- Node.js >= 22
- pnpm >= 9
- Git
安装 Node.js
Section titled “安装 Node.js”访问 Node.js 官网 下载并安装最新版本的 Node.js。建议使用 LTS 版本。
安装完成后，打开终端或命令提示符，运行以下命令验证是否安装成功：
node -vnpm -v如果显示版本号，则表示安装成功。
安装 pnpm
Section titled “安装 pnpm”如果您尚未安装 pnpm，可以通过 npm 安装：
npm install -g pnpm安装完成后，验证是否安装成功：
pnpm -v安装 Git
Section titled “安装 Git”访问 Git 官网 下载并安装适合您操作系统的 Git 版本。
安装完成后，验证是否安装成功：
git --version项目启动步骤
Section titled “项目启动步骤”1. 克隆项目
Section titled “1. 克隆项目”首先，克隆 Mizuki 项目到本地：
git clone https://github.com/LyraVoid/Mizuki.gitcd Mizuki2. 安装依赖
Section titled “2. 安装依赖”使用 pnpm 安装项目依赖：
pnpm install3. 配置博客
Section titled “3. 配置博客”在启动项目之前，您需要根据自己的需求进行配置：
- 编辑
src/config/目录下的配置文件来自定义博客设置 - 更新站点信息、主题颜色、横幅图片和社交链接
- 配置翻译设置和特殊页面功能
4. 启动开发服务器
Section titled “4. 启动开发服务器”运行以下命令启动开发服务器：
pnpm dev启动成功后，您可以在浏览器中访问 http://localhost:4321 查看您的博客。
5. 打包网站
Section titled “5. 打包网站”运行以下命令将网站打包成静态文件：
pnpm build生成的 dist 目录可以部署到您选择的托管平台。
使用以下命令创建新文章：
pnpm new-post <文件名>文章将被创建在 src/content/posts/ 目录中。