WordPress 迁移到 Mizuki

约 1181 字大约 4 分钟

2025-08-16

本指南将帮助您将 WordPress 博客文章迁移到 Mizuki 主题。

什么是 Mizuki？

Mizuki 是一个基于 Astro 开发的现代化博客主题，具有以下特点：

快速的静态站点生成
现代化的设计风格
优秀的 SEO 支持
响应式布局
支持多种内容格式

WordPress 与 Mizuki 文章格式差异

WordPress 导出格式

WordPress 通常通过 XML 文件导出内容，包含文章标题、内容、分类、标签、发布日期等信息。

Mizuki 格式示例：

---
title: Markdown Tutorial
published: 2025-01-20
pinned: true
description: A simple example of a Markdown blog post.
tags: [Markdown, Blogging]
category: Examples
licenseName: "Unlicensed"
author: emn178
sourceLink: "https://github.com/emn178/markdown"
draft: false
---

迁移步骤

1. 准备工作

备份您的 WordPress 网站
确保已安装 Mizuki 主题
准备文章存放目录：src/content/posts/

2. 导出 WordPress 内容

方法一：使用 WordPress 后台导出

登录 WordPress 后台
进入「工具」→「导出」
选择「文章」，点击「下载导出文件」
获得 XML 格式的导出文件

方法二：使用插件导出为 Markdown

推荐使用以下插件将 WordPress 内容直接导出为 Markdown 格式：

WordPress to Static Site Generator
Simply Static
WP Gatsby Markdown Exporter

3. 转换文章格式

从 XML 转换

如果您获得的是 XML 文件，需要将其转换为 Markdown 格式。可以使用在线工具或手动转换：

手动转换：
- 复制文章标题和内容
- 创建新的 .md 文件
- 添加 Frontmatter
在线转换工具：
- WordPress to Markdown 转换器
- Pandoc 命令行工具

添加 Frontmatter

为每篇文章添加 Mizuki 所需的 Frontmatter：

---
title: "文章标题"
pubDate: 2024-01-15  # WordPress 发布日期
updatedDate: 2024-01-16  # WordPress 最后修改日期
description: "文章摘要或描述"  # 可从 WordPress 摘要获取
tags: ["标签1", "标签2"]  # WordPress 标签
category: "分类名称"  # WordPress 主分类
cover: "/images/cover.jpg"  # 特色图片（如有）
draft: false
---

4. 静态资源迁移

图片和媒体文件

下载 WordPress 媒体文件：
- 通过 FTP 下载 /wp-content/uploads/ 目录
- 或使用 WordPress 媒体导出插件
整理图片文件：
- 将图片复制到 Mizuki 的 public/images/ 目录
- 保持原有的目录结构或重新组织
更新图片路径：
- WordPress: https://yoursite.com/wp-content/uploads/2024/01/image.jpg
- Mizuki: ![图片](/images/2024/01/image.jpg)