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

@@ -4,7 +4,7 @@
新建一个文件夹以下步骤均在该文件夹中进行
### 准备站点证书
### 6.3.1 准备站点证书
如果你拥有一个域名国内各大云服务商均提供免费的站点证书你也可以使用 `openssl` 自行签发证书
@@ -82,7 +82,7 @@ $ openssl x509 -req -days 750 -in "site.csr" -sha256 \
新建 `ssl` 文件夹并将 `docker.domain.com.key` `docker.domain.com.crt` `root-ca.crt` 这三个文件移入删除其他文件
### 配置私有仓库
### 6.3.2 配置私有仓库
私有仓库默认的配置文件位于 `/etc/docker/registry/config.yml`我们先在本地编辑 `config.yml`之后挂载到容器中
@@ -123,7 +123,7 @@ health:
threshold: 3
```
### 生成 http 认证文件
### 6.3.3 生成 http 认证文件
运行以下命令
@@ -138,7 +138,7 @@ $ docker run --rm \
> 将上面的 `username` `password` 替换为你自己的用户名和密码
### 编辑 Docker Compose 配置
### 6.3.4 编辑 Docker Compose 配置
编辑 `compose.yaml` ( `docker-compose.yml`) 配置如下
@@ -156,7 +156,7 @@ volumes:
registry-data:
```
### 修改 Hosts 文件
### 6.3.5 修改 Hosts 文件
编辑 `/etc/hosts`
@@ -164,7 +164,7 @@ volumes:
127.0.0.1 docker.domain.com
```
### 启动
### 6.3.6 启动
运行以下命令
@@ -174,7 +174,7 @@ $ docker compose up -d
这样我们就搭建好了一个具有权限认证TLS 的私有仓库接下来我们测试其功能是否正常
### 测试私有仓库功能
### 6.3.7 测试私有仓库功能
由于自行签发的 CA 根证书不被系统信任所以我们需要将 CA 根证书 `ssl/root-ca.crt` 移入 `/etc/docker/certs.d/docker.domain.com` 文件夹中
@@ -216,6 +216,6 @@ no basic auth credentials
发现会提示没有登录不能将镜像推送到私有仓库中
### 注意事项
### 6.3.8 注意事项
如果你本机占用了 `443` 端口你可以配置 [Nginx 代理](https://docs.docker.com/registry/recipes/nginx/),这里不再赘述。