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

@@ -6,7 +6,7 @@
目前Docker Hub 自动构建已经支持 BuildKit具体请参考 https://github.com/docker-practice/docker-hub-buildx
### `Dockerfile` 新增指令详解
### 9.1.1 `Dockerfile` 新增指令详解
BuildKit 引入了多项新指令旨在优化构建缓存和安全性以下将详细介绍这些指令的用法
@@ -159,12 +159,12 @@ $ ssh-add ~/.ssh/id_rsa
$ docker build -t test --ssh default=$SSH_AUTH_SOCK .
```
### 使用 `docker compose build` BuildKit
### 9.1.2 使用 `docker compose build` BuildKit
Docker Compose 同样支持 BuildKit这使得多服务应用的构建更加高效
Docker 23.0 BuildKit 已默认启用无需额外配置如果使用旧版本可设置 `DOCKER_BUILDKIT=1` 环境变量启用
### 官方文档
### 9.1.3 官方文档
* https://github.com/moby/buildkit/blob/master/frontend/dockerfile/docs/experimental.md

View File

@@ -2,7 +2,7 @@
本节涵盖了相关内容与详细描述主要探讨以下几个方面
### 使用
### 9.2.1 使用
Buildx 的使用非常直观绝大多数情况下可以替代 `docker build` 命令
@@ -40,6 +40,6 @@ $ docker buildx build --sbom=true -t myimage .
该命令会在构建结果中包含 SPDX CycloneDX 格式的 SBOM 数据
### 官方文档
### 9.2.2 官方文档
* https://docs.docker.com/engine/reference/commandline/buildx/

View File

@@ -2,7 +2,7 @@
Docker 镜像可以支持多种系统架构这意味着你可以在 `x86_64``arm64` 等不同架构的机器上运行同一个镜像这是通过一个名为 manifest list (或称为 fat manifest) 的文件来实现的
### Manifest List 是什么
### 9.3.1 Manifest List 是什么
为了理解多架构镜像的原理我们需要先了解 Manifest List 的概念
@@ -40,7 +40,7 @@ $ docker manifest inspect hello-world
}
```
### 使用 `docker buildx` 构建多架构镜像
### 9.3.2 使用 `docker buildx` 构建多架构镜像
`docker buildx` 是构建多架构镜像的最佳实践工具它屏蔽了底层的复杂性提供了一键构建多架构镜像的能力
@@ -101,7 +101,7 @@ COPY bin/dist-${TARGETOS}-${TARGETARCH} /dist
ENTRYPOINT ["/dist"]
```
### 使用 `docker manifest` (底层工具)
### 9.3.3 使用 `docker manifest` (底层工具)
除了 `docker buildx`我们也可以直接操作 Manifest List 来手动组合不同架构的镜像