Update mdbook, and make it easier in the future

Author: dae

.github/workflows/build.sh

@@ -1,10 +1,41 @@
 #!/bin/bash
 
-(cd && \
-  curl -LO https://github.com/ankitects/mdbook-linkcheck/releases/download/anki-2022-11-17/mdbook.tar.zst && \
-  tar xaf mdbook.tar.zst)
-export PATH="$HOME:$PATH"
-if [ "$CHECK" = "" ]; then
-    rm $HOME/mdbook-linkcheck
-fi    
+# Version configuration
+MDBOOK_VERSION="0.4.51"
+MDBOOK_LINKCHECK_COMMIT="3222e857f22a5b41596070848203d160a4d78fd9"
+MDBOOK_TOC_VERSION="0.14.2"
+
+# mdbook needs to be able to find things like mdbook-toc
+export PATH="$HOME/.cargo/bin:$PATH"
+
+install_if_needed() {
+    local binary=$1
+    local install_cmd=$2
+    
+    if [ "$GITHUB_ACTIONS" = "true" ]; then
+        # avoid recompiling if cached
+        if ! command -v $binary &> /dev/null; then
+            eval $install_cmd
+        fi
+    else
+        eval $install_cmd
+    fi
+}
+
+# Install required binaries
+install_if_needed "mdbook" "cargo install mdbook --version $MDBOOK_VERSION"
+install_if_needed "mdbook-toc" "cargo install mdbook-toc --version $MDBOOK_TOC_VERSION"
+install_if_needed "mdbook-linkcheck" "cargo install --git https://github.com/ankitects/mdbook-linkcheck --rev $MDBOOK_LINKCHECK_COMMIT mdbook-linkcheck"
+
+# Avoid checking links in deploy mode
+if [ "$CHECK" == "" ]; then
+    mv $HOME/.cargo/bin/mdbook-linkcheck linkcheck-tmp
+fi
+
+mdbook --version
 mdbook build
+
+if [ "$CHECK" == "" ]; then
+  # restore linkcheck so it gets stored in the cache
+  mv linkcheck-tmp $HOME/.cargo/bin/mdbook-linkcheck
+fi

.github/workflows/gh-pages.yml

@@ -11,24 +11,50 @@ on:
 
 jobs:
   deploy:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt
+
+      - name: Cache binaries
+        uses: actions/cache@v4
+        with:
+          path: ~/.cargo/bin
+          key: ${{ runner.os }}-bin-${{ hashFiles('.github/workflows/build.sh') }}
+          restore-keys: |
+            ${{ runner.os }}-bin-
 
       - name: Build
         run: .github/workflows/build.sh
 
       - name: Deploy
-        uses: peaceiris/actions-gh-pages@v3
+        uses: peaceiris/actions-gh-pages@v4
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           publish_dir: ./book/html
           cname: ${{ env.cname }}
 
   check:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt
+
+      - name: Cache binaries
+        uses: actions/cache@v4
+        with:
+          path: ~/.cargo/bin
+          key: ${{ runner.os }}-bin-${{ hashFiles('.github/workflows/build.sh') }}
+          restore-keys: |
+            ${{ runner.os }}-bin-
 
       - name: Build
         run: CHECK=1 .github/workflows/build.sh