mirror of
https://github.com/yeasy/docker_practice.git
synced 2026-03-11 04:14:38 +00:00
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:
@@ -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 查看标签
|
||||
|
||||
本节涵盖了相关内容与详细描述,主要探讨以下几个方面:
|
||||
|
||||
|
||||
Reference in New Issue
Block a user