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 @@
[`podman`](https://github.com/containers/podman) 是一个无守护进程、与 Docker 命令高度兼容的下一代 Linux 容器工具。它由 Red Hat 开发,旨在提供一个更安全的容器运行环境。
## Podman vs Docker
## 16.3 Podman vs Docker
Podman Docker 在设计理念上存在显著差异主要体现在架构和权限模型上
@@ -13,11 +13,11 @@ Podman 和 Docker 在设计理念上存在显著差异,主要体现在架构
| **生态** | 完整的生态系统 (Compose, Swarm) | 专注单机容器配合 Kubernetes 使用 |
| **镜像构建** | `docker build` | `podman build` `buildah` |
## 安装
## 16.3 安装
Podman 支持多种操作系统安装过程也相对简单
### CentOS / RHEL
### 16.3.1 CentOS / RHEL
运行以下命令
@@ -25,7 +25,7 @@ Podman 支持多种操作系统,安装过程也相对简单。
$ sudo yum -y install podman
```
### macOS
### 16.3.2 macOS
macOS 上需要安装 Podman Desktop 或通过 Homebrew 安装
@@ -35,11 +35,11 @@ $ podman machine init
$ podman machine start
```
## 使用
## 16.3 使用
`podman` 的命令行几乎与 `docker` 完全兼容大多数情况下你只需将 `docker` 替换为 `podman` 即可
### 运行容器
### 16.3.1 运行容器
运行以下命令
@@ -49,7 +49,7 @@ $ podman machine start
$ podman run -d -p 80:80 nginx:alpine
```
### 列出容器
### 16.3.2 列出容器
运行以下命令
@@ -57,7 +57,7 @@ $ podman run -d -p 80:80 nginx:alpine
$ podman ps
```
### 构建镜像
### 16.3.3 构建镜像
运行以下命令
@@ -65,7 +65,7 @@ $ podman ps
$ podman build -t myimage .
```
## Pods 的概念
## 16.3 Pods 的概念
Docker 不同Podman 支持 Pod 的概念 (类似于 Kubernetes Pod)允许你在同一个网络命名空间中运行多个容器
@@ -79,7 +79,7 @@ $ podman pod create --name mypod -p 8080:80
$ podman run -d --pod mypod --name webbing nginx
```
## 迁移到 Podman
## 16.3 迁移到 Podman
如果你习惯使用 `docker` 命令可以简单地设置别名
@@ -87,7 +87,7 @@ $ podman run -d --pod mypod --name webbing nginx
$ alias docker=podman
```
### 进阶用法
### 16.3.1 进阶用法
本节涵盖了相关内容与详细描述主要探讨以下几个方面
@@ -118,7 +118,7 @@ $ pip3 install podman-compose
$ podman-compose up -d
```
### 参考
### 16.3.2 参考
* [Podman 官方网站](https://podman.io/)
* [Podman GitHub 仓库](https://github.com/containers/podman)