yeasy
7d9ed83d45
style: 中英文空格 36 处(2 文件)
...
按本书自己的多数体例收口,不是引入新规范;同批在集群 14 本书上做同一件事。
**中英文空格**:改动前 8753 处已空格 : 36 处紧贴(0.4%),改动后紧贴 **0**。只在「汉字 ↔ 拉丁字母/数字」直接相邻处插一个半角空格;不动中文标点与拉丁字符之间、也不动半角括号与中文之间。
脚本用私用区字符遮蔽围栏代码、行内代码、`$$…$$` 公式、链接与图片目标、HTML 标签、裸 URL、引用式链接定义与 YAML front matter 之后再改。
验证:改动前后各自抹掉全部空白与两种圆括号后**逐字节相同**;左右括号总数守恒;逐行比对无一行新增连续多空格;SUMMARY 目录名与文件标题的一致数改动前后不变。`check_project_rules`、`check_emphasis`、根 `format_checker`、`validate_codeblocks`、`scan_secrets` 全绿,测试套失败集合与改动前一致。
2026-08-24 14:29:39 -07:00
yeasy
a780127d48
fix(用词): 「其它」统一为「其他」(34 处 / 25 文件)
...
《现代汉语词典》与《中文技术文档写作风格指南》都以「其他」为规范词形;
本书基线是 90 处「其他」比 35 处「其它」,是集群里遗留最多的一本
(其余各书 0~4 处,blockchain_guide 已于 2026-08-05 统一过 47 处)。
其中 6 处在标题和目录上——`4.6 其它制作镜像的方式`、`第十七章 容器其它生态`、
`18.5 其它安全特性`——标题与 SUMMARY 条目**同批改写以保持一致**:
改动后 196 条目录名与各文件标题仍是 0 处不一致。
**`CHANGELOG.md` 里那一处刻意不动**:它是历史发布记录,改它等于改历史。
改动前后逐字符对称差:只有 34 个「它」变成「他」,无其他字符变化。
`check_project_rules` 202/202、`check_emphasis` 202/202、37 tests OK。
2026-08-24 13:18:05 -07:00
yeasy
ef2625531d
style: 含中文的括号统一为全角(336 处 / 110 文件)
...
全书此前是真·五五开:含中文的括号 336 处半角 : 336 处全角,而且**在同一文件
内混用**——`18_security/18.1_kernel_ns.md` 第 11/17/20 行写 `(如 runC)`,
第 31 行写 `(用户命名空间映射)`。这不是体例问题,是它自己跟自己不一致。
集群里其余 13 本都一边倒(llm_internals 5 : 1049、oc_guide 2 : 713、
forward_deployed_engineering_guide 0 : 108),blockchain_guide 已在 2026-08-05
按同一方向统一过 97 处,故取全角,而非另立新规。全角括号前后不留空格,
原先 `概念 (镜像、容器、仓库) 和` 两侧的空格一并收掉。
**纯拉丁内容的半角括号一个没动**——`新建一个层 (Layer)`、`项目 (project)`
保持原样:改动前后「半角且内容纯拉丁」的数量都是 **1163**,而「半角且含中文」
从 **336 变成 0**。
其余验证:改动前后各自抹掉全部空白与圆括号后**逐字节相同**(两侧均 19559 字符);
左右括号总数改动前后都是 399 : 399,证明没有吞括号也没有配错对。
`check_project_rules` 202/202、`check_emphasis` 202/202、37 tests OK、
根 `format_checker` 与 `validate_codeblocks` 干净、`git diff --check` 干净。
2026-08-24 13:13:23 -07:00
yeasy
1c8f0dc14d
chore: remove the remaining VuePress artifacts
...
Follows the devDependency removal. The build has been mdPress-only since
1.7.0 and nothing referenced these:
- .vuepress/ (config.js + .gitignore). The mirror it configured is still
live, but no workflow in this repo builds or deploys it, so this was a
recipe nobody ran. Local .vuepress/dist/ (400 files of Feb-2026 build
output, never tracked) was removed from the working tree too — with its
.gitignore gone it would otherwise have shown up as untracked noise.
- docker-compose.yml: the vuepress-offline service, plus the now-unused
&mdpress-offline anchor that existed only to feed it.
- README: the 'docker run ... :vuepress' one-liner. That tag was last
pushed 2022-06-25, so readers following it got a four-year-old snapshot
of the book. 'mdpress serve' immediately above it still works.
- CODEOWNERS, .zhlintignore and check_project_rules.py entries for the
deleted directory, and the check-link allowlist entry for the mirror
(no content links to it).
The CHANGELOG entry recording the original CI removal is left alone — it
is history.
Verified: npm test passes (3 + 35), check_project_rules passes 202 files,
docker-compose.yml still parses with no dangling YAML aliases.
2026-07-22 22:51:34 -07:00
yeasy
a1f63a565b
fix(links): repair dead external links found by a cluster-wide sweep
...
对 13 本书的 1,842 个外链做了一次全量 curl 健康检查(跟随重定向、带浏览器 UA),
逐条排除误报后确认的真死链。替换目标全部逐个验证返回 200。
注意两类**不是**缺陷、因此没有动的:
- platform.claude.com / docs.anthropic.com 当时返回 500,串行重试仍 500,
但同日早些时候可正常访问——是上游临时故障,不是死链。
- docker_practice 列出的国内 registry 镜像连不上,是因为书里已明确标注
「已停止服务」「已于 2024 年关闭」,属于故意保留的历史记录。
2026-07-22 16:51:15 -07:00
yeasy
9fdffa9d91
fix(content): harden Docker practice guide
2026-06-16 21:23:21 -07:00
yeasy
26da467052
docs: link deployment engineering guide
2026-05-18 22:37:02 -07:00
yeasy
407d508590
Restructure README with badges and cover
2026-04-17 21:51:38 -07:00
yeasy
04b81a8c05
Fix mdpress port 4000 to 9000
2026-04-05 13:39:46 -07:00
Baohua Yang
2b0c00c5e5
Add recommended reading paths table to README
2026-04-04 22:31:23 -07:00
yeasy
59bfe9cff6
Rename preview PDF
2026-03-28 21:12:58 -07:00
yeasy
137d161480
Add preview PDF
2026-03-28 20:42:25 -07:00
yeasy
85f76aa6d9
Fix guide issues
2026-03-28 18:24:46 -07:00
yeasy
5a6a50ba97
Refine appendix navigation
2026-03-28 18:19:49 -07:00
yeasy
67585c8040
Fix PDF badge link to releases page
2026-03-27 11:43:38 -07:00
yeasy
dbc86370c3
Update README with badges and mdpress fix
2026-03-27 11:18:08 -07:00
yeasy
5a55e03f45
Minor update
2026-03-26 10:02:41 -07:00
yeasy
89601b2ba1
Revert roadmap to Mermaid format
2026-03-26 08:56:11 -07:00
yeasy
8aab3b29ce
Replace Mermaid roadmap with SVG image
2026-03-26 08:54:54 -07:00
yeasy
6ff0af0329
Localize remaining external images
2026-03-26 08:51:29 -07:00
yeasy
efdc2c5156
Bump version to v1.7.0
2026-03-26 08:42:51 -07:00
yeasy
05e1127177
Standardize preview docs
2026-03-24 21:55:16 -07:00
yeasy
ee595e7cce
Fix README navigation
2026-03-24 21:11:28 -07:00
yeasy
8ed0b18e25
Bump version to v1.6.6
2026-03-24 09:26:54 -07:00
yeasy
44b1307277
Remove blank lines after code block markers
2026-03-21 22:36:09 -07:00
Baohua Yang
e53266a97b
Update mdpress build instructions: use brew and remove HonKit
2026-03-19 08:00:09 -07:00
Baohua Yang
0d96b77796
Add mdpress as local build method
2026-03-18 23:17:14 -07:00
yeasy
2ea6a720f1
Bump version to 1.6.5
2026-03-18 20:12:35 -07:00
yeasy
31abbbdf46
Embed local donation image
2026-03-18 19:44:03 -07:00
yeasy
696070cba9
Remove redundant English from headings
2026-03-16 22:34:38 -07:00
yeasy
b9c63a5133
Polish Docker workflow formatting
2026-03-16 00:32:49 -07:00
yeasy
224e2738ce
Replace straight quotes with curved quotes
2026-03-11 22:19:26 -07:00
yeasy
bdaeeaa740
Add details for cloud images
2026-03-09 20:04:22 -07:00
yeasy
a16e0879c0
Improve READMEs and add contribution prompts
2026-03-09 20:04:21 -07:00
baohua
20a69d1662
Fix typography
2026-03-09 20:04:13 -07:00
Baohua Yang
217ca43f86
Refine words
2026-03-02 22:16:51 -08:00
Baohua Yang
a92ed4a63f
Update content
2026-03-02 21:56:46 -08:00
Baohua Yang
9f67b560d9
Add security note
2026-02-28 14:28:38 -08:00
Baohua Yang
f465936b2a
release v1.6.0
2026-02-27 22:29:50 -08:00
Baohua Yang
5f32350c12
Add more content and fix format
2026-02-25 21:06:21 -08:00
Baohua Yang
f0c6d7de95
Fix wrong links
2026-02-22 16:04:41 -08:00
Baohua Yang
fff938780f
Fix double quotes
2026-02-22 14:54:52 -08:00
Baohua Yang
347c38e8bc
Fix naming of the chapter dir
2026-02-22 12:42:15 -08:00
Baohua Yang
58a8fa7339
Fix period mark
2026-02-21 22:44:57 -08:00
Baohua Yang
1f3da23352
Update content
2026-02-21 22:42:46 -08:00
Baohua Yang
114def0634
style(docs): standardize heading formats and numbering
...
- Enforce Level 1-3 structural numbering based on SUMMARY.md hierarchy
- Remove structural numbering from Level 4+ headings
- Eliminate single child headings by converting to bold text
- Auto-inject summary text for headings with multiple children missing intro text
- Exclude Appendix chapters from structural numbering
- Avoid modifying code block contents
- Add script to detect non-standard English usage in headers
2026-02-21 22:40:33 -08:00
Baohua Yang
b9c9efe02b
Fix space with bold markdown
2026-02-21 17:39:37 -08:00
Baohua Yang
e69a140cc9
chore: remove unused historic image files
2026-02-21 16:43:31 -08:00
Baohua Yang
b5ce572b42
Fix format issue
2026-02-21 10:19:28 -08:00
Baohua Yang
07728256b7
release: v1.5.4
2026-02-15 15:14:03 -08:00