リンク解決

コンテンツのソースマップを使って内部リンクの参照先を書き換え、ビルドを通してリンクを維持する。

ResolveLinksPlugin は、起動時に構築されたコンテンツのソースマップを使って、 内部 Markdown リンク（[text](./page.mdx)、[text](../other/page)）を正規化します。 ソースマップが利用可能なときに、プロジェクトレベルで組み込まれます。

何をするか

mdast フェーズで、HTML が生成される前に、プラグインはすべての Link ノードを たどります。各相対リンクに対して:

1. 現在のソースファイルを基準にパスを解決する。

2. 解決したパスをコンテンツのソースマップで照合する。

3. 見つかった場合は、url をそのエントリの最終出力 URL に書き換える。

4. 見つからない場合は、警告診断を出力してリンクをそのまま残す。

これにより、相対ファイルパスとして記述されたリンクの参照先（ローカルで編集しながら コンテンツを相互リンクする際の自然な書き方）は、ファイルから URL へのマッピングが どう設定されていても、ビルド後のサイトで正しい出力 URL を生成します。

設定

ResolveLinksPlugin はプロジェクトごとに組み込まれ、zfb.config.ts のキーとしては 現れません。コンテンツのソースマップが存在するとき（コンテンツコレクションでは デフォルト）、自動的に有効になります。

関連項目

• リンク検証 — 壊れた内部リンクをビルドの致命的エラーとして 扱う、オプトインのプラグイン。

• 外部リンク — 外向きのリンクを扱う、対となるコアプラグイン。