From be84e56752da0d206c483409e418429f8987ecde Mon Sep 17 00:00:00 2001 From: Gregor Zeitlinger Date: Tue, 24 Feb 2026 08:53:17 +0100 Subject: [PATCH 1/3] docs: add lychee config cleanup note for lint:links adopters --- README.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/README.md b/README.md index 8bcdd1b..30eb25d 100644 --- a/README.md +++ b/README.md @@ -244,6 +244,28 @@ two patterns that affect ALL GitHub URLs (any repository): Set `LYCHEE_SKIP_GITHUB_REMAPS=true` to disable all GitHub-specific remaps as an escape hatch if they cause unexpected behavior. +**Lychee config cleanup:** + +When adopting `lint:links`, you can remove the following entries +from your `lychee.toml` because flint handles them at runtime via +`--remap` arguments: + +- **GitHub blob remap for lychee#1729** (e.g. + `"https://github.com/(.*?)/(.*?)/blob/(.*?)/(.*#.*)$ https://raw.githubusercontent.com/$1/$2/$3/$4"`) + — flint remaps fragment URLs to `raw.githubusercontent.com` for + the current repo's base branch, and strips line-number anchors + globally. +- **`#issuecomment-*` excludes** (e.g. + `'^https://github.com/.*#issuecomment-.*$'`) — flint strips the + fragment via remap so the issue/PR page is still checked. +- **`#L\d+` line-number excludes** (e.g. + `'^https://github.com/.+/blob/.+#L\d+'`) — flint strips the + fragment via remap so the file is still checked. + +Note: flint uses `--remap` (not `--exclude`) for these because +lychee's CLI `--exclude` flags override config file excludes rather +than merging with them. + **Environment variables:** From d65e3e83e0a81ed87e018e6ec41fc5c497515463 Mon Sep 17 00:00:00 2001 From: Gregor Zeitlinger Date: Tue, 24 Feb 2026 09:01:41 +0100 Subject: [PATCH 2/3] fix: correct remap description per Copilot review --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 30eb25d..4b6b3bf 100644 --- a/README.md +++ b/README.md @@ -253,7 +253,7 @@ from your `lychee.toml` because flint handles them at runtime via - **GitHub blob remap for lychee#1729** (e.g. `"https://github.com/(.*?)/(.*?)/blob/(.*?)/(.*#.*)$ https://raw.githubusercontent.com/$1/$2/$3/$4"`) — flint remaps fragment URLs to `raw.githubusercontent.com` for - the current repo's base branch, and strips line-number anchors + the current PR's head branch, and strips line-number anchors globally. - **`#issuecomment-*` excludes** (e.g. `'^https://github.com/.*#issuecomment-.*$'`) — flint strips the From 7cd990a8447e78353237dd58d954f4cef699c9d5 Mon Sep 17 00:00:00 2001 From: Gregor Zeitlinger Date: Tue, 24 Feb 2026 09:15:09 +0100 Subject: [PATCH 3/3] fix: wrap long line to satisfy editorconfig 100-char limit --- README.md | 30 ++++++++++++++---------------- 1 file changed, 14 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index 4b6b3bf..c018645 100644 --- a/README.md +++ b/README.md @@ -247,24 +247,22 @@ remaps as an escape hatch if they cause unexpected behavior. **Lychee config cleanup:** When adopting `lint:links`, you can remove the following entries -from your `lychee.toml` because flint handles them at runtime via -`--remap` arguments: - -- **GitHub blob remap for lychee#1729** (e.g. - `"https://github.com/(.*?)/(.*?)/blob/(.*?)/(.*#.*)$ https://raw.githubusercontent.com/$1/$2/$3/$4"`) - — flint remaps fragment URLs to `raw.githubusercontent.com` for - the current PR's head branch, and strips line-number anchors - globally. -- **`#issuecomment-*` excludes** (e.g. - `'^https://github.com/.*#issuecomment-.*$'`) — flint strips the - fragment via remap so the issue/PR page is still checked. -- **`#L\d+` line-number excludes** (e.g. - `'^https://github.com/.+/blob/.+#L\d+'`) — flint strips the - fragment via remap so the file is still checked. +from your `lychee.toml` because flint handles them at runtime +via `--remap` arguments: + +- **GitHub blob/fragment remap for + [lychee#1729](https://github.com/lycheeverse/lychee/issues/1729)** + — flint remaps fragment URLs to `raw.githubusercontent.com` + for the current PR's head branch, and strips line-number + anchors globally. +- **`#issuecomment-*` excludes** — flint strips the fragment + via remap so the issue/PR page is still checked. +- **`#L\d+` line-number excludes** — flint strips the fragment + via remap so the file is still checked. Note: flint uses `--remap` (not `--exclude`) for these because -lychee's CLI `--exclude` flags override config file excludes rather -than merging with them. +lychee's CLI `--exclude` flags override config file excludes +rather than merging with them. **Environment variables:**