URL 移行マップ

これは、販売者共通の GFMR ページを Live Lab の markdown-renderer.wakalab.dev から Wakalab の正本 wakalab.dev へ移すための運用 URL マップです。コンテンツ構成の所有ルールを具体化します。

旧ページと移行先が同じ目的を担う場合は 301 を使います。移行した URL を別の 200 ページとして index させません。Lab に残すのは、固有のレンダリング実演と GFMR 固有の技術情報だけです。

redirect マップ

tools/wp-abilities/snippet/gfmr-demo-abilities.php がこれらの redirect を本番へ反映するソースです。各行は日本語リクエストなら日本語の移行先へ、?gfmr_lang=en または旧 /en/ prefix なら英語の移行先へ 301 します。

旧 WordPress URL	Wakalab の正本 URL	対応	sitemap
/legal/	/ja/legal/	301	WordPress sitemap から除外
/pricing/	/ja/products/markdown-renderer-for-github/pro	301	除外
/license/	/ja/products/markdown-renderer-for-github/pro	301	除外
/documentation/	/ja/products/markdown-renderer-for-github/	301	除外
/roadmap/	/ja/products/markdown-renderer-for-github/roadmap	301	除外
/markdown-renderer-for-github/roadmap/	/ja/products/markdown-renderer-for-github/roadmap	301	除外
/changelog/	/ja/products/markdown-renderer-for-github/changelog	301	除外
/markdown-renderer/	/ja/products/markdown-renderer-for-github/	301	除外
/examples/	Lab 自身	self-canonical	実演として価値がある間は残す
/tech/	Lab 自身	self-canonical	GFMR 固有情報として残す

pricing、license、legal、documentation、changelog の入れ子の旧 URL も同じ 301 方針です。過去リンクで redirect chain を作らないため、PHP の redirect マップに残します。

反映と検証

1. リポジトリの snippet を WordPress Code Snippets へコピーして有効化し、node tools/wp-abilities/client/cli.mjs ping でバージョンを確認します。

2. APPLY=1 node scripts/migrate-wordpress-to-gfmr-lab.mjs を実行します。routing snippet が 1.11.0 以上であることを確認してから、Lab トップの設定と管轄内の旧ページの draft 化を行います。

3. 各旧 URL が 1 回だけ 301 し、移行先が 200 であることを確認します。

   curl -sSI 'https://markdown-renderer.wakalab.dev/pricing/?gfmr_lang=en'
   curl -sSI https://markdown-renderer.wakalab.dev/pricing/

4. redirect が設定する言語 cookie を指定して移行先を監査します。canonical は 1 個、hreflang は en / ja / x-default が揃い、正本と矛盾しないことを確認します。

   node tools/wp-abilities/client/cli.mjs seo-audit \
     --url https://wakalab.dev/ja/products/markdown-renderer-for-github/pro \
     --cookie 'pref-lang=ja'
   RUN_LIVE_WP_SEO_AUDIT=1 node --test tools/wp-abilities/test/seo-audit-live.test.mjs

5. https://markdown-renderer.wakalab.dev/wp-sitemap.xml と Rank Math の page sitemap の両方で、退役した path が消えたことを確認します。301 が本番反映されるまで sitemap から先に URL を消してはいけません。

Search Console の確認リスト

• [ ] redirect 反映後に https://wakalab.dev/sitemap.xml と WordPress sitemap を送信する。
• [ ] 旧 URL と英日それぞれの移行先を URL Inspection し、Google が 301 と selected canonical を認識していることを記録する。
• [ ] 7 日後に Page indexing で redirect / duplicate canonical の警告を確認する。
• [ ] 28 日後に index 数と redirect error を確認し、multi-hop redirect があれば修正する。
• [ ] 90 日後に検索パフォーマンスを確認し、Lab 固有の価値がある URL だけを index 可能な状態で残す。

同一内容のページには canonical や noindex の代わりに 301 を使います。noindex,follow は必要な Lab の案内ページで、検索価値がない場合だけに限定します。