From ea4d0d178e9217712d85ef60277af4c358e7ab5d Mon Sep 17 00:00:00 2001
From: Yeqi Huang <chivier.humber@outlook.com>
Date: Thu, 12 Mar 2026 14:01:24 +0000
Subject: [PATCH] fix: fix preprocessor paths for v1/v2 mdbook builds (#495)

mdbook runs preprocessor commands from the book root directory (where
book.toml lives). The v1/v2 book.toml files had incorrect relative
paths to the preprocessor scripts, causing them to silently fail and
leaving raw rst directives (.. raw:: html, toc blocks) unprocessed.

Fix by using correct relative paths in book.toml (../tools/ for
top-level books, ../../../tools/ for books/zh/) and changing build
scripts to cd into book directories before running mdbook build.

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
---
 build_mdbook_v1.sh    | 4 ++--
 build_mdbook_v2.sh    | 4 ++--
 v1/book.toml          | 2 +-
 v1/books/zh/book.toml | 2 +-
 v2/book.toml          | 2 +-
 v2/books/zh/book.toml | 2 +-
 6 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/build_mdbook_v1.sh b/build_mdbook_v1.sh
index 68e4c5f..522f23b 100755
--- a/build_mdbook_v1.sh
+++ b/build_mdbook_v1.sh
@@ -21,7 +21,7 @@ fi
     --summary-output "${ROOT}/v1/en_chapters/SUMMARY.md" \
     --placeholder-prefix "[TODO: src = zh_chapters/"
 
-mdbook build "${ROOT}/v1"
+cd "${ROOT}/v1" && mdbook build .
 
 # ── Chinese v1 ────────────────────────────────────────────────────────────────
 "${PYTHON_BIN}" "${ROOT}/tools/ensure_book_resources.py" --chapter-dir "${ROOT}/v1/zh_chapters"
@@ -29,4 +29,4 @@ mdbook build "${ROOT}/v1"
     --source "${ROOT}/v1/zh_chapters" \
     --summary-output "${ROOT}/v1/zh_chapters/SUMMARY.md"
 
-mdbook build "${ROOT}/v1/books/zh"
+cd "${ROOT}/v1/books/zh" && mdbook build .
diff --git a/build_mdbook_v2.sh b/build_mdbook_v2.sh
index 524aa3d..4304c17 100755
--- a/build_mdbook_v2.sh
+++ b/build_mdbook_v2.sh
@@ -21,7 +21,7 @@ fi
     --summary-output "${ROOT}/v2/en_chapters/SUMMARY.md" \
     --placeholder-prefix "[TODO: src = zh_chapters/"
 
-mdbook build "${ROOT}/v2"
+cd "${ROOT}/v2" && mdbook build .
 
 # ── Chinese v2 ────────────────────────────────────────────────────────────────
 "${PYTHON_BIN}" "${ROOT}/tools/ensure_book_resources.py" --chapter-dir "${ROOT}/v2/zh_chapters"
@@ -29,4 +29,4 @@ mdbook build "${ROOT}/v2"
     --source "${ROOT}/v2/zh_chapters" \
     --summary-output "${ROOT}/v2/zh_chapters/SUMMARY.md"
 
-mdbook build "${ROOT}/v2/books/zh"
+cd "${ROOT}/v2/books/zh" && mdbook build .
diff --git a/v1/book.toml b/v1/book.toml
index 63f27b2..aef487b 100644
--- a/v1/book.toml
+++ b/v1/book.toml
@@ -9,7 +9,7 @@ build-dir = "../.mdbook-v1/book"
 create-missing = false
 
 [preprocessor.openmlsys]
-command = "python3 tools/mdbook_preprocessor.py"
+command = "python3 ../tools/mdbook_preprocessor.py"
 
 [output.html]
 mathjax-support = true
diff --git a/v1/books/zh/book.toml b/v1/books/zh/book.toml
index 07c02ef..8883e8e 100644
--- a/v1/books/zh/book.toml
+++ b/v1/books/zh/book.toml
@@ -9,7 +9,7 @@ build-dir = "../../../.mdbook-v1-zh/book"
 create-missing = false
 
 [preprocessor.openmlsys-zh]
-command = "python3 tools/mdbook_zh_preprocessor.py"
+command = "python3 ../../../tools/mdbook_zh_preprocessor.py"
 
 [output.html]
 mathjax-support = true
diff --git a/v2/book.toml b/v2/book.toml
index 88785e2..ea6bc17 100644
--- a/v2/book.toml
+++ b/v2/book.toml
@@ -9,7 +9,7 @@ build-dir = "../.mdbook-v2/book"
 create-missing = false
 
 [preprocessor.openmlsys]
-command = "python3 tools/mdbook_preprocessor.py"
+command = "python3 ../tools/mdbook_preprocessor.py"
 
 [output.html]
 mathjax-support = true
diff --git a/v2/books/zh/book.toml b/v2/books/zh/book.toml
index 599e294..68e9240 100644
--- a/v2/books/zh/book.toml
+++ b/v2/books/zh/book.toml
@@ -9,7 +9,7 @@ build-dir = "../../../.mdbook-v2-zh/book"
 create-missing = false
 
 [preprocessor.openmlsys-zh]
-command = "python3 tools/mdbook_zh_preprocessor.py"
+command = "python3 ../../../tools/mdbook_zh_preprocessor.py"
 
 [output.html]
 mathjax-support = true