版本记录
这一页记录《闸北：一条苏州河北岸的百年纪事》的每一次改动。
为什么要留这么一页？因为这本书是从一个废弃的 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 历史里； 本页只记对读者有意义的改动，二者互补。