fix: update to latest mdbook fixing build errors

Author: jeffabailey

.github/workflows/mdbook.yml

@@ -29,8 +29,6 @@ jobs:
   build:
     runs-on: ubuntu-latest
     env:
-      MDBOOK_VERSION: 0.4.52
-      MDBOOK_MERMAID_VERSION: 0.10.0
       CARGO_HOME: ${{ github.workspace }}/.cargo
       RUSTUP_HOME: ${{ github.workspace }}/.rustup
     steps:
@@ -39,8 +37,6 @@ jobs:
         run: bash scripts/install-mdbook.sh
         env:
           REPO_ROOT: ${{ github.workspace }}
-          MDBOOK_VERSION: ${{ env.MDBOOK_VERSION }}
-          MDBOOK_MERMAID_VERSION: ${{ env.MDBOOK_MERMAID_VERSION }}
       - name: Setup Pages
         id: pages
         uses: actions/configure-pages@v5

MDBOOK.md

@@ -20,15 +20,10 @@ cargo install mdbook --version 0.4.52
 Install required preprocessors:
 
 ```sh
-# Install mdbook-mermaid v0.10.0 (compatible with mdbook 0.4.52)
-cargo install mdbook-mermaid --version 0.10.0
-
-# Install mdbook-embedify for embedding external content
+cargo install mdbook-mermaid
 cargo install mdbook-embedify
 ```
 
-**Note:** These specific versions are required for compatibility. mdbook-embedify 0.2.18 is not compatible with mdbook 0.5.x, so we use mdbook 0.4.52 and a compatible version of mdbook-mermaid.
-
 ## Usage
 
 To build the book, run the following command:

mdbook

@@ -3,8 +3,9 @@
 # Usage: ./scripts/install-mdbook.sh   (from repo root)
 set -e
 
-MDBOOK_VERSION="${MDBOOK_VERSION:-0.4.52}"
-MDBOOK_MERMAID_VERSION="${MDBOOK_MERMAID_VERSION:-0.10.0}"
+MDBOOK_VERSION="${MDBOOK_VERSION:-0.5.2}"
+MDBOOK_MERMAID_VERSION="${MDBOOK_MERMAID_VERSION:-0.17.0}"
+MDBOOK_EMBEDIFY_VERSION="${MDBOOK_EMBEDIFY_VERSION:-0.3.2}"
 
 # Install into repo so CI and local use the same layout (avoids cross-device issues in act)
 REPO_ROOT="${REPO_ROOT:-$(git rev-parse --show-toplevel 2>/dev/null || echo "$PWD")}"
@@ -17,12 +18,9 @@ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y --no-mod
 source "${CARGO_HOME}/env"
 rustup update
 
-# Install mdbook v0.4.52 (required for mdbook-embedify compatibility)
 cargo install --version "${MDBOOK_VERSION}" mdbook
-# Install mdbook-mermaid v0.10.0 (compatible with mdbook 0.4.52)
 cargo install --version "${MDBOOK_MERMAID_VERSION}" mdbook-mermaid
-# Install mdbook-embedify (latest version compatible with mdbook 0.4.52)
-cargo install mdbook-embedify
+cargo install --version "${MDBOOK_EMBEDIFY_VERSION}" mdbook-embedify
 
 echo "Done. To build the book, use the project mdbook (do not use your global 'mdbook'):"
 echo "  ./mdbook build"