安装 npm#

如果已安装 npm，跳过此步骤。访问 Node.js 官网 下载并安装最新 LTS 版本。安装完成后，验证是否成功：

1
node -v
2
npm -v

显示版本号即为成功。

安装 pnpm#

如果已安装 pnpm，跳过此步骤。通过 npm 安装：

1
npm install -g pnpm

验证：

1
pnpm -v

显示版本号即为成功。

安装 Git#

如果已安装 Git，跳过此步骤。访问 Git 官网 下载并安装对应版本。验证：

1
git --version

显示版本号即为成功。

1.Fork 并克隆仓库到本地#

• 首先访问 Mizuki 仓库，点击 Fork 将仓库复制到自己的 Github 账号下。
• 克隆到本地（推荐使用 SSH 链接，可避免部分网络问题）：

1
git clone <你的Fork仓库SSH地址>
2
cd mizuki

2. 配置 Git 信息#

1
git config --global user.name "你的Github用户名"
2
git config --global user.email "你的Github邮箱"

（如果已配置过 Git 全局信息，可跳过）

3. 安装依赖#

1
pnpm install

4. 修改博客配置#

编辑 src/config.ts 文件自定义博客设置：

• 更新站点信息、主题颜色、横幅图片和社交链接
• 配置翻译设置和特殊页面功能
• 可参考以下配置项进行修改（以示例为例）：

1
import type { SiteConfig, NavBarConfig, ProfileConfig } from './types/config'
2
export const siteConfig: SiteConfig = {
3
  title: '你的博客标题',
4
  subtitle: '你的博客副标题',
5
  lang: 'zh_CN',
6
  themeColor: {
7
    hue: 355, // 主题色色调值
8
    fixed: false
9
  },
10
  // 其他配置...
11
}
12
// 导航栏和个人信息配置类似

5. 启动开发服务器预览#

1
pnpm dev

启动后，在浏览器访问 http://localhost:4321 查看效果。

6. 撰写文章#

创建新文章：

1
pnpm new-post 文章标题

文章会生成在 src/content/posts 目录下，用 MarkText 打开编辑。文章头部信息说明：

1
title: 文章标题
2
published: 发布日期
3
description: 文章描述
4
image: 封面图链接
5
tags: [标签1, 标签2]
6
category: 分类
7
draft: false # 是否为草稿
8
lang: ''

7. 构建网站#

1
pnpm build

生成的静态文件会在 dist 目录中。

8. 推送代码到 Github#

1
git add .
2
git commit -m "描述"
3
git push