fix: use symlink to mirror Astro base path for lychee

Create dist/tutorial-git -> dist/ symlink so root-relative links
like /tutorial-git/introduction/ resolve correctly.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: braboj

.github/workflows/build.yml

@@ -30,6 +30,9 @@ jobs:
         working-directory: astro-site
         run: npm run build
 
+      - name: Create base path symlink for link checker
+        run: ln -s . astro-site/dist/tutorial-git
+
       - name: Check links
         uses: lycheeverse/lychee-action@v2
         with:

.github/workflows/deploy.yml

@@ -39,6 +39,9 @@ jobs:
         working-directory: astro-site
         run: npm run build
 
+      - name: Create base path symlink for link checker
+        run: ln -s . astro-site/dist/tutorial-git
+
       - name: Check links
         uses: lycheeverse/lychee-action@v2
         with:

lychee.toml

@@ -1,15 +1,6 @@
 # Lychee link checker configuration
 # Runs against the Astro build output in astro-site/dist/
 
-# Remap the /tutorial-git/ base path to the dist root so that
-# root-relative links like /tutorial-git/introduction/ resolve
-# to dist/introduction/index.html
-remap = ["^/tutorial-git/(.*) /$1"]
-
-# Skip external links in CI to avoid flaky failures from transient
-# network issues. Run with --include-mail to check mailto: links.
-exclude_path = []
-
 # Exclude external URLs to keep CI fast and deterministic
 exclude = [
   "^https://",
@@ -19,5 +10,4 @@ exclude = [
 # Accept 200 and 204
 accept = [200, 204]
 
-# No caching needed in CI
 no_progress = true