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 @@
本节涵盖了相关内容与详细描述主要探讨以下几个方面
## Docker 网络概述
## 8.6 Docker 网络概述
Docker 容器需要网络来
@@ -12,7 +12,7 @@ Docker 容器需要网络来:
Docker 在安装时会自动配置网络基础设施大多数情况下开箱即用
## 默认网络架构
## 8.6 默认网络架构
Docker 启动时自动创建以下网络组件
@@ -39,7 +39,7 @@ graph TD
Internet((互联网)) <--> eth0
```
### 核心组件
### 8.6.1 核心组件
相关信息如下表
@@ -50,7 +50,7 @@ graph TD
| **容器 eth0** | 容器内的网卡 |
| **IP 地址** | 自动从 172.17.0.0/16 网段分配 |
### 数据流向
### 8.6.2 数据流向
如下代码块所示展示了相关示例
@@ -74,7 +74,7 @@ flowchart LR
---
## Docker 网络类型
## 8.6 Docker 网络类型
查看默认网络
@@ -96,11 +96,11 @@ ghi789... none null local
---
## 用户自定义网络 (推荐)
## 8.6 用户自定义网络 (推荐)
本节涵盖了相关内容与详细描述主要探讨以下几个方面
### 为什么要用自定义网络
### 8.6.1 为什么要用自定义网络
默认 bridge 网络的局限
@@ -110,7 +110,7 @@ ghi789... none null local
| 所有容器在同一网络 | 更好的隔离性 |
| 需要 --link (已废弃)| 原生支持服务发现 |
### 创建自定义网络
### 8.6.2 创建自定义网络
运行以下命令
@@ -124,7 +124,7 @@ $ docker network create mynet
$ docker network inspect mynet
```
### 使用自定义网络
### 8.6.3 使用自定义网络
运行以下命令
@@ -141,7 +141,7 @@ PING db (172.18.0.3): 56 data bytes
64 bytes from 172.18.0.3: seq=0 ttl=64 time=0.083 ms
```
### 容器名 DNS 解析
### 8.6.4 容器名 DNS 解析
自定义网络自动提供 DNS 服务
@@ -155,11 +155,11 @@ flowchart LR
---
## 容器互联
## 8.6 容器互联
本节涵盖了相关内容与详细描述主要探讨以下几个方面
### 同一网络内的容器
### 8.6.1 同一网络内的容器
同一自定义网络内的容器可以直接通信
@@ -178,7 +178,7 @@ $ docker run -d --name app --network app-net myapp
...
```
### 连接到多个网络
### 8.6.2 连接到多个网络
一个容器可以连接到多个网络
@@ -196,7 +196,7 @@ $ docker network connect backend multi-net-container
$ docker inspect multi-net-container --format '{{json .NetworkSettings.Networks}}'
```
### --link 已废弃
### 8.6.3 --link 已废弃
运行以下命令
@@ -214,11 +214,11 @@ $ docker run --network mynet --name app myapp
---
## 端口映射
## 8.6 端口映射
容器默认只能在 Docker 网络内访问要从外部访问容器需要端口映射
### 基本语法
### 8.6.1 基本语法
运行以下命令
@@ -228,7 +228,7 @@ $ docker run --network mynet --name app myapp
$ docker run -d -p 8080:80 nginx
```
### 映射方式
### 8.6.2 映射方式
相关信息如下表
@@ -240,7 +240,7 @@ $ docker run -d -p 8080:80 nginx
| `-p 127.0.0.1:8080:80` | 只绑定本地 | 仅本机可访问 |
| `-p 8080:80/udp` | UDP 端口 | UDP 协议 |
### 查看端口映射
### 8.6.3 查看端口映射
运行以下命令
@@ -249,7 +249,7 @@ $ docker port mycontainer
80/tcp -> 0.0.0.0:8080
```
### 端口映射示意图
### 8.6.4 端口映射示意图
如下代码块所示展示了相关示例
@@ -261,7 +261,7 @@ flowchart TD
---
## 网络隔离
## 8.6 网络隔离
不同网络之间默认隔离
@@ -289,7 +289,7 @@ ping: db: Name or service not known
---
## 常用命令
## 8.6 常用命令
运行以下命令
@@ -325,7 +325,7 @@ $ docker network prune
---
## 本章小结
## 8.6 本章小结
相关信息如下表
@@ -337,7 +337,7 @@ $ docker network prune
| **网络隔离** | 不同网络默认隔离增强安全性 |
| **--link** | 已废弃使用自定义网络替代 |
## 延伸阅读
## 8.6 延伸阅读
- [配置 DNS](dns.md)自定义 DNS 设置
- [端口映射](port_mapping.md)高级端口配置