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.2.1 基本语法
如下代码块所示展示了相关示例
@@ -15,7 +15,7 @@ COPY [选项] ["<源路径1>", "<源路径2>", ... "<目标路径>"]
---
### 基本用法
### 7.2.2 基本用法
本节涵盖了相关内容与详细描述主要探讨以下几个方面
@@ -69,7 +69,7 @@ src/ /app/src/
---
### 通配符规则
### 7.2.3 通配符规则
COPY 支持 Go `filepath.Match` 通配符规则
@@ -88,7 +88,7 @@ COPY app[0-9].js /app/ # app0.js ~ app9.js
---
### 目标路径
### 7.2.4 目标路径
本节涵盖了相关内容与详细描述主要探讨以下几个方面
@@ -122,7 +122,7 @@ COPY settings.json /app/config/
---
### 修改文件所有者
### 7.2.5 修改文件所有者
使用 `--chown` 选项设置文件的用户和组
@@ -144,7 +144,7 @@ COPY --chown=node . /app/
---
### 保留文件元数据
### 7.2.6 保留文件元数据
COPY 会保留源文件的元数据
@@ -161,7 +161,7 @@ COPY start.sh /app/
---
### COPY vs ADD
### 7.2.7 COPY vs ADD
相关信息如下表
@@ -187,7 +187,7 @@ ADD app.tar.gz /app/
---
### 多阶段构建中的 COPY
### 7.2.8 多阶段构建中的 COPY
本节涵盖了相关内容与详细描述主要探讨以下几个方面
@@ -229,7 +229,7 @@ COPY --link --from=builder /app/dist /usr/share/nginx/html
---
### .dockerignore
### 7.2.9 dockerignore
使用 `.dockerignore` 排除不需要复制的文件
@@ -252,7 +252,7 @@ Dockerfile
---
### 最佳实践
### 7.2.10 最佳实践
本节涵盖了相关内容与详细描述主要探讨以下几个方面