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

@@ -1,8 +1,8 @@
## 挂载主机目录
## 8.3 挂载主机目录
本节涵盖了相关内容与详细描述主要探讨以下几个方面
### 什么是绑定挂载
### 8.3.1 什么是绑定挂载
Bind Mount (绑定挂载) **宿主机的目录或文件** 直接挂载到容器中容器可以读写宿主机的文件系统
@@ -23,7 +23,7 @@ flowchart LR
---
### Bind Mount vs Volume
### 8.3.2 Bind Mount vs Volume
相关信息如下表
@@ -55,7 +55,7 @@ flowchart LR
---
### 基本语法
### 8.3.3 基本语法
本节涵盖了相关内容与详细描述主要探讨以下几个方面
@@ -91,7 +91,7 @@ $ docker run -d \
---
### 使用场景
### 8.3.4 使用场景
本节涵盖了相关内容与详细描述主要探讨以下几个方面
@@ -153,7 +153,7 @@ $ docker run --rm -it \
---
### 只读挂载
### 8.3.5 只读挂载
防止容器修改宿主机文件
@@ -180,7 +180,7 @@ touch: /app/config/new.txt: Read-only file system
---
### 挂载单个文件
### 8.3.6 挂载单个文件
运行以下命令
@@ -202,7 +202,7 @@ $ docker run -d \
---
### 查看挂载信息
### 8.3.7 查看挂载信息
运行以下命令
@@ -235,7 +235,7 @@ $ docker inspect mycontainer --format '{{json .Mounts}}' | jq
---
### 常见问题
### 8.3.8 常见问题
本节涵盖了相关内容与详细描述主要探讨以下几个方面
@@ -287,7 +287,7 @@ $ docker run -v /host/path:/container/path:cached myapp
---
### 最佳实践
### 8.3.9 最佳实践
本节涵盖了相关内容与详细描述主要探讨以下几个方面

View File

@@ -1,4 +1,4 @@
## 本章小结
## 8.5 本章小结
相关信息如下表
@@ -10,7 +10,7 @@
| **适用场景** | 开发环境配置文件日志 |
| **vs Volume** | Bind 更灵活Volume 更适合生产 |
### 延伸阅读
### 8.5.1 延伸阅读
- [数据卷](volume.md)Docker 管理的持久化存储
- [tmpfs 挂载](tmpfs.md)内存临时存储
@@ -25,7 +25,7 @@
| 清理未用 | `docker volume prune` |
| 挂载数据卷 | `-v name:/path` `--mount source=name,target=/path` |
### 延伸阅读
### 8.5.2 延伸阅读
- [绑定挂载](bind-mounts.md)挂载宿主机目录
- [tmpfs 挂载](tmpfs.md)内存中的临时存储

View File

@@ -1,14 +1,14 @@
## tmpfs 挂载
## 8.4 tmpfs 挂载
`tmpfs` 挂载会把数据放在宿主机内存中而不是写入容器可写层或数据卷
### 适用场景
### 8.4.1 适用场景
- 临时缓存
- 会话数据
- 不希望落盘的敏感中间文件
### 基本用法
### 8.4.2 基本用法
如下代码块所示展示了相关示例
@@ -22,13 +22,13 @@ $ docker run --tmpfs /run:rw,noexec,nosuid,size=64m nginx
$ docker run --mount type=tmpfs,destination=/run,tmpfs-size=67108864 nginx
```
### 注意事项
### 8.4.3 注意事项
- 容器停止后`tmpfs` 数据会丢失
- `tmpfs` 占用宿主机内存建议显式限制大小
- 不适合需要持久化的数据
### Volume / Bind Mount 对比
### 8.4.4 Volume / Bind Mount 对比
相关信息如下表

View File

@@ -1,8 +1,8 @@
## 数据卷
## 8.2 数据卷
本节涵盖了相关内容与详细描述主要探讨以下几个方面
### 为什么需要数据卷
### 8.2.1 为什么需要数据卷
容器的存储层有一个关键问题**容器删除后数据就没了**
@@ -17,7 +17,7 @@ flowchart LR
---
### 数据卷的特性
### 8.2.2 数据卷的特性
相关信息如下表
@@ -31,7 +31,7 @@ flowchart LR
---
### 数据卷 vs 容器存储层
### 8.2.3 数据卷 vs 容器存储层
本节涵盖了相关内容与详细描述主要探讨以下几个方面
@@ -71,7 +71,7 @@ graph TD
---
### 数据卷基本操作
### 8.2.4 数据卷基本操作
本节涵盖了相关内容与详细描述主要探讨以下几个方面
@@ -121,7 +121,7 @@ $ docker volume inspect my-vol
---
### 挂载数据卷
### 8.2.5 挂载数据卷
本节涵盖了相关内容与详细描述主要探讨以下几个方面
@@ -187,7 +187,7 @@ $ docker run -d \
---
### 使用场景示例
### 8.2.6 使用场景示例
本节涵盖了相关内容与详细描述主要探讨以下几个方面
@@ -259,7 +259,7 @@ $ docker run -d \
---
### 数据卷管理
### 8.2.7 数据卷管理
本节涵盖了相关内容与详细描述主要探讨以下几个方面
@@ -299,7 +299,7 @@ $ docker volume prune -f
---
### 数据卷备份与恢复
### 8.2.8 数据卷备份与恢复
本节涵盖了相关内容与详细描述主要探讨以下几个方面
@@ -362,7 +362,7 @@ echo "Backed up ${VOLUME_NAME} to ${BACKUP_DIR}/${VOLUME_NAME}_${TIMESTAMP}.tar.
---
### 数据卷 vs 绑定挂载
### 8.2.9 数据卷 vs 绑定挂载
Docker 有两种主要的数据持久化方式
@@ -388,7 +388,7 @@ $ docker run -v /host/path:/app/data nginx
---
### 常见问题
### 8.2.10 常见问题
本节涵盖了相关内容与详细描述主要探讨以下几个方面