Fix issue#20, format following the guidelines

Author: yeasy

README.md

@@ -1,45 +1,46 @@
 Docker —— 从入门到实践
 ===============
 
-v0.2.8
+v0.2.9
 
-[Docker](docker.com)是个伟大的项目，它彻底释放了虚拟化的威力，让应用的分发、部署和管理都变得前所未有的高效和轻松！
+[Docker](docker.com) 是个伟大的项目，它彻底释放了虚拟化的威力，让应用的分发、部署和管理都变得前所未有的高效和轻松！
 
-本书既适用于具备基础Linux知识的Docker初学者，也可供希望理解原理和实现的高级用户参考。同时，书中给出的实践案例，可供在进行实际部署时借鉴。
+本书既适用于具备基础 Linux 知识的 Docker 初学者，也可供希望理解原理和实现的高级用户参考。同时，书中给出的实践案例，可供在进行实际部署时借鉴。
 
-本书源于[WaitFish](github.com/qcpm1983)的《[Docker学习手册v1.0](https://github.com/yeasy/docker_practice/raw/master/_local/docker_manual_waitfish.pdf)》内容。后来，[yeasy](github.com/yeasy)
-根据最新Docker版本对内容进行了修订和重写，并增加了部分内容；与WaitFish协商，将所有内容开源，采用互联网合作的方式进行创作和维护。
+本书源于 [WaitFish](github.com/qcpm1983) 的《[Docker 学习手册 v1.0](https://github.com/yeasy/docker_practice/raw/master/_local/docker_manual_waitfish.pdf)》内容。后来，[yeasy](github.com/yeasy)
+根据最新 Docker 版本对内容进行了修订和重写，并增加内容；经协商将所有内容开源，采用互联网合作的方式进行维护。
 
-前六章为基础内容，供用户理解Docker的基本概念和操作；7~9章介绍一些高级操作；第10章给出典型的应用场景和实践案例；11~13章介绍关于Docker实现的相关技术。
+前六章为基础内容，供用户理解 Docker 的基本概念和操作；7 ~ 9 章介绍一些高级操作；第 10 章给出典型的应用场景和实践案例；11 ~ 13 章介绍关于 Docker 实现的相关技术。
 
-最新版本在线阅读：[GitBook](https://www.gitbook.io/book/yeasy/docker_practice)或[DockerPool](http://dockerpool.com/static/books/docker_practice/index.html)。
+最新版本在线阅读：[GitBook](https://www.gitbook.io/book/yeasy/docker_practice) 或 [DockerPool](http://dockerpool.com/static/books/docker_practice/index.html)。
 
-另外，欢迎加入DockerPool QQ群（341410255），分享Docker资源，交流Docker技术。
+另外，欢迎加入 DockerPool QQ 群（341410255），分享 Docker 资源，交流 Docker 技术。
 
 
-本书源码在Github上维护，欢迎参与： [https://github.com/yeasy/docker_practice](https://github.com/yeasy/docker_practice)
+本书源码在 Github 上维护，欢迎参与： [https://github.com/yeasy/docker_practice](https://github.com/yeasy/docker_practice)。
 
-感谢所有的[贡献者](https://github.com/yeasy/docker_practice/graphs/contributors)。
+感谢所有的 [贡献者](https://github.com/yeasy/docker_practice/graphs/contributors)。
 
 ## 主要版本历史
 * 0.3: 2014-10-TODO
     * 完成仓库章节；
     * 重写安全章节；
     * 修正底层实现章节的架构、名字空间、控制组、文件系统、容器格式等内容；
     * 添加对常见仓库和镜像的介绍；
-    * 添加Dockerfile的介绍。
+    * 添加 Dockerfile 的介绍；
+    * 重新校订中英文混排格式。
 * 0.2: 2014-09-18
     * 对照官方文档重写介绍、基本概念、安装、镜像、容器、仓库、数据管理、网络等章节；
     * 添加底层实现章节；
     * 添加命令查询和资源链接章节；
     * 其它修正。
 * 0.1: 2014-09-05
-    * 添加pdf文件内容;
+    * 添加基本内容;
     * 修正错别字和表达不通顺的地方。
 
 
 ## 参加步骤
-* 在GitHub上fork到自己的仓库，如docker_user/docker_practice，然后clone到本地，并设置用户信息。
+* 在 GitHub 上 `fork` 到自己的仓库，如 `docker_user/docker_practice`，然后 `clone` 到本地，并设置用户信息。
 ```
 $ git clone [email protected]:docker_user/docker_practice.git
 $ cd docker_practice
@@ -52,7 +53,7 @@ $ #do some change on the content
 $ git commit -am "Fix issue #1: change helo to hello"
 $ git push
 ```
-* 在GitHub网站上提交pull request。
+* 在 GitHub 网站上提交 pull request。
 * 定期使用项目仓库内容更新自己仓库内容。
 ```
 $ git remote add upstream https://github.com/yeasy/docker_practice

SUMMARY.md

@@ -1,9 +1,9 @@
 # Summary
 
 * [前言](README.md)
-* [Docker简介](introduction/README.md)
-   * [什么是Docker](introduction/what.md)
-   * [为什么要用Docker](introduction/why.md)
+* [Docker 简介](introduction/README.md)
+   * [什么是 Docker](introduction/what.md)
+   * [为什么要用 Docker](introduction/why.md)
 * [基本概念](basic_concept/README.md)
    * [镜像](basic_concept/internal.md)
    * [容器](basic_concept/container.md)
@@ -38,17 +38,17 @@
    * [容器互联](network/linking.md)
 * [高级网络配置](advanced_network/README.md)
    * [快速配置指南](advanced_network/quick_guide.md)
-   * [配置DNS](advanced_network/dns.md)
+   * [配置 DNS](advanced_network/dns.md)
    * [容器访问控制](advanced_network/access_control.md)
    * [端口映射实现](advanced_network/port_mapping.md)
-   * [配置docker0](advanced_network/docker0.md)
+   * [配置 docker0 网桥](advanced_network/docker0.md)
    * [自定义网桥](advanced_network/bridge.md)
    * [工具和示例](advanced_network/example.md)
    * [编辑网络配置文件](advanced_network/config_file.md)
    * [实例：创建一个点到点连接](advanced_network/ptp.md)
 * [实战案例](cases/README.md)
-   * [使用 Supervisor来管理进程](cases/supervisor.md)
-   * [创建tomcat/weblogic集群](cases/tomcat.md)
+   * [使用 Supervisor 来管理进程](cases/supervisor.md)
+   * [创建 tomcat/weblogic 集群](cases/tomcat.md)
    * [多台物理主机之间的容器互联](cases/container_connect.md)
    * [标准化开发测试和生产环境](cases/environment.md)
 * [安全](security/README.md)
@@ -66,7 +66,7 @@
    * [基本架构](underly/arch.md)
    * [名字空间](underly/namespace.md)
    * [控制组](underly/cgroups.md)
-   * [Union文件系统](underly/ufs.md)
+   * [Union 文件系统](underly/ufs.md)
    * [容器格式](underly/container_format.md)
    * [网络](underly/network.md)
 * [附录一：命令查询](appendix_command/README.md)

advanced_network/README.md

@@ -1,12 +1,12 @@
-#高级网络配置
-本章将介绍Docker的一些高级网络配置和选项。
+# 高级网络配置
+本章将介绍 Docker 的一些高级网络配置和选项。
 
-当Docker启动时，会自动在主机上创建一个`docker0`虚拟网桥，实际上是Linux的一个bridge，可以理解为一个软件交换机。它会在挂载到它的网口之间进行转发。
+当 Docker 启动时，会自动在主机上创建一个 `docker0` 虚拟网桥，实际上是 Linux 的一个 bridge，可以理解为一个软件交换机。它会在挂载到它的网口之间进行转发。
 
-同时，Docker随机分配一个本地未占用的私有网段（在[RFC1918](http://tools.ietf.org/html/rfc1918)中定义）中的一个地址给`docker0`接口。比如典型的`172.17.42.1`，掩码为`255.255.0.0`。此后启动的容器内的网口也会自动分配一个同一网段（`172.17.0.0/16`）的地址。
+同时，Docker 随机分配一个本地未占用的私有网段（在 [RFC1918](http://tools.ietf.org/html/rfc1918) 中定义）中的一个地址给 `docker0` 接口。比如典型的 `172.17.42.1`，掩码为 `255.255.0.0`。此后启动的容器内的网口也会自动分配一个同一网段（`172.17.0.0/16`）的地址。
 
-当创建一个Docker容器的时候，同时会创建了一对`veth pair`接口（当数据包发送到一个接口时，另外一个接口也可以收到相同的数据包）。这对接口一端在容器内，即`eth0`；另一端在本地并被挂载到`docker0`网桥，名称以`veth`开头（例如`vethAQI2QT`）。通过这种方式，主机可以跟容器通信，容器之间也可以相互通信。Docker就创建了在主机和所有容器之间一个虚拟共享网络。
+当创建一个 Docker 容器的时候，同时会创建了一对 `veth pair` 接口（当数据包发送到一个接口时，另外一个接口也可以收到相同的数据包）。这对接口一端在容器内，即 `eth0`；另一端在本地并被挂载到 `docker0` 网桥，名称以 `veth` 开头（例如 `vethAQI2QT`）。通过这种方式，主机可以跟容器通信，容器之间也可以相互通信。Docker 就创建了在主机和所有容器之间一个虚拟共享网络。
 
-![Docker网络](../_images/network.png)
+![Docker 网络](../_images/network.png)
 
-接下来的部分将介绍在一些场景中，docker所有的网络定制配置。linux的原生命令将调整、补充、甚至替换docker默认的网络配置。
+接下来的部分将介绍在一些场景中，Docker 所有的网络定制配置。以及通过 Linux 命令来调整、补充、甚至替换 Docker 默认的网络配置。

advanced_network/access_control.md

@@ -1,35 +1,35 @@
 ## 容器访问控制
-容器的访问控制，主要通过Linux上的`iptables`防火墙来进行管理和实现。`iptables`是Linux上默认的防火墙软件，在大部分发行版中都自带。
+容器的访问控制，主要通过 Linux 上的 `iptables` 防火墙来进行管理和实现。`iptables` 是 Linux 上默认的防火墙软件，在大部分发行版中都自带。
 
 ### 容器访问外部网络
-容器要想访问外部网络，需要本地系统的转发支持。在Linux系统中，检查转发是否打开。
+容器要想访问外部网络，需要本地系统的转发支持。在Linux 系统中，检查转发是否打开。
 
 ```
 $sysctl net.ipv4.ip_forward
 net.ipv4.ip_forward = 1
 ```
-如果为0，说明没有开启转发，则需要手动打开。
+如果为 0，说明没有开启转发，则需要手动打开。
 ```
 $sysctl -w net.ipv4.ip_forward=1
 ```
-如果在启动Docker服务的时候设定`--ip-forward=true`, Docker就会自动设定系统的`ip_forward`参数为1。
+如果在启动 Docker 服务的时候设定 `--ip-forward=true`, Docker 就会自动设定系统的 `ip_forward` 参数为 1。
 
 ### 容器之间访问
 容器之间相互访问，需要两方面的支持。
-* 容器的网络拓扑是否已经互联。默认情况下，所有容器都会被连接到`docker0`网桥上。
-* 本地系统的防火墙软件 -- `iptables`是否允许通过。
+* 容器的网络拓扑是否已经互联。默认情况下，所有容器都会被连接到 `docker0` 网桥上。
+* 本地系统的防火墙软件 -- `iptables` 是否允许通过。
 
 #### 访问所有端口
-当启动Docker服务时候，默认会添加一条转发策略到iptables的FORWARD链上。策略为通过（`ACCEPT`）还是禁止（`DROP`）取决于配置`--icc=true`（缺省值）还是`--icc=false`。当然，如果手动指定`--iptables=false`则不会添加`iptables`规则。
+当启动 Docker 服务时候，默认会添加一条转发策略到 iptables 的 FORWARD 链上。策略为通过（`ACCEPT`）还是禁止（`DROP`）取决于配置`--icc=true`（缺省值）还是 `--icc=false`。当然，如果手动指定 `--iptables=false` 则不会添加 `iptables` 规则。
 
-可见，默认情况下，不同容器之间是允许网络相互访问的。如果为了安全考虑，可以在`/etc/default/docker`文件中配置`DOCKER_OPTS=--icc=false`来禁止它。
+可见，默认情况下，不同容器之间是允许网络互通的。如果为了安全考虑，可以在 `/etc/default/docker` 文件中配置 `DOCKER_OPTS=--icc=false` 来禁止它。
 
 #### 访问指定端口
-在通过`-icc=false`关闭网络访问后，还可以通过`--link=CONTAINER_NAME:ALIAS`选项来访问容器的开放端口。
+在通过 `-icc=false` 关闭网络访问后，还可以通过 `--link=CONTAINER_NAME:ALIAS` 选项来访问容器的开放端口。
 
-例如，在启动Docker服务时，可以同时使用`icc=false --iptables=true`2个参数来关闭允许相互的网络访问，并让Docker可以修改系统中的`iptables`规则。
+例如，在启动 Docker 服务时，可以同时使用 `icc=false --iptables=true` 参数来关闭允许相互的网络访问，并让 Docker 可以修改系统中的 `iptables` 规则。
 
-此时，系统中的`iptables`规则可能是类似
+此时，系统中的 `iptables` 规则可能是类似
 ```
 $ sudo iptables -nL
 ...
@@ -39,9 +39,9 @@ DROP       all  --  0.0.0.0/0            0.0.0.0/0
 ...
 ```
 
-之后，启动容器（`docker run`）时使用`--link=CONTAINER_NAME:ALIAS`选项。docker会在`iptable`中为2个容器分别添加一条`ACCEPT`规则，允许相互访问开放的端口（取决于dockerfile中的EXPOSE行）。
+之后，启动容器（`docker run`）时使用 `--link=CONTAINER_NAME:ALIAS` 选项。Docker 会在 `iptable` 中为 两个容器分别添加一条 `ACCEPT` 规则，允许相互访问开放的端口（取决于 Dockerfile 中的 EXPOSE 行）。
 
-当添加了`--link=CONTAINER_NAME:ALIAS`选项后，添加了`iptables`规则。
+当添加了 `--link=CONTAINER_NAME:ALIAS` 选项后，添加了 `iptables` 规则。
 ```
 $ sudo iptables -nL
 ...
@@ -52,4 +52,4 @@ ACCEPT     tcp  --  172.17.0.3           172.17.0.2           tcp dpt:80
 DROP       all  --  0.0.0.0/0            0.0.0.0/0
 ```
 
-注意：`--link=CONTAINER_NAME:ALIAS`中的`CONTAINER_NAME`目前必须是Docker分配的名字，或使用`--name`参数指定的名字。主机名则不会被识别。
+注意：`--link=CONTAINER_NAME:ALIAS` 中的 `CONTAINER_NAME` 目前必须是 Docker 分配的名字，或使用 `--name` 参数指定的名字。主机名则不会被识别。

advanced_network/bridge.md

@@ -1,15 +1,15 @@
-##自定义网桥
-除了默认的`docker0`网桥，用户也可以指定网桥来连接各个容器。
+## 自定义网桥
+除了默认的 `docker0` 网桥，用户也可以指定网桥来连接各个容器。
 
-在启动Docker服务的时候，使用`-b BRIDGE`或`--bridge=BRIDGE`来指定使用的网桥。
+在启动 Docker 服务的时候，使用 `-b BRIDGE`或`--bridge=BRIDGE` 来指定使用的网桥。
 
 如果服务已经运行，那需要先停止服务，并删除旧的网桥。
 ```
 $ sudo service docker stop
 $ sudo ip link set dev docker0 down
 $ sudo brctl delbr docker0
 ```
-然后创建一个网桥`bridge0`。
+然后创建一个网桥 `bridge0`。
 ```
 $ sudo brctl addbr bridge0
 $ sudo ip addr add 192.168.5.1/24 dev bridge0
@@ -23,12 +23,12 @@ $ ip addr show bridge0
     inet 192.168.5.1/24 scope global bridge0
        valid_lft forever preferred_lft forever
 ```
-配置Docker服务，默认桥接到创建的网桥上。
+配置 Docker 服务，默认桥接到创建的网桥上。
 ```
 $ echo 'DOCKER_OPTS="-b=bridge0"' >> /etc/default/docker
 $ sudo service docker start
 ```
-启动Docker服务。
-新建一个容器，可以看到它已经桥接到了`bridge0`上。
+启动 Docker 服务。
+新建一个容器，可以看到它已经桥接到了 `bridge0` 上。
 
-可以继续用`brctl show`命令查看桥接的信息。另外，在容器中可以使用`ip addr`和`ip route`命令来查看ip地址配置和路由信息。
+可以继续用 `brctl show` 命令查看桥接的信息。另外，在容器中可以使用 `ip addr` 和 `ip route` 命令来查看 IP 地址配置和路由信息。

advanced_network/config_file.md

@@ -1,5 +1,5 @@
 ## 编辑网络配置文件
 
-Docker 1.2.0开始支持在运行中的容器里编辑`/etc/hosts`, `/etc/hostname`和`/etc/resolve.conf`文件。
+Docker 1.2.0 开始支持在运行中的容器里编辑 `/etc/hosts`, `/etc/hostname` 和 `/etc/resolve.conf` 文件。
 
-但是这些修改是临时的，只在运行的容器中保留，容器终止或重启后并不会被保存下来。也不会被`docker commit`提交。
+但是这些修改是临时的，只在运行的容器中保留，容器终止或重启后并不会被保存下来。也不会被 `docker commit` 提交。

advanced_network/dns.md

@@ -1,8 +1,8 @@
-##配置DNS
-Docker没有每个容器专门定制镜像，那么怎么自定义配置容器的主机名和dns配置呢？
-秘诀就是它利用虚拟文件来挂载到来容器的3个相关配置文件。
+## 配置 DNS
+Docker 没有每个容器专门定制镜像，那么怎么自定义配置容器的主机名和 DNS 配置呢？
+秘诀就是它利用虚拟文件来挂载到来容器的 3 个相关配置文件。
 
-在容器中使用mount命令可以看到挂载信息：
+在容器中使用 mount 命令可以看到挂载信息：
 ```
 $ mount
 ...
@@ -11,19 +11,19 @@ $ mount
 tmpfs on /etc/resolv.conf type tmpfs ...
 ...
 ```
-这种机制可以让宿主主机DNS信息发生更新后，所有Docker容器的dns配置通过`/etc/resolv.conf`文件立刻得到更新。
+这种机制可以让宿主主机 DNS 信息发生更新后，所有 Docker 容器的 dns 配置通过 `/etc/resolv.conf` 文件立刻得到更新。
 
 如果用户想要手动指定容器的配置，可以利用下面的选项。
 
 `-h HOSTNAME or --hostname=HOSTNAME`
-设定容器的主机名，它会被写到容器内的`/etc/hostname`和`/etc/hosts`。但它在容器外部看不到，既不会在`docker ps`中显示，也不会在其他的容器的`/etc/hosts`看到。
+设定容器的主机名，它会被写到容器内的 `/etc/hostname` 和 `/etc/hosts`。但它在容器外部看不到，既不会在 `docker ps` 中显示，也不会在其他的容器的 `/etc/hosts` 看到。
 
 `--link=CONTAINER_NAME:ALIAS`
-选项会在创建容器的时候，添加一个其他容器的主机名到`/etc/hosts`文件中，让新容器的进程可以使用主机名ALIAS就可以连接它。
+选项会在创建容器的时候，添加一个其他容器的主机名到 `/etc/hosts` 文件中，让新容器的进程可以使用主机名 ALIAS 就可以连接它。
 
 `--dns=IP_ADDRESS`
-添加dns服务器到容器的`/etc/resolv.conf`中，让容器用这ip地址来解析所有不在`/etc/hosts`中的主机名。
+添加 DNS 服务器到容器的 `/etc/resolv.conf` 中，让容器用这个服务器来解析所有不在 `/etc/hosts` 中的主机名。
 
 `--dns-search=DOMAIN`
-设定容器的搜索域，当设定搜索域为`.example.com`时，在搜索一个名为host的主机时，dns不仅搜索host，还会搜索`host.example.com`。
-注意：如果没有上述最后2个选项，Docker会默认用主机上的`/etc/resolv.conf`来配置容器。
+设定容器的搜索域，当设定搜索域为 `.example.com` 时，在搜索一个名为 host 的主机时，DNS 不仅搜索host，还会搜索 `host.example.com`。
+注意：如果没有上述最后 2 个选项，Docker 会默认用主机上的 `/etc/resolv.conf` 来配置容器。