背景

このサイトの開発ブログはこれまで /blog というURLで公開していました。今回、/blog パスに別の新機能を実装する予定が生まれたため、既存の開発ブログを /devblog へ移行することにしました。

単にページファイルのディレクトリを変えるだけでなく、blog という名前自体を完全に解放することが目標でした。将来の新機能が blog という名前のルーティングやコンテンツコレクションを自由に使えるよう、名前空間ごと空けるアプローチです。

移行した範囲

今回の変更は URL だけでなく、Astro の内部構造にも及びました。

ディレクトリの移動：

• ページルーティング（src/pages/blog/ → src/pages/devblog/）
• コンテンツコレクション（src/content/blog/ → src/content/devblog/）

コード内の参照の変更：

• Astro の getCollection('blog') → getCollection('devblog') への書き換え
• RSS フィード URL（/blog/rss.xml → /devblog/rss.xml）
• wiki 自動リンクの生成ロジック（/blog/wiki/ → /devblog/wiki/）
• サイトマップ内の URL 列挙
• About ページなど各所のナビゲーションリンク

意図的に変えなかったもの：

• データベースのテーブル名（URL とは無関係なため）
• /blog → /devblog の後方互換リダイレクト（/blog を新機能用に完全解放するため、あえて追加しない）

後から発覚した漏れ

初回の移行後、ブランチプレビューで確認したところ、一覧ページの記事リンクがすべて 404 になっていました。

原因は、テンプレートリテラル内の /blog パスが置換の対象から漏れていたことでした。

// 修正前（一覧ページのリンク生成部分）
`/blog/${post.slug}`
`/blog?category=${encodeURIComponent(cat)}`

// 修正後
`/devblog/${post.slug}`
`/devblog?category=${encodeURIComponent(cat)}`

通常の文字列リテラル（'/blog/'）は sed で一括置換できていましたが、バッククォートで始まるテンプレートリテラルはパターンに含めていなかったため見落としていました。

また個別記事ページでは、カテゴリーのリンク形式が古い /blog/category/xxx というパス形式のまま残っていました。現在のサイトではカテゴリーはクエリパラメータ形式（/devblog?category=xxx）で処理されているため、形式ごと変更する必要がありました。

// 修正前（旧パス形式）
`/blog/category/${category}`

// 修正後（クエリパラメータ形式）
`/devblog?category=${encodeURIComponent(category)}`

encodeURIComponent() を追加したのは、カテゴリー名に日本語が含まれる場合に URL エンコードが必要なためです。

Astro のコンテンツコレクションと URL の分離

今回の作業で改めて確認したのは、Astro においてページの URL とコンテンツコレクション名は別物だということです。

• URL のルーティング → src/pages/ 配下のディレクトリ名で決まる
• コンテンツコレクション名 → src/content/ 配下のディレクトリ名で決まる
• コレクションの参照 → コード内の getCollection('コレクション名') で決まる

src/pages/devblog/ を作っただけでは getCollection('blog') は変わらず古いコレクションを参照したままになります。コードの参照も getCollection('devblog') に書き換えるとともに、src/content/devblog/ へのディレクトリ移動も必要でした。

移行後の確認ポイント

• /devblog でブログ一覧が表示される
• 記事個別ページのリンクが正しく /devblog/ を指している
• カテゴリークリックで /devblog?category=xxx へ遷移する
• RSS フィード（/devblog/rss.xml）が正常に返る
• /blog にアクセスすると 404（意図した動作）