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.15.1 基本语法
如下代码块所示展示了相关示例
@@ -19,7 +19,7 @@ SHELL ["executable", "parameters"]
---
### 为什么要用 SHELL 指令
### 7.15.2 为什么要用 SHELL 指令
本节涵盖了相关内容与详细描述主要探讨以下几个方面
@@ -84,7 +84,7 @@ SHELL ["cmd", "/S", "/C"]
---
### 作用范围
### 7.15.3 作用范围
`SHELL` 指令可以出现多次每次只影响其后的指令
@@ -108,7 +108,7 @@ RUN echo "Using sh again"
---
### 对其他指令的影响
### 7.15.4 对其他指令的影响
`SHELL` 影响的是所有使用 **shell 格式** 的指令
@@ -123,7 +123,7 @@ RUN echo "Using sh again"
---
### 最佳实践
### 7.15.5 最佳实践
本节涵盖了相关内容与详细描述主要探讨以下几个方面