# 雙語改版核對 / Bilingual update audit

This report describes the bilingual core before the later navigation reorganization. The current site embeds lecture examples in chapters and groups practice and past-paper answers by chapter. See [ORGANIZATION.md](ORGANIZATION.md) for the delivered organization and its separate content-preservation checks; the core expression counts below exclude the added embedded copies.

## Delivered language coverage

- 73 corresponding English and Traditional Chinese teaching pages, plus one terminology page in each language: **148 HTML pages**.
- The Chinese edition adds **9,666 English term labels** throughout explanations, question procedures, table cells, captions, hints and hidden answers. The reference contains **322 Chinese–English term mappings**, in addition to the existing conceptual glossary.
- Every teaching page has a static language counterpart link. The small local script carries the current section anchor across a language change. Language links still open the corresponding page when JavaScript is disabled.
- English navigation, page titles, teaching prose, questions, answers, image descriptions and controls use the preserved English source. Ten English editable diagrams retain their original wording and geometry and now embed a local font. The Chinese versions and all original source images remain available.
- The original source inventory remains **233 records: 212 checked, 21 incomplete**. No additional source information is available; conditional solutions and missing-data notices remain. These language additions do not turn source blockers into completed answers.

## Preservation and mathematical scope

The immutable `work/bilingual/zh-before` snapshot and SHA-256 manifest preserve the Chinese edition immediately before this change. Removing only the inserted terminology labels, language navigation and new verification notice must recover the exact original Chinese DOM on all 73 pages. All **11,518 Chinese MathML expressions** are retained.

English prose is restored from the preserved English units. **823 inventoried added or revised units** have also been translated directly from the later Chinese edition using **2,540 authored English text slots**, with zero pending slots in that inventory. This covers all 168 caption units, the 258 numerical-review candidate units, all full equation units and the remaining identified inline arithmetic units; these categories overlap. Updated units and formula-only units reuse the authored Chinese MathML, translating only a closed list of mathematical text labels. Other expressions are substituted only when their linear notation matches the English source; the source fragment is recorded and checked for visible-text preservation. Seven damaged source units have explicit recoveries, including the Tutorial 3 Q5 intervals and Q4 self-check. Literal less-than signs are escaped instead of being interpreted as HTML tags.

The English edition contains **10,886 MathML expressions**. The targeted scan finds zero remaining strong inline arithmetic/operator/superscript candidates outside MathML; this is not proof that every mathematical phrase or semantic detail has been reviewed. All identified additions in the selected inventory have English translations. **Full page-by-page bilingual semantic verification is not complete.** The earlier Chinese final semantic review covered 32 of 73 pages, leaving 41 pending; those records apply to the frozen core, not automatically to the new English rendering. No earlier review hashes have been refreshed to imply new review.

## Checks and evidence

- 15 focused checks cover fraction precedence, roots, units, source-word boundaries and subscript/superscript markup during MathML reuse.
- Latest static run: **148 pages, 8,540 local references, 1,594 shared-unit mathematical structure checks, 321 successful HTTP byte comparisons, zero errors**. JavaScript syntax passed. The expanded scan includes text following inline formulas as well as ordinary text nodes.
- Static checks compare original Chinese content, corresponding section IDs and hidden-answer counts, exact shared MathML structure, local link targets, image references, fonts, CSS references and JavaScript syntax. A localhost HTTP test compares served bytes with the delivered files. These checks do not execute a browser.
- Current machine-readable results: [delivery checks](assets/reports/bilingual-delivery-audit.json), [page checklist](assets/reports/bilingual-page-checklist.json), [build totals](assets/reports/bilingual-build-status.json), [term coverage](assets/reports/bilingual-term-coverage.json), [English source preservation](assets/reports/bilingual-english-source-proof.json), [updated-content translations](assets/reports/bilingual-updated-content-audit.json), [formula scan](assets/reports/bilingual-english-math-scan.json), [English SVG preservation](assets/reports/bilingual-english-svg-audit.json) and [SVG text-width estimates](assets/reports/bilingual-english-svg-text-width.json). Font advance estimates are not browser layout tests.
- **Browser checks remain unrun:** file URLs, hosted browser operation, desktop/mobile layout, keyboard interaction, image zoom, reveal controls and printing. The earlier browser tool rejected the local URL and prohibited workarounds. No alternative browser, raw CDP or proxy workaround was used.

## 繁體中文說明

已提供 73 組中英教材及兩頁術語表。中文解說新增 9,666 處英文術語，並保留原有詳解、公式、圖像、引用與答案。英文版本使用保存的完整英文教學原文，並補譯盤點出的 823 個新增或修訂單元，共 2,540 個文字片段，包括原圖解說、數值修訂及完整計算步驟標籤；該盤點沒有待譯片段。英文包含 10,886 個 MathML 公式，中文原有 11,518 個完整保留。**雙語逐頁語義覆核仍未全部完成**；公式掃描與結構比對不能代替人工語義核對。

21 項來源條件不足仍維持 incomplete；瀏覽器、手機、鍵盤及列印測試未執行。靜態連結或 HTTP 檢查通過不代表瀏覽器測試通過。

## Rebuild and provenance

The delivered HTML requires no build step. For maintenance in the existing development environment, use `python tools/rebuild_zh_site.py`. It builds and checks the bilingual core, then runs `organize_site.py` and `check_organized_site.py` for the final chapter structure. Running only the bilingual-core builder omits the organization update. Do not run the retired `tools/build_site.py` or directly overwrite the delivered pages with `tools/build_zh_site.py`.

Chinese text is sourced from the frozen `work/bilingual/zh-before` snapshot; English prose is sourced from `work/upgrade-zh-math/baseline` and its unit inventory, plus the authored `work/bilingual/english-text/*.json` translations of updated content. `tools/bilingual_terms.py` contains the terminology mappings. Updating the underlying Chinese teaching content requires a new explicitly reviewed snapshot and preservation evidence; old review hashes must not be refreshed blindly.
