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 @@
本节涵盖了相关内容与详细描述主要探讨以下几个方面
### 基本语法
### 7.14.1 基本语法
如下代码块所示展示了相关示例
@@ -14,7 +14,7 @@ LABEL <key>=<value> <key>=<value> ...
---
### 为什么需要 LABEL
### 7.14.2 为什么需要 LABEL
1. **版本管理**记录版本号构建时间Git Commit ID
2. **联系信息**维护者邮箱文档地址支持渠道
@@ -23,7 +23,7 @@ LABEL <key>=<value> <key>=<value> ...
---
### 基本用法
### 7.14.3 基本用法
本节涵盖了相关内容与详细描述主要探讨以下几个方面
@@ -51,7 +51,7 @@ LABEL maintainer="user@example.com" \
---
### 常用标签规范
### 7.14.4 常用标签规范
为了标准和互操作性推荐使用 [OCI Image Format Specification](https://github.com/opencontainers/image-spec/blob/main/annotations.md#pre-defined-annotation-keys) 定义的标准标签:
@@ -84,7 +84,7 @@ LABEL org.opencontainers.image.authors="yeasy" \
---
### MAINTAINER 指令 (已废弃)
### 7.14.5 MAINTAINER 指令 (已废弃)
旧版本的 Dockerfile 中常看到 `MAINTAINER` 指令
@@ -107,7 +107,7 @@ LABEL org.opencontainers.image.authors="user@example.com"
---
### 动态标签
### 7.14.6 动态标签
配合 `ARG` 使用可以在构建时动态注入标签
@@ -130,7 +130,7 @@ $ docker build \
---
### 查看标签
### 7.14.7 查看标签
本节涵盖了相关内容与详细描述主要探讨以下几个方面