pin the mdbook-katex and mdbook-bib as well

Author: hovey

.github/workflows/mdbook.yml

@@ -25,16 +25,16 @@ jobs:
         with:
           path: /usr/local/cargo/bin
           # Updated key to 0.4.52 to ensure we cache the correct stable version
-          key: ${{ runner.os }}-mdbook-0.4.52-${{ hashFiles('**/book.toml') }}
+          key: ${{ runner.os }}-mdbook-0.4.52-v2-${{ hashFiles('**/book.toml') }}
           restore-keys: |
-            ${{ runner.os }}-mdbook-0.4.52-
+            ${{ runner.os }}-mdbook-0.4.52-v2
 
       - name: Install mdBook and preprocessors
         run: |
           # Pin mdbook to 0.4.52 for compatibility with older preprocessors
           command -v mdbook >/dev/null 2>&1 || cargo install mdbook --version 0.4.52
-          command -v mdbook-katex >/dev/null 2>&1 || cargo install mdbook-katex
-          command -v mdbook-bib >/dev/null 2>&1 || cargo install mdbook-bib
+          command -v mdbook-katex >/dev/null 2>&1 || cargo install mdbook-katex --version 0.3.0
+          command -v mdbook-bib >/dev/null 2>&1 || cargo install mdbook-bib --version 0.0.3
 
       - name: Build mdBook
         run: mdbook build documentation/mdbook

documentation/mdbook/book.toml

@@ -14,11 +14,15 @@ after = ["links"] # By setting after = ["links"], you ensure that link processin
 [output.html]
 additional-css = ["theme/custom.css"]
 
+# [preprocessor.bib]
+# # The name of your .bib file, relative to the src directory
+# # Ensure it runs after links but before katex
+# after = ["links"]
+# before = ["katex"]
+# bibliography = "bibliography.bib"
+
 [preprocessor.bib]
-# The name of your .bib file, relative to the src directory
-# Ensure it runs after links but before katex
-after = ["links"]
-before = ["katex"]
+# Remove 'after' and 'before' for a moment to see if it's a sorting issue
 bibliography = "bibliography.bib"
 
 # Optional: Set the title for the automatically generated bibliography chapter

documentation/mdbook/src/contributors.md

@@ -68,7 +68,17 @@ Create a `.bib` file (e.g., `bibliography.bib`) in the root of the `documentatio
 3. Configure `book.toml`
 
 Tell mdBook to use the `mdbook-bib` preprocessor and specify the path to the
-bibliography file in the `book.toml` configuration file.  Add the following section
+bibliography file in the `book.toml` configuration file.  
+
+Make sure any GitHub workflows also install `mdbook-bib`, e.g.,
+
+```bash
+      - name: Install mdBook and preprocessors
+        run: |
+          cargo install mdbook mdbook-katex mdbook-bib
+```
+
+Add the following section
 to the `book.toml`:
 
 ```sh