安装 Node.js#

访问 Node.js 官网 下载并安装最新版本的 Node.js。建议使用 LTS 版本。

安装完成后，打开终端或命令提示符，运行以下命令验证 Node.js 是否安装成功：

1
node -v
2
npm -v

如果显示版本号，则表示安装成功。

安装 pnpm#

如果您尚未安装 pnpm，可以通过 npm 安装：

1
npm install -g pnpm

安装完成后，打开终端或命令提示符，运行以下命令验证 pnpm 是否安装成功：

1
pnpm -v

如果显示版本号，则表示安装成功。

安装 Github Desktop#

访问 Github官网下载并安装适合您操作系统的软件版本。

安装完成后，打开软件登录长好即可。

1. 克隆项目#

首先，克隆 Mizuki 项目到本地：

运行Github Desktop点击克隆选项，选择你新建的Mizuki项目。

2. 安装依赖#

使用 pnpm 安装项目依赖：

1
pnpm install

3. 配置博客#

在启动项目之前，您需要根据自己的需求进行配置：

• 编辑 src/config.ts 文件来自定义博客设置
• 更新站点信息、主题颜色、横幅图片和社交链接
• 配置翻译设置和特殊页面功能

4. 启动开发服务器#

运行以下命令启动开发服务器：

1
pnpm dev

启动成功后，您可以在浏览器中访问 http://localhost:4321 查看您的博客。

部署到 github.io 网址#

在 astro.config.mjs 中配置文件设置 site 和 base 选项。

1
import { defineConfig } from 'astro/config'
2

3
export default defineConfig({
4
  site: 'https://<username>.github.io',
5
  base: '/',
6
})

NOTE

这里演示的是部署到仓库名为<username>.github.io！

（如果出现了以下情况，则不要设置 base 参数：

你的页面是由根文件夹所提供。 你的源码存储库是位于 https://github.com//.github.io）

如果你要更改仓库名请将base:'/'更改为base:'仓库名'。当配置了这个值后，你所有的内部页面链接都必须以你的 base 值作为前缀：

1
<a href="/my-repo/about">关于本站</a>

Site

site 的值必须是以下之一：

• 基于你的用户名的以下网址: https://<username>.github.io
• 为 GitHub 组织的私有页面 自动生成的随机网址：https://<random-string>.pages.github.io/

Base【非.github.io】

• base的值请更改为项目名

• 运行项目

• 1
  pnpm dev
  

  NOTE

  这里项目运行会有报错，请通过VS Code搜索项目中报错句段路径，在调取的路径前添加/项目名称我这里是/Mizuki

  全部更改完成即无报错显示

  【不熟悉请不要更改此选项！！默认'/'即可】

  上传代码#

1.在 GitHub 上，跳转到存储库的 Settings 选项卡并找到设置的 Pages 部分。

2.选择 GitHub Actions 作为你网站的 Source，然后按 Save。 小tips: 提交前记得把workflows里的另外两个文件删了，不然action会报错喔OvO

3.将更改好的项目粘贴到Github Desktop克隆的文件夹中，点击上传

你的网站现在应该已完成发布了！当你将更改推送到 Astro 项目的存储库时，GitHub Action 将自动为你部署它们。