fix: configure lychee link checker for Astro base path (#125)

* fix: configure lychee link checker for Astro base path (#121)

Add lychee.toml with remap rule to strip /tutorial-git/ prefix,
re-enable link checking in both build and deploy workflows.

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

* fix: use --root-dir instead of --base for lychee local paths

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

* fix: remap to root-relative paths instead of file:// URLs

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

* 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>

---------

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

Author: braboj

.github/workflows/build.yml

@@ -30,9 +30,11 @@ jobs:
         working-directory: astro-site
         run: npm run build
 
-      # TODO: Fix lychee configuration for Astro's base path and fragment links (#121)
-      # - name: Check links
-      #   uses: lycheeverse/lychee-action@v2
-      #   with:
-      #     args: --base ${{ github.workspace }}/astro-site/dist --root-dir ${{ github.workspace }}/astro-site/dist astro-site/dist
-      #     fail: true
+      - 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:
+          args: --root-dir astro-site/dist --config lychee.toml 'astro-site/dist/**/*.html'
+          fail: true

.github/workflows/deploy.yml

@@ -39,12 +39,14 @@ jobs:
         working-directory: astro-site
         run: npm run build
 
-      # TODO: Fix lychee configuration for Astro's base path and fragment links (#121)
-      # - name: Check links
-      #   uses: lycheeverse/lychee-action@v2
-      #   with:
-      #     args: --base ${{ github.workspace }}/astro-site/dist --root-dir ${{ github.workspace }}/astro-site/dist astro-site/dist
-      #     fail: true
+      - 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:
+          args: --root-dir astro-site/dist --config lychee.toml 'astro-site/dist/**/*.html'
+          fail: true
 
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3

lychee.toml

@@ -0,0 +1,13 @@
+# Lychee link checker configuration
+# Runs against the Astro build output in astro-site/dist/
+
+# Exclude external URLs to keep CI fast and deterministic
+exclude = [
+  "^https://",
+  "^http://",
+]
+
+# Accept 200 and 204
+accept = [200, 204]
+
+no_progress = true