Commit Graph
209 Commits
Author SHA1 Message Date
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