Merge remote-tracking branch 'upstream/master' into working

MachinisteWeb · MachinisteWeb · commit 64bc2ef8f72c · 2017-09-12T12:30:29.000+02:00
# Conflicts:
#	README.md

Signed-off-by: Bruno Lesieur &lt;bruno.lesieur@gmail.com&gt;
diff --git a/book.json b/book.json
@@ -1,6 +1,6 @@
 {
   "gitbook": ">3.0.0",
-  "plugins": ["edit-link", "theme-vuejs@git+https://github.com/pearofducks/gitbook-plugin-theme-vuejs.git", "-fontsettings", "github"],
+  "plugins": ["edit-link", "theme-vuejs", "-fontsettings", "github"],
   "pluginsConfig": {
     "edit-link": {
       "base": "https://github.com/vuejs/vue-ssr-docs/edit/master/",
diff --git a/en/SUMMARY.md b/en/SUMMARY.md
@@ -7,7 +7,7 @@
 - [Introduction au moteur de dépaquetage](bundle-renderer.md)
 - [Configuration de pré-compilation](build-config.md)
 - [Gestion des CSS](css.md)
-- [Gestion des entêtes (En)](head.md)
+- [Gestion des entêtes](head.md)
 - [Mise en cache](caching.md)
 - [Envoi par flux](streaming.md)
 - [Référence de l'API](api.md)
diff --git a/en/head.md b/en/head.md
@@ -52,7 +52,7 @@ export default {
   mixins: [titleMixin],
   title () {
     return this.item.title
-  }
+  },
 
   asyncData ({ store, route }) {
     return store.dispatch('fetchItem', route.params.id)
diff --git a/fr/README.md b/fr/README.md
@@ -1,9 +1,9 @@
 # Guide du rendu côté serveur avec Vue.js
 
 > **Note :** Ce guide nécessite les versions de Vue et de ses bibliothèques de support suivantes :
-> - vue & vue-server-renderer >= 2.3.0
-> - vue-router >= 2.5.0
-> - vue-loader >= 12.0.0 & vue-style-loader >= 3.0.0
+> - vue & vue-server-renderer 2.3.0+
+> - vue-router 2.5.0+
+> - vue-loader 12.0.0+ & vue-style-loader 3.0.0+
 
 > Si vous avez déjà utilisé le rendu côté serveur (SSR pour *Server-Side Rendering*) avec Vue 2.2, vous vous apercevrez que la structure de code recommandée est maintenant [légèrement différente](./structure.md) (avec la nouvelle option [runInNewContext](./api.md#runinnewcontext) mise à `false`). Votre application devrait continuer à fonctionner, mais il est recommandé de migrer vers les nouvelles recommandations.
 
diff --git a/fr/api.md b/fr/api.md
@@ -177,7 +177,7 @@ Voyez l'[Introduction au moteur de dépaquetage](./bundle-renderer.md) et la [Co
   })
   ```
 
-  Notez que cet objet de mise en cache doit au moins implémenter `get` et `set`. De plus `get` et `set` peuvent être optionnellement asynchrone s'ils acceptent en second argument une fonction de rappel. Cela permet à la mise en cache d'utiliser des APIs. Par ex. un client Redis :
+  Notez que cet objet de mise en cache doit au moins implémenter `get` et `set`. De plus `get` et `set` peuvent être optionnellement asynchrones s'ils acceptent en second argument une fonction de rappel. Cela permet à la mise en cache d'utiliser des APIs. Par ex. un client Redis :
 
   ``` js
   const renderer = createRenderer({
diff --git a/fr/css.md b/fr/css.md
@@ -22,7 +22,7 @@ Plus important encore, `vue-style-loader`, le loader utilisé en interne par `vu
 
 ## Activer l'extraction CSS
 
-Pour extraire le CSS des fichiers `*.vue`, utilisez l'option `extractCSS` du `vue-loader` (requiert `vue-loader>=12.0.0`) :
+Pour extraire le CSS des fichiers `*.vue`, utilisez l'option `extractCSS` du `vue-loader` (requiert `vue-loader` 12.0.0+) :
 
 ``` js
 // webpack.config.js
diff --git a/fr/head.md b/fr/head.md
@@ -66,7 +66,7 @@ export default {
 }
 ```
 
-Et passé au moteur de rendu de paquetage dans le template.
+Et passé au moteur de rendu de paquetage dans le template :
 
 ``` html
 <html>
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -24,7 +24,9 @@
   "homepage": "https://github.com/vuejs/vue-ssr-docs#readme",
   "devDependencies": {
     "gitbook-plugin-edit-link": "^2.0.2",
-    "gitbook-plugin-github": "^3.0.0",
-    "gitbook-plugin-theme-vuejs": "pearofducks/gitbook-plugin-theme-vuejs"
+    "gitbook-plugin-github": "^2.0.0"
+  },
+  "dependencies": {
+    "gitbook-plugin-theme-vuejs": "^1.0.0"
   }
 }
diff --git a/ru/README.md b/ru/README.md
@@ -1,9 +1,9 @@
 # Руководство по серверному рендерингу Vue.js
 
 > **Примечание:** для этого руководства требуются следующие версии Vue и библиотек:
-> - vue & vue-server-renderer >= 2.3.0
-> - vue-router >= 2.5.0
-> - vue-loader >= 12.0.0 & vue-style-loader >= 3.0.0
+> - vue & vue-server-renderer 2.3.0+
+> - vue-router 2.5.0+
+> - vue-loader 12.0.0+ & vue-style-loader 3.0.0+
 
 > Если вы ранее использовали Vue 2.2 с серверным рендерингом, вы заметите, что рекомендуемая структура кода теперь [немного отличается](./structure.md) (с новой опцией [runInNewContext](./api.md#runinnewcontext) установленной в `false`). Ваше существующее приложение по-прежнему будет работать, но советуем внести изменения с учётом новых рекомендаций.
 
diff --git a/ru/caching.md b/ru/caching.md
@@ -67,7 +67,7 @@ export default {
 }
 ```
 
-Обратите внимание, что подлежащий кэшированию компонент **также должен определять уникальную опцию «name»**. С уникальным именем ключ кэша таким образом является компоненто-зависимым: вам не нужно беспокоиться о двух компонентах, возвращающих одинаковый ключ.
+Обратите внимание, что подлежащий кэшированию компонент **также должен определять уникальную опцию `name`**. С уникальным именем ключ кэша таким образом является компоненто-зависимым: вам не нужно беспокоиться о двух компонентах, возвращающих одинаковый ключ.
 
 Ключ, возвращаемый из `serverCacheKey` должен содержать достаточную информацию для представления формы результата рендеринга. Указанное выше является хорошей реализацией, если результат рендеринга определяется исключительно с помощью `props.item.id`. Однако, если элемент с таким же идентификатором может со временем меняться или результат рендеринга также зависит от других данных, вам необходимо изменить реализацию `getCacheKey`, чтобы учитывать и другие переменные.
 
diff --git a/ru/css.md b/ru/css.md
@@ -22,7 +22,7 @@
 
 ## Настройка извлечения CSS
 
-Для извлечения CSS из `*.vue` файлов в `vue-loader` используется опция `extractCSS` (требует `vue-loader>=12.0.0`):
+Для извлечения CSS из `*.vue` файлов в `vue-loader` используется опция `extractCSS` (требует `vue-loader` 12.0.0+):
 
 ``` js
 // webpack.config.js
diff --git a/ru/head.md b/ru/head.md
@@ -2,7 +2,7 @@
 
 Аналогично внедрению ресурсов, управление заголовочными тегами следует той же идее: мы можем динамически присоединять данные к `context` рендерера в жизненном цикле компонента, а затем интерполировать эти данные в `template`.
 
-> С версии >=2.3.2 вы можете напрямую получать доступ к контексту SSR в компонентах через `this.$ssrContext`. В более ранних версиях вам потребуется вручную внедрять контекст SSR, передав его в `createApp()` и выставляя его на корневом экземплере `$options` — после чего, компоненты потомки смогут получить к нему доступ через `this.$root.$options.ssrContext`.
+> С версии 2.3.2+ вы можете напрямую получать доступ к контексту SSR в компонентах через `this.$ssrContext`. В более ранних версиях вам потребуется вручную внедрять контекст SSR, передав его в `createApp()` и выставляя его на корневом экземплере `$options` — после чего, компоненты потомки смогут получить к нему доступ через `this.$root.$options.ssrContext`.
 
 Мы можем написать простую примесь для управления заголовком:
 
@@ -38,7 +38,7 @@ const clientTitleMixin = {
   }
 }
 
-// значение VUE_ENV будет определено плагином webpack.DefinePlugin
+// значение `VUE_ENV` будет определено плагином `webpack.DefinePlugin`
 export default process.env.VUE_ENV === 'server'
   ? serverTitleMixin
   : clientTitleMixin
@@ -66,7 +66,7 @@ export default {
 }
 ```
 
-И внутри `template`, переданного в рендерер сборки:
+И внутри шаблона, переданного в рендерер сборки:
 
 ``` html
 <html>
diff --git a/yarn.lock b/yarn.lock
diff --git a/zh/README.md b/zh/README.md
@@ -5,7 +5,7 @@
 > - vue-router 2.5.0+
 > - vue-loader  12.0.0+ & vue-style-loader 3.0.0+
 
-> 如果先前已经使用过 Vue 2.2 的服务器端渲染(SSR)，您应该注意到，推荐的代码结构现在[略有不同](./structure.md)（使用新的 [runInNewContext](./api.md#runinnewcontext) 选项，并设置为 `false`）。现有的应用程序可以继续运行，但建议您迁移到新的推荐规范。
+> 如果先前已经使用过 Vue 2.2 的服务器端渲染(SSR)，你应该注意到，推荐的代码结构现在[略有不同](./structure.md)（使用新的 [runInNewContext](./api.md#runinnewcontext) 选项，并设置为 `false`）。现有的应用程序可以继续运行，但建议你迁移到新的推荐规范。
 
 ## 什么是服务器端渲染(SSR)？
 
@@ -19,7 +19,7 @@ Vue.js 是构建客户端应用程序的框架。默认情况下，可以在浏
 
 - 更好的 SEO，由于搜索引擎爬虫抓取工具可以直接查看完全渲染的页面。
 
-请注意，截至目前，Google 和 Bing 可以很好对同步 JavaScript 应用程序进行索引。在这里，同步是关键。如果您的应用程序初始展示 loading 菊花图，然后通过 Ajax 获取内容，抓取工具并不会等待异步完成后再行抓取页面内容。也就是说，如果 SEO 对你的站点至关重要，而你的页面又是异步获取内容，则你可能需要服务器端渲染(SSR)解决此问题。
+请注意，截至目前，Google 和 Bing 可以很好对同步 JavaScript 应用程序进行索引。在这里，同步是关键。如果你的应用程序初始展示 loading 菊花图，然后通过 Ajax 获取内容，抓取工具并不会等待异步完成后再行抓取页面内容。也就是说，如果 SEO 对你的站点至关重要，而你的页面又是异步获取内容，则你可能需要服务器端渲染(SSR)解决此问题。
 
 - 更快的内容到达时间(time-to-content)，特别是对于缓慢的网络情况或运行缓慢的设备。无需等待所有的 JavaScript 都完成下载并执行，才显示服务器渲染的标记，所以你的用户将会更快速地看到完整渲染的页面。通常可以产生更好的用户体验，并且对于那些「内容到达时间(time-to-content)与转化率直接相关」的应用程序而言，服务器端渲染(SSR)至关重要。
 
@@ -29,22 +29,22 @@ Vue.js 是构建客户端应用程序的框架。默认情况下，可以在浏
 
 - 涉及构建设置和部署的更多要求。与可以部署在任何静态文件服务器上的完全静态单页面应用程序(SPA)不同，服务器渲染应用程序，需要处于 Node.js server 运行环境。
 
-- 更多的服务器端负载。在 Node.js 中渲染完整的应用程序，显然会比仅仅提供静态文件的 server 更加大量占用 CPU 资源(CPU-intensive - CPU 密集)，因此如果您预料在高流量环境(high traffic)下使用，请准备相应的服务器负载，并明智地采用缓存策略。
+- 更多的服务器端负载。在 Node.js 中渲染完整的应用程序，显然会比仅仅提供静态文件的 server 更加大量占用 CPU 资源(CPU-intensive - CPU 密集)，因此如果你预料在高流量环境(high traffic)下使用，请准备相应的服务器负载，并明智地采用缓存策略。
 
-在对您的应用程序使用服务器端渲染(SSR)之前，您应该问第一个问题是否真的需要它。这主要取决于内容到达时间(time-to-content)对应用程序的重要程度。例如，如果您正在构建一个内部仪表盘，初始加载时的额外几百毫秒并不重要，这种情况下去使用服务器端渲染(SSR)将是一个小题大作之举。然而，内容到达时间(time-to-content)要求是绝对关键的指标，在这种情况下，服务器端渲染(SSR)可以帮助您实现最佳的初始加载性能。
+在对你的应用程序使用服务器端渲染(SSR)之前，你应该问第一个问题是否真的需要它。这主要取决于内容到达时间(time-to-content)对应用程序的重要程度。例如，如果你正在构建一个内部仪表盘，初始加载时的额外几百毫秒并不重要，这种情况下去使用服务器端渲染(SSR)将是一个小题大作之举。然而，内容到达时间(time-to-content)要求是绝对关键的指标，在这种情况下，服务器端渲染(SSR)可以帮助你实现最佳的初始加载性能。
 
 ## 服务器端渲染 vs 预渲染(SSR vs Prerendering)
 
-如果您调研服务器端渲染(SSR)只是用来改善少数营销页面（例如 `/`, `/about`, `/contact` 等）的 SEO，那么您可能需要**预渲染**。无需使用 web 服务器实时动态编译 HTML，而是使用预渲染方式，在构建时(build time)简单地生成针对特定路由的静态 HTML 文件。优点是设置预渲染更简单，并可以将您的前端作为一个完全静态的站点。
+如果你调研服务器端渲染(SSR)只是用来改善少数营销页面（例如 `/`, `/about`, `/contact` 等）的 SEO，那么你可能需要**预渲染**。无需使用 web 服务器实时动态编译 HTML，而是使用预渲染方式，在构建时(build time)简单地生成针对特定路由的静态 HTML 文件。优点是设置预渲染更简单，并可以将你的前端作为一个完全静态的站点。
 
-如果您使用 webpack，您可以使用 [prerender-spa-plugin](https://github.com/chrisvfritz/prerender-spa-plugin) 轻松地添加预渲染。它已经被 Vue 应用程序广泛测试 - 事实上，[作者](https://github.com/chrisvfritz)是 Vue 核心团队的成员。
+如果你使用 webpack，你可以使用 [prerender-spa-plugin](https://github.com/chrisvfritz/prerender-spa-plugin) 轻松地添加预渲染。它已经被 Vue 应用程序广泛测试 - 事实上，[作者](https://github.com/chrisvfritz)是 Vue 核心团队的成员。
 
 ## 关于此指南
 
 本指南专注于，使用 Node.js server 的服务器端单页面应用程序渲染。将 Vue 服务器端渲染(SSR)与其他后端设置进行混合使用，是其它后端自身的一个主题，本指南不包括在内。
 
-本指南将会非常深入，并且假设您已经熟悉 Vue.js 本身，并且具有 Node.js 和 webpack 的相当不错的应用经验。如果您具有更高级解决方案，可以提供一个平缓的开箱即用体验，您应该去尝试使用 [Nuxt.js](http://nuxtjs.org/)。它建立在同等的 Vue 技术栈之上，但抽象出很多模板，并提供了一些额外的功能，例如静态站点生成。但是，如果您需要更直接地控制应用程序的结构，Nuxt.js 并不适合这种使用场景。无论如何，阅读本指南将更有助于更好地了解一切如何运行。
+本指南将会非常深入，并且假设你已经熟悉 Vue.js 本身，并且具有 Node.js 和 webpack 的相当不错的应用经验。如果你倾向于使用提供了平滑开箱即用体验的更高层次解决方案，你应该去尝试使用 [Nuxt.js](http://nuxtjs.org/)。它建立在同等的 Vue 技术栈之上，但抽象出很多模板，并提供了一些额外的功能，例如静态站点生成。但是，如果你需要更直接地控制应用程序的结构，Nuxt.js 并不适合这种使用场景。无论如何，阅读本指南将更有助于更好地了解一切如何运行。
 
-当您阅读时，参考官方 [HackerNews Demo](https://github.com/vuejs/vue-hackernews-2.0/) 将会有所帮助，此示例使用了本指南涵盖的大部分技术。
+当你阅读时，参考官方 [HackerNews Demo](https://github.com/vuejs/vue-hackernews-2.0/) 将会有所帮助，此示例使用了本指南涵盖的大部分技术。
 
 最后，请注意，本指南中的解决方案不是限定的 - 我们发现它们对我们来说很好，但这并不意味着无法继续改进。可能会在未来持续改进，欢迎通过随意提交 pull request 作出贡献！
diff --git a/zh/head.md b/zh/head.md
@@ -2,7 +2,7 @@
 
 类似于资源注入，Head 管理遵循相同的理念：我们可以在组件的生命周期中，将数据动态地追加到渲染`上下文`(render context)，然后在`模板`中的占位符替换为这些数据。
 
-> 在 2.3.2+ 的版本，您可以通过 `this.$ssrContext` 来直接访问组件中的服务器端渲染上下文(SSR context)。在旧版本中，您必须通过将其传递给 `createApp()` 并将其暴露于根实例的 `$options` 上，才能手动注入服务器端渲染上下文(SSR context) - 然后子组件可以通过 `this.$root.$options.ssrContext` 来访问它。
+> 在 2.3.2+ 的版本，你可以通过 `this.$ssrContext` 来直接访问组件中的服务器端渲染上下文(SSR context)。在旧版本中，你必须通过将其传递给 `createApp()` 并将其暴露于根实例的 `$options` 上，才能手动注入服务器端渲染上下文(SSR context) - 然后子组件可以通过 `this.$root.$options.ssrContext` 来访问它。
 
 我们可以编写一个简单的 mixin 来完成标题管理：
 
@@ -81,4 +81,4 @@ export default {
 
 ---
 
-使用相同的策略，您可以轻松地将此 mixin 扩展为通用的头部管理工具(generic head management utility)。
+使用相同的策略，你可以轻松地将此 mixin 扩展为通用的头部管理工具(generic head management utility)。

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"gitbook": ">3.0.0",`
`3`		`- "plugins": ["edit-link", "theme-vuejs@git+https://github.com/pearofducks/gitbook-plugin-theme-vuejs.git", "-fontsettings", "github"],`
	`3`	`+ "plugins": ["edit-link", "theme-vuejs", "-fontsettings", "github"],`
`4`	`4`	`"pluginsConfig": {`
`5`	`5`	`"edit-link": {`
`6`	`6`	`"base": "https://github.com/vuejs/vue-ssr-docs/edit/master/",`
Original file line number	Diff line number	Diff line change
`@@ -66,7 +66,7 @@ export default {`
`66`	`66`	`}`
`67`	`67`	```
`68`	`68`
`69`		`-Et passé au moteur de rendu de paquetage dans le template.`
	`69`	`+Et passé au moteur de rendu de paquetage dans le template :`
`70`	`70`
`71`	`71`	``` html
`72`	`72`	`<html>`
Original file line number	Diff line number	Diff line change
`@@ -24,7 +24,9 @@`
`24`	`24`	`"homepage": "https://github.com/vuejs/vue-ssr-docs#readme",`
`25`	`25`	`"devDependencies": {`
`26`	`26`	`"gitbook-plugin-edit-link": "^2.0.2",`
`27`		`- "gitbook-plugin-github": "^3.0.0",`
`28`		`- "gitbook-plugin-theme-vuejs": "pearofducks/gitbook-plugin-theme-vuejs"`
	`27`	`+ "gitbook-plugin-github": "^2.0.0"`
	`28`	`+ },`
	`29`	`+ "dependencies": {`
	`30`	`+ "gitbook-plugin-theme-vuejs": "^1.0.0"`
`29`	`31`	`}`
`30`	`32`	`}`
Original file line number	Diff line number	Diff line change
`@@ -67,7 +67,7 @@ export default {`
`67`	`67`	`}`
`68`	`68`	```
`69`	`69`
`70`		`-Обратите внимание, что подлежащий кэшированию компонент также должен определять уникальную опцию «name». С уникальным именем ключ кэша таким образом является компоненто-зависимым: вам не нужно беспокоиться о двух компонентах, возвращающих одинаковый ключ.`
	`70`	+Обратите внимание, что подлежащий кэшированию компонент также должен определять уникальную опцию `name`. С уникальным именем ключ кэша таким образом является компоненто-зависимым: вам не нужно беспокоиться о двух компонентах, возвращающих одинаковый ключ.
`71`	`71`
`72`	`72`	Ключ, возвращаемый из `serverCacheKey` должен содержать достаточную информацию для представления формы результата рендеринга. Указанное выше является хорошей реализацией, если результат рендеринга определяется исключительно с помощью `props.item.id`. Однако, если элемент с таким же идентификатором может со временем меняться или результат рендеринга также зависит от других данных, вам необходимо изменить реализацию `getCacheKey`, чтобы учитывать и другие переменные.
`73`	`73`
Original file line number	Diff line number	Diff line change
`@@ -2,7 +2,7 @@`
`2`	`2`
`3`	`3`	Аналогично внедрению ресурсов, управление заголовочными тегами следует той же идее: мы можем динамически присоединять данные к `context` рендерера в жизненном цикле компонента, а затем интерполировать эти данные в `template`.
`4`	`4`
`5`		-> С версии >=2.3.2 вы можете напрямую получать доступ к контексту SSR в компонентах через `this.$ssrContext`. В более ранних версиях вам потребуется вручную внедрять контекст SSR, передав его в `createApp()` и выставляя его на корневом экземплере `$options` — после чего, компоненты потомки смогут получить к нему доступ через `this.$root.$options.ssrContext`.
	`5`	+> С версии 2.3.2+ вы можете напрямую получать доступ к контексту SSR в компонентах через `this.$ssrContext`. В более ранних версиях вам потребуется вручную внедрять контекст SSR, передав его в `createApp()` и выставляя его на корневом экземплере `$options` — после чего, компоненты потомки смогут получить к нему доступ через `this.$root.$options.ssrContext`.
`6`	`6`
`7`	`7`	`Мы можем написать простую примесь для управления заголовком:`
`8`	`8`
`@@ -38,7 +38,7 @@ const clientTitleMixin = {`
`38`	`38`	`}`
`39`	`39`	`}`
`40`	`40`
`41`		`-// значение VUE_ENV будет определено плагином webpack.DefinePlugin`
	`41`	+// значение `VUE_ENV` будет определено плагином `webpack.DefinePlugin`
`42`	`42`	`export default process.env.VUE_ENV === 'server'`
`43`	`43`	`? serverTitleMixin`
`44`	`44`	`: clientTitleMixin`
`@@ -66,7 +66,7 @@ export default {`
`66`	`66`	`}`
`67`	`67`	```
`68`	`68`
`69`		-И внутри `template`, переданного в рендерер сборки:
	`69`	`+И внутри шаблона, переданного в рендерер сборки:`
`70`	`70`
`71`	`71`	``` html
`72`	`72`	`<html>`