diff --git a/source/zh-cn/api/box.md b/source/zh-cn/api/box.md
index 14576dda81..03af844118 100644
--- a/source/zh-cn/api/box.md
+++ b/source/zh-cn/api/box.md
@@ -2,28 +2,25 @@
 title: Box
 ---
 
-Box is a container used for processing files in a specified folder. 「Box」是 Hexo 用来处理特定文件夹中的文件的容器，在 Hexo 中有两个 Box，分别是 `hexo.source` 和 `hexo.theme`，前者用于处理 `source` 文件夹，而后者用于处理主题文件夹。 The former is used to process the `source` folder and the latter to process the `theme` folder.
+Box 是 Hexo 用来处理特定文件夹中的文件的容器。 在 Hexo 中有两个 Box，分别是 `hexo.source` 和 `hexo.theme`。 前者用于处理 `source` 文件夹，后者用于处理 `theme` 文件夹。
 
 ## 加载文件
 
-Box 提供了两种方法来加载文件：`process`, `watch`，前者用于加载文件夹内的所有文件；而后者除了执行 `process` 以外，还会继续监视文件变动。 `process` loads all files in the folder. `watch` does the same, but also starts watching for file changes.
+Box 提供了两种方法来加载文件：`process` 和 `watch`。 `process` 加载文件夹中的所有文件。 `watch` 做了与前者相同的操作，但还会开始监视文件的更改。
 
 ```js
-box.process().then(function () {
-  // ...
 box.process().then(function () {
   // ...
 });
 
 box.watch().then(function () {
-  // 之后可调用 box.unwatch()，停止监视文件
-});
+  // 之后可调用 box.unwatch()，停止监视文件。
 });
 ```
 
 ## 比对路径
 
-Box provides many ways for path matching. Box 提供了多种比对路径的模式，您可以以使用正则表达式（regular expression）、函数、或是 Express 风格的模式字符串，例如： For example:
+Box 提供了多种比对路径的模式。 您可以以使用正则表达式（regular expression）、函数、或是 Express 风格的模式字符串。 例如：
 
 ```plain
 posts/:id => posts/89
@@ -34,7 +31,7 @@ posts/*path => posts/2015/title
 
 ## 处理器（Processor）
 
-处理器（Processor）是 Box 中非常重要的元素，它用于处理文件，您可以使用上述的路径对比来限制该处理器所要处理的文件类型。 You can use path matching as described above to restrict what exactly the processor should process. 使用 `addProcessor` 来添加处理器。
+处理器（Processor）是 Box 中非常重要的元素，它用于处理文件。 您可以使用上述的路径对比来限制该处理器所要处理的文件类型。 使用 `addProcessor` 来添加处理器。
 
 ```js
 box.addProcessor("posts/:id", function (file) {
diff --git a/source/zh-cn/api/console.md b/source/zh-cn/api/console.md
index f12ff274a3..90c614c7f3 100644
--- a/source/zh-cn/api/console.md
+++ b/source/zh-cn/api/console.md
@@ -10,10 +10,9 @@ title: 控制台（Console）
 hexo.extend.console.register(name, desc, options, function (args) {
   // ...
 });
-});
 ```
 
-| Argument  | 描述 |
+| 参数        | 描述 |
 | --------- | -- |
 | `name`    | 名称 |
 | `desc`    | 描述 |
@@ -25,7 +24,7 @@ An argument `args` will be passed into the function. This is the argument that u
 
 ### 用法
 
-The usage of a console command. For example:
+The usage of a console command. 例如：
 
 ```js
 {
@@ -36,7 +35,7 @@ The usage of a console command. For example:
 
 ### arguments
 
-控制台各个参数的说明，例如： For example:
+控制台各个参数的说明。 例如：
 
 ```js
 {
@@ -49,7 +48,7 @@ The usage of a console command. For example:
 
 ### options
 
-控制台的各个选项的说明，例如： For example:
+控制台的各个选项的说明。 例如：
 
 ```js
 {
diff --git a/source/zh-cn/api/deployer.md b/source/zh-cn/api/deployer.md
index e14d6c64f0..bec9baa643 100644
--- a/source/zh-cn/api/deployer.md
+++ b/source/zh-cn/api/deployer.md
@@ -10,7 +10,6 @@ title: 部署器（Deployer）
 hexo.extend.deployer.register(name, function (args) {
   // ...
 });
-});
 ```
 
-在函数中会传入 `args` 参数，该参数包含了 `_config.yml` 中的 `deploy` 参数值，以及开发者在终端中所传入的参数。 It contains the `deploy` value set in `_config.yml`, as well as the exact input users typed into their terminal.
+在函数中会传入 `args` 参数。 该参数包含了 `_config.yml` 中设置的 `deploy` 值，以及用户在终端中输入的内容。
diff --git a/source/zh-cn/api/events.md b/source/zh-cn/api/events.md
index b48044851a..47c90d215e 100644
--- a/source/zh-cn/api/events.md
+++ b/source/zh-cn/api/events.md
@@ -2,7 +2,7 @@
 title: 事件
 ---
 
-Hexo 继承了 [EventEmitter][]，您可以用 `on` 方法监听 Hexo 所发布的事件，也可以使用 `emit` 方法对 Hexo 发布事件，更详细的说明请参阅 Node.js 的 API。 Use the `on` method to listen for events emitted by Hexo, and use the `emit` method to emit events. For more information, refer to the Node.js API documentation.
+Hexo 继承了 [EventEmitter][]。 您可以用 `on` 方法监听 Hexo 所发布的事件，也可以使用 `emit` 方法对 Hexo 发布事件。 更详细的说明请参阅 Node.js 的 API。
 
 ### deployBefore
 
diff --git a/source/zh-cn/api/filter.md b/source/zh-cn/api/filter.md
index 27d8c89556..e9c362e430 100644
--- a/source/zh-cn/api/filter.md
+++ b/source/zh-cn/api/filter.md
@@ -16,16 +16,10 @@ hexo.extend.filter.register(type, function() {
   const { config: themeCfg } = this.theme;
   if (themeCfg.fancybox) // do something...
 
-}, priority);
-
-  // Theme configuration
-  const { config: themeCfg } = this.theme;
-  if (themeCfg.fancybox) // do something...
-
 }, priority);
 ```
 
-You can define the `priority`. Lower `priority` means that it will be executed first. 您可以指定过滤器的优先级 `priority`，`priority` 值越低，过滤器会越早执行，默认的 `priority` 是 10。 我们建议提供配置选项如 `hexo.config.your_plugin.priority`、让用户自行决定过滤器的优先级。
+您可以指定过滤器的优先级 `priority`。 `priority` 值越低，过滤器会越早执行。 默认的 `priority` 是 10。 我们建议提供配置选项如 `hexo.config.your_plugin.priority`、让用户自行决定过滤器的优先级。
 
 ## 执行过滤器
 
@@ -39,7 +33,7 @@ hexo.extend.filter.execSync(type, data, options);
 | `context` | Context    |
 | `args`    | 参数。 必须为数组。 |
 
-`data` 会作为第一个参数传入每个过滤器，而您可以在过滤器中通过返回值改变下一个过滤器中的 `data`，如果什么都没有返回的话则会保持原本的 `data`。 The `data` passed into the next filter can be modified by returning a new value. If nothing is returned, the data remains unmodified. 您还可以使用 `args` 指定过滤器的其他参数。 举例来说：
+`data` 会作为第一个参数传入每个过滤器。 而您可以在过滤器中通过返回值改变下一个过滤器中的 `data`。 如果什么都没有返回的话则会保持原本的 data。 您还可以使用 `args` 指定过滤器的其他参数。 举例来说：
 
 ```js
 hexo.extend.filter.register("test", function (data, arg1, arg2) {
@@ -145,7 +139,6 @@ hexo.extend.filter.register("before_exit", function () {
 hexo.extend.filter.register("before_generate", function () {
   // ...
 });
-});
 ```
 
 ### after_generate
@@ -156,7 +149,6 @@ Executed after generation finishes.
 hexo.extend.filter.register("after_generate", function () {
   // ...
 });
-});
 ```
 
 ### template_locals
@@ -180,7 +172,6 @@ hexo.extend.filter.register("template_locals", function (locals) {
 hexo.extend.filter.register("after_init", function () {
   // ...
 });
-});
 ```
 
 ### new_post_path
@@ -191,7 +182,6 @@ hexo.extend.filter.register("after_init", function () {
 hexo.extend.filter.register("new_post_path", function (data, replace) {
   // ...
 });
-});
 ```
 
 ### post_permalink
@@ -202,20 +192,19 @@ Used to determine the permalink of posts.
 hexo.extend.filter.register("post_permalink", function (data) {
   // ...
 });
-});
 ```
 
 ### after_render
 
-Executed after rendering finishes. 在渲染后执行，您可以参考 [渲染](rendering.html#after-render-过滤器) 以了解更多信息。
+在渲染后执行。 您可以参考 [渲染](rendering.html#after-render-过滤器) 以了解更多信息。
 
 ### after_clean
 
 Executed after generated files and cache are removed with `hexo clean` command.
 
 ```js
-hexo.extend.filter.register("before_exit", function () {
-  // ...
+hexo.extend.filter.register("after_clean", function () {
+  // remove some other temporary files
 });
 ```
 
diff --git a/source/zh-cn/api/generator.md b/source/zh-cn/api/generator.md
index ccfed5c2cb..5c94a5c91c 100644
--- a/source/zh-cn/api/generator.md
+++ b/source/zh-cn/api/generator.md
@@ -7,11 +7,12 @@ title: 生成器（Generator）
 ## 概要
 
 ```js
-hexo.extend.generator.register(name, function (locals) {});
+hexo.extend.generator.register(name, function (locals) {
+  // ...
 });
 ```
 
-`locals` 参数会被传递到此函数，其中包含 [网站变量](../docs/variables.html#网站变量)，请尽量利用此参数取得网站数据，避免直接访问数据库。 You should use this argument to get the website data, thereby avoiding having to access the database directly.
+`locals` 参数会被传递到此函数，其中包含 [网站变量](../docs/variables.html#网站变量)。 请尽量利用此参数取得网站数据，避免直接访问数据库。
 
 ## 更新路由
 
@@ -37,13 +38,13 @@ hexo.extend.generator.register("test", function (locals) {
 | `data`   | 数据                                                                                                                                        |
 | `layout` | 布局。 Specify the layouts for rendering. The value can be a string or an array. If it's ignored then the route will return `data` directly. |
 
-在原始文件更新时，Hexo 会执行所有生成器并重建路由，**请直接回传数据，不要直接操作路由**。 **Please return the data and do not access the router directly.**
+在原始文件更新时，Hexo 会执行所有生成器并重建路由。 **请直接回传数据，不要直接访问路由。**
 
 ## 示例
 
 ### 归档页面
 
-Create an archive page at `archives/index.html`. We pass all posts as data to the templates. 在 `archives/index.html` 建立一归档页面，把所有文章当作数据传入模板内，这个数据也就等同于模板中的 `page` 变量。
+在 `archives/index.html` 建立一归档页面。 把所有文章当作数据传入模板内。 这个数据也就等同于模板中的 `page` 变量。
 
 Next, set the `layout` attribute to render with the theme templates. We're setting two layouts in this example: if the `archive` layout doesn't exist, the `index` layout will be used instead.
 
@@ -51,7 +52,7 @@ Next, set the `layout` attribute to render with the theme templates. We're setti
 hexo.extend.generator.register("archive", function (locals) {
   return {
     path: "archives/index.html",
-    data: locals.posts,
+    data: locals,
     layout: ["archive", "index"],
   };
 });
@@ -65,7 +66,8 @@ hexo.extend.generator.register("archive", function (locals) {
 var pagination = require("hexo-pagination");
 
 hexo.extend.generator.register("archive", function (locals) {
-  return pagination("archives/index.html", locals.posts, {
+  // hexo-pagination makes an index.html for the /archives route
+  return pagination("archives", locals.posts, {
     perPage: 10,
     layout: ["archive", "index"],
     data: {},
diff --git a/source/zh-cn/api/helper.md b/source/zh-cn/api/helper.md
index 98ea2ecd55..82d9e89463 100644
--- a/source/zh-cn/api/helper.md
+++ b/source/zh-cn/api/helper.md
@@ -2,7 +2,7 @@
 title: 辅助函数（Helper）
 ---
 
-辅助函数帮助您在模板中快速插入内容，建议您把复杂的代码放在辅助函数而非模板中。 We recommend using helpers instead of templates when you're dealing with more complicated code.
+辅助函数帮助您在模板中快速插入内容。 建议您把复杂的代码放在辅助函数而非模板中。
 
 辅助函数不能从 `source` 的文件中访问。
 
@@ -12,7 +12,6 @@ title: 辅助函数（Helper）
 hexo.extend.helper.register(name, function () {
   // ...
 });
-});
 ```
 
 ## 示例
@@ -44,7 +43,7 @@ hexo.extend.helper.register("lorem", function (path) {
 });
 ```
 
-### 如何在其他插件中使用已经注册的 helper？
+### 如何在另一个扩展（例如过滤器、注入器）中使用注册的helper？
 
 `hexo.extend.helper.get` 会返回一个指定名字的 helper，但是你还需要一个 `bind(hexo)`，就像这样：
 
diff --git a/source/zh-cn/api/index.md b/source/zh-cn/api/index.md
index 30c489dd47..74cbf4b951 100644
--- a/source/zh-cn/api/index.md
+++ b/source/zh-cn/api/index.md
@@ -8,7 +8,7 @@ title: API
 
 ## 初始化
 
-First, we have to create a Hexo instance. 首先，我们必须建立一个 Hexo 实例（instance），第一个参数是网站的根目录，也就是 `base_dir`，而第二个参数则是初始化的选项。 接着执行 `init` 方法后，Hexo 会加载插件及配置文件。
+首先，我们必须建立一个 Hexo 实例（instance）。 一个新的实例需要两个参数：网站根目录 `base_dir`，以及包含初始化选项的对象。 接着执行 `init` 方法后，Hexo 会加载插件及配置文件。
 
 ```js
 var Hexo = require("hexo");
@@ -17,10 +17,9 @@ var hexo = new Hexo(process.cwd(), {});
 hexo.init().then(function () {
   // ...
 });
-});
 ```
 
-| Option             | 描述                                                              | 默认值                                 |
+| 选项                 | 描述                                                              | 默认值                                 |
 | ------------------ | --------------------------------------------------------------- | ----------------------------------- |
 | `debug`            | 开启调试模式。 在终端中显示调试信息，并在根目录中存储 `debug.log` 日志文件。                   | `false`                             |
 | `safe`             | 开启安全模式。 不加载任何插件。                                                | `false`                             |
@@ -30,13 +29,11 @@ hexo.init().then(function () {
 
 ## 加载文件
 
-Hexo 提供了两种方法来加载文件：`load`, `watch`，前者用于加载 `source` 文件夹内的所有文件及主题资源；而后者除了执行 `load` 以外，还会继续监视文件变动。 `load` is used for loading all files in the `source` folder as well as the theme data. `watch` does the same things `load` does, but will also start watching for file changes continuously.
+Hexo 提供了两种方法来加载文件：`load` 和 `watch`。 `load` 用于加载 `source` 文件夹中的所有文件以及主题数据。 `watch` 执行与 `load` 相同的操作，但还会开始连续监视文件更改。
 
 Both methods will load the list of files and pass them to the corresponding processors. After all files have been processed, they will call upon the generators to create the routes.
 
 ```js
-hexo.load().then(function () {
-  // ...
 hexo.load().then(function () {
   // ...
 });
@@ -44,7 +41,6 @@ hexo.load().then(function () {
 hexo.watch().then(function () {
   // 之后可以调用 hexo.unwatch()，停止监视文件
 });
-});
 ```
 
 ## 执行指令
@@ -55,7 +51,6 @@ Any console command can be called explicitly using the `call` method on the Hexo
 hexo.call("generate", {}).then(function () {
   // ...
 });
-});
 ```
 
 ```js
diff --git a/source/zh-cn/api/injector.md b/source/zh-cn/api/injector.md
index 6296cdfa53..7d70fb6d7f 100644
--- a/source/zh-cn/api/injector.md
+++ b/source/zh-cn/api/injector.md
@@ -71,7 +71,7 @@ hexo.extend.injector.register("body_end", () => {
 });
 ```
 
-上述代码将会把 `APlayer.min.css`（`<link>` 标签）和 `APlayer.min.js` （`<script>` 标签）注入到所有 layout 为 `music` 的页面的 `</head>` 和 `</body>` 之前，以及将 `jquery.js`（`<script>` 标签）注入到每一个生成的页面的 `</body>` 之前。 Also, `jquery.js` (`<script>` tag) will be injected to `</body>` of every page generated.
+上述代码将会把 `APlayer.min.css`（`<link>` 标签）和 `APlayer.min.js` （`<script>` 标签）注入到所有 layout 为 `music` 的页面的 `</head>` 和 `</body>` 之前。 此外，`jquery.js`（`<script>` tag）将会被注入到生成的每个页面的 `</body>` 之前。
 
 ## 访问用户配置
 
diff --git a/source/zh-cn/api/locals.md b/source/zh-cn/api/locals.md
index 60ee9a2261..3e5e8a935d 100644
--- a/source/zh-cn/api/locals.md
+++ b/source/zh-cn/api/locals.md
@@ -25,7 +25,6 @@ hexo.locals.get("posts");
 hexo.locals.set('posts', function(){
   return ...
 });
-});
 ```
 
 ## 移除变量
diff --git a/source/zh-cn/api/migrator.md b/source/zh-cn/api/migrator.md
index 1f1f8c47df..5dd603beb7 100644
--- a/source/zh-cn/api/migrator.md
+++ b/source/zh-cn/api/migrator.md
@@ -10,7 +10,6 @@ title: Migrator
 hexo.extend.migrator.register(name, function (args) {
   // ...
 });
-});
 ```
 
-在函数中需要传入 `args` 参数，该参数包含了开发者在终端中所传入的参数。 This argument will contain the user's input into the terminal.
+在函数中需要传入 `args` 参数。 该参数包含了开发者在终端中所传入的参数。
diff --git a/source/zh-cn/api/posts.md b/source/zh-cn/api/posts.md
index 17a0e38186..41347483c6 100644
--- a/source/zh-cn/api/posts.md
+++ b/source/zh-cn/api/posts.md
@@ -2,13 +2,13 @@
 title: 文章
 ---
 
-## Create a Post
+## 创建一个文章
 
 ```js
 hexo.post.create(data, replace);
 ```
 
-| Argument  | 描述     |
+| 参数        | 描述     |
 | --------- | ------ |
 | `data`    | 数据     |
 | `replace` | 替换现有文件 |
@@ -29,7 +29,7 @@ The attributes of a post can be defined in `data`. The table below is not exhaus
 hexo.post.publish(data, replace);
 ```
 
-| Argument  | 描述     |
+| 参数        | 描述     |
 | --------- | ------ |
 | `data`    | 数据     |
 | `replace` | 替换现有文件 |
@@ -47,7 +47,7 @@ The attributes of a post can be defined in `data`. The table below is not exhaus
 hexo.post.render(source, data);
 ```
 
-| Argument | 描述           |
+| 参数       | 描述           |
 | -------- | ------------ |
 | `source` | 文件的完整路径（可忽略） |
 | `data`   | 数据           |
diff --git a/source/zh-cn/api/processor.md b/source/zh-cn/api/processor.md
index de5a26ffc5..50a74a88e0 100644
--- a/source/zh-cn/api/processor.md
+++ b/source/zh-cn/api/processor.md
@@ -7,7 +7,8 @@ title: 处理器（Processor）
 ## 概要
 
 ```js
-hexo.extend.processor.register(rule, function (file) {});
+hexo.extend.processor.register(rule, function (file) {
+  // ...
 });
 ```
 
diff --git a/source/zh-cn/api/renderer.md b/source/zh-cn/api/renderer.md
index 91acae0f83..d038f72cdc 100644
--- a/source/zh-cn/api/renderer.md
+++ b/source/zh-cn/api/renderer.md
@@ -14,13 +14,10 @@ hexo.extend.renderer.register(
     // ...
   },
   sync,
-);
-  },
-  sync,
 );
 ```
 
-| Argument | 描述                   |
+| 参数       | 描述                   |
 | -------- | -------------------- |
 | `name`   | 输入的扩展名（小写，不含开头的 `.`） |
 | `output` | 输出的扩展名（小写，不含开头的 `.`） |
@@ -28,7 +25,7 @@ hexo.extend.renderer.register(
 
 渲染函数中会传入三个参数：
 
-| Argument   | 描述                                             |
+| 参数         | 描述                                             |
 | ---------- | ---------------------------------------------- |
 | `data`     | 包含两个属性：文件路径 `path` 和文件内容 `text`。 `path` 不一定存在。 |
 | `option`   | 选项                                             |
diff --git a/source/zh-cn/api/rendering.md b/source/zh-cn/api/rendering.md
index 0e12115889..090137d395 100644
--- a/source/zh-cn/api/rendering.md
+++ b/source/zh-cn/api/rendering.md
@@ -2,7 +2,7 @@
 title: 渲染
 ---
 
-在 Hexo 中，有两个方法可用于渲染文件或字符串，分别是异步的 `hexo.render.render` 和同步的 `hexo.render.renderSync`，这两个方法的使用方式十分类似，因此下文仅以异步的 `hexo.render.render` 为例。 Unsurprisingly, the two methods are very similar so only the asynchronous `hexo.render.render` will be further discussed in the below paragraphs.
+在 Hexo 中，有两个方法可用于渲染文件或字符串，分别是异步的 `hexo.render.render` 和同步的 `hexo.render.renderSync`。 这两个方法的使用方式十分类似，因此下文仅以异步的 `hexo.render.render` 为例。
 
 ## 渲染字符串
 
@@ -12,18 +12,16 @@ title: 渲染
 hexo.render.render({ text: "example", engine: "swig" }).then(function (result) {
   // ...
 });
-});
 ```
 
 ## 渲染文件
 
-在渲染文件时，您无须指定 `engine`，Hexo 会自动根据扩展名猜测所要使用的渲染引擎，当然您也可以使用 `engine` 指定。 Of course, you are also allowed to explicitly define the `engine`.
+在渲染文件时，您无须指定 `engine`，Hexo 会自动根据扩展名猜测所要使用的渲染引擎。 当然您也可以使用 `engine` 指定。
 
 ```js
 hexo.render.render({ path: "path/to/file.swig" }).then(function (result) {
   // ...
 });
-});
 ```
 
 ## 渲染选项
@@ -34,12 +32,11 @@ You can pass in an options object as the second argument.
 hexo.render.render({ text: "" }, { foo: "foo" }).then(function (result) {
   // ...
 });
-});
 ```
 
 ## after_render 过滤器
 
-在渲染完成后，Hexo 会自动执行相对应的 `after_render` 过滤器，举例来说，我们可以通过这个功能实现 JavaScript 的压缩。 For example, we can use this feature to implement a JavaScript minifier.
+在渲染完成后，Hexo 会自动执行相对应的 `after_render` 过滤器。 举例来说，我们可以通过这个功能实现 JavaScript 的压缩。
 
 ```js
 var UglifyJS = require("uglify-js");
@@ -52,7 +49,7 @@ hexo.extend.filter.register("after_render:js", function (str, data) {
 
 ## 检查文件是否可被渲染
 
-您可以通过 `isRenderable` 或 `isRenderableSync` 两个方法检查文件路径是否可以被渲染，只有在相对应的渲染器（renderer）已注册的情况下才会返回 true。 Only when a corresponding renderer has been registered will this method return true.
+您可以通过 `isRenderable` 或 `isRenderableSync` 两个方法检查文件路径是否可以被渲染。 只有在相对应的渲染器（renderer）已注册的情况下才会返回 true。
 
 ```js
 hexo.render.isRenderable("layout.swig"); // true
diff --git a/source/zh-cn/api/router.md b/source/zh-cn/api/router.md
index d33f1cd1ed..22147f477f 100644
--- a/source/zh-cn/api/router.md
+++ b/source/zh-cn/api/router.md
@@ -6,7 +6,7 @@ title: 路由
 
 ## 获取路径
 
-`get` 方法会传回一个 [Stream][]，例如把该路径的数据存储到某个指定位置。 For example, to save the path data to a specified destination:
+`get` 方法会传回一个 [Stream][]。 例如，把该路径的数据存储到某个指定位置：
 
 ```js
 var data = hexo.route.get("index.html");
@@ -56,7 +56,7 @@ hexo.route.set("index.html", {
 hexo.route.remove("index.html");
 ```
 
-## Get the List of Routes
+## 获取路由列表
 
 ```js
 hexo.route.list();
diff --git a/source/zh-cn/api/tag.md b/source/zh-cn/api/tag.md
index 45067e6495..0848fb044d 100644
--- a/source/zh-cn/api/tag.md
+++ b/source/zh-cn/api/tag.md
@@ -7,15 +7,18 @@ title: 标签插件（Tag）
 ## 概要
 
 ```js
-hexo.extend.tag.register(name, function (args, content) {}, options);
+hexo.extend.tag.register(
+  name,
+  function (args, content) {
+    // ...
   },
   options,
 );
 ```
 
-标签函数会传入两个参数：`args` 和 `content`，前者代表开发者在使用标签插件时传入的参数，而后者则是标签插件所覆盖的内容。 `args` contains the arguments passed into the tag plugin and `content` is the wrapped content from the tag plugin.
+标签函数会传入两个参数：`args` 和 `content`。 `args` 包含传入标签插件的参数，`content` 是标签插件所覆盖的内容。
 
-从 Hexo 3 开始，因为新增了异步渲染功能，而改用 [Nunjucks][] 作为渲染引擎，其行为可能会与过去使用的 [Swig][] 有些许差异。 The behavior may be somewhat different from that in [Swig][].
+从 Hexo 3 开始，因为新增了异步渲染功能，而改用 [Nunjucks][] 作为渲染引擎。 其行为可能会与过去使用的 [Swig][] 有些许差异。
 
 ## 移除标签插件
 
@@ -39,15 +42,15 @@ hexo.extend.tag.unregister("youtube");
 hexo.extend.tag.register("youtube", tagFn);
 ```
 
-## 选项
+## Options
 
 ### ends
 
-Use end tags. 使用结束标签，此选项默认为 `false`。
+使用结束标签。 此选项默认为 `false`。
 
 ### async
 
-Enable async mode. This option is `false` by default.
+启用异步模式。 This option is `false` by default.
 
 ## 示例
 
@@ -136,16 +139,6 @@ hexo.extend.tag.register('foo', function (args) {
 
   return 'foo';
 });
-
-  // Front-matter
-  const { title } = this; // article's (post/page) title
-
-  // Article's content
-  const { _content } = this; // original content
-  const { content } = this; // HTML-rendered content
-
-  return 'foo';
-});
 ```
 
 2.
@@ -170,12 +163,6 @@ module.exports = hexo => {
     return 'foo';
   };
 };
-
-    const { title, _content, content } = this;
-
-    return 'foo';
-  };
-};
 ```
 
 [Nunjucks]: https://mozilla.github.io/nunjucks/
diff --git a/source/zh-cn/api/themes.md b/source/zh-cn/api/themes.md
index f40b89a2ac..7337d30ff2 100644
--- a/source/zh-cn/api/themes.md
+++ b/source/zh-cn/api/themes.md
@@ -32,7 +32,6 @@ var view = hexo.theme.getView("layout.swig");
 view.render({ foo: 1, bar: 2 }).then(function (result) {
   // ...
 });
-});
 ```
 
 您可以以向 `render` 方法传入对象作为参数，`render` 方法会先使用对应的渲染引擎进行解析，并加载 [辅助函数](helper.html)。 When rendering is complete, it will try to find whether a layout exists. If `layout` is `false` or if it doesn't exist, the result will be returned directly.
diff --git a/source/zh-cn/docs/asset-folders.md b/source/zh-cn/docs/asset-folders.md
index 81c1638824..e92d570693 100644
--- a/source/zh-cn/docs/asset-folders.md
+++ b/source/zh-cn/docs/asset-folders.md
@@ -34,6 +34,7 @@ post_asset_folder: true
 
 ```
 {% asset_img example.jpg This is an example image %}
+{% asset_img "spaced asset.jpg" "spaced title" %}
 ```
 
 通过这种方式，图片将会同时出现在文章和主页以及归档页中。
diff --git a/source/zh-cn/docs/commands.md b/source/zh-cn/docs/commands.md
index 5267c717a8..942a0d20d4 100644
--- a/source/zh-cn/docs/commands.md
+++ b/source/zh-cn/docs/commands.md
@@ -23,11 +23,11 @@ $ hexo new [layout] <title>
 
 新建一篇文章。 如果没有设置 `layout` 的话，默认使用 [\_config.yml](configuration.html) 中的 `default_layout` 参数代替。 Use the layout `draft` to create a draft. 如果标题包含空格的话，请使用引号括起来。
 
-| Option            | 描述                                        |
-| ----------------- | ----------------------------------------- |
-| `-p`, `--path`    | Post path. 自定义新文章的路径                      |
-| `-r`, `--replace` | Replace the current post if existed.      |
-| `-s`, `--slug`    | Post slug. Customize the URL of the post. |
+| 选项                | 描述                |
+| ----------------- | ----------------- |
+| `-p`, `--path`    | 文章的路径。 自定义文章的路径。  |
+| `-r`, `--replace` | 如果存在的话，替换当前的文章。   |
+| `-s`, `--slug`    | 文章别名。 自定义文章的 URL。 |
 
 默认情况下，Hexo 会使用文章的标题来决定文章文件的路径。 对于独立页面来说，Hexo 会创建一个以标题为名字的目录，并在目录中放置一个 `index.md` 文件。 你可以使用 `--path` 参数来覆盖上述行为、自行决定文件的目录：
 
@@ -53,13 +53,13 @@ $ hexo generate
 
 生成静态文件。
 
-| 选项                    | 描述                                    |
-| --------------------- | ------------------------------------- |
-| `-d`, `--deploy`      | Deploy after generation finishes      |
-| `-w`, `--watch`       | 监视文件变动                                |
-| `-b`, `--bail`        | 生成过程中如果发生任何未处理的异常则抛出异常                |
-| `-f`, `--force`       | Force regenerate                      |
-| `-c`, `--concurrency` | 最大同时生成文件的数量，默认无限制 Default is infinity |
+| 选项                    | 描述                               |
+| --------------------- | -------------------------------- |
+| `-d`, `--deploy`      | Deploy after generation finishes |
+| `-w`, `--watch`       | 监视文件变动                           |
+| `-b`, `--bail`        | 生成过程中如果发生任何未处理的异常则抛出异常           |
+| `-f`, `--force`       | 强制重新生成                           |
+| `-c`, `--concurrency` | 要同时生成的文件的最大数量。 默认无限制             |
 
 ## publish
 
@@ -89,9 +89,9 @@ $ hexo server
 $ hexo deploy
 ```
 
-Deploys your website.
+部署你的网站。
 
-| Option             | 描述                         |
+| 选项                 | 描述                         |
 | ------------------ | -------------------------- |
 | `-g`, `--generate` | Generate before deployment |
 
@@ -103,7 +103,7 @@ $ hexo render <file1> [file2] ...
 
 渲染文件。
 
-| Option           | 描述                 |
+| 选项               | 描述                 |
 | ---------------- | ------------------ |
 | `-o`, `--output` | Output destination |
 
@@ -129,7 +129,7 @@ $ hexo clean
 $ hexo list <type>
 ```
 
-Lists all routes.
+列出所有路由。
 
 ## version
 
@@ -137,7 +137,7 @@ Lists all routes.
 $ hexo version
 ```
 
-Displays version information.
+显示版本信息。
 
 ## config
 
@@ -163,7 +163,7 @@ $ hexo --safe
 $ hexo --debug
 ```
 
-在终端中显示调试信息并记录到 `debug.log`。 Try this if you encounter any problems with Hexo. 当您碰到问题时，可以尝试用调试模式重新执行一次，并 [提交调试信息到 GitHub](https://github.com/hexojs/hexo/issues/new?assignees=&labels=&projects=&template=bug_report.yml)。
+在终端中显示调试信息并记录到 `debug.log`。 当您使用 Hexo 时遇到问题，可以尝试用调试模式重新执行一次。 如果您发现错误，请[在 GitHub 上提出 issue](https://github.com/hexojs/hexo/issues/new?assignees=&labels=&projects=&template=bug_report.yml)。
 
 ### 简洁模式
 
@@ -176,21 +176,13 @@ Silences output to the terminal.
 ### 自定义配置文件的路径
 
 ```bash
-# 使用 custom.yml 代替默认的 _config.yml
-$ hexo server --config custom.yml
-
-# 使用 custom.yml 和 custom2.json，其中 custom2.json 优先级更高
-$ hexo generate --config custom.yml,custom2.json,custom3.yml
+$ hexo --config custom.yml
 ```
 
-自定义配置文件的路径，指定这个参数后将不再使用默认的 `_config.yml`。 Also accepts a comma-separated list (no spaces) of JSON or YAML config files that will combine the files into a single `_multiconfig.yml`.
+自定义配置文件的路径，指定这个参数后将不再使用默认的 `_config.yml`。 还接受一个以逗号分隔的 JSON 或 YAML 配置文件列表（无空格），该列表将把这些文件合并为一个 `_multiconfig.yml` 文件。
 
 ```bash
-# 使用 custom.yml 代替默认的 _config.yml
-$ hexo server --config custom.yml
-
-# 使用 custom.yml, custom2.json 和 custom3.yml，其中 custom3.yml 优先级最高，其次是 custom2.json
-$ hexo generate --config custom.yml,custom2.json,custom3.yml
+$ hexo --config custom.yml,custom2.json
 ```
 
 ### 显示草稿
diff --git a/source/zh-cn/docs/configuration.md b/source/zh-cn/docs/configuration.md
index 9124c3e2c7..c6313c1342 100644
--- a/source/zh-cn/docs/configuration.md
+++ b/source/zh-cn/docs/configuration.md
@@ -6,19 +6,19 @@ title: 配置
 
 ### 网站
 
-| Setting       | 描述                                                                                                                                                                              |
+| 设置            | 描述                                                                                                                                                                              |
 | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `title`       | 网站标题                                                                                                                                                                            |
 | `subtitle`    | 网站副标题                                                                                                                                                                           |
 | `description` | 网站描述                                                                                                                                                                            |
 | `keywords`    | 网站的关键词。 支持多个关键词。                                                                                                                                                                |
 | `author`      | 您的名字                                                                                                                                                                            |
-| `language`    | 网站使用的语言。 Use a [2-letter ISO-639-1 code](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) or optionally [its variant](/docs/internationalization). Default is `en`.       |
+| `language`    | 网站使用的语言。 使用 [2 个字母的 ISO-639-1 代码](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes)，或 [它的变体](/docs/internationalization)。 默认为 `en`。                                        |
 | `timezone`    | 网站时区。 Hexo 默认使用您电脑的时区。 请参考 [时区列表](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) 进行设置，如 `America/New_York`, `Japan`, 和 `UTC` 。 一般的，对于中国大陆地区可以使用 `Asia/Shanghai`。 |
 
 ### 网址
 
-| Setting                      | 描述                                                             | 默认值                         |
+| 设置                           | 描述                                                             | 默认值                         |
 | ---------------------------- | -------------------------------------------------------------- | --------------------------- |
 | `url`                        | 网址, 必须以 `http://` 或 `https://` 开头                              |                             |
 | `root`                       | 网站根目录                                                          | `url's pathname`            |
@@ -35,15 +35,15 @@ title: 配置
 例如：
 
 ```yaml
-# 比如，一个页面的永久链接是 http://example.com/foo/bar/index.html
+# e.g. page.permalink is http://example.com/foo/bar/index.html
 pretty_urls:
   trailing_index: false
-# 此时页面的永久链接会变为 http://example.com/foo/bar/
+# becomes http://example.com/foo/bar/
 ```
 
 ### 目录
 
-| Setting        | 描述                                                                                                                | 默认值              |
+| 设置             | 描述                                                                                                                | 默认值              |
 | -------------- | ----------------------------------------------------------------------------------------------------------------- | ---------------- |
 | `source_dir`   | Source folder. Where your content is stored                                                                       | `source`         |
 | `public_dir`   | Public folder. Where the static site will be generated                                                            | `public`         |
@@ -70,7 +70,7 @@ skip_render: "_posts/test-post.md"
 
 ### 文章
 
-| Setting                 | 描述                                                                         | 默认值            |
+| 设置                      | 描述                                                                         | 默认值            |
 | ----------------------- | -------------------------------------------------------------------------- | -------------- |
 | `new_post_name`         | 新文章的文件名称                                                                   | `:title.md`    |
 | `default_layout`        | 预设布局                                                                       | `post`         |
@@ -88,9 +88,9 @@ skip_render: "_posts/test-post.md"
 | `highlight`             | 代码块的设置, 请参考 [Highlight.js](/zh-cn/docs/syntax-highlight#Highlight-js) 进行设置 |                |
 | `prismjs`               | 代码块的设置, 请参考 [PrismJS](/zh-cn/docs/syntax-highlight#PrismJS) 进行设置           |                |
 
-### Home page setting
+### 首页设置
 
-| Setting                          | 描述                                                                                                              | 默认值     |
+| 设置                               | 描述                                                                                                              | 默认值     |
 | -------------------------------- | --------------------------------------------------------------------------------------------------------------- | ------- |
 | `index_generator`                | Generate an archive of posts, powered by [hexo-generator-index](https://github.com/hexojs/hexo-generator-index) |         |
 | `index_generator.path`           | Root path for your blog's index page                                                                            | `''`    |
@@ -100,7 +100,7 @@ skip_render: "_posts/test-post.md"
 
 ### 分类 & 标签
 
-| Setting            | 描述   | 默认值             |
+| 设置                 | 描述   | 默认值             |
 | ------------------ | ---- | --------------- |
 | `default_category` | 默认分类 | `uncategorized` |
 | `category_map`     | 分类别名 |                 |
@@ -118,7 +118,7 @@ category_map:
 
 Hexo 使用 [Moment.js](http://momentjs.com/) 来解析和显示时间。
 
-| Setting          | 描述                                                                           | 默认值          |
+| 设置               | 描述                                                                           | 默认值          |
 | ---------------- | ---------------------------------------------------------------------------- | ------------ |
 | `date_format`    | 日期格式                                                                         | `YYYY-MM-DD` |
 | `time_format`    | 时间格式                                                                         | `HH:mm:ss`   |
@@ -136,10 +136,10 @@ Hexo 使用 [Moment.js](http://momentjs.com/) 来解析和显示时间。
 
 ### 分页
 
-| Setting          | 描述                                                              | 参数     |
-| ---------------- | --------------------------------------------------------------- | ------ |
-| `per_page`       | Number of posts displayed on each page. `0` disables pagination | `10`   |
-| `pagination_dir` | URL format                                                      | `page` |
+| 设置               | 描述                   | 参数     |
+| ---------------- | -------------------- | ------ |
+| `per_page`       | 每页显示的帖子数。 `0` 关闭分页功能 | `10`   |
+| `pagination_dir` | URL format           | `page` |
 
 例如：
 
@@ -153,7 +153,7 @@ pagination_dir: 'awesome-page'
 
 ### 扩展
 
-| Setting          | 描述                                                                                                                                   |
+| 设置               | 描述                                                                                                                                   |
 | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
 | `theme`          | 当前主题名称。 值为`false`时禁用主题                                                                                                               |
 | `theme_config`   | 主题的配置文件。 在这里放置的配置会覆盖主题目录下的 `_config.yml` 中的配置                                                                                        |
@@ -162,17 +162,17 @@ pagination_dir: 'awesome-page'
 
 ### 包括或不包括目录和文件
 
-Use the following options to explicitly process or ignore certain files/folders. Support [glob expressions](https://github.com/micromatch/micromatch#extended-globbing) for path matching.
+使用以下选项可明确处理或忽略某些文件/文件夹。 可以使用 [glob 表达式](https://github.com/micromatch/micromatch#extended-globbing) 进行路径匹配。
 
 `include` 和 `exclude` 选项只会应用到 `source/` ，而 `ignore` 选项会应用到所有文件夹.
 
-| Setting   | Description                                                                                                      |
-| --------- | ---------------------------------------------------------------------------------------------------------------- |
-| `include` | Include hidden files (including files/folders with a name that starts with an underscore, with an exception\*) |
-| `exclude` | 资源文件夹，这个文件夹用来存放内容。                                                                                               |
-| `ignore`  | Ignore files/folders                                                                                             |
+| 设置        | 描述                                |
+| --------- | --------------------------------- |
+| `include` | 包含隐藏文件（包括名称以下划线开头的文件/文件夹，\* 除外） |
+| `exclude` | 排除文件或文件夹                          |
+| `ignore`  | 忽略文件/文件夹                          |
 
-例如，使用 `--config` 指定了两个自定义配置文件：
+例如：
 
 ```yaml
 # 处理或不处理目录或文件
@@ -181,50 +181,31 @@ include:
   # 处理 'source/css/_typing.css'
   - "css/_typing.css"
   # 处理 'source/_css/' 中的任何文件，但不包括子目录及其其中的文件。
-  - "css/_typing.css"
-  # Include any file in 'source/_css/'.
-  - "_css/*"
-  # Include any file and subfolder in 'source/_css/'.
   - "_css/*"
-  # 处理 'source/_css/' 中的任何文件和子目录下的任何文件
+  # 处理 'source/_css/' 中的任何文件和子目录下的任何文件。
   - "_css/**/*"
 
 exclude:
-  # 不处理 'source/js/test.js'
+  # 不处理 'source/js/test.js'。
   - "js/test.js"
-  # 不处理 'source/js/' 中的文件、但包括子目录下的所有目录和文件
+  # 不处理 'source/js/' 中的文件、但包括子目录下的所有目录和文件。
   - "js/*"
-  # 不处理 'source/js/' 中的文件和子目录下的任何文件
+  # 不处理 'source/js/' 中的文件和子目录下的任何文件。
   - "js/**/*"
-  # 不处理 'source/js/' 目录下的所有文件名以 'test' 开头的文件，但包括其它文件和子目录下的单文件
+  # 不处理 'source/js/' 目录下的所有文件名以 'test' 开头的文件，但包括其它文件和子目录下的单文件。
   - "js/test*"
-  # 不处理 'source/js/' 及其子目录中任何以 'test' 开头的文件
+  # 不处理 'source/js/' 及其子目录中任何以 'test' 开头的文件。
   - "js/**/test*"
   # 不要用 exclude 来忽略 'source/_posts/' 中的文件。
-  - "js/test.js"
-  # Exclude any file in 'source/js/'.
-  - "js/*"
-  # Exclude any file and subfolder in 'source/js/'.
-  - "js/**/*"
-  # Exclude any file with filename that starts with 'test' in 'source/js/'.
-  - "js/test*"
-  # Exclude any file with filename that starts with 'test' in 'source/js/' and its subfolders.
-  - "js/**/test*"
-  # Do not use this to exclude posts in the 'source/_posts/'.
-  # Use skip_render for that. Or prepend an underscore to the filename.
-  # - "_posts/hello-world.md" # Does not work.
+  # 你应该使用 'skip_render'。 或者在要忽略的文件的文件名之前加一个下划线 '_'。
+  # - "_posts/hello-world.md" # 在这里配置是没有用的。
 
 ignore:
-  # Ignore any folder named 'foo'.
-  ignore:
-  # 忽略任何一个名叫 'foo' 的文件夹
+  # 忽略任何一个名叫 'foo' 的文件夹。
   - "**/foo"
-  # 只忽略 'themes/' 下的 'foo' 文件夹
+  # 只忽略 'themes/' 下的 'foo' 文件夹。
   - "**/themes/*/foo"
-  # 对 'themes/' 目录下的每个文件夹中忽略名叫 'foo' 的子文件夹
-  - "**/themes/**/foo"
-  - "**/themes/*/foo"
-  # Same as above, but applies to every subfolders of 'themes/'.
+  # 对 'themes/' 目录下的每个文件夹中忽略名叫 'foo' 的子文件夹。
   - "**/themes/**/foo"
 ```
 
@@ -239,10 +220,14 @@ ignore:
 可以在 hexo-cli 中使用 `--config` 参数来指定自定义配置文件的路径。 你可以使用一个 YAML 或 JSON 文件的路径，也可以使用逗号分隔（无空格）的多个 YAML 或 JSON 文件的路径。
 
 ```bash
-$ hexo generate --config custom.yml,custom2.json
+# use 'custom.yml' in place of '_config.yml'
+$ hexo server --config custom.yml
+
+# use 'custom.yml' & 'custom2.json', prioritizing 'custom2.json'
+$ hexo server --config custom.yml,custom2.json
 ```
 
-当你指定了多个配置文件以后，Hexo 会按顺序将这部分配置文件合并成一个 `_multiconfig.yml`。 The later values take precedence. 这个原则适用于任意数量、任意深度的 YAML 和 JSON 文件。 Note that **no spaces are allowed in the list**.
+当你指定了多个配置文件以后，Hexo 会按顺序将这部分配置文件合并成一个 `_multiconfig.yml`。 后面的值优先。 这个原则适用于任意数量、任意深度的 YAML 和 JSON 文件。 请注意，**列表中不允许有空格**。
 
 如果 `custom.yml` 中指定了 `foo: bar`，在 custom2.json 中指定了 `"foo": "dinosaur"`，那么在 `_multiconfig.yml` 中你会得到 `foo: dinosaur`。
 
@@ -326,5 +311,5 @@ logo: "a-cool-image.png"
 ```
 
 {% note %}
-我们强烈建议你将所有的主题配置集中在一处。 如果你不得不在多处配置你的主题，那么这些信息对你将会非常有用：Hexo 在合并主题配置时，Hexo 配置文件中的 `theme_config` 的优先级最高，其次是 `_config.[theme].yml` 文件，最后是位于主题目录下的 `_config.yml` 文件。 The `_config.yml` file under the theme directory has the lowest priority.
+我们强烈建议你将所有的主题配置集中在一处。 如果你不得不在多处配置你的主题，那么这些信息对你将会非常有用：Hexo 在合并主题配置时，Hexo 配置文件中的 `theme_config` 的优先级最高，其次是 `_config.[theme].yml` 文件。 最后是位于主题目录下的 `_config.yml` 文件。
 {% endnote %}
diff --git a/source/zh-cn/docs/contributing.md b/source/zh-cn/docs/contributing.md
index fbc931051c..cefa038b7c 100644
--- a/source/zh-cn/docs/contributing.md
+++ b/source/zh-cn/docs/contributing.md
@@ -6,7 +6,7 @@ title: 贡献
 
 ## 开发
 
-我们非常欢迎您加入 Hexo 的开发，这份文件将帮助您了解开发流程。 This document will help you through the process.
+我们非常欢迎您加入 Hexo 的开发。 这份文件将帮助您了解开发流程。
 
 ### 开始之前
 
@@ -22,7 +22,7 @@ title: 贡献
 
 ### 工作流
 
-1. Fork [hexojs/hexo][]
+1. Fork [hexojs/hexo][].
 2. 把库（repository）复制到电脑上，并安装所依赖的插件。
 
 ```bash
@@ -32,14 +32,14 @@ $ npm install
 $ git submodule update --init
 ```
 
-3. Create a feature branch.
+3. 创建一个功能分支。
 
 ```bash
 $ git checkout -b new_feature
 ```
 
 4. Start hacking.
-5. Push the branch:
+5. 推送分支：
 
 ```
 $ git push origin new_feature
@@ -50,13 +50,13 @@ $ git push origin new_feature
 ### 注意事项
 
 - 不要修改 `package.json` 的版本号。
-- 只有在测试通过的情况下您的合并申请才会被批准，在提交前别忘了进行测试。 Don't forget to run tests before submission.
+- 只有在测试通过的情况下您的合并申请才会被批准。 在提交前别忘了进行测试。
 
 ```bash
 $ npm test
 ```
 
-## Updating official-plugins
+## 更新官方插件
 
 我们也欢迎给 [Hexo 官方插件](https://github.com/hexojs) 提交 PR 和 Issue 🤗 🤗
 
@@ -76,7 +76,7 @@ $ cd site
 $ npm install
 ```
 
-3. Start editing the documentation. 开始编辑文件，您可以通过服务器预览变动。
+3. 开始编辑文件。 您可以通过服务器预览变动。
 
 ```bash
 $ hexo server
@@ -87,12 +87,12 @@ $ hexo server
 
 ### 翻译
 
-1. 在 `source` 文件夹中建立一个新的语言文件夹（全小写）。 (All lower case)
+1. 在 `source` 文件夹中建立一个新的语言文件夹。 （全小写）
 2. 把 `source` 文件夹中相关的文件（Markdown 和模板文件）复制到新的语言文件夹中。
 3. 在 `source/_data/language.yml` 中新增语言。
 4. 将 `en.yml` 复制到 `themes/navy/languages`中并命名为语言名称（全小写）。
 
-## Reporting Issues
+## 报告问题
 
 当您在使用 Hexo 时遇到问题，您可以尝试在 [问题解答](troubleshooting.html) 中寻找解答，或是在 [GitHub](https://github.com/hexojs/hexo/issues) 或 [Google Group](https://groups.google.com/group/hexo) 上提问。 如果你没有找答案，请在 Github 报告它。
 
diff --git a/source/zh-cn/docs/data-files.md b/source/zh-cn/docs/data-files.md
index f4cea4c5bb..fb16e7771f 100644
--- a/source/zh-cn/docs/data-files.md
+++ b/source/zh-cn/docs/data-files.md
@@ -2,7 +2,7 @@
 title: 数据文件
 ---
 
-Sometimes you may need to use some data in templates which is not directly available in your posts, or you want to reuse the data elsewhere. For such use cases, Hexo 3 introduced the new **Data files**. 此功能会加载 `source/_data` 内的 YAML 或 JSON 文件，如此一来您便能在网站中复用这些文件了。
+有时，您可能需要在模板中使用一些无法直接在帖子中使用的数据，或者您想在其他地方重复使用这些数据。 对于这种情况，Hexo 3 引入了新的**数据文件**。 此功能会加载 `source/_data` 内的 YAML 或 JSON 文件，如此一来您便能在网站中复用这些文件了。
 
 {% youtube CN31plHbI-w %}
 
diff --git a/source/zh-cn/docs/front-matter.md b/source/zh-cn/docs/front-matter.md
index f1ad39e37a..cbd83b873a 100644
--- a/source/zh-cn/docs/front-matter.md
+++ b/source/zh-cn/docs/front-matter.md
@@ -4,7 +4,7 @@ title: Front-matter
 
 {% youtube Rl48Yk4A_V8 %}
 
-Front-matter is a block of YAML or JSON at the beginning of the file that is used to configure settings for your writings. Front-matter is terminated by three dashes when written in YAML or three semicolons when written in JSON.
+Front-matter 是文件开头的 YAML 或 JSON 代码块，用于配置写作设置。 以 YAML 格式书写时，Front-matter 以三个破折号结束；以 JSON 格式书写时，Front-matter 以三个分号结束。
 
 **YAML**
 
@@ -15,7 +15,7 @@ date: 2013/7/13 20:46:25
 ---
 ```
 
-**JSON Front-matter**
+**JSON**
 
 ```json
 "title": "Hello World",
@@ -23,22 +23,22 @@ date: 2013/7/13 20:46:25
 ;;;
 ```
 
-### Settings & Their Default Values
-
-| Setting           | 描述                                                                              | 默认值                                                    |
-| ----------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------ |
-| `layout`          | 布局                                                                              | [`config.default_layout`](/docs/configuration#Writing) |
-| `title`           | 标题                                                                              | 文章的文件名                                                 |
-| `date`            | 建立日期                                                                            | 文件建立日期                                                 |
-| `updated`         | 更新日期                                                                            | 文件更新日期                                                 |
-| `comments`        | 开启文章的评论功能                                                                       | `true`                                                 |
-| `tags`            | 标签（不适用于分页）                                                                      |                                                        |
-| `categories`      | 分类（不适用于分页）                                                                      |                                                        |
-| `permalink`       | Overrides the default permalink of the post. 覆盖文章的永久链接，永久链接应该以 `/` 或 `.html` 结尾 | `null`                                                 |
-| `excerpt`         | 纯文本的页面摘要。 使用 [该插件](/zh-cn/docs/tag-plugins#文章摘要和截断) 来格式化文本                      |                                                        |
-| `disableNunjucks` | 启用时禁用 Nunjucks 标签 `{{ }}`/`{% %}` 和 [标签插件](/zh-cn/docs/tag-plugins) 的渲染功能       | false                                                  |
-| `lang`            | 设置语言以覆盖 [自动检测](/zh-cn/docs/internationalization#路径)                             | 继承自 `_config.yml`                                      |
-| `published`       | 文章是否发布                                                                          | 对于 `_posts` 下的文章为 `true`，对于 `_draft` 下的文章为 `false`     |
+### 设置 & 默认值
+
+| 设置                | 描述                                                                        | 默认值                                                    |
+| ----------------- | ------------------------------------------------------------------------- | ------------------------------------------------------ |
+| `layout`          | 布局                                                                        | [`config.default_layout`](/docs/configuration#Writing) |
+| `title`           | 标题                                                                        | 文章的文件名                                                 |
+| `date`            | 建立日期                                                                      | 文件建立日期                                                 |
+| `updated`         | 更新日期                                                                      | 文件更新日期                                                 |
+| `comments`        | 开启文章的评论功能                                                                 | `true`                                                 |
+| `tags`            | 标签（不适用于分页）                                                                |                                                        |
+| `categories`      | 分类（不适用于分页）                                                                |                                                        |
+| `permalink`       | 覆盖文章的永久链接. 永久链接应该以 `/` 或 `.html` 结尾                                       | `null`                                                 |
+| `excerpt`         | 纯文本的页面摘要。 使用 [该插件](/zh-cn/docs/tag-plugins#文章摘要和截断) 来格式化文本                |                                                        |
+| `disableNunjucks` | 启用时禁用 Nunjucks 标签 `{{ }}`/`{% %}` 和 [标签插件](/zh-cn/docs/tag-plugins) 的渲染功能 | false                                                  |
+| `lang`            | 设置语言以覆盖 [自动检测](/zh-cn/docs/internationalization#路径)                       | 继承自 `_config.yml`                                      |
+| `published`       | 文章是否发布                                                                    | 对于 `_posts` 下的文章为 `true`，对于 `_draft` 下的文章为 `false`     |
 
 #### 布局
 
@@ -48,25 +48,28 @@ date: 2013/7/13 20:46:25
 
 #### 分类和标签
 
-Only posts support the use of categories and tags. Categories apply to posts in order, resulting in a hierarchy of classifications and sub-classifications. Tags are all defined on the same hierarchical level so the order in which they appear is not important.
+只有文章支持分类和标签。 Categories apply to posts in order, resulting in a hierarchy of classifications and sub-classifications. Tags are all defined on the same hierarchical level so the order in which they appear is not important.
 
-**Example**
+**示例**
 
 ```yaml
 categories:
-  - Diary
+  - Sports
+  - Baseball
 tags:
-  - PS3
-  - Games
+  - Injury
+  - Fight
+  - Shocking
 ```
 
 If you want to apply multiple category hierarchies, use a list of names instead of a single name. If Hexo sees any categories defined this way on a post, it will treat each category for that post as its own independent hierarchy.
 
-**Example**
+**示例**
 
 ```yaml
 categories:
-  - [Diary, PlayStation]
-  - [Diary, Games]
-  - [Life]
+  - [Sports, Baseball]
+  - [MLB, American League, Boston Red Sox]
+  - [MLB, American League, New York Yankees]
+  - Rivalries
 ```
diff --git a/source/zh-cn/docs/generating.md b/source/zh-cn/docs/generating.md
index ff23e84420..df78a3d320 100644
--- a/source/zh-cn/docs/generating.md
+++ b/source/zh-cn/docs/generating.md
@@ -12,7 +12,7 @@ $ hexo generate
 
 ### 监视文件变动
 
-Hexo can watch for file changes and regenerate files immediately. Hexo 能够监视文件变动并立即重新生成静态文件，在生成时会比对文件的 SHA1 checksum，只有变动的文件才会写入。
+Hexo 能够监视文件变动并立即重新生成静态文件。 Hexo 在生成时会比对文件的 SHA1 checksum，只有变动的文件才会写入。
 
 ```bash
 $ hexo generate --watch
@@ -20,7 +20,7 @@ $ hexo generate --watch
 
 ### 完成后部署
 
-To deploy after generating, you can run one of the following commands. There is no difference between the two.
+您可执行下列的其中一个命令，让 Hexo 在生成完毕后自动部署网站。 两个命令的作用是相同的。
 
 ```bash
 $ hexo generate --deploy
diff --git a/source/zh-cn/docs/github-pages.md b/source/zh-cn/docs/github-pages.md
index 548be746c6..f7fcd43fca 100644
--- a/source/zh-cn/docs/github-pages.md
+++ b/source/zh-cn/docs/github-pages.md
@@ -2,10 +2,10 @@
 title: 在 GitHub Pages 上部署 Hexo
 ---
 
-本文将使用 [GitHub Actions](https://docs.github.com/zh/actions) 部署至 GitHub Pages，此方法适用于公开或私人储存库。 It works in both public and private repositories. 若你不希望将源文件夹上传到 GitHub，请参阅 [一键部署](#一键部署)。
+在本教程中，我们使用 [GitHub Actions](https://docs.github.com/zh/actions) 部署 GitHub Pages。 此方法适用于公开或私人储存库. 若你不希望将源文件夹上传到 GitHub，请参阅 [一键部署](#一键部署)。
 
-1. 部署完成后，前往 `https://<你的 GitHub 用户名>.github.io/<repository 的名字>` 查看网站。 If you have already uploaded to another repo, rename the repo instead.
-2. 将 Hexo 文件夹中的文件 push 到储存库的默认分支，默认分支通常名为 `main`，旧一点的储存库可能名为 `master`。 The default branch is usually **main**, older repositories may use **master** branch.
+1. 建立名为 <b>_username_.github.io</b>的储存库。 若之前已将 Hexo 上传至其他储存库，将该储存库重命名即可。
+2. 将 Hexo 文件夹中的文件 push 到储存库的默认分支。 默认分支通常名为**main**，旧一点的储存库可能名为**master**。
 
 - 将 `main` 分支 push 到 GitHub：
 
@@ -15,8 +15,8 @@ title: 在 GitHub Pages 上部署 Hexo
 
 - 默认情况下 `public/` 不会被上传(也不该被上传)，确保 `.gitignore` 文件中包含一行 `public/`。 整体文件夹结构应该与 [示例储存库](https://github.com/hexojs/hexo-starter) 大致相似。
 
-3. 使用 `node --version` 指令检查你电脑上的 Node.js 版本，并记下该版本 (例如：`v20.y.z`) Make a note of the major version (e.g., `v20.y.z`)
-4. In your GitHub repo's setting, navigate to **Settings** > **Pages** > **Source**. Change the source to **GitHub Actions** and save.
+3. 使用 `node --version` 指令检查你电脑上的 Node.js 版本。 记下主要版本（例如，`v20.y.z`）
+4. 在储存库中前往 **Settings** > **Pages** > **Source** 。 将 source 更改为 **GitHub Actions**，然后保存。
 5. 在储存库中建立 `.github/workflows/pages.yml`，并填入以下内容 (将 `20` 替换为上个步骤中记下的版本)：
 
 ```yml .github/workflows/pages.yml
@@ -72,21 +72,21 @@ jobs:
         uses: actions/deploy-pages@v4
 ```
 
-6. Once the deployment is finished, check the webpage at _username_.github.io.
+6. 部署完成后，前往 _username_.github.io 查看网页。
 
 若你使用了一个带有 `CNAME` 的自定义域名，你需要在 `source/` 文件夹中新增 `CNAME` 文件。 [更多信息](https://docs.github.com/zh/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site)
 
 ## 项目页面
 
-If you prefer to have a project page on GitHub:
+如果您希望在 GitHub 上有一个项目页面：
 
-1. Navigate to your repo on GitHub. Go to the **Settings** tab. 建立名为 `<repository 的名字>` 的储存库，这样你的博客网址为 `<你的 GitHub 用户名>.github.io/<repository 的名字>`，repository 的名字可以任意，例如 blog 或 hexo。
+1. 导航到 GitHub 上的存储库。 转到 **Settings** 选项卡。 建立名为 `<repository 的名字>` 的储存库，这样你的博客网址为 `<你的 GitHub 用户名>.github.io/<repository 的名字>`，repository 的名字可以任意，例如 blog 或 hexo。
 2. 编辑你的 `_config.yml`，将 `url:` 更改为 `<你的 GitHub 用户名>.github.io/<repository 的名字>`。
-3. In your GitHub repo's setting, navigate to **Settings** > **Pages** > **Source**. Change the source to **GitHub Actions** and save.
+3. 在 GitHub 仓库的设置中，导航至 **Settings** > **Pages** > **Source** 。 将 source 更改为 **GitHub Actions**，然后保存。
 4. Commit 并 push 到默认分支上。
-5. Once the deployment is finished, check the webpage at _username_.github.io/_repository_.
+5. 部署完成后，前往 _username_.github.io/_repository_ 查看网页。
 
-## One-command deployment
+## 一键部署
 
 以下教学改编自 [一键部署](/zh-cn/docs/one-command-deployment)。
 
@@ -102,10 +102,10 @@ deploy:
 ```
 
 3. 执行 `hexo clean && hexo deploy` 。
-4. Check the webpage at _username_.github.io.
+4. 浏览 _username_.github.io，检查你的网站能否运作。
 
 ## 参考链接
 
-- [GitHub Pages 使用文档](https://docs.github.com/en/pages)
-- [使用自定义 GitHub Actions 工作流进行发布](https://docs.github.com/en/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site#publishing-with-a-custom-github-actions-workflow)
+- [GitHub Pages](https://docs.github.com/zh/pages)
+- [使用自定义 GitHub Actions 工作流进行发布](https://docs.github.com/zh/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site#publishing-with-a-custom-github-actions-workflow)
 - [actions/deploy-github-pages-site](https://github.com/marketplace/actions/deploy-github-pages-site)
diff --git a/source/zh-cn/docs/gitlab-pages.md b/source/zh-cn/docs/gitlab-pages.md
index 6613542cb0..def06c7d7e 100644
--- a/source/zh-cn/docs/gitlab-pages.md
+++ b/source/zh-cn/docs/gitlab-pages.md
@@ -3,13 +3,13 @@ title: 将 Hexo 部署到 GitLab Pages
 ---
 
 1. 如果你更希望你的站点部署在 `<你的 GitLab 用户名>.gitlab.io` 的子目录中，你的 repository 需要直接命名为子目录的名字，这样你的站点可以通过 `https://<你的 GitLab 用户名>.gitlab.io/<repository 的名字>` 访问。 你需要检查你的 Hexo 配置文件，将 `url` 的值修改为 `https://<你的 GitLab 用户名>.gitlab.io/<repository 的名字>`、将 `root` 的值修改为 `/<repository 的名字>/`
-2. Enable Shared Runners via **Settings** > **CI/CD** > **Runners** > **Enable shared runners for this project**.
-3. 将你的 Hexo 站点文件夹推送到 repository 中。 默认情况下 `public` 目录将不会（并且不应该）被推送到 repository 中，建议你检查 `.gitignore` 文件中是否包含 `public` 一行，如果没有请加上。 The folder structure should be roughly similar to [this repo](https://gitlab.com/pages/hexo).
-4. Check what version of Node.js you are using on your local machine with `node --version`. Make a note of the major version (e.g., `v16.y.z`)
-5. Add `.gitlab-ci.yml` file to the root folder of your repo (alongside \_config.yml & package.json) with the following content (replacing `16` with the major version of Node.js you noted in previous step):
+2. 通过 **Settings** > **CI/CD** > **Runners** > **Enable shared runners for this project** 启用共享运行程序。
+3. 将你的 Hexo 站点文件夹推送到 repository 中。 默认情况下 `public` 目录将不会（并且不应该）被推送到 repository 中，建议你检查 `.gitignore` 文件中是否包含 `public` 一行，如果没有请加上。 整体文件夹结构应该与 [示例储存库](https://gitlab.com/pages/hexo) 大致相似。
+4. 使用 `node --version` 指令检查你电脑上的 Node.js 版本。 记下主要版本（例如，`v16.y.z`）
+5. 将 `.gitlab-ci.yml` 文件添加到您的版本库根目录（与 \_config.yml & package.json并列），内容如下（将`16`替换为您在上一步中注意到的 Node.js 主版本）：
 
 ```yml
-image: node:10-alpine # use nodejs v10 LTS
+image: node:16-alpine
 cache:
   paths:
     - node_modules/
@@ -20,26 +20,26 @@ before_script:
 
 pages:
   script:
-    - hexo generate
+    - npm run build
   artifacts:
     paths:
       - public
-  only:
-    - master
+  rules:
+    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
 ```
 
 6. GitLab CI 应该会自动开始运行，构建成功以后你应该可以在 `https://<你的 GitLab 用户名>.gitlab.io` 查看你的网站。
 7. (可选) 如果你需要查看生成的文件，可以在 [job artifact](https://docs.gitlab.com/ee/ci/pipelines/job_artifacts.html) 中找到。
 
-## Project page
+## 项目页面
 
-If you prefer to have a project page on GitLab:
+如果您希望在 GitLab 上有一个项目页面：
 
-1. Go to **Settings** > **General** > **Advanced** > **Change path**. Change the value to a name, so the website is available at <b>username.gitlab.io/_repository_</b>. It can be any name, like _blog_ or _hexo_.
-2. Edit **\_config.yml**, change the `url:` value to `https://username.gitlab.io/repository`.
-3. Commit and push.
+1. 转到 **Settings** > **General** > **Advanced** > **Change path**. 修改仓库名，这样网站就可以在 <b>username.gitlab.io/_repository_</b>。 它可以是任何名字，例如 _blog_ 或 _hexo_。
+2. 编辑 **\_config.yml**，将 `url:` 的值更改为 `https://username.gitlab.io/repository`。
+3. 提交并推送
 
 ## 参考链接
 
-- [GitLab Pages 相关文档](https://docs.gitlab.com/ee/user/project/pages/)
+- [GitLab Pages](https://docs.gitlab.com/ee/user/project/pages/)
 - [GitLab CI 相关文档](https://docs.gitlab.com/ee/ci/yaml/)
diff --git a/source/zh-cn/docs/helpers.md b/source/zh-cn/docs/helpers.md
index f8ee6c0724..c77f7f0b22 100644
--- a/source/zh-cn/docs/helpers.md
+++ b/source/zh-cn/docs/helpers.md
@@ -4,7 +4,7 @@ title: 辅助函数（Helpers）
 
 辅助函数帮助您在模版中快速插入内容。 辅助函数不能在源文件中使用。
 
-You could easily [write your own custom helper](https://hexo.io/api/helper.html) or use our ready-made helpers.
+您可以轻松[编写自己的自定义 helper](https://hexo.io/api/helper.html)，或使用我们现成的 helper。
 
 {% youtube Uc53pW0GJHU %}
 
@@ -18,15 +18,15 @@ You could easily [write your own custom helper](https://hexo.io/api/helper.html)
 <%- url_for(path, [option]) %>
 ```
 
-| Option     | 描述       | 默认值                       |
+| 选项         | 描述       | 默认值                       |
 | ---------- | -------- | ------------------------- |
 | `relative` | 是否输出相对链接 | `config.relative_link` 的值 |
 
-**class_level**
+**示例：**
 
 ```yml
 _config.yml
-root: /blog/
+root: /blog/ # example
 ```
 
 ```js
@@ -44,13 +44,11 @@ relative_link: true
 ```js
 <%- url_for('/css/style.css') %>
 // ../../css/style.css
+
 /* 覆盖配置
  * 即使配置文件中启用了 relative_link，你也可以使用 relative 参数禁用相对链接输出，反之亦然
  */
 <%- url_for('/css/style.css', {relative: false}) %>
-// /css/style.css
- */
-<%- url_for('/css/style.css', {relative: false}) %>
 // /css/style.css
 ```
 
@@ -71,7 +69,7 @@ relative_link: true
 
 ### full_url_for
 
-Returns a URL with the `config.url` prefixed. Output is encoded automatically.
+返回以 `config.url` 为前缀的 URL。 输出会被自动编码。
 
 ```js
 <%- full_url_for(path) %>
@@ -99,12 +97,12 @@ url: https://example.com/blog # example
 <%- gravatar(email, [options]) %>
 ```
 
-| Option | 描述       | 默认值 |
-| ------ | -------- | --- |
-| `s`    | 图片大小     | 80  |
-| `d`    | 默认头像     |     |
-| `f`    | 强制使用默认图象 |     |
-| `r`    | Rating   |     |
+| 选项  | 描述       | 默认值 |
+| --- | -------- | --- |
+| `s` | 输出的图片的大小 | 80  |
+| `d` | 默认头像     |     |
+| `f` | 强制使用默认图象 |     |
+| `r` | Rating   |     |
 
 访问 [Gravatar](https://en.gravatar.com/site/implement/images/) 了解更多。
 
@@ -125,7 +123,7 @@ url: https://example.com/blog # example
 
 ### css
 
-加载 CSS 文件。 `path` can be an array or a string. `path` can be a string, an array, an object or an array of objects. `path` 可以是数组或字符串，如果 `path` 开头不是 `/` 或任何协议，则会自动加上根路径；如果后面没有加上 `.css` 扩展名的话，也会自动加上。 对于自定义属性请使用对象类型。
+加载 CSS 文件。 `path` can be a string, an array, an object or an array of objects. `path` 可以是数组或字符串，如果 `path` 开头不是 `/` 或任何协议，则会自动加上根路径；如果后面没有加上 `.css` 扩展名的话，也会自动加上。 对于自定义属性请使用对象类型。
 
 ```js
 <%- css(path, ...) %>
@@ -183,7 +181,7 @@ url: https://example.com/blog # example
 <%- link_to(path, [text], [options]) %>
 ```
 
-| Option     | 描述       | 默认值   |
+| 选项         | 描述       | 默认值   |
 | ---------- | -------- | ----- |
 | `external` | 在新视窗打开链接 | false |
 | `class`    | Class 名称 |       |
@@ -210,12 +208,12 @@ url: https://example.com/blog # example
 <%- mail_to(path, [text], [options]) %>
 ```
 
-| Option    | 描述       |
+| 选项        | 描述       |
 | --------- | -------- |
 | `class`   | Class 名称 |
 | `id`      | ID       |
 | `subject` | 邮件主题     |
-| `cc`      | CC       |
+| `cc`      | 抄送（CC）   |
 | `bcc`     | 密送（BCC）  |
 | `body`    | 邮件内容     |
 
@@ -237,7 +235,7 @@ url: https://example.com/blog # example
 <%- image_tag(path, [options]) %>
 ```
 
-| Option   | 描述       |
+| 选项       | 描述       |
 | -------- | -------- |
 | `alt`    | 图片的替代文字  |
 | `class`  | Class 名称 |
@@ -261,7 +259,7 @@ url: https://example.com/blog # example
 <%- feed_tag(path, [options]) %>
 ```
 
-| Option  | 描述      | 默认值            |
+| 选项      | 描述      | 默认值            |
 | ------- | ------- | -------------- |
 | `title` | Feed 标题 | `config.title` |
 | `type`  | Feed 类型 |                |
@@ -273,14 +271,14 @@ url: https://example.com/blog # example
 // <link rel="alternate" href="/atom.xml" title="Hexo" type="application/atom+xml">
 
 <%- feed_tag('rss.xml', { title: 'RSS Feed', type: 'rss' }) %>
-// <link rel="alternate" href="/atom.xml" title="RSS Feed" type="application/rss+xml">
+// <link rel="alternate" href="/atom.xml" title="RSS Feed" type="application/atom+xml">
 
 /* Defaults to hexo-generator-feed's config if no argument */
 <%- feed_tag() %>
 // <link rel="alternate" href="/atom.xml" title="Hexo" type="application/atom+xml">
 ```
 
-## Conditional Tags
+## 条件标签
 
 ### is_current
 
@@ -332,7 +330,7 @@ url: https://example.com/blog # example
 
 ### is_year
 
-Check whether the current page is a yearly archive page.
+检查当前页面是否为年度归档页面。
 
 ```js
 <%- is_year() %>
@@ -340,7 +338,7 @@ Check whether the current page is a yearly archive page.
 
 ### is_month
 
-检查当前页面是否为首页。
+检查当前页面是否为月度存档页面。
 
 ```js
 <%- is_month() %>
@@ -386,7 +384,6 @@ Check whether the current page is a yearly archive page.
 
 ```js
 <%- strip_html('It\'s not <b>important</b> anymore!') %>
-// It's not important anymore! %>
 // It's not important anymore!
 ```
 
@@ -457,7 +454,7 @@ Check whether the current page is a yearly archive page.
 移除超过 `length` 长度的字符串。 `length` 的默认值是 30。
 
 ```js
-<%- truncate(text, length) %>
+<%- truncate(text, [options]) %>
 ```
 
 **示例：**
@@ -469,12 +466,6 @@ Check whether the current page is a yearly archive page.
 <%- truncate('Once upon a time in a world far far away', {length: 17, separator: ' '}) %>
 // Once upon a...
 
-<%- truncate('And they found that many people were sleeping better.', {length: 25, omission: '... (continued)'}) %>
-// And they f... (continued)
-
-<%- truncate('Once upon a time in a world far far away', {length: 17, separator: ' '}) %>
-// Once upon a...
-
 <%- truncate('And they found that many people were sleeping better.', {length: 25, omission: '... (continued)'}) %>
 // And they f... (continued)
 ```
@@ -498,13 +489,13 @@ Check whether the current page is a yearly archive page.
 
 ### partial
 
-Loads other template files. You can define local variables in `locals`.
+加载其他模板文件。 您可以在 `locals` 中定义局部变量。
 
 ```js
 <%- partial(layout, [locals], [options]) %>
 ```
 
-| Option  | 描述                                | 默认值     |
+| 选项      | 描述                                | 默认值     |
 | ------- | --------------------------------- | ------- |
 | `cache` | 缓存（使用 Fragment cache）             | `false` |
 | `only`  | 限制局部变量。 在模板中只能使用 `locals` 中设定的变量。 | `false` |
@@ -646,17 +637,17 @@ Loads other template files. You can define local variables in `locals`.
 <%- list_categories([options]) %>
 ```
 
-| Option       | 描述                                                                                                                                | 默认值      |
-| ------------ | --------------------------------------------------------------------------------------------------------------------------------- | -------- |
-| `orderby`    | 分类排列方式                                                                                                                            | name     |
-| `order`      | 排列顺序。 `1`, `asc` 升序；`-1`, `desc` 降序。                                                                                              | 1        |
-| `show_count` | 显示每个分类的文章总数                                                                                                                       | true     |
-| `style`      | Style to display the category list. 分类列表的显示方式。 使用 `list` 以无序列表（unordered list）方式显示。 Use `false` or any other value to disable it. | list     |
-| `separator`  | 分类间的分隔符号。 只有在 `style` 不是 `list` 时有用。                                                                                              | ,        |
-| `depth`      | 要显示的分类层级。 `0` 显示所有层级的分类；`-1` 和 `0` 很类似，但是显示不分层级；`1` 只显示第一层的分类。                                                                    | 0        |
-| `class`      | 分类列表的 class 名称。                                                                                                                   | category |
-| `transform`  | 改变分类名称显示方法的函数                                                                                                                     |          |
-| `suffix`     | 为链接添加前缀                                                                                                                           | None     |
+| 选项           | 描述                                                                    | 默认值      |
+| ------------ | --------------------------------------------------------------------- | -------- |
+| `orderby`    | 分类排列方式                                                                | name     |
+| `order`      | 排列顺序。 `1`, `asc` 升序；`-1`, `desc` 降序。                                  | 1        |
+| `show_count` | 显示每个分类的文章总数                                                           | true     |
+| `style`      | 分类列表的显示方式。 使用 `list` 以无序列表（unordered list）方式显示。 使用 `false` 或任何其他值禁用它。 | list     |
+| `separator`  | 分类间的分隔符号。 只有在 `style` 不是 `list` 时有用。                                  | ,        |
+| `depth`      | 要显示的分类层级。 `0` 显示所有层级的分类；`-1` 和 `0` 很类似，但是显示不分层级；`1` 只显示第一层的分类。        | 0        |
+| `class`      | 分类列表的 class 名称。                                                       | category |
+| `transform`  | 改变分类名称显示方法的函数                                                         |          |
+| `suffix`     | 为链接添加前缀                                                               | None     |
 
 **示例：**
 
@@ -667,7 +658,8 @@ Loads other template files. You can define local variables in `locals`.
     return titlecase(str);
   }
 }) %>
- <%- list_categories(post.categories, {
+
+<%- list_categories(post.categories, {
   class: 'post-category',
   transform(str) {
     return str.toUpperCase();
@@ -683,21 +675,21 @@ Loads other template files. You can define local variables in `locals`.
 <%- list_tags([options]) %>
 ```
 
-| 选项           | 描述                                                                                                                           | Default |
-| ------------ | ---------------------------------------------------------------------------------------------------------------------------- | ------- |
-| `orderby`    | Order of categories                                                                                                          | name    |
-| `order`      | 分类排列顺序。 `1`, `asc` 升序；`-1`, `desc` 降序。                                                                                       | 1       |
-| `show_count` | 显示每个标签的文章总数                                                                                                                  | true    |
-| `style`      | Style to display the tag list. 标签列表的显示方式。 使用 `list` 以无序列表（unordered list）方式显示。 Use `false` or any other value to disable it. | list    |
-| `separator`  | 标签间的分隔符号。 只有在 `style` 不是 `list` 时有用。                                                                                         | ,       |
-| `class`      | 标签列表的类名（字符串）或自定义每个标签的类（对象，见下文）。                                                                                              | tag     |
-| `transform`  | 改变标签名称显示方法的函数。 请查看 [list_categories](#list-categories) 中给出的例子                                                                |         |
-| `amount`     | 要显示的标签数量（0 = 无限制）                                                                                                            | 0       |
-| `suffix`     | 为链接添加前缀                                                                                                                      | None    |
+| 选项           | 描述                                                                    | 默认值  |
+| ------------ | --------------------------------------------------------------------- | ---- |
+| `orderby`    | 标签排列方式                                                                | name |
+| `order`      | 排列顺序。 `1`, `asc` 升序；`-1`, `desc` 降序。                                  | 1    |
+| `show_count` | 显示每个标签的文章总数                                                           | true |
+| `style`      | 标签列表的显示方式。 使用 `list` 以无序列表（unordered list）方式显示。 使用 `false` 或任何其他值禁用它。 | list |
+| `separator`  | 标签间的分隔符号。 只有在 `style` 不是 `list` 时有用。                                  | ,    |
+| `class`      | 标签列表的类名（字符串）或自定义每个标签的类（对象，见下文）。                                       | tag  |
+| `transform`  | 改变标签名称显示方法的函数。 请查看 [list_categories](#list-categories) 中给出的例子         |      |
+| `amount`     | 要显示的标签数量（0 = 无限制）                                                     | 0    |
+| `suffix`     | 为链接添加前缀                                                               | None |
 
 类的高级定制：
 
-| 选项            | 描述                                                                                      | Default                                    |
+| 选项            | 描述                                                                                      | 默认值                                        |
 | ------------- | --------------------------------------------------------------------------------------- | ------------------------------------------ |
 | `class.ul`    | `<ul>` 类名 （只适用于样式 `list`）                                                         | `tag-list` （列表样式）                          |
 | `class.li`    | `<li>` 类名 （只适用于样式 `list`）                                                         | `tag-list-item` （列表样式）                     |
@@ -722,16 +714,16 @@ Loads other template files. You can define local variables in `locals`.
 <%- list_archives([options]) %>
 ```
 
-| Option       | 描述                                                                                                                               | 默认值       |
-| ------------ | -------------------------------------------------------------------------------------------------------------------------------- | --------- |
-| `type`       | 类型。 此设定可为 `yearly` 或 `monthly`。                                                                                                  | monthly   |
-| `order`      | 标签排列顺序。 `1`, `asc` 升序；`-1`, `desc` 降序。                                                                                           | 1         |
-| `show_count` | 显示每个归档的文章总数                                                                                                                      | true      |
-| `format`     | 日期格式                                                                                                                             | MMMM YYYY |
-| `style`      | Style to display the archive list. 归档列表的显示方式。 使用 `list` 以无序列表（unordered list）方式显示。 Use `false` or any other value to disable it. | list      |
-| `separator`  | 归档间的分隔符号。 只有在 `style` 不是 `list` 时有用。                                                                                             | ,         |
-| `class`      | 归档列表的 class 名称。                                                                                                                  | archive   |
-| `transform`  | 改变归档名称显示方法的函数。 请查看 [list_categories](#list-categories) 中给出的例子                                                                    |           |
+| 选项           | 描述                                                                    | 默认值       |
+| ------------ | --------------------------------------------------------------------- | --------- |
+| `type`       | 类型。 此设定可为 `yearly` 或 `monthly`。                                       | monthly   |
+| `order`      | 排列顺序。 `1`, `asc` 升序；`-1`, `desc` 降序。                                  | 1         |
+| `show_count` | 显示每个归档的文章总数                                                           | true      |
+| `format`     | 日期格式                                                                  | MMMM YYYY |
+| `style`      | 归档列表的显示方式。 使用 `list` 以无序列表（unordered list）方式显示。 使用 `false` 或任何其他值禁用它。 | list      |
+| `separator`  | 归档间的分隔符号。 只有在 `style` 不是 `list` 时有用。                                  | ,         |
+| `class`      | 归档列表的 class 名称。                                                       | archive   |
+| `transform`  | 改变归档名称显示方法的函数。 请查看 [list_categories](#list-categories) 中给出的例子         |           |
 
 ### list_posts
 
@@ -741,15 +733,15 @@ Loads other template files. You can define local variables in `locals`.
 <%- list_posts([options]) %>
 ```
 
-| Option      | 描述                                                                                            | 默认值  |
-| ----------- | --------------------------------------------------------------------------------------------- | ---- |
-| `orderby`   | Order of posts                                                                                | date |
-| `order`     | 文章排列顺序。 `1`, `asc` 升序；`-1`, `desc` 降序。                                                        | 1    |
-| `style`     | 文章列表的显示方式。 使用 `list` 以无序列表（unordered list）方式显示。 Use `false` or any other value to disable it. | list |
-| `separator` | 文章间的分隔符号。 只有在 `style` 不是 `list` 时有用。                                                          | ,    |
-| `class`     | 文章列表的 class 名称。                                                                               | post |
-| `amount`    | 要显示的文章数量（0 = 无限制）                                                                             | 6    |
-| `transform` | 改变文章名称显示方法的函数。 请查看 [list_categories](#list-categories) 中给出的例子                                 |      |
+| 选项          | 描述                                                                    | 默认值  |
+| ----------- | --------------------------------------------------------------------- | ---- |
+| `orderby`   | 文章排序方式                                                                | date |
+| `order`     | 文章排列顺序。 `1`, `asc` 升序；`-1`, `desc` 降序。                                | 1    |
+| `style`     | 文章列表的显示方式。 使用 `list` 以无序列表（unordered list）方式显示。 使用 `false` 或任何其他值禁用它。 | list |
+| `separator` | 文章间的分隔符号。 只有在 `style` 不是 `list` 时有用。                                  | ,    |
+| `class`     | 文章列表的 class 名称。                                                       | post |
+| `amount`    | 要显示的文章数量（0 = 无限制）                                                     | 6    |
+| `transform` | 改变文章名称显示方法的函数。 请查看 [list_categories](#list-categories) 中给出的例子         |      |
 
 ### tagcloud
 
@@ -759,7 +751,7 @@ Loads other template files. You can define local variables in `locals`.
 <%- tagcloud([tags], [options]) %>
 ```
 
-| Option                 | 描述                                                                                                                           | 默认值       |
+| 选项                     | 描述                                                                                                                           | 默认值       |
 | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------- | --------- |
 | `min_font`             | 最小字体尺寸                                                                                                                       | 10        |
 | `max_font`             | 最大字体尺寸                                                                                                                       | 20        |
@@ -789,13 +781,13 @@ Loads other template files. You can define local variables in `locals`.
 
 ### paginator
 
-Inserts a paginator.
+插入 paginator.
 
 ```js
 <%- paginator(options) %>
 ```
 
-| Option                     | 描述                                              | 默认值           |
+| 选项                         | 描述                                              | 默认值           |
 | -------------------------- | ----------------------------------------------- | ------------- |
 | `base`                     | 基础网址                                            | /             |
 | `format`                   | 网址格式                                            | page/%d/      |
@@ -803,13 +795,13 @@ Inserts a paginator.
 | `current`                  | 目前页数                                            | 0             |
 | `prev_text`                | 上一页链接的文字。 仅在 `prev_next` 设定开启时才有用。              | Prev          |
 | `next_text`                | 下一页链接的文字。 仅在 `prev_next` 设定开启时才有用。              | Next          |
-| `space`                    | 空白文字                                            | &hellip;      |
+| `space`                    | 空白文字                                            | &hellp;       |
 | `prev_next`                | 显示上一页和下一页的链接                                    | true          |
 | `end_size`                 | 显示于两侧的页数                                        | 1             |
 | `mid_size`                 | 显示于中间的页数                                        | 2             |
 | `show_all`                 | 显示所有页数。 如果开启此参数的话，`end_size` 和 `mid_size` 就没用了。 | false         |
 | `escape`                   | 转义 HTML 标签                                      | true          |
-| page_class                 | 分页链接的 class 名称                                  | `page-number` |
+| `page_class` (+6.3.0)      | 分页链接的 class 名称                                  | `page-number` |
 | `current_class` (+6.3.0)   | 当前页链接的 class 名称                                 | `current`     |
 | `space_class` (+6.3.0)     | 空白文字的 class 名称                                  | `space`       |
 | `prev_class` (+6.3.0)      | 上一页链接的 class 名称                                 | `extend prev` |
@@ -859,11 +851,11 @@ Inserts a paginator.
 <%- search_form(options) %>
 ```
 
-| Option   | 描述                                                                                                         | 默认值         |
-| -------- | ---------------------------------------------------------------------------------------------------------- | ----------- |
-| `class`  | 表单的 class name                                                                                             | search-form |
-| `text`   | 搜索提示文字                                                                                                     | Search      |
-| `button` | 显示搜索按钮。 The value can be a boolean or a string. If the value is a string, it'll be the text of the button. | false       |
+| 选项       | 描述                                      | 默认值         |
+| -------- | --------------------------------------- | ----------- |
+| `class`  | 表单的 class name                          | search-form |
+| `text`   | 搜索提示文字                                  | Search      |
+| `button` | 显示搜索按钮。 该值可以是布尔值或字符串。 如果是字符串，它将会是按钮的文本。 | false       |
 
 ### number_format
 
@@ -873,7 +865,7 @@ Inserts a paginator.
 <%- number_format(number, [options]) %>
 ```
 
-| Option      | 描述                         | 默认值   |
+| 选项          | 描述                         | 默认值   |
 | ----------- | -------------------------- | ----- |
 | `precision` | 数字精度。 此选项可为 `false` 或非负整数。 | false |
 | `delimiter` | 千位数分隔符号                    | ,     |
@@ -915,13 +907,13 @@ Inserts a paginator.
 
 ### open_graph
 
-Inserts [Open Graph][] data.
+插入 [Open Graph][] 数据。
 
 ```js
 <%- open_graph([options]) %>
 ```
 
-| Option          | 描述                                   | 默认值                                                     |
+| 选项              | 描述                                   | 默认值                                                     |
 | --------------- | ------------------------------------ | ------------------------------------------------------- |
 | `title`         | 页面标题 (`og:title`)                    | `page.title`                                            |
 | `type`          | 页面类型 (`og:type`)                     | article(post page)<br>website(non-post page)      |
@@ -949,7 +941,7 @@ Inserts [Open Graph][] data.
 <%- toc(str, [options]) %>
 ```
 
-| Option                  | 描述                  | 默认值               |
+| 选项                      | 描述                  | 默认值               |
 | ----------------------- | ------------------- | ----------------- |
 | `class`                 | Class 名称            | `toc`             |
 | `class_item` (+6.3.0)   | 目录元素的 Class 名称      | `${class}-item`   |
@@ -961,6 +953,7 @@ Inserts [Open Graph][] data.
 | `list_number`           | 显示编号                | true              |
 | `max_depth`             | 生成 TOC 的最大深度        | 6                 |
 | `min_depth`             | 生成 TOC 的最小深度        | 1                 |
+| `max_items` (+7.3.0)    | 生成的 toc 的最大项目数      | `Infinity`        |
 
 **示例：**
 
@@ -972,7 +965,7 @@ Inserts [Open Graph][] data.
 
 带有 `data-toc-unnumbered="true"` 属性的标题将被标记为未编号（不显示列表编号）。
 
-{% note warn "警告！" %} %}
+{% note warn "警告！" %}
 对于使用 `data-toc-unnumbered="true"`，渲染引擎必须要有添加 CSS 类的选项。
 
 请看下面的 PR。
diff --git a/source/zh-cn/docs/index.md b/source/zh-cn/docs/index.md
index 8e0722d15b..e5216dd48c 100644
--- a/source/zh-cn/docs/index.md
+++ b/source/zh-cn/docs/index.md
@@ -10,11 +10,11 @@ Hexo 是一个快速、简洁且高效的博客框架。 Hexo 使用 [Markdown](
 
 ## 安装
 
-It only takes a few minutes to set up Hexo. If you encounter a problem and can't find the solution here, please [submit a GitHub issue](https://github.com/hexojs/hexo/issues) and we'll help.
+设置 Hexo 只需几分钟。 如果您遇到问题，并且在这里找不到解决方案，请[提交 GitHub 问题](https://github.com/hexojs/hexo/issues)，我们将提供帮助。
 
 {% youtube PsXWbI2Mqu0 %}
 
-### Requirements
+### 要求
 
 安装 Hexo 相当简单，只需要先安装下列应用程序即可：
 
@@ -33,7 +33,7 @@ It only takes a few minutes to set up Hexo. If you encounter a problem and can't
 - Linux (Fedora, Red Hat, CentOS)：`sudo yum install git-core`
 
 {% note warn Mac 用户 %}
-You may encounter some problems when compiling. Please install Xcode from App Store first. 如果在编译时可能会遇到问题，请先到 App Store 安装 Xcode，Xcode 完成后，启动并进入 **Preferences -> Download -> Command Line Tools -> Install** 安装命令行工具。
+如果在编译时可能会遇到问题。 请先到 App Store 安装 Xcode。 Xcode 完成后，启动并进入 **Preferences -> Download -> Command Line Tools -> Install** 安装命令行工具。
 {% endnote %}
 
 ### 安装 Node.js
@@ -45,15 +45,15 @@ Node.js 为大多数平台提供了官方的 [安装程序](https://nodejs.org/z
 - Windows：通过 [nvs](https://github.com/jasongin/nvs/)（推荐）或者 [nvm](https://github.com/nvm-sh/nvm) 安装。
 - Mac：使用 [Homebrew](https://brew.sh/) 或 [MacPorts](http://www.macports.org/) 安装。
 - Linux（DEB/RPM-based）：从 [NodeSource](https://github.com/nodesource/distributions) 安装。
-- Others: Install it through respective package manager. 其它：使用相应的软件包管理器进行安装，可以参考由 Node.js 提供的 [指导](https://nodejs.org/en/download/package-manager/)。
+- 其它：使用相应的软件包管理器进行安装。 可以参考由 Node.js 提供的 [指导](https://nodejs.org/en/download/package-manager/)。
 
 对于 Mac 和 Linux 同样建议使用 nvs 或者 nvm，以避免可能会出现的权限问题。
 
-{% note info Windows 用户 %}
+{% note info Windows %}
 使用 Node.js 官方安装程序时，请确保勾选 **Add to PATH** 选项（默认已勾选）
 {% endnote %}
 
-{% note info Windows 用户 %}
+{% note warn Mac / Linux %}
 如果在尝试安装 Hexo 的过程中出现 `EACCES` 权限错误，请遵循 [由 npmjs 发布的指导](https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally) 修复该问题。
 {% endnote %}
 
diff --git a/source/zh-cn/docs/internationalization.md b/source/zh-cn/docs/internationalization.md
index a5fd5a498a..ffd5581bc8 100644
--- a/source/zh-cn/docs/internationalization.md
+++ b/source/zh-cn/docs/internationalization.md
@@ -2,7 +2,7 @@
 title: 国际化（i18n）
 ---
 
-若要让您的网站以不同语言呈现，您可使用国际化（internationalization）功能。 请先在 `_config.yml` 中调整 `language` 设定，这代表的是预设语言，您也可设定多个语言来调整预设语言的顺位。 You can also set multiple languages and modify the order of default languages.
+若要让您的网站以不同语言呈现，您可使用国际化（internationalization）功能。 请先在 `_config.yml` 中调整 `language` 设定，这代表的是预设语言。 您也可设定多个语言来调整预设语言的顺位。
 
 ```yaml
 language: zh-tw
@@ -14,11 +14,11 @@ language:
 
 ### 语言文件
 
-Language files can be YAML or JSON files. 语言文件可以使用 YAML 或 JSON 编写，并放在主题文件夹中的 `languages` 文件夹。 您可以在语言文件中使用 [printf 格式](https://github.com/alexei/sprintf.js)。
+语言文件可以使用 YAML 或 JSON 编写。 并放在主题文件夹中的 `languages` 文件夹。 您可以在语言文件中使用 [printf 格式](https://github.com/alexei/sprintf.js)。
 
 ### 模板
 
-Use `__` or `_p` helpers in templates to get the translated strings. The former is for normal usage and the latter is for plural strings. For example:
+在模板中使用 `__` 或 `_p` 辅助函数来获取翻译后的字符串。 前者用于一般使用，后者用于复数字符串。 例如：
 
 ```yaml en.yml
 index:
@@ -54,4 +54,4 @@ i18n_dir: :lang
 /zh-tw/index.html => zh-tw
 ```
 
-The string will only be served as a language when the language file exists. 捕获到的字符串唯有在语言文件存在的情况下，才会被当作是语言，因此例二 `/archives/index.html` 中的 `archives` 就不被当成是语言。
+捕获到的字符串唯有在语言文件存在的情况下，才会被当作是语言。 因此，`/archives/index.html`（例 2）中的 `archives` 就不被当成是语言。
diff --git a/source/zh-cn/docs/migration.md b/source/zh-cn/docs/migration.md
index 85b7505ca9..39c0d45ff9 100644
--- a/source/zh-cn/docs/migration.md
+++ b/source/zh-cn/docs/migration.md
@@ -28,9 +28,9 @@ new_post_name: :year-:month-:day-:title.md
 
 ## Octopress
 
-Move all files in the Octopress `source/_posts` folder to `source/_posts`
+将 Octopress `source/_posts` 文件夹中的所有文件移到 `source/_posts` 文件夹中
 
-Modify the `new_post_name` setting in `_config.yml`:
+修改`_config.yml`中的`new_post_name`设置：
 
 ```yaml
 new_post_name: :year-:month-:day-:title.md
@@ -46,7 +46,7 @@ $ npm install hexo-migrator-wordpress --save
 
 在 WordPress 仪表盘中导出数据("Tools" → "Export" → "WordPress")（详情参考[WP支持页面](https://wordpress.com/zh-cn/support/export/)）。
 
-Now run:
+运行：
 
 ```bash
 $ hexo migrate wordpress <source>
@@ -64,7 +64,7 @@ $ npm install hexo-migrator-joomla --save
 
 使用 [J2XML](http://extensions.joomla.org/extensions/migration-a-conversion/data-import-a-export/12816?qh=YToxOntpOjA7czo1OiJqMnhtbCI7fQ%3D%3D) 组件导出 Joomla 文章。
 
-Now run:
+运行：
 
 ```bash
 $ hexo migrate joomla <source>
diff --git a/source/zh-cn/docs/one-command-deployment.md b/source/zh-cn/docs/one-command-deployment.md
index 7be97e1395..9f341fd97f 100644
--- a/source/zh-cn/docs/one-command-deployment.md
+++ b/source/zh-cn/docs/one-command-deployment.md
@@ -1,23 +1,23 @@
 ---
-title: One-Command Deployment
+title: 一键部署
 ---
 
-Hexo provides a fast and easy deployment strategy. You only need one single command to deploy your site to your server.
+Hexo 提供快速、简便的部署策略。 您只需一条命令即可将网站部署到服务器上。
 
 ```bash
 $ hexo deploy
 ```
 
-Install the necessary plugin(s) that is compatible with the deployment method provided by your server/repository.
+安装与服务器/存储库提供的部署方法兼容的必要插件。
 
-Deployment is usually configured through **\_config.yml**. A valid configuration must have the `type` field. For example:
+部署通常通过**\_config.yml**进行配置。 有效配置必须有 `type` 字段。 例如：
 
 ```yaml
 deploy:
   type: git
 ```
 
-您可同时使用多个 deployer，Hexo 会依照顺序执行每个 deployer。 Hexo will execute each deployer in order.
+您可同时使用多个 deployer。 Hexo 会依照顺序执行每个 deployer。
 
 ```yaml
 deploy:
@@ -37,27 +37,27 @@ deploy:
 $ npm install hexo-deployer-git --save
 ```
 
-2. Edit **\_config.yml** (with example values shown below as comments):
+2. 编辑 **\_config.yml** （示例值如下所示）：
 
 ```yaml
 deploy:
   type: git
-  repo: <repository url> #https://bitbucket.org/JohnSmith/johnsmith.bitbucket.io
+  repo: <repository url> # https://bitbucket.org/JohnSmith/johnsmith.bitbucket.io
   branch: [branch]
   message: [message]
 ```
 
-| Option    | 描述                                       | 默认                                                                                     |
-| --------- | ---------------------------------------- | -------------------------------------------------------------------------------------- |
-| `repo`    | URL of the target repository             |                                                                                        |
-| `branch`  | 分支名称                                     | `gh-pages` (GitHub)<br>`coding-pages` (Coding.net)<br>`master` (others)    |
-| `message` | 自定义提交信息                                  | `<code>Site updated: {% raw %}{{ now('YYYY-MM-DD HH:mm:ss') }}{% endraw %}`)</code> |
-| `token`   | 可选的令牌值，用于认证 repo。 用 `$` 作为前缀从而从环境变量中读取令牌 |                                                                                        |
+| 选项        | 描述                                       | 默认                                                                                  |
+| --------- | ---------------------------------------- | ----------------------------------------------------------------------------------- |
+| `repo`    | 目标存储库的 URL                               |                                                                                     |
+| `branch`  | 分支名称                                     | `gh-pages` (GitHub)<br>`coding-pages` (Coding.net)<br>`master` (others) |
+| `message` | 自定义提交信息                                  | `Site updated: {% raw %}{{ now('YYYY-MM-DD HH:mm:ss') }}{% endraw %}`               |
+| `token`   | 可选的令牌值，用于认证 repo。 用 `$` 作为前缀从而从环境变量中读取令牌 |                                                                                     |
 
 3. 此外，如果您的 Github Pages 需要使用 CNAME 文件**自定义域名**，请将 CNAME 文件置于 `source` 目录下，只有这样 `hexo deploy` 才能将 CNAME 文件一并推送至部署分支。
 
 - 除非你使用令牌或 SSH 密钥认证，否则你会被提示提供目标仓库的用户名和密码。
-- hexo-deployer-git 并不会存储你的用户名和密码. 请使用 [git-credential-cache](https://git-scm.com/docs/git-credential-cache) 来临时存储它们。 Use [git-credential-cache](https://git-scm.com/docs/git-credential-cache) to store them temporarily.
+- hexo-deployer-git 并不会存储你的用户名和密码。 请使用 [git-credential-cache](https://git-scm.com/docs/git-credential-cache) 来临时存储它们。
 
 4. 登入 Github/BitBucket/Gitlab，请在库设置（Repository Settings）中将默认分支设置为`_config.yml`配置中的分支名称。 稍等片刻，您的站点就会显示在您的Github Pages中。
 
@@ -78,14 +78,14 @@ deploy:
   message: [message]
 ```
 
-| Option               | 描述                                                                                 |
+| 选项                   | 描述                                                                                 |
 | -------------------- | ---------------------------------------------------------------------------------- |
 | `repo`, `repository` | Heroku 库（Repository）地址                                                             |
 | `message`            | 自定提交信息 (默认为 `Site updated: {% raw %}{{ now('YYYY-MM-DD HH:mm:ss') }}{% endraw %}`) |
 
 ## Netlify
 
-[Netlify](https://www.netlify.com/) provides continuous deployment (Git-triggered builds), an intelligent global CDN, full DNS (including custom domains), automated HTTPS, asset acceleration, and a lot more. It is a unified platform that automates your code to create high-performance, easily maintainable sites and web apps.
+[Netlify](https://www.netlify.com/) 提供持续部署（Git 触发构建）、智能全球 CDN、完整 DNS（包括自定义域）、自动 HTTPS、资产加速等功能。 它是一个统一的平台，可自动执行代码，创建高性能、易于维护的网站和网络应用程序。
 
 There are two different ways to deploy your sites on Netlify. 首先，也是最通用的方式，就是使用Netlify提供的网页端用户界面。 前往[新建一个网站页面](https://app.netlify.com/start)，选择需要关联的 Github/BitBucket/Gitlab 库，然后遵循网站提示。
 
@@ -115,7 +115,7 @@ deploy:
   ignore_errors: [true|false]
 ```
 
-| Option          | 描述          | 默认值   |
+| 选项              | 描述          | 默认值   |
 | --------------- | ----------- | ----- |
 | `host`          | 远程主机的地址     |       |
 | `user`          | 使用者名称       |       |
@@ -146,10 +146,10 @@ deploy:
   message: [message]
 ```
 
-| Option    | 描述                                                                                 |
-| --------- | ---------------------------------------------------------------------------------- |
-| `repo`    | OpenShift 库（Repository）地址                                                          |
-| `message` | 自定提交信息 (默认为 `Site updated: {% raw %}{{ now('YYYY-MM-DD HH:mm:ss') }}{% endraw %}`) |
+| 选项        | 描述                                                                                |
+| --------- | --------------------------------------------------------------------------------- |
+| `repo`    | OpenShift 库（Repository）地址                                                         |
+| `message` | 自定提交信息（默认为 `Site updated： {% raw %}{{ now('YYYY-MM-DD HH:mm:ss') }}{% endraw %}`) |
 
 ## FTPSync
 
@@ -173,7 +173,7 @@ deploy:
   verbose: [true|false]
 ```
 
-| Option    | 描述                      | 默认值   |
+| 选项        | 描述                      | 默认值   |
 | --------- | ----------------------- | ----- |
 | `host`    | 远程主机的地址                 |       |
 | `user`    | 使用者名称                   |       |
@@ -206,18 +206,18 @@ deploy:
   agent: [path/to/agent/socket]
 ```
 
-| Option        | 描述                                              | 默认值              |
-| ------------- | ----------------------------------------------- | ---------------- |
-| `host`        | 远程主机的地址                                         |                  |
-| `port`        | 端口                                              | 22               |
-| `user`        | 使用者名称                                           |                  |
-| `pass`        | 密码                                              |                  |
-| `privateKey`  | ssh私钥的目录地址                                      |                  |
-| `passphrase`  | Optional passphrase for the private key         |                  |
-| `agent`       | ssh套接字的目录地址                                     | `$SSH_AUTH_SOCK` |
-| `remotePath`  | 远程主机的根目录                                        | `/`              |
-| `forceUpload` | Override existing files                         | false            |
-| `concurrency` | Max number of SFTP tasks processed concurrently | 100              |
+| 选项            | 描述                                      | 默认值              |
+| ------------- | --------------------------------------- | ---------------- |
+| `host`        | 远程主机的地址                                 |                  |
+| `port`        | 端口                                      | 22               |
+| `user`        | 使用者名称                                   |                  |
+| `pass`        | 密码                                      |                  |
+| `privateKey`  | SSH 私钥的目录地址                             |                  |
+| `passphrase`  | Optional passphrase for the private key |                  |
+| `agent`       | ssh套接字的目录地址                             | `$SSH_AUTH_SOCK` |
+| `remotePath`  | 远程主机的根目录                                | `/`              |
+| `forceUpload` | 覆盖现有的文件                                 | false            |
+| `concurrency` | 同时处理的 SFTP 任务的最大数量                      | 100              |
 
 ## Vercel
 
@@ -280,7 +280,7 @@ $ hexo generate —deploy && bip deploy
 2. 修改配置。
 
 ```yaml
-deploy: # 所有部署器的根配置块
+deploy: # The root configuration block for all deployers
   - type: rss3
     endpoint: https://hub.rss3.io
     privateKey: 47e18d6c386898b424025cd9db446f779ef24ad33a26c499c87bb3d9372540ba
@@ -331,11 +331,11 @@ edgio deploy
 
 此外，你也可以点击下面的部署按钮来创建一个新的项目：
 
-[![Deploy To Edgio](https://docs.edg.io/button.svg)](https://app.layer0.co/deploy?repo=https%3A%2F%2Fgithub.com%2Fedgio-docs%2Fedgio-hexo-example)
+[![部署到 Edgio](https://docs.edg.io/button.svg)](https://app.layer0.co/deploy?repo=https%3A%2F%2Fgithub.com%2Fedgio-docs%2Fedgio-hexo-example)
 
 ## 其他方法
 
-Hexo 生成的所有文件都放在 `public` 文件夹中，您可以将它们复制到您喜欢的地方。 You can copy them to wherever you like.
+Hexo 生成的所有文件都放在 `public` 文件夹中。 您可以将它们复制到您喜欢的地方。
 
 [hexo-deployer-git]: https://github.com/hexojs/hexo-deployer-git
 [hexo-deployer-heroku]: https://github.com/hexojs/hexo-deployer-heroku
diff --git a/source/zh-cn/docs/permalinks.md b/source/zh-cn/docs/permalinks.md
index 3e8bf4c57a..2ff4c2bb2f 100644
--- a/source/zh-cn/docs/permalinks.md
+++ b/source/zh-cn/docs/permalinks.md
@@ -42,7 +42,7 @@ categories:
   - bar
 ```
 
-| Setting                         | 结果                          |
+| 设置                              | 结果                          |
 | ------------------------------- | --------------------------- |
 | `:year/:month/:day/:title/`     | 2013/07/14/hello-world/     |
 | `:year-:month-:day-:title.html` | 2013-07-14-hello-world.html |
@@ -57,7 +57,7 @@ categories:
   - bar
 ```
 
-| Setting                     | 结果                            |
+| 设置                          | 结果                            |
 | --------------------------- | ----------------------------- |
 | `:year/:month/:day/:title/` | 2013/07/14/lorem/hello-world/ |
 | `:year/:month/:day/:name/`  | 2013/07/14/hello-world/       |
diff --git a/source/zh-cn/docs/plugins.md b/source/zh-cn/docs/plugins.md
index aa23dbacbc..d6b7484d08 100644
--- a/source/zh-cn/docs/plugins.md
+++ b/source/zh-cn/docs/plugins.md
@@ -10,13 +10,12 @@ Hexo 有强大的插件系统，使您能轻松扩展功能而不用修改核心
 
 ### 插件（Packages）
 
-If your code is complicated or if you want to publish it to the NPM registry, we recommend using a plugin. First, create a folder in the `node_modules` folder. The name of this folder must begin with `hexo-` or Hexo will ignore it.
+如果您的代码很复杂或者您想将其发布到 NPM，建议使用插件。 首先，在`node_modules`文件夹中创建一个文件夹。 该文件夹的名称必须以 `hexo-` 开头，否则 Hexo 将忽略它。
 
 文件夹内至少要包含 2 个文件：一个是主程序，另一个是 `package.json`，描述插件的用途和所依赖的插件。
 
 ```plain
 .
-.
 ├── index.js
 └── package.json
 ```
@@ -57,11 +56,10 @@ You'll also need to list your plugin as a dependency in the root `package.json`
 
 3. 在 `source/_data/plugins/` 中创建一个新的 yaml 文件，使用您的插件名称作为文件名。
 
-4. Edit `source/_data/plugins/<your-plugin-name>.yml` and add your plugin. For example:
+4. 编辑 `source/_data/plugins/<your-plugin-name>.yml` 并添加您的插件。 例如：
 
    ```yaml
    description: Server module for Hexo.
-   description: Server module for Hexo.
    link: https://github.com/hexojs/hexo-server
    tags:
      - official
diff --git a/source/zh-cn/docs/server.md b/source/zh-cn/docs/server.md
index 9af2a1346e..0936a59a63 100644
--- a/source/zh-cn/docs/server.md
+++ b/source/zh-cn/docs/server.md
@@ -4,13 +4,13 @@ title: 服务器
 
 ## [hexo-server][]
 
-With the release of Hexo 3, the server has been separated from the main module. Hexo 3.0 把服务器独立成了个别模块，您必须先安装 [hexo-server][] 才能使用。
+Hexo 3.0 把服务器独立成了个别模块 您必须先安装 [hexo-server][] 才能使用。
 
 ```bash
 $ npm install hexo-server --save
 ```
 
-Once the server has been installed, run the following command to start the server. 安装完成后，输入以下命令以启动服务器，您的网站会在 `http://localhost:4000` 下启动。 在服务器启动期间，Hexo 会监视文件变动并自动更新，您无须重启服务器。
+安装完成后，输入以下命令以启动服务器。 默认情况下，您的网站会在 `http://localhost:4000` 下启动。 在服务器启动期间，Hexo 会监视文件变动并自动更新，您无须重启服务器。
 
 ```bash
 $ hexo server
@@ -24,7 +24,7 @@ $ hexo server -p 5000
 
 ### 静态模式
 
-In static mode, only files in the `public` folder will be served and file watching is disabled. You have to run `hexo generate` before starting the server. Usually used in production.
+在静态模式下，服务器只处理 `public` 文件夹中的文件，并且不会监视文件变化。 您必须在启动服务器之前运行 `hexo generate`。 通常用于生产环境。
 
 ```bash
 $ hexo server -s
@@ -32,7 +32,7 @@ $ hexo server -s
 
 ### 自定义 IP
 
-服务器默认运行在 `0.0.0.0`，您可以覆盖默认的 IP 设置，如下： You can override the default IP setting.
+Hexo 服务器默认运行在 `0.0.0.0`。 您可以覆盖默认的 IP 设置。
 
 ```bash
 $ hexo server -i 192.168.1.1
diff --git a/source/zh-cn/docs/setup.md b/source/zh-cn/docs/setup.md
index edfa913366..61704121c7 100644
--- a/source/zh-cn/docs/setup.md
+++ b/source/zh-cn/docs/setup.md
@@ -12,11 +12,10 @@ $ cd <folder>
 $ npm install
 ```
 
-Once initialized, here's what your project folder will look like:
+初始化后，您的项目文件夹将如下所示：
 
 ```plain
 .
-.
 ├── _config.yml
 ├── package.json
 ├── scaffolds
@@ -28,11 +27,11 @@ Once initialized, here's what your project folder will look like:
 
 ### \_config.yml
 
-网站的 [配置](configuration.html) 信息，您可以在此配置大部分的参数。 You can configure most settings here.
+网站的 [配置](configuration.html) 文件。 您可以在此配置大部分的参数。
 
 ### package.json
 
-应用程序的信息。 [EJS](https://ejs.co/), [Stylus](http://learnboost.github.io/stylus/) 和 [Markdown](http://daringfireball.net/projects/markdown/) 渲染引擎 已默认安装，您可以自由移除。 If you want, you can uninstall them later.
+应用程序的信息。 [EJS](https://ejs.co/), [Stylus](http://learnboost.github.io/stylus/) 和 [Markdown](http://daringfireball.net/projects/markdown/) 渲染引擎 已默认安装，您可以自由移除。 如果您想，可以稍后卸载它们。
 
 ```json package.json
 {
@@ -63,7 +62,7 @@ Once initialized, here's what your project folder will look like:
 
 ### source
 
-资源文件夹是存放用户资源的地方。 This is where you put your site's content. 除 `_posts` 文件夹之外，开头命名为 `_` (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。 Markdown 和 HTML 文件会被解析并放到 `public` 文件夹，而其他文件会被拷贝过去。
+资源文件夹。 是存放用户资源的地方。 除 `_posts` 文件夹之外，开头命名为 `_` (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。 Markdown 和 HTML 文件会被解析并放到 `public` 文件夹，而其他文件会被拷贝过去。
 
 ### themes
 
diff --git a/source/zh-cn/docs/syntax-highlight.md b/source/zh-cn/docs/syntax-highlight.md
index b2ae7931b5..06cc30b6d3 100644
--- a/source/zh-cn/docs/syntax-highlight.md
+++ b/source/zh-cn/docs/syntax-highlight.md
@@ -22,7 +22,7 @@ code snippet
 ```
 ````
 上面的第三种是 Markdown 的 fenced code block 语法。 Hexo 对其进行了扩展，使其支持更多特性。 在[标签插件文档](tag-plugins#代码块)中你可以找到可用的选项。
-> 提示：Hexo 支持用任何格式书写文章，只需安装相应渲染插件即可。 It can be in markdown, ejs, swig, nunjucks, pug, asciidoc, etc. Regardless of the format used, those three code block syntax will always be available.
+> 提示：Hexo 支持用任何格式书写文章，只需安装相应渲染插件即可。 可以使用 markdown、ejs、swig、nunjucks、pug、asciidoc 等。 无论使用哪种格式，这三种代码块语法始终可用。
 ## 配置
 v7.0.0以下：
 
@@ -150,7 +150,7 @@ highlight:
 
 > 提示：如果你想使用「子语言高亮」功能（例如在高亮 HTML 时同时高亮内部嵌入的 JavaScript 代码），请开启 `auto_detect`，并且在文章中插入代码块时不要标注语言。
 
-{% note warn "警告！" %} %}
+{% note warn "警告！" %}
 `auto_detect` 十分耗费资源。 如果你不需要使用「子语言高亮」功能，或者不介意在书写代码块时标记语言，请不要启用此功能。
 {% endnote %}
 
@@ -187,7 +187,7 @@ Hexo 通过用 `<figure>` 和 `<table>` 包裹其代码块为其添加了行号
 
 ### tab_replace
 
-Replace tabs inside code block with given string. By default it is 2 spaces.
+用给定字符串替换代码块内的制表符。 默认为 2 个空格。
 
 ### exclude_languages (+6.1.0)
 
@@ -263,7 +263,7 @@ Hexo 内建的 PrismJS 支持浏览器端高亮（`preprocess` 设置为 `false`
 - [语言显示](https://prismjs.com/plugins/show-language/)：当代码块有标注语言时，Hexo 总会添加 `data-language` 属性。
 - Hexo 也支持其它不需要特殊 HTML 代码格式的 PrismJS 插件，不过你需要引入它们的 JavaScript 文件。
 
-All prism plugins are supported if `preprocess` is set to `false`. Here are a few things you should still pay attention to:
+如果 `preprocess` 设置为 `false`，则支持所有 prism 插件。 以下是您仍需注意的几件事：
 
 - [行号显示](https://prismjs.com/plugins/line-numbers/)：当 `preprocess` 设置为 `false` 时，Hexo 不会生成插件所需的 HTML 代码格式。 `prism-line-numbers.css` 和 `prism-line-numbers.js`均需被引入。
 - [语言显示](https://prismjs.com/plugins/show-language/)：当代码块有标注语言时，Hexo 总会添加 `data-language` 属性。
@@ -279,7 +279,7 @@ All prism plugins are supported if `preprocess` is set to `false`. Here are a fe
 
 ### tab_replace
 
-Replace `\t` inside code block with given string. By default it is 2 spaces.
+将代码块内的 `\t` 替换为给定的字符串。 默认为 2 个空格。
 
 ## 其它参考资料
 
diff --git a/source/zh-cn/docs/tag-plugins.md b/source/zh-cn/docs/tag-plugins.md
index 88f8d587b7..cdb425589d 100644
--- a/source/zh-cn/docs/tag-plugins.md
+++ b/source/zh-cn/docs/tag-plugins.md
@@ -2,7 +2,7 @@
 title: 标签插件（Tag Plugins）
 ---
 
-标签插件和 Front-matter 中的标签不同，它们是用于在文章中快速插入特定内容的插件。 They are ported from Octopress and provide a useful way for you to quickly add specific content to your posts.
+标签插件和 Front-matter 中的标签不同。 它们是从 Octopress 移植的，为您提供了一种快速向帖子添加特定内容的有用方法。
 
 虽然你可以使用任何格式书写你的文章，但是标签插件永远可用，且语法也都是一致的。
 
@@ -41,12 +41,11 @@ Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque hendrerit
 ```
 {% blockquote David Levithan, Wide Awake %}
 Do not just seek happiness for yourself. Seek happiness for all. Through kindness. Through mercy.
-{% endblockquote %} Seek happiness for all. Through kindness. Through mercy.
 {% endblockquote %}
 ```
 
 {% blockquote David Levithan, Wide Awake %}
-Do not just seek happiness for yourself. Seek happiness for all. Through kindness. Through mercy. Seek happiness for all. Through kindness. Through mercy.
+Do not just seek happiness for yourself. Seek happiness for all. Through kindness. Through mercy.
 {% endblockquote %}
 
 **引用 Twitter**
@@ -54,12 +53,11 @@ Do not just seek happiness for yourself. Seek happiness for all. Through kindnes
 ```
 {% blockquote @DevDocs https://twitter.com/devdocs/status/356095192085962752 %}
 NEW: DevDocs now comes with syntax highlighting. http://devdocs.io
-{% endblockquote %} http://devdocs.io
 {% endblockquote %}
 ```
 
 {% blockquote @DevDocs https://twitter.com/devdocs/status/356095192085962752 %}
-NEW: DevDocs now comes with syntax highlighting. http://devdocs.io http://devdocs.io
+NEW: DevDocs now comes with syntax highlighting. http://devdocs.io
 {% endblockquote %}
 
 **引用网络上的文章**
@@ -68,7 +66,6 @@ NEW: DevDocs now comes with syntax highlighting. http://devdocs.io http://devdoc
 {% blockquote Seth Godin http://sethgodin.typepad.com/seths_blog/2009/07/welcome-to-island-marketing.html Welcome to Island Marketing %}
 Every interaction is both precious and an opportunity to delight.
 {% endblockquote %}
-{% endblockquote %}
 ```
 
 {% blockquote Seth Godin http://sethgodin.typepad.com/seths_blog/2009/07/welcome-to-island-marketing.html Welcome to Island Marketing %}
@@ -172,7 +169,7 @@ content
 ## jsFiddle (`v7.0.0` 中被移除)
 
 {% note warn %}
-The tag was removed in Hexo 7.0.0. 如果你正在使用 `v7.0.0+`，请使用 [hexo-tag-embed](https://github.com/hexojs/hexo-tag-embed) 替代。
+该标签在 Hexo 7.0.0 中被删除。 如果你正在使用 `v7.0.0+`，请使用 [hexo-tag-embed](https://github.com/hexojs/hexo-tag-embed) 替代。
 {% endnote %}
 
 在文章中嵌入 jsFiddle。
@@ -301,7 +298,7 @@ To embed a Gist snippet:
 Inserts a responsive or specified size Vimeo video.
 
 ```
-{% vimeo video_id %}
+{% vimeo video_id [width] [height] %}
 ```
 
 ## Include Posts
@@ -333,9 +330,9 @@ This will work as long as the filename of the post is `how-to-bake-a-cake.md`, e
 
 **Display custom text.**
 
-`{% raw %}{% post_link hexo-3-8-released '通往文章的链接' %}{% endraw %}`
+`{% raw %}{% post_link hexo-3-8-released 'Link to a post' %}{% endraw %}`
 
-{% post_link hexo-3-8-released '通往文章的链接' %}
+{% post_link hexo-3-8-released 'Link to a post' %}
 
 **Escape title.**
 
@@ -394,7 +391,7 @@ _hexo-renderer-marked 3.1.0+ 可以（可选）自动解析图片的文章路径
 
 **title 和 alt 属性**
 
-`{% asset_img logo.svg "lorem ipsum'dolor'" %}`
+`{% asset_img foo.jpg "lorem ipsum'dolor'" %}`
 
 ```html
 <img src="/2020/01/02/hello/foo.jpg" title="lorem ipsum" alt="dolor" />
diff --git a/source/zh-cn/docs/templates.md b/source/zh-cn/docs/templates.md
index 4f6f9f83a5..de68b088fa 100644
--- a/source/zh-cn/docs/templates.md
+++ b/source/zh-cn/docs/templates.md
@@ -2,11 +2,11 @@
 title: 模版
 ---
 
-Templates define the presentation of your website by describing what each page should look like. The table below shows the corresponding template for every available page. 模板决定了网站内容的呈现方式，每个主题至少都应包含一个 `index` 模板，以下是各页面相对应的模板名称：
+模板决定了网站内容的呈现方式。 以下是各页面相对应的模板名称。 每个主题至少都应包含一个 `index` 模板。
 
 {% youtube mb65bQ4iUc4 %}
 
-| 模板         | Page | 回退        |
+| 模板         | 页面   | 回退        |
 | ---------- | ---- | --------- |
 | `index`    | 首页   |           |
 | `post`     | 文章   | `index`   |
@@ -17,7 +17,7 @@ Templates define the presentation of your website by describing what each page s
 
 ## 布局（Layout）
 
-如果页面结构类似，例如两个模板都有页首（Header）和页脚（Footer），您可考虑通过「布局」让两个模板共享相同的结构。 一个布局文件必须要能显示 `body` 变量的内容，如此一来模板的内容才会被显示，举例来说： For example:
+如果页面结构类似，例如两个模板都有页首（Header）和页脚（Footer），您可考虑通过「布局」让两个模板共享相同的结构。 一个布局文件必须要能显示 `body` 变量的内容，如此一来模板的内容才会被显示。 例如：
 
 ```html index.ejs
 index
@@ -43,11 +43,11 @@ index
 </html>
 ```
 
-By default, the `layout` template is used by all other templates. 每个模板都默认使用 `layout` 布局，您可在 front-matter 指定其他布局，或是设为 `false` 来关闭布局功能，您甚至可在布局中再使用其他布局来建立嵌套布局。 It's even possible to build a complex nested structure by including more layout templates in your top layout.
+每个模板都默认使用 `layout` 布局。 您可在 front-matter 指定其他布局，或是设为 `false` 来关闭布局功能。 您甚至可在布局中再使用其他布局来建立嵌套布局。
 
 ## Partials
 
-Partials are useful for sharing components between your templates. Typical examples include headers, footers or sidebars. You may want to put your partials in separate files to make maintaining your website significantly more convenient. For example:
+Partials are useful for sharing components between your templates. Typical examples include headers, footers or sidebars. You may want to put your partials in separate files to make maintaining your website significantly more convenient. 例如：
 
 ```html partial/header.ejs
 <h1 id="logo"><%= config.title %></h1>
@@ -87,9 +87,9 @@ Partials are useful for sharing components between your templates. Typical examp
 
 ## 优化
 
-If your theme is exceedingly complex or if the number of files to generate becomes too large, Hexo's file generation performance may begin to decrease considerably. 如果您的主题太过于复杂，或是需要生成的文件量太过于庞大，可能会大幅降低性能，除了简化主题外，您可以考虑 Hexo 2.7 新增的局部缓存（Fragment Caching） 功能。
+如果您的主题过于复杂或需要生成的文件数量过多，Hexo 的文件生成性能可能会开始大幅下降。 除了简化主题外，您可以考虑 Hexo 2.7 新增的局部缓存（Fragment Caching） 功能。
 
-本功能借鉴于 [Ruby on Rails](http://guides.rubyonrails.org/caching_with_rails.html#fragment-caching)，它储存局部内容，下次便能直接使用缓存内容，可以减少文件夹查询并使生成速度更快。 It causes content to be saved as fragments and cached for when additional requests are made. This can reduce the number of database queries and can also speed up file generation.
+本功能借鉴于 [Ruby on Rails](http://guides.rubyonrails.org/caching_with_rails.html#fragment-caching)。 它储存局部内容，下次便能直接使用缓存内容。 可以减少文件夹查询并使生成速度更快。
 
 局部模板让您在不同模板之间共享相同的组件，例如页首（Header）、页脚（Footer）或侧边栏（Sidebar）等，可利用局部模板功能分割为个别文件，让维护更加便利。 举例来说：
 
@@ -106,5 +106,5 @@ If your theme is exceedingly complex or if the number of files to generate becom
 ```
 
 {% note warn %}
-`fragment_cache()` 将会缓存第一次的渲染结果，并在之后直接输出缓存的结果。 因此只有在不同页面的渲染结果都相同时才应使用局部缓存。 This should only be used on partials that are expected **not** to change across different pages. Otherwise, it should **not** be enabled. 比如，在配置中启用了 `relative_link` 后不应该使用局部缓存，因为相对链接在每个页面可能不同。 This is because relative links may appear differently across pages.
+`fragment_cache()` 将会缓存第一次的渲染结果，并在之后直接输出缓存的结果。 因此只有在不同页面的渲染结果都**相同**时才应使用局部缓存。 否则，**不**应该被开启。 比如，在配置中启用了 `relative_link` 后不应该使用局部缓存。 因为相对链接在每个页面可能不同。
 {% endnote %}
diff --git a/source/zh-cn/docs/themes.md b/source/zh-cn/docs/themes.md
index d4be3ee201..daeb96a65a 100644
--- a/source/zh-cn/docs/themes.md
+++ b/source/zh-cn/docs/themes.md
@@ -4,11 +4,10 @@ title: 主题
 
 {% youtube 5ROIU_9dYe4 %}
 
-创建 Hexo 主题非常容易，您只要在 `themes` 文件夹内，新增一个任意名称的文件夹，并修改 `_config.yml` 内的 `theme` 设定，即可切换主题。 To start using your theme, modify the `theme` setting in your site's `_config.yml`. 一个主题可能会有以下的结构：
+创建 Hexo 主题非常简单，只需创建一个新文件夹即可。 并修改 `_config.yml` 内的 `theme` 设定，即可切换主题。 一个主题可能会有以下的结构：
 
 ```plain
 .
-.
 ├── _config.yml
 ├── languages
 ├── layout
@@ -26,22 +25,22 @@ title: 主题
 
 ### layout
 
-布局文件夹。 This folder contains the theme's template files, which define the appearance of your website. 用于存放主题的模板文件，决定了网站内容的呈现方式，Hexo 内建 [Nunjucks][] 模板引擎，您可以另外安装插件来获得 [EJS][] 或 [Pug][] 支持，Hexo 根据模板文件的扩展名来决定所使用的模板引擎，例如： Hexo chooses the template engine based on the file extension of the template (just like the posts). For example:
+布局文件夹。 用于存放主题的模板文件，决定了网站内容的呈现方式。 Hexo 内建 [Nunjucks][] 模板引擎，您可以另外安装插件来获得 [EJS][] 或 [Pug][] 支持。 Hexo 根据模板的文件扩展名选择模板引擎（就像帖子一样）。 例如：
 
 ```plain
 layout.ejs   - 使用 EJS
-layout.swig  - 使用 Swig
+layout.njk   - 使用 Nunjucks
 ```
 
 您可参考 [模板](templates.html) 以获得更多信息。
 
 ### scripts
 
-脚本文件夹。 在启动时，Hexo 会加载此文件夹内的 JavaScript 文件，请参见 [插件](plugins.html) 以获得更多信息。 For more info, see [plugins](plugins.html).
+脚本文件夹。 在启动时，Hexo 会加载此文件夹内的 JavaScript 文件。 请参见 [plugins](plugins.html). 以获得更多信息。
 
 ### source
 
-Source folder. Place your assets (e.g. CSS and JavaScript files) here. 文件或文件夹开头名称为 `_`（下划线）或隐藏的文件会被忽略。
+Source 文件夹。 Place your assets (e.g. CSS and JavaScript files) here. 文件或文件夹开头名称为 `_`（下划线）或隐藏的文件会被忽略。
 
 Hexo will process and save all renderable files to the `public` folder. Non-renderable files will be copied to the `public` folder directly.
 
@@ -64,7 +63,6 @@ Hexo will process and save all renderable files to the `public` folder. Non-rend
 
    ```yaml
    description: A brand new default theme for Hexo.
-   description: A brand new default theme for Hexo.
    link: https://github.com/hexojs/hexo-theme-landscape
    preview: http://hexo.io/hexo-theme-landscape
    tags:
@@ -75,7 +73,7 @@ Hexo will process and save all renderable files to the `public` folder. Non-rend
      - one_column
    ```
 
-5. 在 `source/themes/screenshots` 中添加一张截图（名称与主题相同），图片必须为 800x500 的 PNG 文件。 It must be a 800\*500px PNG.
+5. 在 `source/themes/screenshots` 中添加截图（名称与主题相同）。 图片必须为 800x500 的 PNG 文件。
 6. 推送（push）分支。
 7. 建立一个新的合并申请（pull request）并描述改动。
 
diff --git a/source/zh-cn/docs/troubleshooting.md b/source/zh-cn/docs/troubleshooting.md
index 33ebd1ed8a..a7b37ac457 100644
--- a/source/zh-cn/docs/troubleshooting.md
+++ b/source/zh-cn/docs/troubleshooting.md
@@ -1,5 +1,5 @@
 ---
-title: Troubleshooting
+title: 故障排除
 ---
 
 在使用 Hexo 时，您可能会遇到一些问题，下列的常见问题解答可能会对您有所帮助。 如果您在这里找不到解答，可以在 [GitHub](https://github.com/hexojs/hexo/issues) 或 [Google Group](https://groups.google.com/group/hexo) 上提问。
@@ -28,7 +28,7 @@ JS-YAML: bad indentation of a mapping entry at line 18, column 31:
 Error: EMFILE, too many open files
 ```
 
-虽然 Node.js 有非阻塞 I/O，同步 I/O 的数量仍被系统所限制，在生成大量静态文件的时候，您可能会碰到 EMFILE 错误，您可以尝试提高同步 I/O 的限制数量来解决此问题。 You may come across an EMFILE error when trying to generate a large number of files. You can try to run the following command to increase the number of allowed synchronous I/O operations.
+虽然 Node.js 有非阻塞 I/O，同步 I/O 的数量仍被系统所限制，在生成大量静态文件的时候，您可能会碰到 EMFILE 错误，您可以尝试提高同步 I/O 的限制数量来解决此问题。 在生成大量静态文件的时候，您可能会碰到 EMFILE 错误。 您可以尝试提高同步 I/O 的限制数量来解决此问题。
 
 ```bash
 $ ulimit -n 10000
@@ -55,7 +55,7 @@ ulimit: open files: cannot modify limit: Operation not permitted
 # '*' applies to all users and '-' set both soft and hard limits
 ```
 
-- 上述设置在某些情况下可能不适用，请确保 `/etc/pam.d/login` 和 `/etc/pam.d/lightdm` 有以下一行(如果这些文件不存在，请忽略此步骤)： (Ignore this step if those files do not exist)
+- 上述设置在某些情况下可能不适用，请确保 "/etc/pam.d/login" 和 "/etc/pam.d/lightdm" 中有以下一行。 (如果这些文件不存在，请忽略此步骤)
 
 ```
 session required pam_limits.so
@@ -118,7 +118,7 @@ To fix this, try
 Error: listen EADDRINUSE
 ```
 
-您可能同时开启两个 Hexo 服务器，或者有其他应用程序正在占用相同的端口，请尝试修改 `port` 参数，或是在启动 Hexo 服务器时加上 `-p` 选项。 Try to modify the `port` setting or start the Hexo server with the `-p` flag.
+您可能同时开启两个 Hexo 服务器，或者有其他应用程序正在占用相同的端口。 请尝试修改 `port` 参数，或是在启动 Hexo 服务器时加上 `-p` 选项。
 
 ```bash
 $ hexo server -p 5000
@@ -130,7 +130,7 @@ $ hexo server -p 5000
 npm ERR! node-waf configure build
 ```
 
-当您尝试安装以 C/C++ 或其他非 JavaScript 语言所编写的插件时，可能会遇到此类问题，请确认您已经在电脑上安装相对应的编译器。 Make sure you have installed the right compiler on your computer.
+当您尝试安装以 C/C++ 或其他非 JavaScript 语言所编写的插件时，可能会遇到此类问题。 请确认您已经在电脑上安装相对应的编译器。
 
 ## DTrace 错误 （Mac OS X）
 
@@ -150,7 +150,7 @@ $ npm install hexo --no-optional
 
 ## 在 Jade 或 Swig 遍历数据
 
-Hexo 使用 [Warehouse][] 存储数据，它不是一般数组所以必须先进行类型转型才能遍历。 It's not an array so you may have to transform objects into iterables.
+Hexo 使用 [Warehouse][] 存储数据。 它不是一般数组所以必须先进行类型转型才能遍历。
 
 ```
 {% for post in site.posts.toArray() %}
@@ -172,14 +172,14 @@ $ hexo clean
 ```json
 {
   "hexo": {
-    "version": "3.9.0"
+    "version": "3.2.2"
   }
 }
 ```
 
 ## Escape Contents
 
-Hexo 使用 [Nunjucks][] 来解析文章（旧版本使用 [Swig][]，两者语法类似），内容若包含 `{{ }}` 或 `{% %}` 可能导致解析错误，您可以用 [`raw`](/zh-cn/docs/tag-plugins#Raw) 标签包裹，单反引号 `` `{{ }}` `` 或 三反引号 来避免潜在问题发生。 Content wrapped with `{{ }}` or `{% %}` will get parsed and may cause problems. You can skip the parsing by wrapping it with the [`raw`](/docs/tag-plugins#Raw) tag plugin, a single backtick `` `{{ }}` `` or a triple backtick. 此外，Nunjucks 标签也可以通过渲染器的选项（如果支持的话）、[API](/zh-cn/api/renderer#禁用-Nunjucks-标签) 或 [front-matter](/zh-cn/docs/front-matter) 来禁用。
+Hexo 使用 [Nunjucks][] 来解析文章（旧版本使用 [Swig][]，两者语法类似）。 内容若包含 `{{ }}` 或 `{% %}` 可能导致解析错误。 您可以使用 [`raw`](/docs/tag-plugins#Raw) 标记插件、单反引号 `` `{{ }}` `` 或三反引号对其进行包裹，从而跳过解析过程。 此外，Nunjucks 标签也可以通过渲染器的选项（如果支持的话）、[API](/zh-cn/api/renderer#禁用-Nunjucks-标签) 或 [front-matter](/zh-cn/docs/front-matter) 来禁用。
 
 ```
 {% raw %}
@@ -273,24 +273,21 @@ Possible cause:
 ```
 YAMLException: Specified list of YAML types (or a single Type object) contains a non-Type object.
     at ...
-    at ...
 ```
 
 这可能是由于存在包管理器无法自动修复的不正确的依赖项（即 `js-yaml`）引起的，您需要手动更新它：
 
 ```sh
-npm ERR! node-waf configure build
+$ npm install js-yaml@latest
 ```
 
-or
+或者
 
 ```sh
-$ npm install js-yaml@latest
-# 如果您使用 yarn 作为包管理器，请运行下面这个命令：
 $ yarn add js-yaml@latest
 ```
 
-if you use `yarn`.
+如果您使用 `yarn`。
 
 [Warehouse]: https://github.com/hexojs/warehouse
 [Swig]: https://node-swig.github.io/swig-templates/
diff --git a/source/zh-cn/docs/variables.md b/source/zh-cn/docs/variables.md
index 57d898c1dc..f12f63f9bd 100644
--- a/source/zh-cn/docs/variables.md
+++ b/source/zh-cn/docs/variables.md
@@ -8,10 +8,10 @@ title: 变量
 
 | 变量       | 描述                               | 类型                        |
 | -------- | -------------------------------- | ------------------------- |
-| `site`   | Sitewide information.            | `object`; 见 [网站变量](#网站变量) |
+| `site`   | 全站信息                             | `object`; 见 [网站变量](#网站变量) |
 | `page`   | 针对该页面的内容以及 front-matter 中自定义的变量。 | `object`; 见 [页面变量](#页面变量) |
 | `config` | 网站配置                             | `object` (站点的配置文件)        |
-| `theme`  | 主题配置。 继承自网站配置。                   | `object` (主题配置文件)         |
+| `theme`  | 主题配置。 继承自网站配置。                   | `object` (主题的配置文件)        |
 | `path`   | 当前页面的路径（不含根路径）                   | `string`                  |
 | `url`    | 当前页面的完整网址                        | `string`                  |
 | `env`    | 环境变量                             | ???                       |
@@ -26,8 +26,8 @@ title: 变量
 | ----------------- | ---- | --------------------------- |
 | `site.posts`      | 所有文章 | `array`，包含了站点全部的文章 `object` |
 | `site.pages`      | 所有分页 | `array`，包含了站点全部的分页 `object` |
-| `site.categories` | 所有分类 | `array`，包含了站点全部的分类 `object` |
-| `site.tags`       | 所有标签 | `object` 或 `null`           |
+| `site.categories` | 所有分类 | `array` of ???              |
+| `site.tags`       | 所有标签 | `array` of ???              |
 
 ### 页面变量
 
@@ -35,31 +35,31 @@ title: 变量
 
 | 变量                 | 描述                                            | 类型               |
 | ------------------ | --------------------------------------------- | ---------------- |
-| `page.title`       | Article title                                 | `string`         |
-| `page.date`        | Article created date                          | [Moment.js][] 对象 |
+| `page.title`       | 文章标题                                          | `string`         |
+| `page.date`        | 文章建立日期                                        | [Moment.js][] 对象 |
 | `page.updated`     | 页面更新日期                                        | [Moment.js][] 对象 |
-| `page.comments`    | Comment enabled or not                        | `boolean`        |
+| `page.comments`    | 评论是否启用                                        | `boolean`        |
 | `page.layout`      | 布局名称                                          | `string`         |
 | `page.content`     | 页面的完整内容                                       | `string`         |
-| `page.excerpt`     | Article excerpt                               | `string`         |
+| `page.excerpt`     | 文章摘要                                          | `string`         |
 | `page.more`        | 除了页面摘要的其余内容                                   | `string`         |
-| `page.source`      | The path of the source file                   | `string`         |
+| `page.source`      | 源文件的路径                                        | `string`         |
 | `page.full_source` | 页面的完整原始路径                                     | `string`         |
 | `page.path`        | 页面网址（不含根路径）。 我们通常在主题中使用 `url_for(page.path)`。 | `string`         |
-| `page.permalink`   | Full (encoded) URL of the article             | `string`         |
+| `page.permalink`   | 文章的完整（编码的）URL                                 | `string`         |
 | `page.prev`        | 上一个页面。 如果此为第一个页面则为 `null`。                    | ???              |
 | `page.next`        | 下一个页面。 如果此为最后一个页面则为 `null`。                   | ???              |
 | `page.raw`         | 文章的原始内容                                       | ???              |
-| `page.photos`      | 文章的照片（用于相簿）                                   | array            |
+| `page.photos`      | 文章的照片（用于相簿）                                   | array of ???     |
 | `page.link`        | 文章的外部链接（用于链接文章）                               | `string`         |
 
 **文章 (`post`):** 与 `page` 布局相同，但新增以下变量。
 
-| 变量                | 描述                              | 类型                          |
-| ----------------- | ------------------------------- | --------------------------- |
-| `page.published`  | True if the post is not a draft | `boolean`                   |
-| `page.categories` | 该文章的所有分类                        | `array`，包含了站点全部的标签 `object` |
-| `page.tags`       | 该文章的所有标签                        | `object` 或 `null`           |
+| 变量                | 描述               | 类型             |
+| ----------------- | ---------------- | -------------- |
+| `page.published`  | 如果帖子不是草稿，则为 true | `boolean`      |
+| `page.categories` | 该文章的所有分类         | `array` of ??? |
+| `page.tags`       | 该文章的所有标签         | `array` of ??? |
 
 **首页（`index`）**
 
diff --git a/source/zh-cn/docs/writing.md b/source/zh-cn/docs/writing.md
index 830609b4dc..01a2d4b8eb 100644
--- a/source/zh-cn/docs/writing.md
+++ b/source/zh-cn/docs/writing.md
@@ -10,7 +10,7 @@ title: 写作
 $ hexo new [layout] <title>
 ```
 
-`post` is the default `layout`, but you can supply your own. 您可以在命令中指定文章的布局（layout），默认为 `post`，可以通过修改 `_config.yml` 中的 `default_layout` 参数来指定默认布局。
+`post`是默认的`布局`，但你也可以提供自己的布局。 您可以通过编辑 `_config.yml` 中的 `default_layout` 设置来更改默认布局。
 
 ## 布局（Layout）
 
@@ -51,13 +51,13 @@ Drafts are not displayed by default. You can add the `--draft` option when runni
 
 ## Scaffolds
 
-在新建文章时，Hexo 会根据 `scaffolds` 文件夹内相对应的文件来建立文件，例如： For example:
+在新建文章时，Hexo 会根据 `scaffolds` 文件夹内相对应的文件来建立文件。 例如：
 
 ```bash
 $ hexo new photo "My Gallery"
 ```
 
-在执行这行指令时，Hexo 会尝试在 `scaffolds` 文件夹中寻找 `photo.md`，并根据其内容建立文章，以下是您可以在模版中使用的变量： The following placeholders are available in scaffolds:
+在执行这行指令时，Hexo 会尝试在 `scaffolds` 文件夹中寻找 `photo.md`，并根据其内容建立文章。 以下是您可以在模版中使用的变量：
 
 | Placeholder | 描述     |
 | ----------- | ------ |
diff --git a/source/zh-cn/index.md b/source/zh-cn/index.md
index f91a131dca..44ab4277a8 100644
--- a/source/zh-cn/index.md
+++ b/source/zh-cn/index.md
@@ -1,6 +1,6 @@
 ---
 layout: index
-description: Hexo is a fast, simple & powerful blog framework powered by Node.js.
+description: Hexo 是一个由Node.js驱动的快速、简单的 & 强大的博客框架。
 subtitle: 快速、简洁且高效的博客框架
 comments: false
 ---
@@ -12,7 +12,7 @@ comments: false
         <i class="fa fa-bolt"></i>
       </div>
       <h3 class="intro-feature-title">超快速度</h3>
-      <p class="intro-feature-desc">Node.js 所带来的超快生成速度，让上百个页面在几秒内瞬间完成渲染。 Hundreds of files take only seconds to build.</p>
+      <p class="intro-feature-desc">Node.js 所带来的超快生成速度。 上百个页面在几秒内完成渲染。</p>
     </div>
   </li>
   <li class="intro-feature-wrap">
@@ -34,8 +34,8 @@ comments: false
       <div class="intro-feature-icon">
         <i class="fa fa-cog"></i>
       </div>
-      <h3 class="intro-feature-title">Plugins</h3>
-      <p class="intro-feature-desc">Features powerful APIs for limitless extensibility. 强大的 API 带来无限的可能，与数种模板引擎（EJS，Pug，Nunjucks）和工具（Babel，PostCSS，Less/Sass）轻易集成 Easily integrate with existing NPM packages (Babel, PostCSS, Less/Sass, etc).</p>
+      <h3 class="intro-feature-title">插件</h3>
+      <p class="intro-feature-desc">强大的 API 带来无限的可能。 支持数种模板引擎（EJS，Pug，Nunjucks等）。 可以与现有的NPM包 (Babel, PostCSS, Less/Sass 等) 轻松地集成。</p>
     </div>
   </li>
 </ul>