fix: fix equation rendering by changing the toolchain to mathjax (#493)

* docs: update README and build guide

* fix: escape * and _ inside math to prevent markdown emphasis corruption

* fix: configure MathJax to use TeX (Computer Modern) font

* feat: enhance markdown processing with label and figure collection

* fix: remove duplicate bibliography directives from chapter summaries

References are already handled at the chapter level, so the
:bibliography: directives in summary pages are redundant and cause
rendering issues.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
anyin233
2026-03-12 06:21:56 +00:00
committed by GitHub
parent ec03af6862
commit 00db02dbfd
26 changed files with 642 additions and 1037 deletions

View File

@@ -23,20 +23,12 @@ jobs:
with:
mdbook-version: 'latest'
- name: Cache mdbook-typst-math binary
uses: actions/cache@v4
with:
path: .mdbook-bin
key: mdbook-typst-math-v0.3.0-linux-x86_64
- name: Run mdBook regression tests
run: |
python3 -m unittest discover -s tests -p 'test_prepare_mdbook.py'
python3 -m unittest discover -s tests -p 'test_prepare_mdbook_zh.py'
python3 -m unittest discover -s tests -p 'test_assemble_docs_publish_tree.py'
python3 -m unittest discover -s tests -p 'test_ensure_book_resources.py'
python3 -m unittest discover -s tests -p 'test_mdbook_typst_math.py'
python3 -m unittest discover -s tests -p 'test_ensure_mdbook_typst_math.py'
python3 -m unittest discover -s tests -p 'test_update_docs_workflow.py'
- name: Build English HTML with mdBook

View File

@@ -17,12 +17,6 @@ jobs:
with:
python-version: '3.10'
- name: Cache mdbook-typst-math binary
uses: actions/cache@v4
with:
path: .mdbook-bin
key: mdbook-typst-math-v0.3.0-linux-x86_64
- name: Setup mdBook
uses: peaceiris/actions-mdbook@v2
with:
@@ -34,8 +28,6 @@ jobs:
python3 -m unittest discover -s tests -p 'test_prepare_mdbook_zh.py'
python3 -m unittest discover -s tests -p 'test_assemble_docs_publish_tree.py'
python3 -m unittest discover -s tests -p 'test_ensure_book_resources.py'
python3 -m unittest discover -s tests -p 'test_mdbook_typst_math.py'
python3 -m unittest discover -s tests -p 'test_ensure_mdbook_typst_math.py'
- name: Build English HTML with mdBook
run: bash build_mdbook.sh