WordPressからMizukiへの移行

681字程度約2分

2025-08-16

このガイドでは、WordPressブログの投稿をMizukiテーマに移行する方法を説明します。

Mizukiとは？

MizukiはAstroをベースに開発されたモダンなブログテーマで、以下の特徴があります。

高速な静的サイト生成
モダンなデザインスタイル
優れたSEOサポート
レスポンシブなレイアウト
複数のコンテンツ形式をサポート

WordPressとMizukiの記事形式の違い

WordPressエクスポート形式

WordPressは通常、XMLファイルを介してコンテンツをエクスポートします。これには、記事のタイトル、コンテンツ、カテゴリ、タグ、公開日、その他の情報が含まれます。

Mizuki形式の例:

---
title: Markdownチュートリアル
published: 2025-01-20
pinned: true
description: Markdownブログ投稿の簡単な例です。
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コンテンツのエクスポート

方法1: WordPress管理パネルからのエクスポート

WordPress管理パネルにログイン
「ツール」→「エクスポート」に移動
「投稿」を選択し、「エクスポートファイルをダウンロード」をクリック
XML形式のエクスポートファイルを取得

方法2: プラグインを使用して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)