Skip to content

Latest commit

 

History

History
49 lines (35 loc) · 2.6 KB

README.md

File metadata and controls

49 lines (35 loc) · 2.6 KB

深入理解 AI Infra・繁體中文版

這是《深入理解 AI Infra:量化分析與系統設計》的繁體中文版,與原始中文稿和英文版並列保存。原始 manuscripts/ 與 book/ 不會因為這個版本而改寫;本目錄保留繁中字稿、繁中配圖、封面與獨立的 PDF 建置腳本。

內容

路徑 內容
introduction.md、chapter01.md … chapter12.md 前言與十二章繁中字稿
images/ 以繁中標籤重繪的配圖(Git LFS)
preamble.tex 繁中字型設定與共用書籍版型
cover.tex 繁中封面
build_pdf.py、build_pdf.sh Pandoc + XeLaTeX 建置腳本
assemble.py 從繁中字稿整理章節並收集配圖
tools/ 簡繁轉換、台灣用語校正與配圖腳本

建置 PDF

git lfs pull --include="book-zh-tw/images/**" --exclude=""
bash book-zh-tw/build_pdf.sh

需要 Python 3.9+、Pandoc 3.x、XeLaTeX 與 Poppler。建置結果會寫入 book-zh-tw/AI-Infra-Book-ZH-TW.pdf;中間檔案放在 book-zh-tw/build/,不納入版本控制。

推送到 GitHub 後,Build and publish book workflow 會另外建置繁中版本;在該次 run 的 artifacts 下載 book-pdf-zh-tw-download 即可取得 PDF 與版面驗證結果。

更新翻譯

繁中字稿由目前的 manuscripts/ 產生。要重建稿件,先安裝可選的轉換工具:

python3 -m pip install -r book-zh-tw/tools/requirements.txt
python3 book-zh-tw/tools/convert_book.py translate
python3 book-zh-tw/tools/translate_figures.py apply
python3 book-zh-tw/tools/translate_figures.py check
python3 book-zh-tw/tools/translate_figures.py render
python3 book-zh-tw/assemble.py

convert_book.py verify 會確認標題、表格、公式、程式碼區塊、圖片目標、連結目標與數字沒有漂移。配圖腳本只替換可繪製的字串常數;檔名、路徑、資料比對值與檢查腳本中的簡體字會保留。

translate_figures.py render 需要各章 requirements.txt 中的繪圖依賴,並會在暫存的 manuscripts/ 副本中執行,不會改寫原始稿件。assemble.py 會檢查 LFS 指標檔與配圖中的簡體字;第 6 章的 figure-6-context-dependency 沒有生成腳本,第 7 章的 figure-7-ub-round-trip 從資料檔讀取文字,因此保留為已知例外。其餘結果與 fallback 會記錄在被忽略的 tools/figure-check.json。

版本範圍

這份版本是依照英文版 PR #4 的組織方式製作:翻譯版獨立放在 book-zh-tw/,不取代原始稿件;數字、公式、連結、程式碼與計算條件以原稿為準。