Update Github workflows to account for the mdBook upgrade

mdBook was still referring to 0.4.x versions in the github workflow, and
mdbook-linkcheck has not been updated to support 0.5. This commit
switches the repo to using "mdbook-linkcheck2", which is a fork that's
been properly updated.

mdbook-linkcheck2 does not have any releases associated with the repo,
which meant I had to switch installation methods. As such, I moved
towards a (hopefully) straightforward `cargo install` approach.

Author: mtthgn

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

@@ -27,13 +27,15 @@ concurrency:
   cancel-in-progress: false
 
 env:
-  MDBOOK_LINKCHECK_VER: 0.7.7
+  MDBOOK_VERSION: 0.5.2
+  MDBOOK_LINKCHECK2_VERSION: 0.12.0
 
 jobs:
   build:
     name: Build Pan Docs
     runs-on: ubuntu-latest
     steps:
+      - uses: dtolnay/rust-toolchain@stable
       - name: Checkout pandocs
         uses: actions/checkout@v4
         with:
@@ -45,9 +47,7 @@ jobs:
           workspaces: pandocs/
 
       - name: Install mdbook
-        uses: peaceiris/actions-mdbook@v2
-        with:
-          mdbook-version: 0.4.40
+        run: cargo install mdbook@${MDBOOK_VERSION}
 
       - name: Install static-sitemap-cli
         run: npm install static-sitemap-cli
@@ -78,6 +78,7 @@ jobs:
     name: Check for dead links
     runs-on: ubuntu-latest
     steps:
+      - uses: dtolnay/rust-toolchain@stable
       - name: Checkout pandocs
         uses: actions/checkout@v4
         with:
@@ -88,17 +89,10 @@ jobs:
         with:
           workspaces: pandocs/
 
-      - 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 mdbook dependencies
+        run: |
+          cargo install mdbook@${MDBOOK_VERSION}
+          cargo install mdbook-linkcheck2@${MDBOOK_LINKCHECK2_VERSION}
 
       - name: Install Python dependencies
         run: |
@@ -107,10 +101,7 @@ jobs:
 
       - name: Check links
         working-directory: pandocs/
-        env:
-          MDBOOK_OUTPUT__LINKCHECK__COMMAND: "../mdbook-linkcheck"
-        run: |
-          mdbook build
+        run: mdbook build
 
   deploy:
     name: Deploy to GitHub pages

book.toml

@@ -38,7 +38,7 @@ git-repository-url = "https://github.com/gbdev/pandocs"
 edit-url-template = "https://github.com/gbdev/pandocs/edit/master/{path}"
 site-url = "/pandocs/"
 
-[output.linkcheck]
+[output.linkcheck2]
 follow-web-links = true
 traverse-parent-directories = false
 optional = true