Avoid broken links blocking the site's deployment

Author: ISSOtm

.github/workflows/build-and-deploy.yml

@@ -54,13 +54,6 @@ jobs:
     - name: Install static-sitemap-cli
       run: npm install static-sitemap-cli
 
-    # FIXME: Keep this up to date
-    - name: Install mdbook-linkcheck
-      run: | # `-L` because GitHub performs a redirection
-        curl -L -o mdbook-linkcheck.zip "https://github.com/Michael-F-Bryan/mdbook-linkcheck/releases/download/v${MDBOOK_LINKCHECK_VER}/mdbook-linkcheck.x86_64-unknown-linux-gnu.zip"
-        unzip mdbook-linkcheck.zip mdbook-linkcheck
-        chmod +x mdbook-linkcheck
-
     - name: Install Python dependencies
       run: |
         python -m pip install --upgrade pip
@@ -70,7 +63,6 @@ jobs:
       working-directory: pandocs/
       env:
         MDBOOK_BUILD__CREATE_MISSING: "false" # Prevent creating missing files in SUMMARY.md
-        MDBOOK_OUTPUT__LINKCHECK__COMMAND: "../mdbook-linkcheck"
       run: |
         mdbook build
   
@@ -84,6 +76,44 @@ jobs:
       with:
         path: pandocs/docs/pandocs/
 
+  linkcheck:
+    name: Check for dead links
+    runs-on: ubuntu-latest
+    steps:
+    - name: Checkout pandocs
+      uses: actions/checkout@v4
+      with:
+        path: pandocs
+
+    - name: Cache Rust build dir
+      uses: Swatinem/rust-cache@v2
+      with:
+        workspaces: pandocs/target/
+
+    - name: Install mdbook
+      uses: peaceiris/actions-mdbook@v2
+      with:
+        mdbook-version: 0.4.40
+
+    # FIXME: Keep this up to date
+    - name: Install mdbook-linkcheck
+      run: | # `-L` because GitHub performs a redirection
+        curl -L -o mdbook-linkcheck.zip "https://github.com/Michael-F-Bryan/mdbook-linkcheck/releases/download/v${MDBOOK_LINKCHECK_VER}/mdbook-linkcheck.x86_64-unknown-linux-gnu.zip"
+        unzip mdbook-linkcheck.zip mdbook-linkcheck
+        chmod +x mdbook-linkcheck
+
+    - name: Install Python dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r pandocs/requirements.txt
+
+    - name: Check links
+      working-directory: pandocs/
+      env:
+        MDBOOK_OUTPUT__LINKCHECK__COMMAND: "../mdbook-linkcheck"
+      run: |
+        mdbook build
+
   deploy:
     name: Deploy to GitHub pages
     # Do not run this unless *pushing* to `master`.