WordPressからEmDashへ。ブログサイトの移行で得たもの

WordPressからEmDashへ。ブログサイトの移行で得たもの

EmDashが正式リリースされて1ヶ月が経ちました。
その間PHP脆弱性(PHP2Shell)で世の中あたふたしている中、安直に脱PHP!とか脱WordPress!と声高に叫んでるひとが散見されるけど、そんなひとたちとはちがうんだからね!?同じにしないでよね!?と言わずにはいられないmmochiです。

さて、あんどぷらすでは、mmochiの個人ブログ(いわゆる社長ブログの類です。本当は。)「きこりのこしかけ」を、WordPressからEmDashへ移行しました。

コーポレートサイトのEmDash化では、CMSの移行だけでなく、開発環境やデプロイフロー、独自プラグイン、画像配信など、さまざまな領域で試行錯誤を重ねてきました。

今回の目的は、単純にWordPressからEmDashに移行することではありません。
先行案件で蓄積した知見や実装を別のサイトにも適用し、再利用できる移行手順や実装として整理することです。

サイトの規模や構成が変わっても、どこまで同じ方法で対応できるのか。実際の移行を通じて確認していきましたよ。

WordPressのテーマを参照してデザインを再構築

今回のサイトは、長年WordPressで運用してきた個人ブログです。

移行にあたっては、既存サイト(WordPress)のテーマファイルやCSS、JavaScriptなども参照しながらデザインを再構築しました。

そもそもCMSが変わればテンプレートの仕組みも変わりますし、開発言語も異なるのでWordPressのテーマをそのまま移植することはできないんですよね。
EmDashをCMSとして利用し、Astroをベースにした新しい構成に合わせて、既存のデザインや表示仕様を組み直していきます。

既存の実装を読み解き、新しい環境に合わせて再設計する。これがデザイン移行の基本になります。

サイト固有の機能も再構築

今回の移行では、デザインだけでなく、WordPressで実装していたサイト独自の機能もEmDashに合わせて再構築しています。

例えば「からく値」。からく値
これは、記事ごとに辛口度を1辛〜3辛で設定する、きこりのこしかけ独自の指標です。

WordPressではカスタムフィールドで管理していましたが、EmDashでは記事のデータ構造に専用フィールドを追加し、管理画面から選択できるようにしました。
もちろん、記事一覧や詳細ページなどの表示にも反映しています。
からく値管理画面

目次についても、WordPressではTable of Contents Plusのショートコード `[toc]` を利用していましたが、EmDashでは専用のカスタムブロックに置き換えています。

記事内の見出しから目次を自動生成し、それぞれの見出しにアンカーリンクを設定する仕組み。
目次と本文の見出しを個別に管理する必要がなく、記事の構成に応じて自動的に反映されます。
目次管理画面

こうしたサイト独自の機能も、単純に見た目を再現するだけではなく、新しいCMSのデータ構造や仕組みに合わせて作り直す必要があります。

独自プラグインの再利用と動作検証

コーポレートサイトのEmDash化で実装した独自プラグインも、今回のブログで再利用していきます。(ただし、WordPressにある機能を完全移植したものではありません。未だ改良の余地のあるプロトタイプです。)

構造化データの出力を支援する「ANDPLUS-SchemaBridge」や、AI向けの情報提供を支援する「ANDPLUS-LLMO」です。

今回は、これらを異なるサイト構成やコンテンツ構造でも利用できるか、改めて動作を確認しました。

ANDPLUS-LLMOでは、コーポレートサイトで先行して実装した「llms.txt v2」への対応も引き続き採用しています。
※Markdown形式での記事や固定ページの出力、カテゴリー・タグの一覧、AI向けのドキュメントナビゲーション、sitemap-ai.xmlの生成など、サイトの情報を機械からも参照しやすい形で提供する機能です。

サイトごとに同じ機能を作り直すのではなく、共通部分をプラグインとして再利用できることは、複数サイトを構築・運用するうえで大きなメリットになります。
ただし、EmDashのプラグインはまだ共通化や相互利用が十分に進んでいる段階ではないのですよね。
プラグインの提供元や対応状況も含めて、導入時には確認が必要です。

EmDashのプラグインと実行方式

EmDashでは、プラグインには大きく分けて2つの実行方式があります。
今回利用している独自プラグインは、astro.config.mjsのpluginsに登録するネイティブプラグインです。

一方、EmDashには、sandboxedとして登録し、分離されたisolateで実行するサンドボックス型のプラグインもあります。
Cloudflare Workers上でサンドボックス型を利用する場合は、Worker Loaderなどの設定に加えてWorkers Paidプランが必要になります。

どちらが優れているという単純な話ではなく、プラグインの提供元や管理方法、実行環境、求める信頼境界などによって適切な方式は変わります。
自社で開発・管理する機能を複数のサイトで利用する場合には、こうした実行方式も含めて、運用に合った構成を選ぶことが重要ですね。

GitHubとCLIによる開発・デプロイ

開発環境やデプロイについても、コーポレートサイトで構築した運用フローを適用しています。

  • GitHubでソースコードを管理し、Cursorを使って開発。
  • ステージング環境で確認したうえで、CLIから本番環境へデプロイ。
  • データベースのマイグレーションもCLIで実行。

基本的には、あんどぷらすで取り組む構築案件は同様の構成を前提としています。

従来のWebサイトとは保守の考え方も変わる

EmDashへの移行を検討する際には、公開後の保守についても考えておくことが大切です。

LAMP環境のWebサイトの多くでは、サーバー上にプログラムファイルを配置し、FTPなどでファイルをアップロードして更新する運用が一般的ですよね。

一方、Cloudflareを基盤とするEmDashでは、GitHubでソースコードを管理し、CLIからデプロイする構成になります。
Cloudflare WorkersやD1などの環境設定、データベースのマイグレーションも管理対象です。

ソースコードだけでなく、実行環境やデータベースの状態も含めて管理する必要があります。
従来のようにサーバー上のファイルを更新するだけでは完結しないため、開発環境やデプロイの仕組みも含めた保守が必要になります。

記事の投稿や編集といった日常的なコンテンツ管理はCMSの管理画面から行えますが、プログラムの変更や機能追加、環境のアップデート、障害対応には、開発環境やデプロイの仕組みを理解している必要があります。

そのため、EmDashでサイトを構築する場合は、公開後の保守・運用についても、構築を担当した制作会社などの専門パートナーと継続的に連携できる体制をおすすめします。

日常のコンテンツ更新と、システムそのものの保守は別のもの。
構築時の設計や実装を理解しているパートナーがいることは、長期的な運用においても重要ですね。

画像配信とOGPの確認

なにげに注意しなければいけないのは、画像の表示についてです。
たとえば、Cloudflare Accessで保護している管理用環境に画像を配置し、そのURLを公開ページから参照すると、認証されていない閲覧者やクローラーは画像を取得できません。

管理者としてログインしたブラウザーでは問題なく表示されていても、一般の閲覧者や外部サービスからは認証画面にリダイレクトされる可能性があります。

また、OGP画像も、ブラウザーでページを表示できることと、SNSのクローラーが画像を取得できることは別です。
Facebookなどで画像が取得できない場合は、画像URLだけでなく、Cloudflareのセキュリティ設定やアクセス制御、キャッシュなども確認する必要があります。
きこりのこしかけOGP facebook

あたりまえではあるんですけど、外部サービスからの取得までを公開環境で確認しておくことが大切ですね。

移行はコンテンツを移すだけではない

WordPressからEmDashへの移行は、記事や固定ページを別のCMSに移すだけではありません。
そもそも全く異なるCMSですし、開発言語も実行環境も違います。
そのまま移せるわけないですよねー。

ページ数やデザインの複雑さだけでは、移行の難易度は判断できないのですよね。
(もちろん複雑なデザインの場合、デザインの移行ではなく再現になるので難易度は高いのですけど。)

独自機能や外部サービスとの連携、コンテンツ構造、現在の運用方法など、サイトがどのような仕組みで成り立っているかによって必要な対応は変わるのですが、今回のブログ移行を通じて、コーポレートサイトで得た知見や実装を、異なるサイトにも適用できることを確認できました。

一度構築した仕組みを、別のサイトでも再現できる形に整理する。
今回の移行で得られた一番の成果は、そこにあると思います。

プラットフォームのリプレースは、新規構築とは違った難しさがありますねー。

WordPressからの移行を検討している方へ

WordPressからEmDashへの移行に限らず、新規構築やリニューアルでも、まずは現在のサイトがどのような構成で、どのような機能や運用に依存しているかを把握することが重要です。

テーマやプラグイン、外部連携、画像配信、サーバー、公開後の保守体制まで含めて検討する必要があります。

あんどぷらすでは、現在のサイト構成や運用状況を確認したうえで、EmDashへの移行方針や必要な対応をご提案しています。

既存サイトの移行や、これからの運用を見据えたリニューアル・新規構築を検討されている方は、お気軽にご相談ください。

あんどぷらすへのご相談はこちら