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

# Conflicts:
#	en/README.md
#	en/SUMMARY.md
#	en/api.md
#	en/basic.md

Signed-off-by: Bruno Lesieur <[email protected]>

Author: MachinisteWeb

en/README.md

@@ -41,7 +41,7 @@ Si vous utilisez webpack, vous pouvez facilement ajouter du pré-rendu avec le p
 
 ## À propos de ce guide
 
-Ce guide est dédié au rendu côté serveur des applications monopages utilisant Node.js en tant que serveur web. Utiliser le SSR de Vue avec une autre configuration serveur est un sujet qui ne sera pas abordé dans ce guide.
+Ce guide est dédié au rendu côté serveur des applications monopages utilisant Node.js en tant que serveur web. Utiliser le SSR de Vue avec une autre configuration serveur est un sujet brièvement abordé dans une [section dédiée](./non-node.md).
 
 Ce guide va réellement entrer dans le détail et présuppose que vous êtes déjà familiarisé avec Vue.js et que vous avez un niveau de connaissance correcte concernant Node.js et webpack. Si vous préférez une solution de haut niveau fournissant une expérience de développement prête à l'emploi, vous devriez probablement essayer [Nuxt.js](https://nuxtjs.org/). Il est construit par-dessus l'écosystème de Vue et vous fournit des éléments préconçus ainsi que des fonctionnalités supplémentaires pour générer des sites web statiques. Il ne vous conviendra cependant pas si vous souhaitez avoir un contrôle plus direct sur la structure de votre application. Dans tous les cas, il reste toujours intéressant de parcourir ce guide pour mieux comprendre comment chaque élément fonctionne avec le reste.
 

en/SUMMARY.md

@@ -10,6 +10,7 @@
 - [Gestion des entêtes](head.md)
 - [Mise en cache](caching.md)
 - [Envoi par flux](streaming.md)
+- [Utilisation dans des environnements autre que Node.js](non-node.md)
 - [Référence de l'API](api.md)
   - [createRenderer](api.md#createrendereroptions)
   - [createBundleRenderer](api.md#createbundlerendererbundle-options)

en/api.md

@@ -30,23 +30,35 @@ Voyez l'[Introduction au moteur de dépaquetage](./bundle-renderer.md) et la [Co
 
 ## `Class: Renderer`
 
-- #### `renderer.renderToString(vm[, context], callback)`
+- #### `renderer.renderToString(vm[, context, callback]): ?Promise<string>`
 
   Fait le rendu d'une instance de Vue sous forme de chaine de caractères. L'objet de contexte est optionnel. La fonction de rappel est une fonction de rappel typique de Node.js avec en premier argument l'erreur potentielle et en second argument la chaine de caractères du rendu.
 
-- #### `renderer.renderToStream(vm[, context])`
+  In 2.5.0+, the callback is also optional. When no callback is passed, the method returns a Promise which resolves to the rendered HTML.
 
+<<<<<<< HEAD
   Fait le rendu d'une instance de Vue sous forme de flux. L'objet de contexte est optionnel. Voir l'[Envoi par flux](./streaming.md) pour plus de détails.
+=======
+- #### `renderer.renderToStream(vm[, context]): stream.Readable`
+
+  Render a Vue instance to a [Node.js readble stream](https://nodejs.org/dist/latest-v8.x/docs/api/stream.html#stream_readable_streams). The context object is optional. See [Streaming](./streaming.md) for more details.
+>>>>>>> upstream/master
 
 ## `Class: BundleRenderer`
 
-- #### `bundleRenderer.renderToString([context, ]callback)`
+- #### `bundleRenderer.renderToString([context, callback]): ?Promise<string>`
 
   Fait le rendu d'un paquetage sous forme de chaine de caractères. L'objet de contexte est optionnel. La fonction de rappel est une fonction de rappel typique de Node.js avec en premier argument l'erreur potentielle et en second argument la chaine de caractères du rendu.
 
-- #### `bundleRenderer.renderToStream([context])`
+  In 2.5.0+, the callback is also optional. When no callback is passed, the method returns a Promise which resolves to the rendered HTML.
+
+- #### `bundleRenderer.renderToStream([context]): stream.Readable`
 
+<<<<<<< HEAD
   Fait le rendu d'un paquetage sous forme de flux. L'objet de contexte est optionnel. Voir l'[Envoi par flux](./streaming.md) pour plus de détails.
+=======
+  Render the bundle to a [Node.js readble stream](https://nodejs.org/dist/latest-v8.x/docs/api/stream.html#stream_readable_streams). The context object is optional. See [Streaming](./streaming.md) for more details.
+>>>>>>> upstream/master
 
 ## Options de `Renderer`
 
@@ -67,7 +79,13 @@ Voyez l'[Introduction au moteur de dépaquetage](./bundle-renderer.md) et la [Co
 
   - `context.state`: (Object) L'état initial du store Vuex devrait être injecté dans la page sous la variable `window.__INITIAL_STATE__`. Le JSON en ligne est automatiquement désinfecté avec [serialize-javascript](https://github.com/yahoo/serialize-javascript) pour éviter les injections XSS.
 
+<<<<<<< HEAD
   En plus, quand `clientManifest` est fourni, le modèle de page injecte automatiquement les éléments suivants :
+=======
+    In 2.5.0+, the embed script also self-removes in production mode.
+
+  In addition, when `clientManifest` is also provided, the template automatically injects the following:
+>>>>>>> upstream/master
 
   - JavaScript client et fichiers CSS nécessaires pour le rendu (avec les fragments asynchrones automatiquement déduits),
   - utilisation optimale des indices de ressources `<link rel="preload/prefetch">` pour le rendu de la page.
@@ -125,6 +143,14 @@ Voyez l'[Introduction au moteur de dépaquetage](./bundle-renderer.md) et la [Co
   })
   ```
 
+- #### `shouldPrefetch`
+
+  - 2.5.0+
+
+  A function to control what files should have `<link rel="prefetch">` resource hints generated.
+
+  By default, all assets in async chunks will be prefetched since this is a low-priority directive; however you can customize what to prefetch in order to better control bandwidth usage. This option expects the same function signature as `shouldPreload`.
+
 - #### `runInNewContext`
 
   - 2.3.0+

en/basic.md

@@ -32,6 +32,13 @@ renderer.renderToString(app, (err, html) => {
   console.log(html)
   // => <div data-server-rendered="true">Hello World</div>
 })
+
+// Dans la 2.5.0+, retourne une promesse si aucune fonction de rappel n'est passée :
+renderer.renderToString.then(html => {
+  console.log(html)
+}).catch(err => {
+  console.error(err)
+})
 ```
 
 ## Intégration avec un serveur

en/non-node.md

@@ -0,0 +1,41 @@
+# Usage in non-Node.js Environments
+
+The default build of `vue-server-renderer` assumes a Node.js environment, which makes it unusable in alternative JavaScript environments such as [php-v8js](https://github.com/phpv8/v8js) or [Nashorn](https://docs.oracle.com/javase/8/docs/technotes/guides/scripting/nashorn/). In 2.5 we have shipped a build in `vue-server-renderer/basic.js` that is largely environment-agnostic, which makes it usable in the environments mentioned above.
+
+For both environments, it is necessary to first prepare the environment by mocking the `global` and `process` objects, with `process.env.VUE_ENV` set to `"server"`, and `process.env.NODE_ENV` set to `"development"` or `"production"`.
+
+In Nashorn, it may also be necessary to provide a polyfill for `Promise` or `setTimeout` using Java's native timers.
+
+Example usage in php-v8js:
+
+``` php
+<?php
+$vue_source = file_get_contents('/path/to/vue.js');
+$renderer_source = file_get_contents('/path/to/vue-server-renderer/basic.js');
+$app_source = file_get_contents('/path/to/app.js');
+
+$v8 = new V8Js();
+
+$v8->executeString('var process = { env: { VUE_ENV: "server", NODE_ENV: "production" }}; this.global = { process: process };');
+$v8->executeString($vue_source);
+$v8->executeString($renderer_source);
+$v8->executeString($app_source);
+?>
+```
+
+---
+
+``` js
+// app.js
+var vm = new Vue({
+  template: `<div>{{ msg }}</div>`,
+  data: {
+    msg: 'hello'
+  }
+})
+
+// exposed by vue-server-renderer/basic.js
+renderVueComponentToString(vm, (err, res) => {
+  print(res)
+})
+```

ja/SUMMARY.md

@@ -10,18 +10,19 @@
 - [ヘッドの管理](head.md)
 - [キャッシュ](caching.md)
 - [ストリーミング](streaming.md)
+- [非 Node.js 環境における使用](non-node.md)
 - [API リファレンス](api.md)
     - [createRenderer](api.md#createrendereroptions)
     - [createBundleRenderer](api.md#createbundlerendererbundle-options)
     - [クラス: Renderer](api.md#class-renderer)
     - [クラス: BundleRenderer](api.md#class-bundlerenderer)
     - [Renderer 生成時のオプション](api.md#renderer-options)
-    - [template](api.md#template)
-    - [clientManifest](api.md#clientmanifest)
-    - [inject](api.md#inject)
-    - [shouldPreload](api.md#shouldpreload)
-    - [runInNewContext](api.md#runinnewcontext)
-    - [basedir](api.md#basedir)
-    - [cache](api.md#cache)
-    - [directives](api.md#directives)
+            - [template](api.md#template)
+            - [clientManifest](api.md#clientmanifest)
+            - [inject](api.md#inject)
+            - [shouldPreload](api.md#shouldpreload)
+            - [runInNewContext](api.md#runinnewcontext)
+            - [basedir](api.md#basedir)
+            - [cache](api.md#cache)
+            - [directives](api.md#directives)
     - [webpack プラグイン](api.md#webpack-plugins)

package-lock.json

@@ -23,10 +23,8 @@
   },
   "homepage": "https://github.com/vuejs/vue-ssr-docs#readme",
   "devDependencies": {
+    "gitbook-plugin-theme-vuejs": "^1.1.0",
     "gitbook-plugin-edit-link": "^2.0.2",
     "gitbook-plugin-github": "^2.0.0"
-  },
-  "dependencies": {
-    "gitbook-plugin-theme-vuejs": "^1.0.0"
   }
 }