Skip to content

Commit 435adea

Browse files
eshanrnheshanrnh
committed
Adding Lychee Config files
1 parent 15fbab4 commit 435adea

File tree

4 files changed

+187
-0
lines changed

4 files changed

+187
-0
lines changed

‎.github/lychee.toml‎

Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
# .github/lychee.toml
2+
3+
############################# Display #############################
4+
# Verbose program output
5+
# Accepts log level: "error", "warn", "info", "debug", "trace"
6+
verbose = "info"
7+
8+
# Don't show interactive progress bar while checking links.
9+
no_progress = true
10+
11+
############################# Cache ###############################
12+
# Enable link caching. This can be helpful to avoid checking the same links on
13+
# multiple runs.
14+
cache = false
15+
16+
############################# Runtime #############################
17+
# Maximum number of concurrent link checks.
18+
max_concurrency = 12
19+
20+
# Maximum number of allowed redirects.
21+
max_redirects = 5
22+
23+
# Maximum number of allowed retries before a link is declared dead.
24+
max_retries = 1
25+
26+
############################# Requests ############################
27+
# Website timeout from connect to response finished.
28+
timeout = 10
29+
30+
# Minimum wait time in seconds between retries of failed requests.
31+
retry_wait_time = 1
32+
33+
# Accept more status codes (follow redirects automatically)
34+
accept = ["200..=204", "301..=308", "429"]
35+
36+
# Avoid false fragment errors
37+
include_fragments = false
38+
39+
# Only test links with the given schemes (e.g. https).
40+
# Omit to check links with any other scheme.
41+
# At the moment, we support http, https, file, and mailto.
42+
scheme = ["https"]
43+
44+
# When links are available using HTTPS, treat HTTP links as errors.
45+
require_https = false
46+
47+
# Fallback extensions to apply when a URL does not specify one.
48+
# This is common in documentation tools that cross-reference files without extensions.
49+
fallback_extensions = ["md", "html"]
50+
51+
############################# Exclusions ##########################
52+
# Exclude URLs and mail addresses from checking (supports regex).
53+
exclude = [
54+
'^mailto:',
55+
'^https?://localhost',
56+
'^https?://127\\.0\\.0\\.1',
57+
'^https://www\.linkedin\.com',
58+
'^https?://issues\.umbraco\.org/',
59+
'^https?://web\\.archive\\.org/web/'
60+
]
61+
62+
# Exclude these filesystem paths from getting checked.
63+
exclude_path = [
64+
'(^|/)node_modules/',
65+
'(^|/)dist/',
66+
'(^|/)bin/',
67+
'\\.txt$', # skip .txt extensions
68+
'(^|/)test/' # skip directories named "test"
69+
]
70+
71+
# URLs to check (supports regex). Has preference over all excludes.
72+
include = ['gist\.github\.com.*']
73+
74+
# Skip checking mail addresses
75+
include_mail = true
76+
77+
############################# Content Checks ######################
78+
# Mark pages as broken if the body contains "page not found" or "404"
79+
[content]
80+
deny = ["(?i)page not found", "(?i)404"]

‎.github/workflows/check-broken-pr-links.yml‎

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
name: Check Links in Pull Requests
2+
3+
on:
4+
pull_request:
5+
branches:
6+
- main
7+
paths:
8+
- '**/*.md'
9+
10+
jobs:
11+
check-links:
12+
runs-on: ubuntu-latest
13+
14+
steps:
15+
# 1️⃣ Checkout the repository
16+
- name: Checkout code
17+
uses: actions/checkout@v4
18+
with:
19+
fetch-depth: 0
20+
21+
# 2️⃣ Get changed Markdown files in the PR
22+
- name: Get changed Markdown files
23+
id: changed-files
24+
run: |
25+
CHANGED_FILES=$(git diff --name-only ${{ github.event.pull_request.base.sha }} ${{ github.sha }} | grep '\.md$' || true)
26+
CHANGED_FILES="${CHANGED_FILES//$'\n'/ }" # replace newlines with spaces
27+
echo "CHANGED_FILES=$CHANGED_FILES" >> $GITHUB_ENV
28+
echo "Changed Markdown files: $CHANGED_FILES"
29+
30+
# 3️⃣ Skip if no Markdown files changed
31+
- name: Skip if no changed Markdown files
32+
if: env.CHANGED_FILES == ''
33+
run: |
34+
echo "No Markdown files changed. Skipping link check."
35+
exit 0
36+
37+
# 4️⃣ Run Lychee on changed files (compact output)
38+
- name: Run Lychee
39+
id: run-lychee
40+
uses: lycheeverse/lychee-action@v2
41+
with:
42+
args: |
43+
--no-progress
44+
--include-fragments
45+
--format compact
46+
${{ env.CHANGED_FILES }}
47+
output: lychee/out_raw.md
48+
fail: false # ✅ don't fail yet, let us capture output
49+
50+
# 5️⃣ Clean Lychee output (remove summary line + mark if has content)
51+
- name: Clean Lychee output
52+
id: clean-output
53+
if: always()
54+
run: |
55+
grep -v '^🔍' lychee/out_raw.md > lychee/out.md || true
56+
if [ -s lychee/out.md ]; then
57+
echo "has_content=true" >> $GITHUB_OUTPUT
58+
else
59+
echo "has_content=false" >> $GITHUB_OUTPUT
60+
fi
61+
62+
# 6️⃣ Comment broken links on PR
63+
- name: Comment broken links
64+
if: always() && (env.CHANGED_FILES != '') && (steps.clean-output.outputs.has_content == 'true')
65+
uses: marocchino/sticky-pull-request-comment@v2
66+
with:
67+
path: lychee/out.md
68+
recreate: true
69+
70+
# 7️⃣ Fail workflow if broken links are found
71+
- name: Fail workflow if broken links
72+
if: steps.clean-output.outputs.has_content == 'true'
73+
run: |
74+
echo "❌ Broken links detected. Please review the PR comment for details."
75+
exit 1

‎.gitignore‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,3 +4,4 @@
44
*.orig
55
.vscode
66
.idea
7+
.lycheecache

‎.lycheeignore‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
# These links are ignored by lychee link checker: https://github.com/lycheeverse/lychee
2+
# The file allows you to list multiple regular expressions for exclusion (one pattern per line).
3+
# The `.lycheeignore` file is only used for excluding URLs, not paths. Use the `exclude_path` key in the `lychee.toml` file. ref: https://lychee.cli.rs/recipes/excluding-paths/
4+
5+
# GitHub blob/tree fragment links
6+
^https://github\.com/umbraco/Umbraco-CMS/blob/.*/.*#L.*
7+
^https://github\.com/umbraco/Umbraco-CMS/tree/.*
8+
^https://github\.com/Shazwazza/Articulate/blob/.*/.*#L.*
9+
^https://github\.com/umbraco/Umbraco-CMS/blob/.*
10+
11+
# Anchor/fragment links causing false positives
12+
^https://apidocs\.umbraco\.com/.*/#.*
13+
^https://tinymce\.github\.io/.*/#.*
14+
^https://openid\.net/.*/#.*
15+
^https://docs\.microsoft\.com/.*#.*
16+
^https://learn\.microsoft\.com/.*#.*
17+
^https://developer\.mozilla\.org/.*/#.*
18+
^https://learning\.postman\.com/docs/.*/#.*
19+
^https://nginx\.org/.*/#.*
20+
^https://azure\.microsoft\.com/en-gb/services/media-services/.*
21+
^https://www\.tiny\.cloud/docs/.*
22+
23+
# TinyMCE anchors
24+
^https://github\.com/tinymce/tinymce/issues/.*#.*
25+
26+
# NIST FIPS and other static docs
27+
^https://csrc\.nist\.gov/publications/PubsFIPS\.html#.*
28+
29+
# Timeout-prone Umbraco issue links
30+
^https://issues\.umbraco\.org/issue/.*
31+
^https://issues\.umbraco\.org/issues/.*

0 commit comments

Comments
 (0)