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

@@ -1,4 +1,4 @@
## etcd 集群
## 14.3 etcd 集群
下面我们使用 [Docker Compose](../../10_compose/README.md) 模拟启动一个 3 节点的 `etcd` 集群

View File

@@ -1,4 +1,4 @@
## 使用 etcdctl
## 14.4 使用 etcdctl
`etcdctl` 是一个命令行客户端它能提供一些简洁的命令供用户直接跟 `etcd` 服务打交道而无需基于 `HTTP API` 方式这在某些情况下将很方便例如用户对服务进行测试或者手动修改数据库内容我们也推荐在刚接触 `etcd` 时通过 `etcdctl` 命令来熟悉相关的操作这些操作跟 `HTTP API` 实际上是对应的
@@ -81,7 +81,7 @@ OPTIONS:
-w, --write-out="simple" set the output format (fields, json, protobuf, simple, table)
```
### 数据库操作
### 14.4.1 数据库操作
数据库操作围绕对键值和目录的 CRUD (符合 REST 风格的一套操作Create) 完整生命周期的管理
@@ -125,7 +125,7 @@ $ etcdctl del testkey
1
```
### 非数据库操作
### 14.4.2 非数据库操作
本节涵盖了相关内容与详细描述主要探讨以下几个方面

View File

@@ -1,4 +1,4 @@
## 安装
## 14.2 安装
本节将介绍 etcd 的几种常见安装方式包括二进制安装Docker 镜像运行以及在 macOS 上的安装
@@ -6,7 +6,7 @@
>注意本章节内容基于 etcd `3.4.x` 版本
### 二进制文件方式下载
### 14.2.1 二进制文件方式下载
编译好的二进制文件都在 [github.com/etcd-io/etcd/releases](https://github.com/etcd-io/etcd/releases/) 页面,用户可以选择需要的版本,或通过下载工具下载。
@@ -61,7 +61,7 @@ hello world
说明 etcd 服务已经成功启动了
### Docker 镜像方式运行
### 14.2.2 Docker 镜像方式运行
镜像名称为 `quay.io/coreos/etcd`可以通过下面的命令启动 `etcd` 服务监听到 `2379` `2380` 端口
@@ -89,7 +89,7 @@ quay.io/coreos/etcd:v3.4.0 \
打开新的终端按照上一步的方法测试 `etcd` 是否成功启动
### macOS 中运行
### 14.2.3 macOS 中运行
运行以下命令

View File

@@ -1,4 +1,4 @@
## 简介
## 14.1 简介
如图 12-5 所示etcd 项目使用该标识