版本記錄
這一頁記錄《閘北：一條蘇州河北岸的百年紀事》的每一次改動。
為什麼要留這麼一頁？因為這本書是從一個廢棄的 GitBook 項目上重生的， 底稿、結構、出處體系都換過一遍。把改動攤開寫清楚，讀者能看到「哪些是新查的、 哪些是改過的」，作者也能知道「上一版到底改了什麼」。
版本號怎麼讀
採用 主版本.次版本.修訂號 三段式：
| 段位 | 什麼時候 +1 | 例子 |
|---|---|---|
| 主版本（X.0.0） | 動了全書結構，或整體遷移平臺 | GitBook → HonKit |
| 次版本（x.Y.0） | 新增了一個模塊／整塊內容 | 新增「版本記錄」模塊 |
| 修訂號（x.y.Z） | 改事實、修 bug、改措辭 | 修正一條死鏈 |
類型圖例
表格裡「類型」一列的取值：
| 類型 | 含義 |
|---|---|
| 新增 | 增加新頁面、新模塊、新功能 |
| 修訂 | 修改既有頁面的事實、數據或表述 |
| 修復 | 修 bug（死鏈、構建報錯、顯示異常等） |
| 增強 | 改善閱讀體驗（樣式、導航、預覽、構建流程） |
| 重構 | 結構性調整（目錄、工程配置、來源體系） |
版本速覽
| 版本 | 日期 | 類型 | 一句話說清改了什麼 |
|---|---|---|---|
| v1.0 | 2023-11-03 | 初始 | 原 GitBook 項目，僅有佔位文件，隨後廢棄 |
| v2.0.0 | 2026-10-09 | 重構 | 遷到 HonKit 6，全書 45 頁從零重寫 |
| v2.0.1 | 2026-10-09 | 修復 | 修掉 60 條跨目錄死鏈 |
| v2.0.2 | 2026-10-09 | 增強 | 一鍵本地預覽 + 發佈產物瘦身 |
| v2.1.0 | 2026-10-09 | 新增 | 新增「版本記錄」模塊（本頁） |
| v2.2.0 | 2026-10-09 | 增強 | 啟用 7 個閱讀增強插件（中文搜索、編輯本頁等） |
| v2.3.0 | 2026-10-09 | 修復 | 修掉重複加載與換頁亂追加 DOM 兩個缺陷；配色改版 |
| v3.0.0 | 2026-10-09 | 重構 | 多語言化：中文遷入 zh/，新增英／日／韓／法／德五語版本，卷首五語齊備 |
| v3.1.0 | 2026-10-09 | 增強 | 去掉「選擇語言」落地頁：打開即是中文；頂欄右側新增六語平鋪語言欄 |
| v3.1.1 | 2026-10-09 | 新增 | 補齊作者署名「舟哥（Nickzhuo）」：寫進六語種元數據、封面、關於作者與術語表 |
| v3.2.0 | 2026-10-10 | 新增 | 英、日、韓、法、德五語種正文全部譯畢（各 43 頁）；全書六語種共 276 個頁面 |
| v3.2.1 | 2026-10-10 | 修訂 | 全語種譯文質量抽檢：來源段標籤 4 頁歸位、法德「版本記錄」頁名對齊、汪壽華異名補註漢字消歧 |
| v3.2.2 | 2026-10-10 | 修復 | 修好五個外語版本的站內搜索：此前它們加載的都是中文索引，一搜非中文詞就是 0 結果 |
| v3.3.0 | 2026-10-12 | 新增 | 中文拆成「简体中文」與「繁體中文」兩版，與英日韓法德同列；頂欄語言欄由六條增為七條，全書七語種共 323 個頁面 |
| v3.4.0 | 2026-10-12 | 新增 | 上線 https://zhabei.org：七語種封面與「關於本書」頁寫明在線閱讀地址；全站 323 頁補 canonical 與七語種 hreflang 互指，並生成 sitemap.xml 與 robots.txt |
| v3.5.0 | 2026-10-12 | 增強 | 頂欄右側與每頁正文末尾都展示本書的域名 zhabei.org，點它回到當前語言的封面 |
| v3.5.1 | 2026-10-12 | 修訂 | 左側欄頂部去掉「GitHub」入口，只留域名 zhabei.org；想找源碼的讀者仍可從封面正文與頂欄「編輯本頁」進入 |
| v3.5.2 | 2026-10-12 | 增強 | 封面「本書包含」表裡的四個部分與四篇附錄都做成了鏈接，點一下直接跳過去 |
| v3.5.3 | 2026-10-12 | 增強 | 頁腳在域名之後補上作者署名「舟哥@2026」與當前版本號，每頁都能一眼看到手上是哪一版 |
| v3.6.0 | 2026-10-12 | 增強 | 全站約 1.77 萬條內鏈改為直達地址；每頁新增七語種社交分享縮略圖；瀏覽器語言不是中文時浮出一條切換提示 |
逐版明細
v3.6.0 · 2026-10-12 · 內鏈直達 + 分享縮略圖 + 語言提示
| 類型 | 更新點 | 涉及文件 |
|---|---|---|
| 增強 | 全站約 1.77 萬條內部鏈接改成直達地址。 此前每條鏈都寫成 xxx.html，而線上地址的規範形式是「單頁不帶擴展名、目錄頁帶斜槓」（如 /zh/part1/01-naming、/zh/），於是每點一下都要先被重定向一次。現在內鏈與規範地址是同一個口徑，點一下就到；站內搜索結果的地址也一併改了，從搜索框點進去同樣不再繞路 |
scripts/inject-seo.mjs |
| 新增 | 每一頁都有了社交分享縮略圖。 七語種各一張 1200×630 的卡片，用本書的紙墨配色、寫各自語言的書名與作者署名。把任意一頁的地址發到微信、群聊或社交平臺，顯示的就是這張卡片，而不是一段光禿禿的鏈接 | 新增 assets/og/*.png（七張）、scripts/gen-og-images.mjs |
| 新增 | 瀏覽器語言不是中文時，頁面下方浮出一條提示。 它說明檢測到的瀏覽器語言是什麼，並給一個按鈕直接切到那一版；打開網站仍然是一律先進简体中文，不想看可以直接關掉，關過一次之後不再出現 | scripts/inject-seo.mjs、styles/website.css |
| 說明 | 提示條掛在頁面末尾而不是正文裡 —— 站內翻頁替換的是正文那塊容器，掛在正文裡一翻頁就沒了。另外這條提示只在語言確實不同時出現：中文瀏覽器讀中文版、英文瀏覽器讀英文版，都不會多出任何一條；點「切換」進的是當前這一頁的對應語種，不是把人扔回封面 | scripts/inject-seo.mjs |
| 增強 | 新增本地預覽 npm run preview，按與線上同一套地址規則提供構建產物（無擴展名、尾斜槓、.html 自動跳轉），於是「本地點得通」約等於「線上點得通」。原有的 npm run serve 仍可用於邊改邊看，只是它走的是另一套構建流程，頁面裡不會有頁腳與 SEO 標籤 |
新增 scripts/preview-dist.mjs、package.json |
v3.5.3 · 2026-10-12 · 頁腳補作者與版本號
| 類型 | 更新點 | 涉及文件 |
|---|---|---|
| 增強 | 每頁正文末尾的落款，從「書名 + 域名」續成了「書名 + zhabei.org + 舟哥@2026 + 版本號」。 域名之後先跟作者名「舟哥@2026」並加粗，再跟當前版本號、字號降一號壓成灰色。這樣排是讓落款本身就能回答「這是誰寫的、哪一版」：粗體一眼認出作者，版本號小而不搶注意力，卻隨時可查 | scripts/inject-seo.mjs、styles/website.css |
| 說明 | 版本號不另存一處，構建時直接從中文源「版本記錄」頁的「版本速覽」表末行讀取（該表按時間正序追加，末行即最新版）。為什麼不取工程文件裡的版本字段：那個字段自 v2.0.0 起就沒再維護，拿它做源會立刻顯示錯版本。讀不到版本號時構建當場報錯退出，絕不讓頁腳靜默顯示空版本 | scripts/inject-seo.mjs |
| 說明 | 作者名七語種共用同一串「舟哥@2026」——它是人名／簽名，不是可譯的界面文案，與各語種封面「舟哥（Nickzhuo）編著」的署名是同一件事；版本號同樣是不譯的 vX.Y.Z。頁腳自檢相應新增兩項：作者串恰為「舟哥@2026」，版本號形如 vX.Y.Z 且與中文源「版本速覽」末行逐字一致（自檢獨立解析一遍，與注入腳本互為兩把鎖） |
scripts/check-branding.py |
v3.5.2 · 2026-10-12 · 封面目錄可點擊
| 類型 | 更新點 | 涉及文件 |
|---|---|---|
| 增強 | 封面「本書包含」那張表不再只是文字了。 「部分」一列與「內容」一列的粗體標題都做成了鏈接，點哪一處都會跳到該部分的「寫在前面」頁；附錄那一行的四項（路名密碼 / 大事年表 / 地名對照 / 引用書目）各自單獨成鏈，直接落到對應的頁面。看書的人多半有「看到目錄就想點」的習慣，不該讓他先去側欄裡翻 | 七語種 README.md |
| 說明 | 鏈接用的都是相對地址（如 part1/README.md），跟頁內其它鏈接一個寫法：在 https://zhabei.org 上照常跳轉，本地預覽時也不會跳出 localhost。七個語種的錨文本各按本語言的譯法書寫，鏈接目標逐字一致，由 scripts/check-translations.py 的 A 項自動把關 |
— |
v3.5.1 · 2026-10-12 · 側欄只留域名
| 類型 | 更新點 | 涉及文件 |
|---|---|---|
| 修訂 | 左側欄頂部的「GitHub」入口去掉了。 那一列原先並排兩枚鏈接——域名與 GitHub，現在只剩域名一個。側欄是給讀者指路用的，把源碼倉庫擺在這裡，跟「讀書」這件事沒什麼關係，也容易讓人以為非去 GitHub 不可 | book.json（links.sidebar） |
| 說明 | 想找源碼的讀者入口並沒有斷：封面頁正文裡「源文件在 GitHub」那一句照舊（那是留給勘誤的），頂欄的「編輯本頁」按鈕也仍指向倉庫。側欄只是不再重複擺一個 | — |
v3.5.0 · 2026-10-12 · 頂欄與頁腳展示域名
| 類型 | 更新點 | 涉及文件 |
|---|---|---|
| 增強 | 每一頁的頂欄右側與正文末尾都展示本書的域名 zhabei.org。 頂欄那一枚做成徽標，排在語言欄左邊、以一道細豎線相隔；頁腳那一枚與書名同排，當作每頁的落款。讀者翻到任何一頁都能一眼看到這本書的正式網址，也方便直接把它發給別人 |
頂欄模板 header.html、scripts/inject-seo.mjs、styles/website.css |
| 增強 | 兩處域名都鏈回當前語言的封面——日文頁點它回 /ja/，法文頁回 /fr/，而不是一律把人送回簡體版；用的是相對鏈接，所以本地預覽時點它不會跳出 localhost |
同上 |
| 新增 | 域名展示自檢 scripts/check-branding.py：逐頁核對頂欄徽標與頁腳署名是否齊備、兩處鏈接是否都指向本語言的封面、頁腳書名是否與該頁標題一致、樣式是否已同步進構建產物。已做證偽測試（把鏈接改指它語種、刪掉頁腳、改錯書名、多插一枚徽標，四種破壞都能報出來） |
新增 scripts/check-branding.py |
| 說明 | 頁腳走構建後注入而不是覆蓋模板：主題里根本沒有 website/footer.html 這個模板，想在模板里加就只能把 page.html（128 行，含側欄狀態恢復腳本）整份抄一份出來，抄本一漂移就是靜默失效；而且該書搜索插件已經佔了同名的 page.html，再疊一層會互相頂掉、連搜索一起壞。注入版另帶計數斷言：頁面結構一變就在構建期直接報錯，不會靜默丟掉頁腳 |
— |
v3.4.0 · 2026-10-12 · 上線 zhabei.org
| 類型 | 更新點 | 涉及文件 |
|---|---|---|
| 新增 | 本書正式上線 https://zhabei.org。七語種封面與「關於本書」頁都寫明了在線閱讀地址，讀者不必先拿到源文件才能開始讀 | 七語種 README.md、about.md |
| 新增 | 全站 323 頁補上 SEO 基建：每頁一條自指的 canonical、七語種 hreflang 互指（含 x-default 指向簡體版）、Open Graph 標籤，並把此前一直空著的 description 按正文首段補齊；另生成 sitemap.xml（322 條，每條帶七語種 xhtml:link 互指）與 robots.txt。根跳轉頁帶 noindex，故不進 sitemap |
新增 scripts/inject-seo.mjs、package.json |
| 新增 | SEO 自檢 scripts/check-seo.py：核對每頁 canonical 是否自指且唯一、七語種 hreflang 是否成閉環、描述是否為空、sitemap 是否覆蓋全部頁面 |
新增 scripts/check-seo.py |
| 說明 | 站點結構：同域分路徑（/zh/、/zh-hant/、/en/ …），七個語種共用一個域名。網址形式是「單頁不帶擴展名、封面頁帶斜槓」（如 /zh/part1/01-naming、/zh/）—— 這是託管平臺的規範形式，canonical 與 sitemap 都按它生成；寫成 .html 的舊式地址照常可用，會自動跳過去。站點地址集中在 scripts/inject-seo.mjs 頂部一處，可用環境變量 SITE_URL 覆蓋 |
— |
v3.3.0 · 2026-10-12 · 中文拆為簡體／繁體兩版
| 類型 | 更新點 | 涉及文件 |
|---|---|---|
| 新增 | 中文自本版起分「简体中文」與「繁體中文」兩版，與英、日、韓、法、德同列，頂欄語言欄由六條增為七條。 簡體版仍是唯一真源（zh/），繁體版（zh-hant/）由它派生而非手抄——同一份文本的兩種字形不該有兩份底稿，否則中文源一改就得再抄一遍 |
zh-hant/（新增 47 頁 + book.json）、LANGS.md、頂欄模板 |
| 新增 | 新增派生腳本 scripts/gen-zh-hant.py：一條命令從 zh/ 重建 zh-hant/（含 book.json 與 SUMMARY.md），帶 --check（只比對，發現漂移即返回 1）與 --report（五項審計） |
scripts/gen-zh-hant.py |
| 說明 | 繁體版採用臺灣正體字形（OpenCC s2tw），並把正文裡的 ASCII 直引號成對轉成「」『』（簡體版用 "，是大陸排版慣例）。引號轉換必須跳過代碼段：本頁就有一處代碼段寫著一個 ASCII 直引號（"），第一版沒跳過，那個字面引號被當成排版引號吃掉，於是整份文件的引號奇偶翻轉——後面的 **轉換遠不止"換個字形"** 全變成先閉後開。一處錯、通篇錯，而且構建不報錯 |
scripts/gen-zh-hant.py |
| 說明 | 轉換遠不止「換個字形」：OpenCC 的詞組表會把「三曾里」「吉慶里」等 21 個里弄名的通名「里」當成方位詞錯轉成「裡」，把「工程總局幹的第一件事」轉成「乾的」，把商務印書館創辦人「鮑咸昌」轉成「鮑鹹昌」，還會把助詞「了」誤作「瞭」（點明了原因 → 點明瞭原因）。這些逐條進了覆蓋表，用私用區佔位符繞開 OpenCC——實測 OpenCC 完全不碰私用區，所以不能「先換繁體再送 OpenCC」，它對自己吐出的繁體仍會再動手 |
scripts/gen-zh-hant.py |
| 說明 | 字形口徑：只轉字形與標點，不做用詞本地化。 所以 報道（臺作「報導」）、鏈接（臺作「連結」）、視頻、軟件、網絡 等大陸詞形一律保留——本書是大陸作者寫上海，與英法德日韓各版保留原語義是同一條原則 |
docs/TRANSLATION-GLOSSARY.md |
| 增強 | 三支自檢腳本擴到七語種：語言欄斷言由「恰好 6 條」改為 7 條；搜索索引的語種身份交叉矩陣擴為 7×7 —— 簡繁兩版頁面 URL 鍵完全相同，正是這類串味缺陷最容易踩的一對；譯文自檢新增 K 項「繁體字形派生守恆」（逐頁等長、無裸引號、無未還原佔位符），並對繁體跳過不適用的兩項 | scripts/check-langbar.py、scripts/check-search.py、scripts/check-translations.py |
| 修訂 | 七語種封面與語言欄的語言清單由「中文 · English · …」改為「简体中文 · 繁體中文 · English · …」；語言名稱一律用其自身文字書寫——繁體版封面同樣寫「简体中文」，正如英文版正文裡寫「日本語」「한국어」 | 七語種 README.md、頂欄模板 |
| 修復 | 頂欄「編輯本頁」按鈕此前七個語種的頁面上都寫中文——它的文案取自根配置裡的一個字符串，被所有語種子書共用，所以英文版讀者看到的也是「編輯本頁」。現改為按語言取值：編輯本頁／Edit this page／このページを編集／이 페이지 편집／Modifier cette page／Diese Seite bearbeiten。插件本就支持按語言取文案（它讀的是子書的語言目錄名），只是配置裡沒寫全；順帶實測了七條跳轉地址，都指向倉庫中真實存在的目錄 |
根 book.json |
v3.2.2 · 2026-10-10 · 修好五語種搜索
| 類型 | 更新點 | 涉及文件 |
|---|---|---|
| 修復 | 英、日、韓、法、德五版的站內搜索此前等於沒有。 搜索索引由 search-plus 插件生成，而該插件把索引存在一個模塊級全局變量裡；HonKit 的多語言構建又把六個語種併發跑在同一個進程中，各語種頁面的 URL 鍵還完全同名，於是後建的語言覆蓋先建的——六份索引文件最終字節數完全相同，內容清一色是中文。外語版讀者打開搜索框，無論輸入什麼非中文詞都是 0 結果。這個故障構建不報錯、頁面也照常，只有真去搜一下才會發現 |
local-plugins/gitbook-plugin-search-plus/index.js（新增；按「輸出根」分桶，其前端腳本與模板逐字節照抄上游）、package.json |
| 新增 | 新增搜索索引自檢 scripts/check-search.py：逐語種核對索引條數、與目錄的頁面覆蓋、字段完整性，並用各語種封面副標題做語種身份交叉矩陣（自己命中、其餘五語種 0 命中） |
scripts/check-search.py |
| 說明 | 上線前全面複查：構建 6 語種 × 46 頁、共 277 個頁面；全站內部鏈接 21,072 條 0 死鏈；276 頁語言欄全部正常；譯文機器校驗八項全過。並用真實瀏覽器實測三站搜索——中文「閘北」46 條命中、英文「Sihang Warehouse」16 條、法文「ruisseau」27 條 | — |
v3.2.1 · 2026-10-10 · 全語種譯文質量抽檢
對英、日、韓、法、德五語種做了一次人工精讀加機器校驗的抽檢（鏈接、數字、專名、語種洩漏、篇幅比、標題結構共八項），查出並修掉三類不一致。
| 類型 | 更新點 | 涉及文件 |
|---|---|---|
| 修訂 | 韓文兩頁附錄的章末來源段標籤作 **인용과 출처**：、德文兩頁作 **Quellen und Herkunft**:，均與術語表規定的 **출처**：／**Quellen**: 不符，現四頁一律歸位 |
ko/appendix/place-names.md、ko/appendix/road-names.md、de/appendix/place-names.md、de/appendix/road-names.md |
| 修訂 | 法、德兩版「版本記錄」的目錄條目與頁內標題不一致（法文目錄作 Journal des versions、頁內標題作 Journal des modifications；德文目錄作 Versionsverlauf、頁內標題作 Änderungsprotokoll），現統一為頁內標題——其餘四語種本就沒有這個偏差。改的是目錄真源，生成物一併重出 |
scripts/toc.tsv、fr/SUMMARY.md、de/SUMMARY.md |
| 修訂 | 《汪壽華》篇「原名」一行，英、法兩版因拼音同音（紀元／寄元 同為 Jiyuan，今亮／晉亮／金亮 同為 Jinliang）讀起來像重複出錯；現英、法、德三版均在姓名後括注漢字消歧，與日、韓版做法一致 | en/part4/05-wangshouhua.md、fr/part4/05-wangshouhua.md、de/part4/05-wangshouhua.md |
v3.2.0 · 2026-10-10 · 五語種正文全部譯畢
| 類型 | 更新點 | 涉及文件 |
|---|---|---|
| 新增 | 英、日、韓、法、德五個語種的正文全部譯完，每語種 43 頁（第一部 10、第二部 10、第三部 10、第四部 9、附錄 4），加上各語種卷首 3 頁，六語種合計 276 個頁面。至此全書不再有任何佔位頁 | en/、ja/、ko/、fr/、de/ 下全部 .md |
| 新增 | 術語表增補第七節「正文高頻補充專名」（上海總工會、不夜城、中國共產黨、國民黨、淞滬會戰、十九路軍、蔣介石、毛澤東、青雲路、會文路、彭越浦、廣肇山莊、走馬塘、中環、赤膊區、黃埔 等 25 條）與第八節「數值與計量寫法」（萬元／億元／畝／里／km² 的五語種統一寫法） | docs/TRANSLATION-GLOSSARY.md |
| 修訂 | 統一德語「十九路軍」為 Routenarmee（原 part1 作 Route-Armee，與術語表不一致，共 9 處） |
de/README.md、de/part1/05-1927-1932.md、de/appendix/ |
| 修訂 | 英文封面頁「全書構成」由列表改回與中文一致的三列表格；刪除已過時的「本譯本分階段進行」一句（英文版正文已全部譯畢） | en/README.md |
| 說明 | 五語正文的譯名與語體一律以術語表為準：日文用繁體漢字＋片假名讀法，韓文按普通話音譯，英法德用漢語拼音 | — |
v3.1.1 · 2026-10-09 · 作者署名（舟哥 / Nickzhuo）
| 類型 | 更新點 | 涉及文件 |
|---|---|---|
| 新增 | 作者暱稱「舟哥（Nickzhuo）」正式寫進全書，四個地方口徑統一：各語種元數據 author 字段、封面署名、章末落款、關於作者小節。寫法按語種：中文「舟哥（Nickzhuo）」；英／法／德「Zhou Ge (舟哥) · Nickzhuo」；日文「舟哥（Nickzhuo）」；韓文「저우거(舟哥) · Nickzhuo」。拉丁字母 Nickzhuo 一律原樣保留，便於全書檢索與元數據統一 |
book.json、*/book.json、*/README.md、*/about.md |
| 新增 | 各語種「關於本書」頁補「關於作者」小節，並說明勘誤、補充與討論都走 GitHub 倉庫 | */about.md |
| 新增 | 翻譯術語表新增「本書作者」一節，明確六個語種的署名寫法，並要求與元數據逐字一致 | docs/TRANSLATION-GLOSSARY.md |
| 修訂 | 根 book.json 的作者由「舟哥」補齊為「舟哥（Nickzhuo）」 |
book.json |
v3.1.0 · 2026-10-09 · 去掉語言落地頁 + 頂欄語言欄
| 類型 | 更新點 | 涉及文件 |
|---|---|---|
| 增強 | 打開站點直接進入中文。根 index.html 不再是「選擇語言」落地頁，改為一枚零秒跳轉頁：meta refresh 寫在 <head>，瀏覽器解析到 head 就跳、body 來不及繪製，因此看不到任何閃爍；再疊一層 location.replace() 且不寫歷史記錄，避免讀者點「後退」被彈回這裡形成死循環 |
_layouts/website/languages.html |
| 新增 | 每一頁頂欄右側新增六語平鋪語言欄（中文 · English · 日本語 · 한국어 · Français · Deutsch），不做下拉框；當前語種以硃砂色膠囊高亮。鏈接按「當前頁面 → 另一語種的同名頁面」自動換算，封面 README.md 正確映射為 index.html |
local-plugins/honkit-plugin-zhabei-theme/_layouts/website/header.html、styles/website.css |
| 增強 | 頂欄改為 flex 佈局：工具按鈕（側欄開關／編輯本頁／字體）居左，語言欄靠右。窄屏（≤900px）語言欄自動折到第二行居中，320px 下仍不溢出、不遮擋正文 | styles/website.css |
| 修復 | 語言欄模板必須放在本地插件裡，不能放項目根 _layouts/：多語言模式下每個語種是一個獨立 Book，其內容根是 zh/、en/… 而不是項目根，放根目錄會靜默失效（構建不報錯，但頁面上根本沒有語言欄）。已在模板與 .bookignore 裡註明 |
local-plugins/honkit-plugin-zhabei-theme/_layouts/website/header.html |
| 修復 | 模板註釋必須寫成 `：HonKit 在templateEngine.toNunjucks()裡把 nunjucks 的註釋定界符改成了三井號。用默認的「井號花括號」寫註釋時，它**根本不叫註釋** —— 裡面出現的塊標籤會被真的解析，構建報parseBlock: expected endblock, got end of file`；若沒有塊標籤，整段註釋文字會直接顯示在頁面上 |
_layouts/website/languages.html、local-plugins/honkit-plugin-zhabei-theme/_layouts/website/header.html |
| 說明 | 各語種封面裡「其他語言版本見語言選擇頁」一句同步改為指向頂欄語言欄 | */README.md |
v3.0.0 · 2026-10-09 · 多語言化（英／日／韓／法／德）
| 類型 | 更新點 | 涉及文件 |
|---|---|---|
| 重構 | 全書改為 HonKit 多語言結構：新增 LANGS.md，中文內容整體遷入 zh/，每個語種自成一冊（各有自己的 book.json 與 SUMMARY.md）；根 book.json 的 language 置空並改為全語種共用 |
LANGS.md、book.json、zh/ |
| 新增 | 新增英、日、韓、法、德五個語種版本，46 條目錄逐條按各語種書寫 | en/、ja/、ko/、fr/、de/ |
| 新增 | 翻譯術語表：五語轉寫總則 + 地名／機構／事件／人物／概念對照，作為全書譯名的唯一依據。日文用漢字＋當年在滬實際讀法（閘北＝ザホク，吳昌碩＝呉昌碩ごしょうせき）；韓文依 1986 年國立國語院《外來語表記法》用普通話音譯（閘北＝자베이） | docs/TRANSLATION-GLOSSARY.md |
| 新增 | 卷首五語齊備：封面、關於本書、版本記錄，五種語言均已譯畢 | */README.md、*/about.md、*/changelog.md |
| 新增 | 未譯章節佔位頁（避免側欄 404 死鏈）與全站內部鏈接自檢腳本 | scripts/make-stubs.py、scripts/check-links.py |
| 修復 | 語種頁樣式不生效：根 book.json 的 theme-default.styles 在語言子書中拿不到（主題模板裡 fileExists(style) 在語言作用域下不成立，改用 ../ 路徑又觸發 FileOutOfScopeError）。改為本地插件 honkit-plugin-zhabei-theme 以「書籍資源」方式注入，六語種全部生效 |
local-plugins/、scripts/sync-styles.mjs、package.json |
| 增強 | 語言選擇頁改用自定模板（替換 HonKit 內置的英文硬編碼標題），並套用「紙墨」配色；內置的 float 兩列佈局改用 CSS grid —— 原因是主題給 .languages 加了 ::before/::after{display:table}，在 grid 容器裡會各佔一格，把 6 個條目擠成錯位 |
_layouts/website/languages.html、styles/website.css |
| 說明 | 正文五語翻譯分階段進行；未譯章節暫以佔位頁呈現，譯完即覆蓋 | — |
v2.3.0 · 2026-10-09 · 修缺陷 + 配色改版
| 類型 | 更新點 | 涉及文件 |
|---|---|---|
| 修復 | 「頂部兩個字體下拉框」：highlight / fontsettings / theme-default 本是 HonKit 默認插件，卻又在 book.json 裡重複聲明，導致被加載兩次（實測掛載了兩個 fontsettings/website.css） |
book.json |
| 修復 | 移除 splitter：它只在換頁時 append 一個 width:5px; height:100% 的絕對定位豎條且從不清理（實測連續翻頁 8 次，.divider-content-summary 從 1 漲到 9），是右側白邊的來源 |
book.json、package.json |
| 修復 | 移除 back-to-top-button：同樣在換頁時無條件 append，.back-to-top 同樣 1→9；且該包已被 npm 標記為不再維護 |
book.json、package.json |
| 增強 | 配色改版為「紙墨 · 淺色」：原內置 color-theme-1（羊皮紙）會把側欄刷成近黑 #111、正文刷成米黃，與自定義樣式互相打架；現統一為淺底深字 + 硃砂 #9c3d2e 強調 |
styles/website.css（調色板集中在頂部 :root） |
| 增強 | 正文字體默認改為襯線體，字號 2 | book.json |
| 修訂 | 清理未使用的 gitbook-plugin-toc 依賴 |
package.json |
| 修訂 | 清理已移除插件在 _book/ 中的殘留產物 |
_book/（構建產物，不入庫） |
v2.2.0 · 2026-10-09 · 啟用閱讀增強插件
| 類型 | 更新點 | 涉及文件 |
|---|---|---|
| 增強 | 中文搜索增強：以 search-plus 取代內置 lunr/search，支持中文分詞與結果高亮 |
book.json |
| 增強 | 「編輯本頁」：頁面頂部直鏈 GitHub 倉庫對應源文件，讀者可即點即改 | book.json |
| 增強 | 標題錨點：每個小標題生成可複製的獨立鏈接（全書 46 頁覆蓋） | book.json |
| 增強 | 側邊欄章節摺疊：點擊章節標題可收起/展開下級目錄 | book.json |
| 增強 | 「回到頂部」懸浮按鈕 （已於 v2.3.0 移除） | book.json |
| 增強 | 側邊欄寬度可拖拽（已於 v2.3.0 移除） | book.json |
| 增強 | 代碼塊一鍵複製 | book.json |
| 增強 | 新增插件依賴 | package.json、package-lock.json |
v2.1.0 · 2026-10-09 · 新增模塊
| 類型 | 更新點 | 涉及文件 |
|---|---|---|
| 新增 | 新增「版本記錄」模塊，用表格逐條記錄每次改動 | changelog.md（本頁） |
| 重構 | 目錄新增「版本記錄」條目 | SUMMARY.md |
v2.0.2 · 2026-10-09 · 增強本地預覽
| 類型 | 更新點 | 涉及文件 |
|---|---|---|
| 新增 | 一鍵預覽啟動器（雙擊即起服務並打開瀏覽器） | preview.bat |
| 新增 | HonKit 構建排除清單，把開發文件擋在發佈產物之外 | .bookignore |
| 增強 | 封面頁補「本地閱讀（重要）」小節，說明 file:// 為何打不開 |
README.md |
| 修復 | 定位並說明：HonKit 站點為 SPA 式導航，file:// 下會被 CORS 攔截，必須走 HTTP |
— |
v2.0.1 · 2026-10-09 · 修復死鏈
| 類型 | 更新點 | 涉及文件 |
|---|---|---|
| 修復 | 修正 60 條跨目錄內部鏈接（共 34 個文件），原因是鏈接按「書根」而非「當前文件」書寫 | part1/–part4/、appendix/ 下多個 .md |
| 增強 | 建全量鏈接自檢：45 頁、2065 條內部鏈接，0 死鏈 | 校驗腳本（臨時） |
v2.0.0 · 2026-10-09 · 遷移平臺並重寫全書
| 類型 | 更新點 | 涉及文件 |
|---|---|---|
| 重構 | 構建系統由 GitBook 遷至 HonKit 6（SUMMARY.md / book.json 近乎平替） |
package.json、book.json |
| 新增 | 全書 45 頁從零重寫：封面、前言 + 四大部分 + 四篇附錄 | 45 個 .md |
| 新增 | 第一部分 · 閘北編年史（9 章，得名 → 2015 撤二建一） | part1/ |
| 新增 | 第二部分 · 閘北街道概覽（8 個街道 + 彭浦鎮） | part2/ |
| 新增 | 第三部分 · 閘北著名景點（9 篇） | part3/ |
| 新增 | 第四部分 · 閘北歷史人物（8 篇） | part4/ |
| 新增 | 附錄：路名密碼、大事年表、地名今昔、引用書目 | appendix/ |
| 新增 | 文獻來源三級體系（甲方志/公報/文保名錄、乙權威媒體、丙百科遊記），每章末尾附「引用與出處」 | 全書各章 |
| 增強 | 自定義「檔案紙」樣式（襯線正文、棕調標題、表格美化） | styles/website.css |
| 增強 | GitHub Pages 自動部署工作流 | .github/workflows/deploy.yml |
| 增強 | 行尾/編碼規範化，保證 Windows 開發、Linux 構建一致 | .gitattributes、.gitignore |
| 修訂 | 刪除佔位文件 | NONONO（已刪） |
v1.0 · 2023-11-03 · 初始（已廢棄）
| 類型 | 更新點 | 涉及文件 |
|---|---|---|
| 新增 | 由 GitBook 雲端編輯器建立項目骨架 | README.md、SUMMARY.md |
| 新增 | 佔位文件 | NONONO |
| 說明 | 三次提交均為 GitBook 自動生成（GITBOOK-3 / GITBOOK-4 / Create NONONO），無實質內容，此後項目廢棄 |
— |
維護約定
為了方便長期追加，改動記錄遵循下面三條：
- 一次改動一次提交：每完成一輪修改，先在「版本速覽」加一行，再到「逐版明細」加一節；
- 每行必須能獨立看懂：寫清「改了什麼」，不要只寫「優化」「更新」這類空話；
- 註明涉及文件：方便按圖索驥地複查或回退。
更細的技術性提交說明（commit message）保存在 Git 歷史裡； 本頁只記對讀者有意義的改動，二者互補。