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
08e981018e
fix(content): 修正四处书内自相矛盾的技术断言
...
1. FROM「必须是第一条指令」（4.5、7.16、summary 三处）与本书 7.7.4「FROM 之前的
ARG」整节直接冲突。官方 Dockerfile 参考写的是 "A Dockerfile must begin with a
FROM instruction. This may be after parser directives, comments, and globally
scoped ARGs"，且 "ARG is the only instruction that may precede FROM"。三处
一并改成「第一条构建指令」并点明例外。
2. 12 章小结把 USER Namespace 列进「默认启用」的一档，并写「容器 root ≠ 宿主机
root」；而同章 12.2.2 明写 USER Namespace 默认**不**启用、需 userns-remap 显式
开启，18.1 更直说「在默认情况下，容器内的 root 用户（UID=0）就是宿主机上的
root 用户」。小结按正文口径改回——这条读反了会直接误判容器逃逸的风险面。
3. 11.5「目前支持三种日志驱动类型」是 Compose 早期文本的残留。官方支持 json-file、
local、syslog、journald、gelf、fluentd、awslogs、splunk、etwlogs、gcplogs、
none 共十余种，本书 19 章小结自己就列了六种。改为给出常见取值并链到官方清单。
4. 7.8 与 7.5 的示例注释建议 postgres:latest / redis:latest，而 4.1、7.10、
7.16、7 章小结、4.5 全都要求避免 latest（7.8 同一文件第 177 行也写「避免
latest」）。按全书口径改掉这两处。
另：ENV 的空格分隔旧写法（7.6 的「格式一」、附录四的 PG_MAJOR/PATH 示例）改为等号
形式并加注。BuildKit 的 LegacyKeyValueFormat 检查会报
"ENV key=value" should be used instead of legacy "ENV key value" format，
而本书 10.2 与 07 章 README 正是在推荐 docker buildx build --check。
2026-08-07 23:26:12 -07:00
yeasy
9fdffa9d91
fix(content): harden Docker practice guide
2026-06-16 21:23:21 -07:00
yeasy
2185211041
fix(07): note FROM uses pre-FROM ARG, not ENV, for variable substitution
2026-05-28 11:38:27 -07:00
yeasy
b148d9efa9
Update nginx to 1.30 stable, add IPVS deprecation note
2026-05-02 18:18:48 +00:00
yeasy
1e9cdeea3f
Update Grafana to v13, add version notes
2026-04-25 15:50:13 +00:00
yeasy
76c2ae50fe
Add blank lines around headers
2026-03-24 09:27:04 -07:00
yeasy
44b1307277
Remove blank lines after code block markers
2026-03-21 22:36:09 -07:00
yeasy
370949f226
Add blank lines before headers
2026-03-21 12:57:51 -07:00
yeasy
a8e7ba1551
修复错别字：。env → .env
2026-03-14 13:55:58 -07:00
Baohua Yang
5f32350c12
Add more content and fix format
2026-02-25 21:06:21 -08:00
Baohua Yang
5e8d7252be
Simplify words and fix format issues
2026-02-24 22:01:02 -08:00
Baohua Yang
8c77a9aa99
Fix missing links
2026-02-22 13:40:20 -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
e69a140cc9
chore: remove unused historic image files
2026-02-21 16:43:31 -08:00
Baohua Yang
cc13935f0f
style: apply global formatting fixes (struct, spacing, zhlint)
2026-02-21 11:08:52 -08:00
Baohua Yang
1203dee81e
Continue to fix format issues
2026-02-21 10:47:37 -08:00
Baohua Yang
20c4f21247
Fix and improve
2026-02-12 16:51:50 -08:00
Baohua Yang
194680ab6e
Restruct
2026-02-09 12:56:12 -08:00
yeasy