370 字
2 分钟
本地部署
🌸 Mizuki 本地部署教程
本文将详细介绍如何在自己的计算机上本地部署 Mizuki 静态博客系统。
📋 系统要求
- Node.js: 版本 ≥ 20.x
- 包管理器: pnpm ≥ 9.x (推荐) 或 npm ≥ 8.x
- Git: 最新版本
🚀 快速开始
1. 克隆项目
git clone https://github.com/matsuzaka-yuki/mizuki.gitcd mizuki2. 安装依赖
安装 pnpm（如果还没有安装）
npm install -g pnpm安装项目依赖
pnpm install3. 基础配置
修改 src/config.ts 文件：
export const siteConfig: SiteConfig = { title: "您的博客名称", subtitle: "博客描述", lang: "zh-CN", themeColor: { hue: 210, fixed: false, }, banner: { enable: true, src: ["assets/banner/1.webp"], carousel: { enable: true, interval: 0.8, }, },};4. 启动开发服务器
pnpm dev访问 http://localhost:4321 查看效果。
📝 内容管理
创建新文章
pnpm new-post "我的第一篇文章"文章将创建在 src/content/posts/ 目录下。
文章 Frontmatter 示例
---title: 文章标题published: 2026-01-30description: 文章描述image: ./cover.jpgtags: [标签1, 标签2]category: 分类draft: falsepinned: false---📁 项目结构
mizuki/├── src/│ ├── components/ # 组件│ ├── content/ # 博客内容│ ├── layouts/ # 布局组件│ ├── pages/ # 页面│ └── config.ts # 配置文件├── public/ # 静态资源├── package.json # 依赖配置└── README.md # 说明文档🔧 高级配置
自定义主题色
在 config.ts 中修改 themeColor.hue 值 (0-360)：
themeColor: { hue: 280, // 紫色主题 fixed: false,}启用/禁用功能typescript// 启用暗色主题切换themeSwitcher: { enable: true, defaultTheme: "auto",}
// 启用搜索功能search: { enable: true, provider: "pagefind",}部分信息可能已经过时