* feat: remove bilingual button on the front page
* misc: clean repo
* test: fix test suite for v1/v2 restructure and removed language switch
* refactor: restructure chapters for the second edition
* refactor: restructure project
* refactor: remove unused scripts
* refactor: move conftest.py to tests directory
* refactor: update README with new chapter structure and logo path
* fix: update image paths in README and README_EN for consistency
* refactor: update directory structure and script references in documentation
The variable was renamed from docsRoot to root in #496 but one
reference was missed, causing a ReferenceError that broke the
entire script and prevented V1/V2/EN/ZH buttons from rendering.
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
* feat: add bilingual issue and PR templates
* feat: add bilingual contributing guides for v2
* docs: migrate style guide to v2/info, trim contributing guides
* docs: move terminology to v2/info
* docs: update README links to v2 contributing and style guides
* refactor: remove content about Writing Guidelines from contribution guidence, replace it with link to style.md
* misc: update contribution guide and PR template
Two fixes:
1. version-selector.js: Simplify basePath() to determine site root from
the URL prefix (/ or /docs/) instead of trying to strip path segments.
Previously, visiting /index.html caused basePath to compute
/index.html/v1/ (404) because it didn't strip the filename first.
2. prepare_mdbook.py: Strip pandoc-style heading IDs ({#label}) from
both extracted titles (used in SUMMARY.md sidebar) and rendered
markdown content. Fixes "Model Deployment {#ch:deploy}" showing
raw in the sidebar and page headings.
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
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>
* feat: add v1/v2 versioning and language selector for mdbook
- Copy current content to v1/ directory (1st Edition)
- Create v2/ directory with new TOC structure (2nd Edition) and placeholder chapters
- Add version selector (V1/V2) and language toggle (EN/ZH) in top-right nav bar
- Add build scripts: build_mdbook_v1.sh, build_mdbook_v2.sh
- Update assemble_docs_publish_tree.py to support v1/v2 deployment layout
- Fix mdbook preprocessor to use 'sections' key (v0.4.43 compatibility)
- Update .gitignore for new build artifact directories
- Deployment layout: / = v2 EN, /cn/ = v2 ZH, /v1/ = v1 EN, /v1/cn/ = v1 ZH
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* build: update CI to build and verify all four books (v1/v2 x EN/ZH)
- Clarify step names: "Build v2 (EN + ZH)" and "Build v1 (EN + ZH)"
- Add verification step to check all four index.html outputs exist
- Deploy workflow assembles: / = v2 EN, /cn/ = v2 ZH, /v1/ = v1 EN, /v1/cn/ = v1 ZH
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix: gracefully skip missing TOC entries instead of crashing
resolve_toc_target() now returns None for missing files instead of
raising FileNotFoundError. This fixes v1 EN build where chapter index
files reference TOC entry names that don't match actual filenames.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
* 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>
* build: add mdbook support for zh chapters
Add mdBook configuration rooted at zh_chapters, generate and commit SUMMARY.md, rewrite d2l-specific directives through a Python preprocessor, refresh chapter resource symlinks from the build scripts, and ignore local build-only links and helper directories.
* feat: add raw HTML inline and frontpage layout support for mdbook preprocessor
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* feat: add dark mode image background for mdbook dark themes
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix: add resource symlinks and repo root static fallback to mdbook build
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* feat: add BibTeX citation support with inline links and bibliography
Parse mlsys.bib to generate author-year inline citations linked to
per-page bibliography sections. Missing bib keys degrade gracefully
to plain text placeholders.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* refactor: switch citation display to footnote style
Use numbered superscript references [1] [2] inline with an ordered
list bibliography at page bottom. Each entry has a back-link (↩)
to the citation site.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix: strip LaTeX escapes outside math mode in mdbook preprocessor
Remove \_, \%, \#, \& escapes from text outside $...$ math spans
while preserving them inside math mode for MathJax compatibility.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* style: set frontpage author grid to 6 columns and widen main content area
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix: group mdbook toc by part titles
* fix: enable inline math rendering in mdbook
* build: migrate docs publishing to mdbook
Move the English root site to mdBook, keep the Chinese site as a sub-book, and update CI/deploy to publish .mdbook outputs to docs/ and docs/cn/. Also add regression coverage for placeholder skipping, publish-tree assembly, and shared resource setup.
* ci: use official pages deployment workflow
Switch the docs deployment workflow to the official GitHub Pages actions flow and verify it uses Pages action outputs for the deployment URL.
* feat: add homepage language switch links
Inject a homepage-only language switch into the mdBook frontpage wrapper so the English homepage links to the Chinese homepage and the Chinese homepage links back to the English homepage.
* fix: correct english homepage frontpage
Add an English-specific frontpage template so the default homepage no longer falls back to the Chinese frontpage, and clear homepage image backgrounds in the frontpage wrapper CSS.
* fix: align english homepage author grid
Top-align the English homepage author cards, enlarge the row gap, and normalize avatar sizing so author portraits line up consistently.
* fix: restore dark mode body image backgrounds
Apply light gray backgrounds to body images in dark themes for both English and Chinese mdBook themes while explicitly excluding homepage frontpage images.
* fix: restyle homepage language switch button
Move the homepage language switch below the GitHub star button and restyle it to match the same button family on both the English and Chinese homepages.
* fix: center homepage content container
Align the English and Chinese homepage frontpage wrapper with the main content container so homepage content is centered like normal body content.
* fix: stack english homepage footer copy
Keep the English homepage contributor and errata footer lines in normal block flow so each sentence stays on its own line instead of being laid out as author-grid columns.
* fix: widen centered homepage container
Keep the homepage frontpage wrapper centered while ensuring it uses at least 80% of the available content area, without changing normal body page layout.
* fix: widen homepage main content area
Apply a homepage-only override so mdbook-content > main uses at least 80% of the available content width while keeping normal body pages on the default layout.
* ci: use peaceiris action for mdbook
Replace manual mdBook installation in CI and Pages workflows with peaceiris/actions-mdbook@v2 and keep a regression test to ensure the action stays in use.
* fix: reduce homepage main width floor
Lower the homepage-only mdbook-content > main minimum width from 80% to 65% while leaving normal body pages unchanged.
* build: switch math rendering to mdbook-katex
Use mdbook-katex in pre-render mode for both books, pin mdBook to a compatible version, update build scripts and workflows, and replace the old MathJax regression tests with KaTeX coverage.
* Revert "build: switch math rendering to mdbook-katex"
This reverts commit b9cf38a5d1.
* build: switch math rendering from MathJax to mdbook-typst-math
* ci: deploy docs to openmlsys.github.io repo
* fix: convert pandoc tables to GFM pipe tables for mdbook
* feat: convert :eqlabel:/:eqref: to MathJax \tag/\label/\eqref
- Add process_equation_labels() to inject \tag{n}\label{name} into
preceding $$ equations, replacing :eqlabel: directives
- Change :eqref: conversion from backtick code to $\eqref{name}$
for clickable cross-references
- Add TeX.equationNumbers.autoNumber:"none" to MathJax config to
prevent conflicts with manual \tag numbering
- Add tests for single-line, multi-line, and sequential numbering
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* ci: cache mdbook-typst-math binary in workflows
* feat: add LaTeX-to-Typst math converter with eqref/tag support
* feat: integrate LaTeX-to-Typst conversion into zh preprocessor
* fix: strip LaTeX escapes only outside math spans and code blocks
* fix: load references/*.bib so all citations render correctly
* fix: skip citations with no bib entry instead of rendering raw keys
* ci: remove redundant CI workflow, keep only deploy workflow
* ci: Add CI workflow for testing and building mdBook
* ci: remove concurrency settings from update_docs.yml
Removed concurrency settings from the update_docs workflow.
---------
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
* update accelerator_practise.md
* update images in accelerator_practise.md
* update images in accelerator_practise.md
* feat(accelerator): update according to the book
---------
Co-authored-by: Went-Liang <wenteng_liang@163.com>
