[docs][zh-cn] synced updates (#1097)

* [zh-cn] Webpack -> webpack and refined testing.md

* [docs][zh-cn] synced updates from #cda4973 to #ebd66fe

* Update postcss.md

* Update testing.md

Author: Jinjiang

docs/zh-cn/README.md

@@ -2,37 +2,37 @@
 
 ### `vue-loader` 是什么？
 
-`vue-loader` 是一个 Webpack 的 loader，可以将用下面这个格式编写的 Vue 组件转换为 JavaScript 模块：
+`vue-loader` 是一个 webpack 的 loader，可以将用下面这个格式编写的 Vue 组件转换为 JavaScript 模块：
 
 ![screenshot](http://blog.evanyou.me/images/vue-component.png)
 
 这里有一些 `vue-loader` 提供的很酷的特性：
 
 - 默认支持 ES2015；
-- 允许对 Vue 组件的组成部分使用其它 Webpack loader，比如对 `<style>` 使用 SASS 和对 `<template>` 使用 Jade；
+- 允许对 Vue 组件的组成部分使用其它 webpack loader，比如对 `<style>` 使用 SASS 和对 `<template>` 使用 Jade；
 - `.vue` 文件中允许自定义节点，然后使用自定义的 loader 进行处理；
-- 把 `<style>` 和 `<template>` 中的静态资源当作模块来对待，并使用 Webpack loader 进行处理；
+- 把 `<style>` 和 `<template>` 中的静态资源当作模块来对待，并使用 webpack loader 进行处理；
 - 对每个组件模拟出 CSS 作用域；
 - 支持开发期组件的热重载。
 
-简而言之，编写 Vue.js 应用程序时，组合使用 Webpack 和 `vue-loader` 能带来一个现代，灵活并且非常强大的前端工作流程。
+简而言之，编写 Vue.js 应用程序时，组合使用 webpack 和 `vue-loader` 能带来一个现代，灵活并且非常强大的前端工作流程。
 
-### Webpack 是什么?
+### webpack 是什么?
 
-如果你已经熟悉了 Webpack，随时可以跳过下面的说明。如果你没有使用过 Webpack，下面是一个快速介绍：
+如果你已经熟悉了 webpack，随时可以跳过下面的说明。如果你没有使用过 webpack，下面是一个快速介绍：
 
-[Webpack](https://webpack.github.io/) 是一个模块打包工具。它将一堆文件中的每个文件都作为一个模块，找出它们的依赖关系，将它们打包为可部署的静态资源。
+[webpack](https://webpack.github.io/) 是一个模块打包工具。它将一堆文件中的每个文件都作为一个模块，找出它们的依赖关系，将它们打包为可部署的静态资源。
 
 ![webpack](https://webpack.github.io/assets/what-is-webpack.png)
 
-一个基本的例子，想像我们有一些 CommonJS 模块，它们不能直接在浏览器中运行，所以我们需要打包成一个文件，这样就可以通过 `<script>` 标签加载。Webpack 可以遵循 `require()` 调用的依赖关系，为我们完成这些工作。
+一个基本的例子，想像我们有一些 CommonJS 模块，它们不能直接在浏览器中运行，所以我们需要打包成一个文件，这样就可以通过 `<script>` 标签加载。webpack 可以遵循 `require()` 调用的依赖关系，为我们完成这些工作。
 
-但是 Webpack 可以做的不止这些。通过“loader”，我们可以配置 Webpack 以任何方式去转换所有类型的文件。包括以下例子：
+但是 webpack 可以做的不止这些。通过“loader”，我们可以配置 webpack 以任何方式去转换所有类型的文件。包括以下例子：
 
 - 转换 ES2015，CoffeeScript 或者 TypeScript 模块为普通的 ES5 CommonJS 模块；
 - 可以选择在编译之前检验你的源代码；
 - 将 Jade 模版转换为纯 HTML 并且嵌入 Javascript 字符串中；
 - 将 SASS 文件转换为纯 CSS，然后将其转换成 JavaScript 片段，将生成的 CSS 作为 `<style>` 标签插入页面；
 - 处理 HTML 或者 CSS 中引用的图片，移动到配置的路径中，并且使用 md5 hash 重命名。
 
-当你理解 Webpack 原理后会感觉它是如此强大，它可以大大优化你的前端工作流程。它主要的缺点是配置复杂麻烦，但是使用本指南，应该可以帮助你找到 Vue.js 和 `vue-loader` 使用时的最常见问题的解决方案。
+当你理解 webpack 原理后会感觉它是如此强大，它可以大大优化你的前端工作流程。它主要的缺点是配置复杂麻烦，但是使用本指南，应该可以帮助你找到 Vue.js 和 `vue-loader` 使用时的最常见问题的解决方案。

docs/zh-cn/configurations/advanced.md

@@ -12,7 +12,7 @@
 
 > 注意 `preLoaders` 和 `postLoaders` 只在 10.3.0+ 版本支持
 
-### Webpack 2.x
+### webpack 2.x
 
 ``` js
 module.exports = {
@@ -54,7 +54,7 @@ module.exports = {
 }
 ```
 
-### Webpack 1.x
+### webpack 1.x
 
 ``` js
 // webpack.config.js

docs/zh-cn/configurations/asset-url.md

@@ -14,10 +14,10 @@
 createElement('img', { attrs: { src: require('../image.png') }})
 ```
 
-因为 `.png` 不是一个 JavaScript 文件，你需要配置 Webpack 使用 [file-loader](https://github.com/webpack/file-loader) 或者 [url-loader](https://github.com/webpack/url-loader) 去处理它们。`vue-cli` 脚手器工具已经为你配置好了。
+因为 `.png` 不是一个 JavaScript 文件，你需要配置 webpack 使用 [file-loader](https://github.com/webpack/file-loader) 或者 [url-loader](https://github.com/webpack/url-loader) 去处理它们。`vue-cli` 脚手器工具已经为你配置好了。
 
 使用它们的好处：
 
-1. `file-loader` 可以指定要复制和放置资源文件的位置，以及如何使用版本哈希命名以获得更好的缓存。此外，这意味着 **你可以就近管理图片文件，可以使用相对路径而不用担心布署时URL问题**。使用正确的配置，Webpack 将会在打包输出中自动重写文件路径为正确的URL。
+1. `file-loader` 可以指定要复制和放置资源文件的位置，以及如何使用版本哈希命名以获得更好的缓存。此外，这意味着 **你可以就近管理图片文件，可以使用相对路径而不用担心布署时URL问题**。使用正确的配置，webpack 将会在打包输出中自动重写文件路径为正确的URL。
 
 2. `url-loader` 允许你有条件将文件转换为内联的 base-64 URL (当文件小于给定的阈值)，这会减少小文件的 HTTP 请求。如果文件大于该阈值，会自动的交给 `file-loader` 处理。

docs/zh-cn/configurations/custom-blocks.md

@@ -42,7 +42,7 @@ comp-a h2 {
 #### webpack.config.js
 
 ``` js
-// Webpack 2.x
+// webpack 2.x
 var ExtractTextPlugin = require("extract-text-webpack-plugin")
 
 module.exports = {

docs/zh-cn/configurations/extract-css.md

@@ -39,7 +39,7 @@ module.exports = {
 
 将所有 Vue 组件中的所有已处理的 CSS 提取为单个 CSS 文件配置示例：
 
-### Webpack 2.x
+### webpack 2.x
 
 
 ``` js
@@ -70,7 +70,7 @@ module.exports = {
 }
 ```
 
-### Webpack 1.x
+### webpack 1.x
 
 ``` bash
 npm install extract-text-webpack-plugin --save-dev

docs/zh-cn/configurations/pre-processors.md

@@ -1,6 +1,6 @@
 # 使用预处理器
 
-在 Webpack 中，所有的预处理器需要匹配对应的 loader。`vue-loader` 允许你使用其它 Webpack loader 处理 Vue 组件的某一部分。它会根据 `lang` 属性自动推断出要使用的 loader。
+在 webpack 中，所有的预处理器需要匹配对应的 loader。`vue-loader` 允许你使用其它 webpack loader 处理 Vue 组件的某一部分。它会根据 `lang` 属性自动推断出要使用的 loader。
 
 ### CSS
 
@@ -87,7 +87,7 @@ npm install coffee-loader --save-dev
 
 ### 模版
 
-模版的处理方式略有不同，因为大多数 Webpack 模版处理器 (比如 `pug-loader`) 会返回模版处理函数，而不是编译的 HTML 字符串，我们使用原始的 `pug` 替代 `pug-loader`：
+模版的处理方式略有不同，因为大多数 webpack 模版处理器 (比如 `pug-loader`) 会返回模版处理函数，而不是编译的 HTML 字符串，我们使用原始的 `pug` 替代 `pug-loader`：
 
 ``` bash
 npm install pug --save-dev
@@ -104,12 +104,12 @@ div
 
 ### 行内 Loader Requests
 
-你可以在 `lang` 属性中使用 [Webpack loader requests](https://webpack.github.io/docs/loaders.html#introduction)：
+你可以在 `lang` 属性中使用 [webpack loader requests](https://webpack.github.io/docs/loaders.html#introduction)：
 
 ``` html
 <style lang="sass?outputStyle=expanded">
   /* use sass here with expanded output */
 </style>
 ```
 
-但是，这使你的 Vue 组件只适用于 Webpack，不能与 Browserify 和 [vueify](https://github.com/vuejs/vueify) 一同使用。**如果你打算将你的 Vue 组件作为可重复使用的第三方组件，请避免使用这个语法。**
+但是，这使你的 Vue 组件只适用于 webpack，不能与 Browserify 和 [vueify](https://github.com/vuejs/vueify) 一同使用。**如果你打算将你的 Vue 组件作为可重复使用的第三方组件，请避免使用这个语法。**

docs/zh-cn/features/es2015.md

@@ -58,7 +58,7 @@ export default {
 
 ### 转换普通 `.js` 文件
 
-由于 `vue-loader` 只处理 `.vue` 文件，你需要告诉 Webpack 如何使用 `babel-loader` 或者 `buble-loader` 处理普通 `.js` 文件，在 Webpack 中配置 `babel-loader` 或者 `buble-loader`。脚手架工具 `vue-cli` 已经为你做了这些。
+由于 `vue-loader` 只处理 `.vue` 文件，你需要告诉 webpack 如何使用 `babel-loader` 或者 `buble-loader` 处理普通 `.js` 文件，在 webpack 中配置 `babel-loader` 或者 `buble-loader`。脚手架工具 `vue-cli` 已经为你做了这些。
 
 ### 使用 `.babelrc` 配置 Babel
 

docs/zh-cn/features/postcss.md

@@ -4,32 +4,43 @@
 
 ## 使用配置文件
 
-`vue-loader` 从 11.0 版本开始支持通过 [`postcss-loader`](https://github.com/postcss/postcss-loader#usage) 自动加载同一个配置文件：
+`vue-loader` 支持通过 [`postcss-loader`](https://github.com/postcss/postcss-loader#usage) 自动加载同一个配置文件：
 
 - `postcss.config.js`
 - `.postcssrc`
 - `package.json` 中的 `postcss`
 
 使用配置文件允许你在由 `postcss-loader` 处理的普通CSS文件和 `*.vue` 文件中的 CSS 之间共享相同的配置，这是推荐的做法。
 
+## 配合 `postcss-loader` 使用
+
+因为 `vue-loader` 内部通过 PostCSS 处理其样式，你只需要对标准的 CSS 文件应用 `postcss-loader` 即可。即便你的工程中存在 PostCSS 配置文件，也无需在样式块上指定 `lang="postcss"`。
+
+有时用户可能只是出于语法高亮的目的使用 `lang="postcss"`。从 13.6.0 开始，如果没有 loader (通过 `vue-loader` 自身的 `loaders` 选项) 显式配置下列 PostCSS 扩展，则它们只会简单的进行 `vue-loader` 的默认 PostCSS 转换：
+
+- `postcss`
+- `pcss`
+- `sugarss`
+- `sss`
+
 ## 内联选项
 
 或者，你可以使用 `vue-loader` 的 `postcss` 选项来为 `.vue` 文件指定配置。
 
-Webpack 1.x 例子：
+webpack 1.x 例子：
 
 ``` js
 // webpack.config.js
 module.exports = {
   // 其它配置……
   vue: {
-    // 使用自定义 postcss 插件
+    // 使用自定义 PostCSS 插件
     postcss: [require('postcss-cssnext')()]
   }
 }
 ```
 
-Webpack 2.x 例子：
+webpack 2.x 例子：
 
 ``` js
 // webpack.config.js
@@ -66,3 +77,17 @@ module.exports = {
     }
   }
   ```
+
+### 禁止自动加载配置文件
+
+在 13.6.0+ 版本中，自动加载 PostCSS 配置文件可以通过指定 `postcss.useConfigFile: false` 来禁用：
+
+``` js
+postcss: {
+  useConfigFile: false,
+  plugins: [/* ... */],
+  options: {/* ... */}
+}
+```
+
+这样做会使得 `*.vue` 文件内部的 PostCSS 配置完全由内联配置所控制。

docs/zh-cn/options.md

@@ -1,8 +1,8 @@
 # 选项参考
 
-## Webpack 1 和 2 之间的使用差异
+## webpack 1 和 2 之间的使用差异
 
-Webpack 2：配置直接放到 loader rule 中。
+webpack 2：配置直接放到 loader rule 中。
 
 ``` js
 module.exports = {
@@ -21,7 +21,7 @@ module.exports = {
 }
 ```
 
-Webpack 1.x：在 Webpack 配置中添加根节点 `vue` 块。
+webpack 1.x：在 webpack 配置中添加根节点 `vue` 块。
 
 ``` js
 module.exports = {
@@ -36,7 +36,7 @@ module.exports = {
 
 - 类型：`{ [lang: string]: string }`
 
-  指定 Webpack loader 对象覆盖用于 `*.vue` 文件内的语言块的默认 loader。如果指定，该键对应于语言块的 `lang` 属性。每种类型的默认 `lang` 是：
+  指定 webpack loader 对象覆盖用于 `*.vue` 文件内的语言块的默认 loader。如果指定，该键对应于语言块的 `lang` 属性。每种类型的默认 `lang` 是：
 
   - `<template>`: `html`
   - `<script>`: `js`
@@ -45,7 +45,7 @@ module.exports = {
   例如，使用 `babel-loader` 和 `eslint-loader` 处理所有的 `<script>` 块：
 
   ``` js
-  // Webpack 2.x config
+  // webpack 2.x config
   module: {
     rules: [
       {
@@ -138,14 +138,23 @@ module.exports = {
 
     向 PostCSS 插件提供上下文。详见 [postcss-loader 文档](https://github.com/postcss/postcss-loader#context-ctx)。
 
+### postcss.useConfigFile
+
+> 13.6.0 新增
+
+- 类型：`boolean`
+- 默认值：`true`
+
+  设为 `false` 之后可以禁止自动加载 PostCSS 配置文件。
+
 ### cssSourceMap
 
 - 类型: `Boolean`
 - 默认值: `true`
 
   是否开启 CSS 的 source maps，关闭可以避免 `css-loader` 的 some relative path related bugs 同时可以加快构建速度。
 
-  注意，这个值会在 Webpack 配置中没有 `devtool` 的情况下自动设置为 `false`。
+  注意，这个值会在 webpack 配置中没有 `devtool` 的情况下自动设置为 `false`。
 
 ### esModule
 
@@ -182,7 +191,7 @@ module.exports = {
 - 类型: `{ [tag: string]: string | Array<string> }`
 - 默认值: `{ img: 'src', image: 'xlink:href' }`
 
-  在模版编译过程中，编译器可以将某些属性，如 `src` 路径，转换为 `require` 调用，以便目标资源可以由 Webpack 处理。默认配置会转换 `<img>` 标签上的 `src` 属性和 SVG 的 `<image>` 标签上的 `xlink：href` 属性。
+  在模版编译过程中，编译器可以将某些属性，如 `src` 路径，转换为 `require` 调用，以便目标资源可以由 webpack 处理。默认配置会转换 `<img>` 标签上的 `src` 属性和 SVG 的 `<image>` 标签上的 `xlink：href` 属性。
 
 ### buble
 

docs/zh-cn/start/spec.md

@@ -56,7 +56,7 @@ export default {
 
 - 每个 `.vue` 文件最多包含一个 `<script>` 块。
 
-- 该脚本在类 CommonJS 环境中执行 (就像通过 Webpack 打包的正常 js 模块)，这意味这你可以 `require()` 其它依赖。在 ES2015 支持下，你也可以使用 `import` 和 `export` 语法。
+- 该脚本在类 CommonJS 环境中执行 (就像通过 webpack 打包的正常 js 模块)，这意味这你可以 `require()` 其它依赖。在 ES2015 支持下，你也可以使用 `import` 和 `export` 语法。
 
 - 脚本必须导出 Vue.js 组件对象。也可以导出由 `Vue.extend()` 创建的扩展对象，但是普通对象是更好的选择。
 
@@ -68,13 +68,13 @@ export default {
 
 - `<style>` 标签可以有 `scoped` 或者 `module` 属性 (查看 [CSS 作用域](../features/scoped-css.md)和 [CSS Modules](../features/css-modules.md)) 以帮助你将样式封装到当前组件。具有不同封装模式的多个 `<style>` 标签可以在同一个组件中混合使用。
 
-- 默认情况下，将会使用 `style-loader` 提取内容，并通过 `<style>` 标签动态加入文档的 `<head>` 中，也可以[配置 Webpack 将所有 styles 提取到单个 CSS 文件中](../configurations/extract-css.md)。
+- 默认情况下，将会使用 `style-loader` 提取内容，并通过 `<style>` 标签动态加入文档的 `<head>` 中，也可以[配置 webpack 将所有 styles 提取到单个 CSS 文件中](../configurations/extract-css.md)。
 
 ### 自定义块
 
 > 只在 vue-loader 10.2.0+ 中支持
 
-可以在 `.vue` 文件中添加额外的自定义块来实现项目的特定需求，例如 `<docs>` 块。`vue-loader` 将会使用标签名来查找对应的 webpack loader 来应用在对应的块上。Webpack loader 需要在 `vue-loader` 的选项 `loaders` 中指定。
+可以在 `.vue` 文件中添加额外的自定义块来实现项目的特定需求，例如 `<docs>` 块。`vue-loader` 将会使用标签名来查找对应的 webpack loader 来应用在对应的块上。webpack loader 需要在 `vue-loader` 的选项 `loaders` 中指定。
 
 更多细节，查看[自定义块](../configurations/custom-blocks.md)。
 

docs/zh-cn/workflow/linting.md

@@ -38,9 +38,9 @@ module.exports = {
 }
 ```
 
-注意 Webpack loader 处理顺序是 **从右到左**。确保在 `vue` 之前应用 `eslint`，这样才能检验编译前的代码。
+注意 webpack loader 处理顺序是 **从右到左**。确保在 `vue` 之前应用 `eslint`，这样才能检验编译前的代码。
 
-我们需要考虑使用的 NPM 包中的第三方 `.vue` 组件，实际使用中我们希望使用 `vue-loader` 去处理第三方组件，但是不想检验它们。我们需要把 lint 配置到 Webpack 的 [preLoaders](https://webpack.github.io/docs/loaders.html#loader-order) 中：
+我们需要考虑使用的 NPM 包中的第三方 `.vue` 组件，实际使用中我们希望使用 `vue-loader` 去处理第三方组件，但是不想检验它们。我们需要把 lint 配置到 webpack 的 [preLoaders](https://webpack.github.io/docs/loaders.html#loader-order) 中：
 
 ``` js
 // webpack.config.js
@@ -66,7 +66,7 @@ module.exports = {
 }
 ```
 
-For Webpack 2.x：
+For webpack 2.x：
 
 ``` js
 // webpack.config.js

docs/zh-cn/workflow/production.md

@@ -34,6 +34,6 @@ module.exports = {
 
 1. 使用环境变量动态构建；
 
-2. 或者，使用两个分开的 Webpack 配置文件，一个用于开发环境，一个用于生产环境。把可能共用的配置放到第三个文件中，如 [vue-hackernews-2.0](https://github.com/vuejs/vue-hackernews-2.0) 所示。
+2. 或者，使用两个分开的 webpack 配置文件，一个用于开发环境，一个用于生产环境。把可能共用的配置放到第三个文件中，如 [vue-hackernews-2.0](https://github.com/vuejs/vue-hackernews-2.0) 所示。
 
 只要达到目标，怎么做取决于你。

docs/zh-cn/workflow/testing-with-mocks.md

@@ -4,6 +4,8 @@
 
 `vue-loader` 提供了一个可以使用 [inject-loader](https://github.com/plasticine/inject-loader) 将任意依赖项注入到 `*.vue` 组件的特性。大体思路是：我们使用 `inject-loader` 为该模块创建一个 “模块工厂” 功能，而不是直接导入组件模块。当使用 mock 对象调用此函数时，它会返回模块的实例，并注入到 mock 中。
 
+> 注意：你必须在注入模式下禁用 `esModule` 选项，否则会报错。
+
 假设我们有一个这样的组件：
 
 ``` html
@@ -14,9 +16,9 @@
 
 <script>
 // this dependency needs to be mocked
-import SomeService from '../service'
+const SomeService = require('../service')
 
-export default {
+module.exports = {
   data () {
     return {
       msg: SomeService.msg
@@ -28,10 +30,8 @@ export default {
 
 以下是使用 mock 导入的方法：
 
-> 注意: [email protected] 当前是不稳定的。
-
 ``` bash
-npm install inject-loader@^2.0.0 --save-dev
+npm install inject-loader --save-dev
 ```
 
 ``` js