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.8.1 基本语法
如下代码块所示展示了相关示例
@@ -15,7 +15,7 @@ VOLUME /路径
---
### 为什么使用 VOLUME
### 7.8.2 为什么使用 VOLUME
> **核心原则**容器存储层应该保持无状态任何运行时数据都应该存储在卷中
@@ -45,7 +45,7 @@ flowchart LR
---
### 基本用法
### 7.8.3 基本用法
本节涵盖了相关内容与详细描述主要探讨以下几个方面
@@ -69,7 +69,7 @@ VOLUME ["/data", "/logs", "/config"]
---
### VOLUME 的行为
### 7.8.4 VOLUME 的行为
本节涵盖了相关内容与详细描述主要探讨以下几个方面
@@ -106,7 +106,7 @@ $ docker run -v /my/data:/var/lib/mysql mysql:8.0
---
### VOLUME 在构建时的特殊行为
### 7.8.5 VOLUME 在构建时的特殊行为
> **重要**VOLUME 之后对该目录的修改会被丢弃
@@ -143,7 +143,7 @@ VOLUME /data
---
### 常见使用场景
### 7.8.6 常见使用场景
本节涵盖了相关内容与详细描述主要探讨以下几个方面
@@ -176,7 +176,7 @@ VOLUME /app/uploads
---
### 查看 VOLUME 定义
### 7.8.7 查看 VOLUME 定义
运行以下命令
@@ -195,7 +195,7 @@ $ docker inspect mycontainer --format '{{json .Mounts}}' | jq
---
### VOLUME vs docker run -v
### 7.8.8 VOLUME vs docker run -v
相关信息如下表
@@ -208,7 +208,7 @@ $ docker inspect mycontainer --format '{{json .Mounts}}' | jq
---
### Compose
### 7.8.9 Compose
Compose 中配置如下
@@ -230,7 +230,7 @@ volumes:
---
### 安全注意事项
### 7.8.10 安全注意事项
本节涵盖了相关内容与详细描述主要探讨以下几个方面
@@ -259,7 +259,7 @@ $ docker run -v mysql_data:/var/lib/mysql mysql:8.0
---
### 最佳实践
### 7.8.11 最佳实践
本节涵盖了相关内容与详细描述主要探讨以下几个方面