Updated Simplified Chinese intro topic; Translate en doc to Simplified Chinese (axios#116)

* [Added] Translate multipart topic to Simplified Chinese

* [Updated] Added `multipart` topic;
[Updated] `url-encoded` topic;

* Updated Simplified Chinese intro topic;
* [Updated] Added `multipart` topic;
[Updated] `url-encoded` topic;
[Added] http server script;

* [Updated] Added docs;

Updated Simplified Chinese intro topic;
[Updated] `intro` topic;
[Updated] `api_intro` topic;
[Updated] `post_example` topic;

---------

Co-authored-by: Jay <[email protected]>

Author: CrabSAMA

posts/zh/api_intro.md

@@ -54,6 +54,9 @@ axios('/user/12345');
 ##### axios.post(url[, data[, config]])
 ##### axios.put(url[, data[, config]])
 ##### axios.patch(url[, data[, config]])
+##### axios.postForm(url[, data[, config]])
+##### axios.putForm(url[, data[, config]])
+##### axios.patchForm(url[, data[, config]])
 
 ###### 注意
 在使用别名方法时， `url`、`method`、`data` 这些属性都不必在配置中指定。

posts/zh/cancellation.md

@@ -2,7 +2,7 @@
 title: '取消请求'
 prev_title: '错误处理'
 prev_link: '/zh/docs/handling_errors'
-next_title: 'URL-Encoding Bodies'
+next_title: '请求体编码'
 next_link: '/zh/docs/urlencoded'
 ---
 

posts/zh/intro.md

@@ -16,7 +16,17 @@ Axios 是一个基于 *[promise](https://javascript.info/promise-basics)* 网络
 - 拦截请求和响应
 - 转换请求和响应数据
 - 取消请求
+- 超时处理
+- 查询参数序列化支持嵌套项处理
+- 自动将请求体序列化为：
+    - JSON (`application/json`)
+    - Multipart / FormData (`multipart/form-data`)
+    - URL encoded form (`application/x-www-form-urlencoded`)
+- 将 HTML Form 转换成 JSON 进行请求
 - 自动转换JSON数据
+- 获取浏览器和 node.js 的请求进度，并提供额外的信息（速度、剩余时间）
+- 为 node.js 设置带宽限制
+- 兼容符合规范的 FormData 和 Blob（包括 node.js）
 - 客户端支持防御[XSRF](http://en.wikipedia.org/wiki/Cross-site_request_forgery)
 
 # 安装
@@ -49,4 +59,11 @@ $ yarn add axios
 
 ```html
 <script src="https://unpkg.com/axios/dist/axios.min.js"></script>
-```
+```
+
+为了直接使用 `require` 导入预构建的 CommonJS 模块（如果您的模块打包器无法自动解析它们），我们提供了以下预构建模块：
+
+```js
+const axios = require('axios/dist/browser/axios.cjs'); // browser
+const axios = require('axios/dist/node/axios.cjs'); // node
+```

posts/zh/multipart.md

@@ -0,0 +1,162 @@
+---
+title: 'Multipart 实体请求'
+prev_title: '请求体编码'
+prev_link: '/zh/docs/urlencoded'
+next_title: '注意事项'
+next_link: '/zh/docs/notes'
+---
+
+## 使用 `multipart/form-data` 类型发起 `POST` 请求 
+
+### 使用 FormData API
+
+#### 浏览器
+
+```js 
+const form = new FormData();
+form.append('my_field', 'my value');
+form.append('my_buffer', new Blob([1,2,3]));
+form.append('my_file', fileInput.files[0]);
+
+axios.post('https://example.com', form)
+```
+
+Axios 会将传入数据序列化，因此使用 Axios 提供的 API 可以无需手动处理 FormData 的数据并实现一样的效果：
+
+```js
+axios.postForm('https://httpbin.org/post', {
+  my_field: 'my value',
+  my_buffer: new Blob([1,2,3]),
+  my_file:  fileInput.files // FileList will be unwrapped as sepate fields
+});
+```
+
+HTML 表单可以直接作为请求内容来进行传输。
+
+#### Node.js
+
+```js 
+import axios from 'axios';
+
+const form = new FormData();
+form.append('my_field', 'my value');
+form.append('my_buffer', new Blob(['some content']));
+
+axios.post('https://example.com', form)
+```
+
+由于 node.js 当前不支持从文件创建 `Blob`，因此您可以使用第三方软件包来实现该目的。
+
+```js
+import {fileFromPath} from 'formdata-node/file-from-path'
+
+form.append('my_field', 'my value');
+form.append('my_file', await fileFromPath('/foo/bar.jpg'));
+
+axios.post('https://example.com', form)
+```
+
+当 Axios 版本小于 `v1.3.0` 时您必须引入 `form-data` 包。
+
+```js 
+const FormData = require('form-data');
+
+const form = new FormData();
+form.append('my_field', 'my value');
+form.append('my_buffer', new Buffer(10));
+form.append('my_file', fs.createReadStream('/foo/bar.jpg'));
+
+axios.post('https://example.com', form)
+```
+
+### 🆕 自动序列化
+
+从 `v0.27.0` 版本开始，当请求头中的 Content-Type 是 `multipart/form-data` 时，Axios 支持自动地将普通对象序列化成一个 FormData 对象。
+
+这个示例请求演示了如何将一个数据通过 `FormData` 格式进行提交（浏览器与 Node.js 环境）：
+
+```js
+import axios from 'axios';
+
+axios.post('https://httpbin.org/post', {
+  user: {
+    name: 'Dmitriy'
+  },
+  file: fs.createReadStream('/foo/bar.jpg')
+}, {
+  headers: {
+    'Content-Type': 'multipart/form-data'
+  }
+}).then(({data})=> console.log(data));
+```
+
+Axios FormData 序列化器支持一些特殊的结尾，以执行以下操作：
+
+- `{}` - 通过 `JSON.stringify` 序列化数据
+- `[]` - 将 array-like 的对象使用相同的键值来展开为单独的字段
+
+> 提示：默认情况下，展开、扩展操作将在数组和 FileList 对象上使用。
+>
+
+FormData 序列化器支持通过 `config.formSerializer: object` 这个参数来传递一些额外的选项，以支持一些特殊的情况：
+
+- `visitor: Function` - 用户定义的处理函数，将递归调用以按照自定义规则将数据对象序列化为`FormData`对象。
+- `dots: boolean = false` - 使用点符号而不是括号来序列化数组和对象；
+- `metaTokens: boolean = true` - 在 FormData 键值中添加特殊结尾（例如`user{}: '{"name": "John"}'`）。后端的 body-parser 可能会使用此元信息自动将值解析为 JSON。
+- `indexes: null|false|true = false` - 控制如何添加索引到打平的 array-like 对象的展开键值中
+    - `null` - 不添加中括号（`arr: 1`，`arr: 2`，`arr: 3`）
+    - `false`（默认值）- 添加空中括号（`arr[]: 1`，`arr[]: 2`，`arr[]: 3`）
+    - `true` - 添加带有索引的中括号（`arr[0]: 1`，`arr[1]: 2`，`arr[2]: 3`）
+
+假设说我们有一个这样的示例对象：
+
+```js
+const obj = {
+  x: 1,
+  arr: [1, 2, 3],
+  arr2: [1, [2], 3],
+  users: [{name: 'Peter', surname: 'Griffin'}, {name: 'Thomas', surname: 'Anderson'}],
+  'obj2{}': [{x:1}]
+};
+```
+
+接下来这些序列化的步骤将会由 Axios 内置的序列化器自动执行：
+
+```js
+const formData= new FormData();
+formData.append('x', '1');
+formData.append('arr[]', '1');
+formData.append('arr[]', '2');
+formData.append('arr[]', '3');
+formData.append('arr2[0]', '1');
+formData.append('arr2[1][0]', '2');
+formData.append('arr2[2]', '3');
+formData.append('users[0][name]', 'Peter');
+formData.append('users[0][surname]', 'Griffin');
+formData.append('users[1][name]', 'Thomas');
+formData.append('users[1][surname]', 'Anderson');
+formData.append('obj2{}', '[{"x":1}]');
+```
+
+```js
+import axios from 'axios';
+
+axios.post('https://httpbin.org/post', {
+  'myObj{}': {x: 1, s: "foo"},
+  'files[]': document.querySelector('#fileInput').files 
+}, {
+  headers: {
+    'Content-Type': 'multipart/form-data'
+  }
+}).then(({data})=> console.log(data));
+```
+
+Axios支持以下别名方法：`postForm`，`putForm`，`patchForm`，这些方法只是对应的 HTTP 方法，其 content-type 头部默认设为`multipart/form-data`。
+
+`FileList` 对象可以被直接传递：
+
+```js
+await axios.postForm('https://httpbin.org/post', document.querySelector('#fileInput').files)
+```
+
+所有文件将使用相同的字段名`files[]`发送。

posts/zh/notes.md

@@ -1,8 +1,8 @@
 ---
 title: '注意事项'
 description: '一些注意事项'
-prev_title: 'URL-Encoding Bodies'
-prev_link: '/zh/docs/urlencoded'
+prev_title: 'Multipart 实体请求'
+prev_link: '/zh/docs/multipart'
 ---
 
 ## 语义化

posts/zh/post_example.md

@@ -33,9 +33,54 @@ function getUserPermissions() {
   return axios.get('/user/12345/permissions');
 }
 
+const [acct, perm] = await Promise.all([getUserAccount(), getUserPermissions()]);
+
+// OR
+
 Promise.all([getUserAccount(), getUserPermissions()])
-  .then(function (results) {
-    const acct = results[0];
-    const perm = results[1];
+  .then(function ([acct, perm]) {
+    // ...
   });
-```
+```
+
+将 HTML Form 转换成 JSON 进行请求
+
+```js
+const {data} = await axios.post('/user', document.querySelector('#my-form'), {
+  headers: {
+    'Content-Type': 'application/json'
+  }
+})
+```
+
+### Forms
+
+- Multipart (`multipart/form-data`)
+
+```js
+const {data} = await axios.post('https://httpbin.org/post', {
+    firstName: 'Fred',
+    lastName: 'Flintstone',
+    orders: [1, 2, 3],
+    photo: document.querySelector('#fileInput').files
+  }, {
+    headers: {
+      'Content-Type': 'multipart/form-data'
+    }
+  }
+)
+```
+
+- URL encoded form (`application/x-www-form-urlencoded`)
+
+```js
+const {data} = await axios.post('https://httpbin.org/post', {
+    firstName: 'Fred',
+    lastName: 'Flintstone',
+    orders: [1, 2, 3]
+  }, {
+    headers: {
+      'Content-Type': 'application/x-www-form-urlencoded'
+    }
+})
+```

posts/zh/urlencoded.md

@@ -2,8 +2,8 @@
 title: '请求体编码'
 prev_title: '取消请求'
 prev_link: '/zh/docs/cancellation'
-next_title: '注意事项'
-next_link: '/zh/docs/notes'
+next_title: 'Multipart 实体请求'
+next_link: '/zh/docs/multipart'
 ---
 
 默认情况下，axios将 JavaScript 对象序列化为 `JSON` 。 要以`application/x-www-form-urlencoded`格式发送数据，您可以使用以下选项之一。
@@ -91,3 +91,55 @@ axios.interceptors.request.use(config => {
   return config;
 });
 ```
+
+### 🆕 自动序列化
+
+当请求头中的 `content-type` 是  `application/x-www-form-urlencoded` 时，Axios 将自动地将普通对象序列化成 urlencoded 的格式。
+
+在浏览器和 `node.js` 环境中都适用：
+
+```js
+const data = {
+  x: 1,
+  arr: [1, 2, 3],
+  arr2: [1, [2], 3],
+  users: [{name: 'Peter', surname: 'Griffin'}, {name: 'Thomas', surname: 'Anderson'}],
+};
+
+await axios.post('https://postman-echo.com/post', data,
+  {headers: {'content-type': 'application/x-www-form-urlencoded'}}
+);
+```
+
+服务器接收到的数据就像是这样：
+
+```js
+  {
+    x: '1',
+    'arr[]': [ '1', '2', '3' ],
+    'arr2[0]': '1',
+    'arr2[1][0]': '2',
+    'arr2[2]': '3',
+    'arr3[]': [ '1', '2', '3' ],
+    'users[0][name]': 'Peter',
+    'users[0][surname]': 'griffin',
+    'users[1][name]': 'Thomas',
+    'users[1][surname]': 'Anderson'
+  }
+````
+
+如果您的服务器框架的请求体解析器（例如`express.js`的`body-parser`）支持嵌套对象解码，则其接收到的数据将与您提交的数据一样。
+
+以下是一个`express.js`的服务器示例，它将会把接收到的数据作为响应返回：
+
+```js
+  var app = express();
+  
+  app.use(bodyParser.urlencoded({ extended: true })); // support url-encoded bodies
+  
+  app.post('/', function (req, res, next) {
+     res.send(JSON.stringify(req.body));
+  });
+
+  server = app.listen(3000);
+```

zh.lang.js

@@ -83,7 +83,12 @@ module.exports = {
     {
       type: "link",
       href: "/docs/urlencoded",
-      text: "请求体编码",
+      text: "🆕 请求体编码",
+    },
+    {
+      type: "link",
+      href: "/docs/multipart",
+      text: "🆕 Multipart 实体请求",
     },
     {
       type: "heading",