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 @@
在生产环境中我们通常需要容器持续运行不受终端关闭的影响本节将深入讲解如何让容器在后台运行以及理解容器生命周期的核心概念
### 核心概念前台 vs 后台
### 5.2.1 核心概念前台 vs 后台
当你在终端运行一个程序时有两种模式
@@ -11,7 +11,7 @@
Docker 容器默认是 **前台运行** 使用 `-d` (detach) 参数可以让容器在后台运行
### 基本使用
### 5.2.2 基本使用
本节涵盖了相关内容与详细描述主要探讨以下几个方面
@@ -49,7 +49,7 @@ $ docker run -d ubuntu:24.04 /bin/sh -c "while true; do echo hello world; sleep
- 终端立即释放可以继续执行其他命令
- 输出不会直接显示 (需要用 `docker logs` 查看)
### 深入理解容器为什么会 立即退出
### 5.2.3 深入理解容器为什么会 立即退出
> **这是初学者最常遇到的困惑** 理解这个问题你就理解了 Docker 的核心设计理念
@@ -97,7 +97,7 @@ flowchart TD
| `docker run -d nginx` 后改了配置 | 配置错误导致 nginx 启动失败 | 查看 `docker logs` |
| 自定义镜像容器启动即退 | Dockerfile CMD 执行完毕 | 确保 CMD 是前台进程 |
### 查看后台容器
### 5.2.4 查看后台容器
本节涵盖了相关内容与详细描述主要探讨以下几个方面
@@ -139,7 +139,7 @@ $ docker container ls -a
加上 `-a` 参数可以看到所有容器包括已停止的这对于调试 容器启动即退出 的问题非常有用
### 最佳实践
### 5.2.5 最佳实践
本节涵盖了相关内容与详细描述主要探讨以下几个方面
@@ -205,7 +205,7 @@ $ docker logs -f myapp
$ docker logs -t myapp
```
### 常见问题排查
### 5.2.6 常见问题排查
本节涵盖了相关内容与详细描述主要探讨以下几个方面
@@ -252,7 +252,7 @@ $ docker attach mycontainer
> **注意**`attach` 会连接到容器的主进程如果主进程不是交互式的你可能只能看到输出使用 `Ctrl+P` `Ctrl+Q` 可以安全退出而不停止容器
### 延伸阅读
### 5.2.7 延伸阅读
- [进入容器](5.4_attach_exec.md)如何进入正在运行的容器执行命令
- [容器日志](../appendix/20.1_best_practices.md)生产环境的日志管理最佳实践