From 5a6a50ba9742d1fcaed3ea41a765b03d618ff2d3 Mon Sep 17 00:00:00 2001 From: yeasy Date: Sat, 28 Mar 2026 18:19:49 -0700 Subject: [PATCH] Refine appendix navigation --- CHANGELOG.md | 5 +++++ README.md | 2 +- appendix/README.md | 17 +++++++++-------- appendix/repo/README.md | 15 ++++++++++++++- appendix/resources.md | 42 +++++++++++++++++++---------------------- package.json | 2 +- 6 files changed, 49 insertions(+), 34 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 99966ad..c850be1 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,10 @@ # 修订记录 +* 1.7.1 2026-03-28 + * 对齐附录首页与目录结构，补全学习路线入口 + * 重组资源链接页，统一官方一手入口 + * 完善附录二导航页，提升热门镜像查阅体验 + * 1.7.0 2026-03-25 * 精简 CI 流程，移除遗留的 vuepress 构建，统一使用 mdpress * 升级 etcd 集群示例从 v3.4.0 到 v3.5.17 diff --git a/README.md b/README.md index 33af752..61033b1 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ [![图](https://img.shields.io/github/stars/yeasy/docker_practice.svg?style=social&label=Stars)](https://github.com/yeasy/docker_practice) [![图](https://img.shields.io/github/release/yeasy/docker_practice/all.svg)](https://github.com/yeasy/docker_practice/releases) [![图](https://img.shields.io/badge/Based-Docker%20Engine%20v29.x-blue.svg)](https://docs.docker.com/engine/release-notes/) [![图](https://img.shields.io/badge/Docker%20%E6%8A%80%E6%9C%AF%E5%85%A5%E9%97%A8%E4%B8%8E%E5%AE%9E%E6%88%98-jd.com-red.svg)][1] -[**v1.7.0**](https://github.com/yeasy/docker_practice/releases/tag/v1.7.0) | [PDF 下载](https://github.com/yeasy/docker_practice/releases/latest) +[**v1.7.1**](https://github.com/yeasy/docker_practice/releases/tag/v1.7.1) | [PDF 下载](https://github.com/yeasy/docker_practice/releases/latest) ## 下载离线版本 diff --git a/appendix/README.md b/appendix/README.md index a0c0fce..91de4d5 100644 --- a/appendix/README.md +++ b/appendix/README.md @@ -1,13 +1,14 @@ # 附录 -本章包含了 Docker 相关的参考资料、常见问题解答以及最佳实践指南，旨在为读者提供便捷的查阅工具。 +本附录汇总了 Docker 相关的常见问题、镜像参考、命令速查、最佳实践、调试方法、官方资源、术语表与学习路线，便于按需查阅。 ## 目录 -* [**常见问题总结 (FAQ)**](faq/README.md)：汇总了学习和使用 Docker 过程中的常见问题与错误解决方案。 -* [**热门镜像介绍**](repo/README.md)：详细介绍了 Nginx，MySQL，Redis 等常用官方镜像的使用方法。 -* [**Docker 命令查询**](command/README.md)：速查 Docker 客户端和服务端的常用命令。 -* [**Dockerfile 最佳实践**](best_practices.md)：提供编写高效、安全 Dockerfile 的指导原则。 -* [**如何调试 Docker**](debug.md)：介绍 Docker 调试技巧和工具。 -* [**资源链接**](resources.md)：推荐更多 Docker 相关的学习资源。 -* [**术语词表**](glossary.md)：统一全书中英文术语、缩写与命令写法。 +* [**附录一：常见问题与错误速查**](faq/README.md)：汇总学习和使用 Docker 过程中的常见问题与错误解决方案。 +* [**附录二：热门镜像介绍**](repo/README.md)：介绍常用官方镜像的用途、基本用法与适用场景。 +* [**附录三：Docker 命令查询**](command/README.md)：速查 Docker 客户端和服务端的常用命令。 +* [**附录四：Dockerfile 最佳实践**](best_practices.md)：提供编写高效、安全 Dockerfile 的指导原则。 +* [**附录五：如何调试 Docker**](debug.md)：介绍 Docker 调试技巧和工具。 +* [**附录六：资源链接**](resources.md)：提供官方文档、发布页和参考入口。 +* [**附录七：术语表**](glossary.md)：统一全书中英文术语、缩写与命令写法。 +* [**附录八：Docker 学习路线图与知识体系**](learning_roadmap.md)：给出阶段化学习路径和知识地图。 diff --git a/appendix/repo/README.md b/appendix/repo/README.md index 592ffb1..941110c 100644 --- a/appendix/repo/README.md +++ b/appendix/repo/README.md @@ -1,3 +1,16 @@ # 附录二：热门镜像介绍 -本章将介绍一些热门镜像的功能，使用方法等。包括 Ubuntu、CentOS、MySQL、MongoDB、Redis、Nginx、Wordpress、Node.js 等。 +本附录介绍常用官方镜像的用途、基本用法与适用场景，便于快速查阅。 + +## 目录 + +* [Ubuntu](ubuntu.md)：Ubuntu 官方镜像的使用方法。 +* [CentOS](centos.md)：CentOS 镜像与替代发行版的说明。 +* [Nginx](nginx.md)：Nginx 官方镜像的使用方法。 +* [PHP](php.md)：PHP 官方镜像的使用方法。 +* [Node.js](nodejs.md)：Node.js 官方镜像的使用方法。 +* [MySQL](mysql.md)：MySQL 官方镜像的使用方法。 +* [WordPress](wordpress.md)：WordPress 官方镜像的使用方法。 +* [MongoDB](mongodb.md)：MongoDB 官方镜像的使用方法。 +* [Redis](redis.md)：Redis 官方镜像的使用方法。 +* [MinIO](minio.md)：MinIO 官方镜像的使用方法。 diff --git a/appendix/resources.md b/appendix/resources.md index 21cd88c..eeedb7e 100644 --- a/appendix/resources.md +++ b/appendix/resources.md @@ -1,29 +1,25 @@ ## 附录六：资源链接 -### 官方网站 +本页只保留适合作为一手核验入口的官方资源，便于查版本、查命令、查发布说明和查最佳实践。 -* [Docker 官方主页](https://www.docker.com) -* [Docker 官方博客](https://www.docker.com/blog/) -* [Docker 官方文档](https://docs.docker.com/) -* [Docker Hub](https://hub.docker.com) -* [Docker 源代码仓库](https://github.com/moby/moby) -* [Docker 路线图](https://github.com/docker/roadmap/projects) -* [Docker 发布版本历史](https://docs.docker.com/release-notes/) -* [Docker 常见问题](https://docs.docker.com/engine/faq/) +### 官方入口 + +* [Docker 文档](https://docs.docker.com/) +* [Docker 入门指南](https://docs.docker.com/get-started/) +* [Docker 发行说明](https://docs.docker.com/engine/release-notes/) +* [Docker Desktop 发行说明](https://docs.docker.com/desktop/release-notes/) +* [Docker Compose 安装](https://docs.docker.com/compose/install/) +* [Docker Hub 文档](https://docs.docker.com/docker-hub/) +* [Docker Blog](https://www.docker.com/blog/) +* [Docker Roadmap](https://github.com/docker/roadmap) + +### 参考文档 + +* [Docker CLI 参考](https://docs.docker.com/engine/reference/commandline/docker/) +* [Dockerfile 参考](https://docs.docker.com/reference/dockerfile/) +* [Docker 构建最佳实践](https://docs.docker.com/build/building/best-practices/) * [Docker 远端应用 API](https://docs.docker.com/develop/sdk/) -### 实践参考 +### 源码仓库 -* [Dockerfile 参考](https://docs.docker.com/engine/reference/builder/) -* [Dockerfile 最佳实践](https://docs.docker.com/build/building/best-practices/) - -### 技术交流 - -* [Docker 邮件列表](https://groups.google.com/forum/#!forum/docker-user) -* [Docker 社区 Slack](https://dockercommunity.slack.com/) -* [Docker Community Discord](https://discord.gg/docker) -* [Docker 的 X (Twitter) 主页](https://twitter.com/docker) - -### 其它 - -* [Docker 的 StackOverflow 问答主页](https://stackoverflow.com/search?q=docker) +* [Moby 源代码仓库](https://github.com/moby/moby) diff --git a/package.json b/package.json index 19a6aae..e7a9a63 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "docker_practice", - "version": "1.7.0", + "version": "1.7.1", "description": "docker_practice", "main": "index.js", "devDependencies": {