リンクチェッカー

作成2026年4月27日Takeshi Takatsudo

ビルド後の内部リンクを検証するリンクチェッカー。ビルド済みHTMLとMDXソースファイルを対象にします。

リンクチェッカー

zudo-docには、サイトビルド後に2種類の検証を行う組み込みリンクチェッカー（scripts/check-links.js）が含まれています。

チェック内容

モード1: ビルド済みHTMLスキャン

dist/内のすべての.htmlファイルをスキャンし、内部<a href="...">リンクの各ターゲットがディスク上に存在するかを検証します。以下を処理します：

ベースパスの除去（例：/pj/zudo-doc/docs/foo → docs/foo）
末尾スラッシュの解決（docs/foo/ → docs/foo/index.html）
拡張子の解決（docs/foo → docs/foo/index.htmlまたはdocs/foo.html）
解決前のクエリ文字列とフラグメントの除去
ファイルのディレクトリに対する相対リンクの解決
パフォーマンスのための解決済みパスのキャッシュ

スキップされるリンク（チェック対象外）：

外部URL（https://、http://）
アンカーのみのリンク（#section）
mailto:、javascript:、data:、tel: URI
バージョン付きドキュメントリンク（/v/*/） — バージョンコンテンツが不完全な場合があるため

モード2: MDXソーススキャン

設定されたコンテンツディレクトリ内のすべての.mdxおよび.mdファイルをスキャンし、ベースパスをバイパスする絶対リンクを検出します。以下のようなリンクが対象です：

<!-- これらはフラグされます — ベースパスをバイパスしています -->
[guide](/docs/guides/foo)
<a href="/ja/docs/guides/foo">link</a>

<!-- これらは問題ありません — 相対パスを使用しています -->
[guide](./foo.mdx)
[guide](../other/bar.mdx)

ベースパスが設定されている場合（例：/pj/zudo-doc/）、/docs/や/ja/docs/で始まる絶対リンクはベースパスのプレフィックスが欠けているため壊れます。MDXソーススキャンは、これらが本番環境で壊れたリンクになる前に検出します。

フェンスドコードブロック内のリンクは無視されます。