Complete proofreading

Author: ulivz

Diff for: docs/guide/README.md

@@ -30,7 +30,6 @@ Each markdown file is compiled into HTML with [markdown-it](https://github.com/m
 
 VuePress is still a work in progress. There are a few things that it currently does not support but are planned:
 
-- Multi-Language Support
 - Algolia DocSearch Integration
 - Blogging support
 

Diff for: docs/zh/README.md

@@ -20,7 +20,7 @@ footer: MIT Licensed | Copyright © 2018-present Evan You
 yarn global add vuepress # 或者：npm install -g vuepress
 
 # 新建一个 markdown 文件
-echo "# Hello VuePress!" > README.md
+echo '# Hello VuePress!' > README.md
 
 # 开始写作
 vuepress dev .
@@ -30,5 +30,5 @@ vuepress build .
 ```
 
 ::: warning NODE VERSION
-请确保你的 Node.js 的版本大于 8。
+请确保你 Node.js 的版本大于 8。
 :::

Diff for: docs/zh/config/README.md

@@ -90,7 +90,7 @@ module.exports = {
 当然，仅仅只在你的网站部署后能用 SSL 的时候开启它，因为 service worker 只能在 HTTPs 的链接下注册。
 :::
 
-## Theming
+## 主题
 
 ### theme
 
@@ -143,7 +143,7 @@ module.exports = {
 }
 ```
 
-## Build Pipeline
+## 构建流程
 
 ### postcss
 
@@ -184,7 +184,7 @@ module.exports = {
 }
 ```
 
-## Browser Compatibility
+## 浏览器兼容性
 
 ### evergreen
 

Diff for: docs/zh/default-theme-config/README.md

@@ -8,9 +8,9 @@ sidebar: auto
 所有列在这一页的选项仅对默认的主题生效。如果你在使用一个自定义主题，选项可能会有不同。
 :::
 
-## Homepage
+## 首页
 
-默认的主题提供了一个 homepage 的布局 (用于 [这个网站的主页](/zh/))。想要使用它，需要在你的根级 `README.md` 的 [YAML front matter](../guide/markdown.html#yaml-front-matter) 指定 `home: true`。以下是这个网站实际使用的数据：
+默认的主题提供了一个首页（Homepage）的布局 (用于 [这个网站的主页](/zh/))。想要使用它，需要在你的根级 `README.md` 的 [YAML front matter](../guide/markdown.md#yaml-front-matter) 指定 `home: true`。以下是这个网站实际使用的数据：
 
 ``` yaml
 ---
@@ -31,7 +31,7 @@ footer: MIT Licensed | Copyright © 2018-present Evan You
 
 任何 `YAML front matter` 之后额外的内容将会以普通的 markdown 被渲染，并插入到 `features` 的后面。
 
-## Navbar Links
+## 导航栏
 
 你可以通过 `themeConfig.nav` 增加一些导航链接:
 
@@ -81,9 +81,9 @@ module.exports = {
 }
 ```
 
-## Sidebar
+## 侧边栏
 
-想要使 sidebar 生效，需要设置 `themeConfig.sidebar`，基本的配置，需要一个包含了多个链接的数组：
+想要使 侧边栏（Sidebar）生效，需要配置 `themeConfig.sidebar`，基本的配置，需要一个包含了多个链接的数组：
 
 ``` js
 // .vuepress/config.js
@@ -100,9 +100,9 @@ module.exports = {
 
 你可以省略 `.md` 拓展名，同时以 `/` 结尾的路径将会被视为 `*/README.md`，这个链接的文字将会被自动获取到（无论你是声明为页面的第一个 header，还是明确地在 `YAML front matter` 中指定页面的标题）。如果你想要显示地指定链接的文字，使用一个格式为 `[link, text]` 的数组。
 
-### Nested Header Links
+### 嵌套的标题链接
 
-默认情况下，侧边栏（sidebar）会自动地显示由当前页面标的题（headers）组成的的链接，并按照页面本身的结构进行嵌套，你可以通过 `themeConfig.sidebarDepth` 来修改它的行为。默认的深度是 `1`，它将提取到 `h2` 的标题，设置成 `0` 将会禁用标题（headers）链接，同时，最大的深度为 `2`，它将同时提取 `h2` 和 `h3` 标题。
+默认情况下，侧边栏会自动地显示由当前页面标的题（headers）组成的的链接，并按照页面本身的结构进行嵌套，你可以通过 `themeConfig.sidebarDepth` 来修改它的行为。默认的深度是 `1`，它将提取到 `h2` 的标题，设置成 `0` 将会禁用标题（headers）链接，同时，最大的深度为 `2`，它将同时提取 `h2` 和 `h3` 标题。
 
 也可以使用 `YAML front matter` 来为某个页面重写此值：
 
@@ -112,9 +112,9 @@ sidebarDepth: 2
 ---
 ```
 
-### Sidebar Groups
+### 侧边栏分组
 
-你可以通过使用**对象**来将侧边栏（sidebar）划分成多个组：
+你可以通过使用**对象**来将侧边栏划分成多个组：
 
 ``` js
 // .vuepress/config.js
@@ -137,11 +137,11 @@ module.exports = {
 }
 ```
 
-侧边栏（sidebar）的组默认是可折叠的，你可以设置 `collapsable: false` 来让一个组永远都是展开状态。
+侧边栏的每个子组默认是可折叠的，你可以设置 `collapsable: false` 来让一个组永远都是展开状态。
 
-### Multiple Sidebars
+### 多个侧边栏
 
-如果你想为不同的页面组来显示不同的侧边栏（sidebar），首先，将你的页面文件组织成下述的目录结构：
+如果你想为不同的页面组来显示不同的侧边栏，首先，将你的页面文件组织成下述的目录结构：
 
 ```
 .
@@ -156,7 +156,7 @@ module.exports = {
    └─ four.md
 ```
 
-接着，遵循以下的侧边栏（sidebar）配置：
+接着，遵循以下的侧边栏配置：
 
 ``` js
 // .vuepress/config.js
@@ -180,29 +180,29 @@ module.exports = {
 }
 ```
 
-### Auto Sidebar for Single Pages
+### 自动生成侧栏
 
-如果你希望自动生成一个仅仅包含了当前页面标题（header）链接的侧边栏（sidebar），你可以通过 `YAML front matter` 来实现：
+如果你希望自动生成一个仅仅包含了当前页面标题（headers）链接的侧边栏，你可以通过 `YAML front matter` 来实现：
 
 ``` yaml
 ---
 sidebar: auto
 ---
 ```
 
-### Disabling the Sidebar
+### 禁用侧边栏
 
-你可以通过 `YAML front matter` 来禁用指定页面的侧边栏（sidebar）：
+你可以通过 `YAML front matter` 来禁用指定页面的侧边栏：
 
 ``` yaml
 ---
 sidebar: false
 ---
 ```
 
-## Prev / Next Links
+## 上 / 下一篇链接
 
-上一篇和下一篇文章的链接将会自动地根据当前页面的侧边栏（sidebar）的顺序来获取。你也可以使用 `YAML front matter` 来明确地重写或者禁用它：
+上一篇和下一篇文章的链接将会自动地根据当前页面的侧边栏的顺序来获取。你也可以使用 `YAML front matter` 来明确地重写或者禁用它：
 
 ``` yaml
 ---
@@ -211,7 +211,7 @@ next: false
 ---
 ```
 
-## GitHub Repo and Edit Links
+## Github 和编辑链接
 
 当你提供了 `themeConfig.repo` 选项，将会自动在每个页面的导航栏生成生成一个 GitHub 链接，以及在页面的底部生成一个 `"Edit this page"` 链接。
 
@@ -231,7 +231,7 @@ module.exports = {
 }
 ```
 
-## Simple CSS Override
+## 简单的 CSS 覆盖
 
 如果你只是希望应用一些简单的 overrides 到默认主题的样式上，你可以创建一个 `.vuepress/override.styl` 文件，这是一个 [Stylus](http://stylus-lang.com/) 文件，但是你仍然可以使用普通的 CSS 语法。
 
@@ -245,9 +245,9 @@ $borderColor = #eaecef
 $codeBgColor = #282c34
 ```
 
-## Custom Layout for Specific Pages
+## 特定页面的自定义布局
 
-默认情况下，每个 `*.md` 文件将会被渲染在一个 `<div class="page">` 容器中，同时还有侧边栏（sidebar）、自动生成的编辑链接，以及上一篇 / 下一篇文章的链接。如果你想要使用一个完全自定义的组件来代替当前的页面（而只保留导航栏），你可以再次使用 `YAML front matter` 来指定这个组件。
+默认情况下，每个 `*.md` 文件将会被渲染在一个 `<div class="page">` 容器中，同时还有侧边栏、自动生成的编辑链接，以及上 / 下一篇文章的链接。如果你想要使用一个完全自定义的组件来代替当前的页面（而只保留导航栏），你可以再次使用 `YAML front matter` 来指定这个组件。
 
 ``` yaml
 ---

Diff for: docs/zh/guide/README.md

@@ -1,8 +1,8 @@
 # 介绍
 
-VuePress 由两部分组成：一个是由 Vue 驱动的极简主题系统带来的静态网站生成器，一个是为书写技术而优化的默认主题，它的诞生初衷是为了助力 Vue 及其子项目书写文档的需求。
+VuePress 由两部分组成：一个是由 Vue 驱动的极简主题系统带来的静态网站生成器，一个是为书写技术文档而优化的默认主题，它的诞生初衷是为了助力 Vue 及其子项目书写文档的需求。
 
-每一个由 VuePress 生成的页面都有自己预渲染好的 HTML，因此带来了非常好的加载性能和搜索引擎优化（SEO）。同时，一旦页面被加载，Vue 将接管这些静态内容，并将其转换成一个完整的单页应用程序（SPA），其他的页面都将在用户浏览到的时候按需加载。
+每一个由 VuePress 生成的页面都有自己预渲染好的 HTML，也因此带来了非常好的加载性能和搜索引擎优化（SEO）。同时，一旦页面被加载，Vue 将接管这些静态内容，并将其转换成一个完整的单页应用（SPA），其他的页面都将在用户浏览到的时候按需加载。
 
 ## 它是如何工作的？
 
@@ -14,7 +14,7 @@ VuePress 由两部分组成：一个是由 Vue 驱动的极简主题系统带来
 
 - [内置的 Markdown 拓展](./markdown.md)，为技术文档而生
 - [在 Markdown 文件使用 Vue 组件的能力](./using-vue.md)
-- [Vue 驱动的自定义主题系统](./custom-themes)
+- [Vue 驱动的自定义主题系统](./custom-themes.md)
 - 支持 PWA
 - 集成了 Google Analytics
 - 一个默认的主题包含：
@@ -24,13 +24,12 @@ VuePress 由两部分组成：一个是由 Vue 驱动的极简主题系统带来
   - 可以自定义的导航栏（navbar）和侧边栏（sidebar）
   - 自动生成的 GitHub 链接和页面的编辑链接
 
-## Todo Features
+## Todo
 
 VuePress 仍然处于开发中，这里有一些目前还不支持、但已经在计划中的特性：
 
-- 多语言的支持
-- 集成 Algolia DocSearch 
-- 对博客的支持
+- Algolia DocSearch 的集成
+- 博客系统
 
 欢迎你的 Contribution！
 

Diff for: docs/zh/guide/assets.md

@@ -1,8 +1,8 @@
 # 静态资源
 
-## Relative URLs
+## 相对路径
 
-所有的 Markdown 文件都会被 webpack 编译成 Vue 组件，因此你可以，并且**应该更倾向于**使用相对路径来引用所有的静态资源：
+所有的 Markdown 文件都会被 webpack 编译成 Vue 组件，因此你可以，并且**应该更倾向于**使用相对路径（Relative URLs）来引用所有的静态资源：
 
 ``` md
 ![An image](./image.png)
@@ -31,20 +31,20 @@ module.exports = {
 }
 ```
 
-## Public Files
+## 公共文件
 
 有时，你可能需要提供一个静态资源，但是它们并不直接被你的任何一个 markdown 文件或者主题组件引用 —— 举例来说，favicons 和 PWA 的图标，在这种情形下，你可以将它们放在 `.vuepress/public` 中， 它们最终会被复制到生成的静态文件夹中。
 
-## Base URL
+## 基础路径
 
 如果你的网站会被部署到一个**非根路径**，你将需要在 `.vuepress/config.js` 中设置 `base`，举例来说，如果你打算将你的网站部署到 `https://foo.github.io/bar/`，那么 `base` 的值就应该被设置为 `"/bar/"` (应当总是以斜杠开始，并以斜杠结束)。
 
-有了基础路径，如果你希望引用一张放在 `.vuepress/public` 中的图片，你需要使用这样路径：`/bar/image.png`，然而，一旦某一天你决定去修改 `base`，这样的路径引用将会显得异常脆弱。为了解决这个问题，VuePress 提供了内置的一个 helper `$withBase`（它被注入到了 Vue 的原型上），可以帮助你生成正确的路径：
+有了基础路径（Base URL），如果你希望引用一张放在 `.vuepress/public` 中的图片，你需要使用这样路径：`/bar/image.png`，然而，一旦某一天你决定去修改 `base`，这样的路径引用将会显得异常脆弱。为了解决这个问题，VuePress 提供了内置的一个 helper `$withBase`（它被注入到了 Vue 的原型上），可以帮助你生成正确的路径：
 
 ``` vue
 <img :src="$withBase('/foo.png')" alt="foo">
 ```
 
-值得一提的是，你不仅可以在你组件中使用上述的语法，在 Markdown 文件中亦是如此。
+值得一提的是，你不仅可以在你的 Vue 组件中使用上述的语法，在 Markdown 文件中亦是如此。
 
-补充一句，一个 `base` 路径一旦被设置，它将会自动地作为前缀插入到 `.vuepress/config.js` 中所有以 `/` 开始的资源路径中。
+最后补充一句，一个 `base` 路径一旦被设置，它将会自动地作为前缀插入到 `.vuepress/config.js` 中所有以 `/` 开始的资源路径中。

Diff for: docs/zh/guide/basic-config.md

@@ -2,7 +2,7 @@
 
 ## 配置文件
 
-如果没有任何配置，这个网站将会是非常局限的，用户也无法在你的网站上自由导航。为了更好地自定义你的网站，让我们首先在你的文档目录下创建一个 `.vuepress` 目录，所有 VuePress 相关的文件将会被放在这里。
+如果没有任何配置，这个网站将会是非常局限的，用户也无法在你的网站上自由导航。为了更好地自定义你的网站，让我们首先在你的文档目录下创建一个 `.vuepress` 目录，所有 VuePress 相关的文件都将会被放在这里。
 
 一个 VuePress 网站必要的配置文件是 `.vuepress/config.js`，它应该导出一个 JavaScript 对象：
 
@@ -13,21 +13,21 @@ module.exports = {
 }
 ```
 
-如果你运行起开发服务器，你应该能看到一个页面，它包含一个页头，里面包含一个标题和一个搜索框。VuePress 内置了基于 headers 的搜索 —— 它自动为所有页面的标题(`h1`，或者是通过 `YAML front matter` 设置的 `title`)、`h2` 和 `h3` 构建了一个简单的搜索索引。
+对于上述的配置，如果你运行起 dev server，你应该能看到一个页面，它包含一个页头，里面包含一个标题和一个搜索框。VuePress 内置了基于 headers 的搜索 —— 它会自动为所有页面的标题、`h2` 和 `h3` 构建起一个简单的搜索索引。
 
 参见 [配置](../config/) 来查看所有可配置的选项。 
 
 
 ## 主题配置
 
-一个 VuePress 主题应该负责整个网站的布局和交互细节。VuePress 自带了一个默认的主题（正是你现在所看到的），它是为技术文档而设计的。同时，默认主题提供了一些选项，让你可以去自定义导航栏（navbar）、 侧边栏（sidebar）和 homepage 等，详情请参见 [默认主题](../default-theme-config/) 。
+一个 VuePress 主题应该负责整个网站的布局和交互细节。在 VuePress 中，目前自带了一个默认的主题（正是你现在所看到的），它是为技术文档而设计的。同时，默认主题提供了一些选项，让你可以去自定义导航栏（navbar）、 侧边栏（sidebar）和 首页（homepage） 等，详情请参见 [默认主题](../default-theme-config/) 。
 
 如果你想开发一个自定义主题，可以参考 [自定义主题](./custom-themes.md)。
 
 
 ## 应用级别的优化
 
-由于 VuePress 是一个标准的 Vue 应用，你可以通过创建一个 `.vuepress/enhanceApp.js` 文件来做一些应用级别的优化，当该文件存在的时候，会被导入到应用内部。`enhanceApp.js` 应该 `export default` 一个钩子函数，并接受一个包含了一些应用级别属性的对象作为参数。你可以使用这个钩子来安装一些附加的 Vue 插件，注册全局组件，或者增加额外的路由钩子等：
+由于 VuePress 是一个标准的 Vue 应用，你可以通过创建一个 `.vuepress/enhanceApp.js` 文件来做一些应用级别的优化，当该文件存在的时候，会被导入到应用内部。`enhanceApp.js` 应该 `export default` 一个钩子函数，并接受一个包含了一些应用级别属性的对象作为参数。你可以使用这个钩子来安装一些附加的 Vue 插件、注册全局组件，或者增加额外的路由钩子等：
 
 ```js
 export default ({

Diff for: docs/zh/guide/custom-themes.md

@@ -4,7 +4,7 @@
 主题组件受到同样的 [浏览器的 API 访问限制](./using-vue.md#browser-api-access-restrictions)。
 :::
 
-VuePress 使用单文件组件来构建自定义主题。想要开发一个自定义主题，首先在你的文档根目录新建一个 `.vuepress/theme` 文件夹，然后新建一个 `Layout.vue` 文件：
+VuePress 使用单文件组件来构建自定义主题。想要开发一个自定义主题，首先在你的文档根目录新建一个 `.vuepress/theme` 文件夹，然后再创建一个 `Layout.vue` 文件：
 
 ```
 .
@@ -24,7 +24,7 @@ VuePress 使用单文件组件来构建自定义主题。想要开发一个自
 ``` json
 {
   "title": "VuePress",
-  "description": "Vue-powered Static Site Generator",
+  "description": "Vue 驱动的静态网站生成器",
   "base": "/",
   "pages": [
     {
@@ -37,7 +37,7 @@ VuePress 使用单文件组件来构建自定义主题。想要开发一个自
 }
 ```
 
-`title`, `description` 和 `base` 会从 `.vuepress/config.js` 中对应的的字段复制过来，而 `pages` 是一个包含了每个页面元数据对象的数据，包括它的路径、页面标题（明确地通过 [YAML front matter](./markdown.html#yaml-front-matter) 指定，或者通过该页面的第一个标题取到），以及所有源文件中的 `YAML front matter` 的数据。
+`title`, `description` 和 `base` 会从 `.vuepress/config.js` 中对应的的字段复制过来，而 `pages` 是一个包含了每个页面元数据对象的数据，包括它的路径、页面标题（明确地通过 [YAML front matter](./markdown.md#yaml-front-matter) 指定，或者通过该页面的第一个标题取到），以及所有源文件中的 `YAML front matter` 的数据。
 
 下面的这个对象是你正在看的这个页面的 `$page` 的值：
 

Diff for: docs/zh/guide/getting-started.md

@@ -20,7 +20,7 @@ vuepress build .
 
 ## 现有项目
 
-如果你想在一个现有项目中使用 VuePress，同时想要保留项目已有中的文档，此时你应该将 VuePress 作为本地依赖。下述的安装流程，你同样可以使用持续集成工具，或者一些开源服务，如 Netlify，来帮助你在每次更新代码时自动部署。
+如果你想在一个现有项目中使用 VuePress，同时想要在该项目中保存文档，此时你应该将 VuePress 作为本地依赖。下述的安装流程，你同样可以使用持续集成工具，或者一些开源服务，如 Netlify，来帮助你在每次更新代码时自动部署。
 
 ``` bash
 # 将 VuePress 作为一个本地依赖安装
@@ -51,13 +51,13 @@ npx vuepress dev docs
 }
 ```
 
-于是你就可以这样开始你的写作了:
+于是，你就可以这样开始你的写作了:
 
 ``` bash
 yarn docs:dev # 或者：npm run docs:dev
 ```
 
-要生成静态资源时，则运行：
+要生成静态资源时，运行：
 
 ``` bash
 yarn docs:build # 或者：npm run docs:build