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.7.1 基本语法
如下代码块所示展示了相关示例
@@ -14,7 +14,7 @@ ARG <参数名>[=<默认值>]
---
### ARG vs ENV
### 7.7.2 ARG vs ENV
相关信息如下表
@@ -37,7 +37,7 @@ ARG <参数名>[=<默认值>]
---
### 基本用法
### 7.7.3 基本用法
本节涵盖了相关内容与详细描述主要探讨以下几个方面
@@ -72,7 +72,7 @@ $ docker build --build-arg NODE_VERSION=18 -t myapp .
---
### ARG 的作用域
### 7.7.4 ARG 的作用域
本节涵盖了相关内容与详细描述主要探讨以下几个方面
@@ -130,7 +130,7 @@ RUN echo "Running with Node $NODE_VERSION"
---
### 常见使用场景
### 7.7.5 常见使用场景
本节涵盖了相关内容与详细描述主要探讨以下几个方面
@@ -192,7 +192,7 @@ $ docker build --build-arg NPM_TOKEN=xxx .
---
### ARG 传递给 ENV
### 7.7.6 ARG 传递给 ENV
如果需要在运行时使用 ARG 的值
@@ -210,7 +210,7 @@ CMD echo "App version: $APP_VERSION"
---
### 预定义 ARG
### 7.7.7 预定义 ARG
Docker 提供了一些预定义的 ARG无需声明即可使用
@@ -229,7 +229,7 @@ $ docker build --build-arg HTTP_PROXY=http://proxy:8080 .
---
### 最佳实践
### 7.7.8 最佳实践
本节涵盖了相关内容与详细描述主要探讨以下几个方面