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
This commit is contained in:
Baohua Yang
2026-02-21 22:40:33 -08:00
parent 33af380be1
commit 175aaae48a
136 changed files with 1015 additions and 766 deletions

View File

@@ -2,7 +2,7 @@
本节涵盖了相关内容与详细描述主要探讨以下几个方面
### 基本语法
### 7.3.1 基本语法
如下代码块所示展示了相关示例
@@ -18,7 +18,7 @@ ADD [选项] ["<源路径>", ... "<目标路径>"]
---
### ADD vs COPY
### 7.3.2 ADD vs COPY
相关信息如下表
@@ -34,7 +34,7 @@ ADD [选项] ["<源路径>", ... "<目标路径>"]
---
### 自动解压功能
### 7.3.3 自动解压功能
本节涵盖了相关内容与详细描述主要探讨以下几个方面
@@ -83,7 +83,7 @@ app.tar.gz 包含: /app/ 目录结果:
---
### URL 下载功能 (不推荐)
### 7.3.4 URL 下载功能 (不推荐)
本节涵盖了相关内容与详细描述主要探讨以下几个方面
@@ -131,7 +131,7 @@ RUN curl -fsSL https://example.com/app.tar.gz | tar -xz -C /app
---
### 修改文件所有者
### 7.3.5 修改文件所有者
如下代码块所示展示了相关示例
@@ -142,7 +142,7 @@ ADD --chown=1000:1000 files/ /app/
---
### 何时使用 ADD
### 7.3.6 何时使用 ADD
本节涵盖了相关内容与详细描述主要探讨以下几个方面
@@ -184,7 +184,7 @@ COPY archive.tar.gz /archives/ # ✅ 保持原样
---
### 缓存行为
### 7.3.7 缓存行为
ADD 可能导致构建缓存失效
@@ -210,7 +210,7 @@ ADD app.tar.gz /app/
---
### 最佳实践
### 7.3.8 最佳实践
本节涵盖了相关内容与详细描述主要探讨以下几个方面