
WordPressの2つのブログをAstroに移行した(全307記事)
WordPressで運用してきた2つのブログを、Astroで作っているこのサイト(y16ra.dev)に統合しました。
- 技術ブログ「y16ra.tech」:161記事(2017〜2025年)
- ライフログ「tricoro.blog」:146記事
合計307記事です。2025年分の11記事は先に手作業で移行していたので、今回の対象は296記事でした。
移行の方針
先に決めたのは次のルールです。
- 記事は選別せず、全部持っていく
- スラッグ(URLの末尾)は英語・ローマ字に統一する
- カテゴリは元のブログの表記のまま残す(「未分類」だけ除く)
- アイキャッチ画像は本文の最初の画像を使う。なければなし
- 画像は幅1,600pxを上限に圧縮する
- URLが変わるので、旧URLから新URLへの対応表を作り、記事単位で301リダイレクト(恒久的な転送)する。設定は今後対応する予定です(詳しくは「残っている作業」に書きます)
旧ドメインは移行後も契約の更新時期まで残し、リダイレクト専用にします。
変換のやり方
公開されているWordPressの記事ページをスクリプトで取得し、Cocoonの本文部分を抜き出して、Astroのコンテンツ形式(src/content/blog/<年>/<スラッグ>/index.md+画像フォルダ)に一括変換しました。変換スクリプトの作成から細かい修正までは、AIエージェントに手伝ってもらいながら進めています。
結果は296記事・画像394枚です。プルリクエストでプレビューを確認しながら進めました。
つまずいた点
一括変換で本文の大部分はそのまま移せましたが、WordPress独自の表現があちこちに残りました。
ブログカードの崩れ
WordPressのリンクカード(ブログカード)で貼っていたリンクが、プレビュー画像やファビコン(ブラウザのタブに出る小さなアイコン)の断片だけを残して崩れていました。75記事・105件を通常のリンクに置き換えています。
ショートコードの残り
[embedyt] のような、WordPressで動画などを埋め込むための [...] 形式の記法(ショートコード)がそのまま残っていたものは、埋め込みに変換しました。SlideShareの埋め込みもありましたが、こちらは元のスライドがWordPress側でもすでに表示できなくなっていたため、スライドへのリンクに置き換えています。
消えた商品表
Amazonの商品名と価格を並べた表が、変換の過程で中身ごと消えてしまった記事がありました。12記事・18商品分を、商品ページへのリンク付きで復元しています。
長い年月のリンク切れ
- 非公開になっていたYouTube動画(埋め込みが再生できない状態)
- 画像のURL自体が404(ページが見つからないというHTTPのエラー)で、Web Archive(インターネット上のページを保存しているサービス)にも残っていないもの
後者は復元を諦め、壊れた画像参照を取り除きました。9年も運用していると、こういう「静かなリンク切れ」が積み上がっていることを実感します。
検証
マージ前にプレビュー環境で、移行した全記事の表示、ランダムに抜いた記事、既存の2025年記事を確認しました。本番反映後にも同じ観点で再確認しています。
残っている作業
旧ドメイン側のリダイレクト設定が残っています。対応表(307件)は作成済みです。サーバー(ConoHa WING)のファイルマネージャーは、10月29日に確認した時点でメンテナンスが明けていました(いつ明けたかは確認できていません)。.htaccess(サーバーの動作を指定する設定ファイル)の差し替えは、これから行います。これが終われば引っ越しは完了です。
おまけ:HTTPSの設定漏れ
移行とは別に、Search Consoleで「HTTPS が評価されていません」と出ているページがありました(対象例:https://y16ra.dev/blog/2026/claude-haiku-5-5/)。Search ConsoleはGoogleが提供する、サイトの検索まわりの状態を確認できるツールです。調べたところ、Cloudflareの「常にHTTPSを使用」がオフになっていたのが原因でした。これをオンにして、httpでアクセスしてもhttpsへ転送されるようにしています。
まとめ
- 2つのWordPressブログ、307記事をAstroの1サイトに統合した
- 一括変換のあと、ブログカード・ショートコード・商品表などの残件を個別に直した
- 残りは旧ドメインのリダイレクト設定のみ
- おまけとして、CloudflareのHTTPS設定漏れも直した
過去記事は資産なので、プラットフォームを変えても捨てずに済んでよかったです。今後の記事はこのサイトに一本化していきます。