迁移指南总览
本指南帮助你将现有博客内容迁移到 Mizuki 主题。无论你使用什么平台,都可以在这里找到对应的迁移方案。
静态博客框架
Section titled “静态博客框架”| 平台 | 迁移难度 | 说明 |
|---|---|---|
| Hexo | ⭐⭐ 简单 | Markdown 文件,格式相近 |
| Hugo | ⭐⭐ 简单 | Markdown 文件,需要调整 frontmatter |
| Jekyll | ⭐⭐ 简单 | Markdown 文件,格式相近 |
| Gridea | ⭐⭐ 简单 | Markdown 文件,直接导入 |
CMS 系统
Section titled “CMS 系统”| 平台 | 迁移难度 | 说明 |
|---|---|---|
| WordPress | ⭐⭐⭐ 中等 | 需要数据库导出和格式转换 |
| Typecho | ⭐⭐⭐ 中等 | 需要数据库导出和格式转换 |
| Halo | ⭐⭐⭐ 中等 | 支持 API 导出 |
| Z-Blog | ⭐⭐⭐ 中等 | 需要数据库导出 |
| 方式 | 适用场景 | 说明 |
|---|---|---|
| Markdown 导入 | 任意平台 | 手动导入 Markdown 文件 |
| HTML 导入 | 任意平台 | 导入 HTML 文件并转换 |
1. 备份原博客
Section titled “1. 备份原博客”在开始迁移之前,务必备份原博客的所有内容:
# 备份整个博客目录cp -r /path/to/old-blog /path/to/old-blog-backup
# 或使用 Gitcd /path/to/old-bloggit archive -o backup.zip HEAD2. 安装 Mizuki
Section titled “2. 安装 Mizuki”git clone https://github.com/LyraVoid/Mizuki.gitcd Mizukipnpm install3. 了解 Mizuki 的文件结构
Section titled “3. 了解 Mizuki 的文件结构”src/├── content/│ └── posts/ # 文章目录├── data/ # 数据文件└── assets/ # 资源文件public/└── images/ # 图片目录通用迁移流程
Section titled “通用迁移流程”- 导出内容:从原平台导出文章和图片
- 转换格式:将内容转换为 Mizuki 兼容的 Markdown 格式
- 导入文件:将转换后的文件放入 Mizuki 相应目录
- 调整配置:根据需要调整 frontmatter 和配置
- 测试验证:本地运行测试,确保内容正确显示