ルールの一覧へ

リンクの言葉の URL と行き先が違う

link-text-url-mismatch既定で動く日本語 / 英語

見えている URL と、実際の行き先のサイトが違うリンク

例

指摘される文
新しい手引きは [https://docs.example.com/guide](https://old.example.net/guide) にあります。
chaff の出力
1:9 リンクの言葉は「docs.example.com」ですが、行き先は「old.example.net」です
直した文
新しい手引きは [https://docs.example.com/guide](https://docs.example.com/guide) にあります。
chaff の出力
指摘なし

直し方

言葉と行き先のどちらが正しいかを確かめ、もう一方を合わせてください。行き先の名前を言葉にすると、この食い違いは起きません([導入の手引き](https://…))。

なぜ指摘するのか

「[https://example.com/guide](https://other.example/page)」のように、リンクの言葉が URL で、その URL と実際の行き先のサイトが違うリンクです。読み手は見えている URL に行くつもりで押し、別のサイトに着きます。URL を書き換えたときに片方だけ直した跡であることが多く、なりすましの手口と同じ形でもあります。サイト(ホスト)が同じでも、見えているパスが行き先のパスの頭でなければ([github.com/acme/handbook](https://github.com/handbook))、別のページなので指します。

指摘しないもの

同じサイトの URL を短く見せたもの([github.com/a](https://github.com/a/b)、途中を「…」で省いたもの)、言葉が URL でないリンク、行き先が相対パスやページ内のリンク、参照の形のリンク([言葉][1])は指しません。www. の有無と大文字小文字は同じと読みます。

止める・ゆるめる

この一か所だけ黙らせる(文書に書く)
<!-- stet: link-text-url-mismatch — 理由 -->
チームでゆるめる(理由は chaff.yaml にコメントで残ります)
npx chaffjs relax link-text-url-mismatch --why "理由"
チームで止める(chaff.yaml)
rules: link-text-url-mismatch: off
技術的な情報
層
L1
状態
安定
重さ
注意
対象の言語
日本語と英語
向いている文章
business, technical, blog, legal, docs, academic, literature, speech
文書から読み取るもの
markdown

強さ(段階)

chaff.yaml の rules にこの名前と段階を書くと変わります。書かなければ、ジャンルが決めた段階で動きます(どのジャンルで動くかは下の「ジャンルごとの動き」にあります)。

strictエラー
normal注意
relaxed情報

このルールには数える上限がありません。段階は指摘の重さを変えます。relaxed にすると指摘は消えずに一段軽く出ます。

ジャンルごとの動き

既定で動くジャンル
technical/spec, technical/readme, blog/tech, blog/essay, blog/owned-media, business/proposal, business/report, business/email, business/press-release, business/meeting-notes, legal/contract, legal/statute, legal/judgment, legal/patent, docs/manual, docs/faq, docs/glossary, academic/paper, literature/fiction, literature/essay, literature/poetry, literature/play, speech/address, speech/transcript

ジャンル

指摘の文

リンクの言葉は「{shown}」ですが、行き先は「{target}」です

書き直しの深さ(chaff fix-plan --depth): light — 語と文を直す。構成と文体は残す

このページはルールの定義ファイルから作られています:packages/chaff/rules/link-text-url-mismatch.yaml