Skip to content

[url:...] を仕様の自動リンク <URL> へ一括変換#3088

Merged
znz merged 1 commit into
rurema:masterfrom
znz:convert-url-refs-to-autolinks
Jul 14, 2026
Merged

[url:...] を仕様の自動リンク <URL> へ一括変換#3088
znz merged 1 commit into
rurema:masterfrom
znz:convert-url-refs-to-autolinks

Conversation

@znz

@znz znz commented Jul 14, 2026

Copy link
Copy Markdown
Member

MARKUP_SPEC §7.4 は外部 URL を <URL> / [タイトル](URL) と規定していますが、
rd→md 変換器は [[url:...]] を他の参照タイプと同じ「角括弧1段減」規則で
[url:...] に変換していたため、仕様と実データが乖離していました。
rurema/bitclust#241<URL> 自動リンクがネイティブ描画できるようになったので、
manual/ の [url:...] 453 箇所(117 ファイル)を仕様どおりの <URL> へ揃えます。

変換規則

  • [url:TARGET]<TARGET>(スクリプトによる一括変換)
  • コードフェンス内(行頭・インデントとも)は対象外(該当 0 件を監査で確認)
  • #@# コメント行は対象外(そこにあるのは [[url:]] の rd 残骸 7 件のみ)
  • 見出し・dlist コード term・テーブル・インラインコードスパン内の出現は 0 件(監査済み)

あわせて修正

  • manual/doc/news/3_0_0.md[[url:https://github.com/ruby/webrick]
    (閉じ括弧不足で rd 時代から literal 表示だったタイポ)を <URL> に修正
  • Gemfile.lock の bitclust を 83ab432(#241)へバンプ
    (<URL> の描画に必要。Fix syntax of news/1_9_0.md #3086 のリスト内フェンスの描画にも必要)

検証

変換前(master)と変換後の manual/ 全 1250 ファイルを bitclust 83ab432 の
MDCompiler(GFM モード)で描画して比較:

  • 意図的に直した news/3_0_0.md 以外の 1249 ファイルは HTML 完全一致
    ([url:X]<X> はどちらも同じ direct_url で描画されるため)
  • news/3_0_0.md の差分は literal だった
    [[url:https://github.com/ruby/webrick] が正しい外部リンクになるのみ

🤖 Generated with Claude Code

MARKUP_SPEC §7.4 は外部 URL を <URL> / [タイトル](URL) と規定しているが、
rd→md 変換器は [[url:...]] を他の参照と同じ「角括弧1段減」で [url:...] に
変換していたため、仕様と実データが乖離していた。bitclust #241 で <URL>
自動リンクがネイティブ描画できるようになったので、manual/ の [url:...]
453 箇所を仕様どおりの <URL> へ揃える。

- コードフェンス内・#@# コメント行(そこにあるのは [[url:]] の rd 残骸のみ)
  は変換対象外
- news/3_0_0.md の [[url:https://github.com/ruby/webrick](閉じ括弧不足で
  rd 時代から literal 表示だった)も <URL> に修正
- Gemfile.lock の bitclust を 83ab432(#241、<URL> 描画対応)へバンプ

検証: 変換前後の manual/ 全 1250 ファイルを bitclust 83ab432 の
MDCompiler(GFM) で描画して比較し、意図的に直した news/3_0_0.md の
1ファイル以外は HTML が完全一致([url:] と <URL> は同じ direct_url 描画)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@znz znz merged commit 8a96c6e into rurema:master Jul 14, 2026
9 checks passed
@znz znz deleted the convert-url-refs-to-autolinks branch July 14, 2026 11:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant