[RU] Translation update (vuejs#144)

* Добавлены бэктики

* routing.md исправлен пример

* data.md исправлен пример

* data.md добавлены бэктики

* data.md исправление

* universal.md правка

* universal.md правка

* api.md опечатка

* structure.md опечатка

* head.md исправлен пример

* README.md исправлена ссылка на HTTPS

* caching.md правка

* api.md новые правки к 2.5.0

* basic.md добавлен новый пример для 2.5.0

* non-node.md добавлен новый раздел

* README.md добавлена ссылка на новый раздел

* SUMMARY.md добавлена ссылка на новый раздел в оглавление

* non-node.md допереведен комментарий

* hydration.md новые правки

* non-node.md мелкие правки

Author: Alex-Sokolov

ru/README.md

@@ -41,7 +41,7 @@ Vue.js — это фреймворк для создания приложени
 
 ## Об этом руководстве
 
-Это руководство ориентировано на SPA приложения с рендерингом на сервере, используя Node.js в качестве сервера. Использование серверного рендеринга Vue совместно с другими технологиями и настройками бэкэнда являются отдельной темой и не рассматриваются в этом руководстве.
+Это руководство ориентировано на SPA приложения с рендерингом на сервере, используя Node.js в качестве сервера. Использование серверного рендеринга Vue совместно с другими технологиями и настройками бэкэнда являются отдельной темой и кратко обсуждается в [отдельном разделе](./non-node.md).
 
 Это руководство будет очень детальным и предполагает, что вы уже знакомы с самим Vue.js, имеете знания и опыт работы с Node.js и Webpack. Если вы предпочитаете более высокоуровневые решения, обеспечивающие работу из коробки — вам следует попробовать [Nuxt.js](https://nuxtjs.org/). Он построен на том же стеке Vue, но позволяет абстрагироваться от написания шаблонного кода, а также предоставляет некоторые дополнительные возможности, такие как генерация статичного сайта. Однако он может не подойти, если вам необходим полный контроль над структурой приложения. В любом случае, вам будет полезно прочитать это руководство, чтобы лучше понимать, как все составляющие работают вместе.
 

ru/SUMMARY.md

@@ -10,6 +10,7 @@
 - [Управление заголовочными тегами (head)](head.md)
 - [Кэширование](caching.md)
 - [Стриминг](streaming.md)
+- [Использование в не-Node.js окружениях](non-node.md)
 - [Справочник API](api.md)
   - [createRenderer](api.md#createrendereroptions)
   - [createBundleRenderer](api.md#createbundlerendererbundle-options)

ru/api.md

@@ -30,23 +30,27 @@ const renderer = createBundleRenderer(serverBundle, { ... })
 
 ## `Класс: Renderer`
 
-- #### `renderer.renderToString(vm[, context], callback)`
+- #### `renderer.renderToString(vm[, context, callback]): ?Promise<string>`
 
   Рендерит экземпляр Vue в строку. Объект контекста опционален. Коллбэк является обычным для Node.js коллбэком, где первый аргумент является ошибкой, а второй аргумент — отрендеренной строкой.
 
-- #### `renderer.renderToStream(vm[, context])`
+  С версии 2.5.0+ коллбэк является опциональным. Когда коллбэк не указан, метод возвращает Promise, который разрешается отрендеренным HTML.
 
-  Рендерит экземпляр Vue в поток (stream) Node.js. Объект контекста опционален. См. также [Стриминг](./streaming.md) для подробностей.
+- #### `renderer.renderToStream(vm[, context]): stream.Readable`
+
+  Рендерит экземпляр Vue в [Node.js readable stream](https://nodejs.org/dist/latest-v8.x/docs/api/stream.html#stream_readable_streams). Объект контекста опционален. См. также [Стриминг](./streaming.md) для подробностей.
 
 ## `Класс: BundleRenderer`
 
-- #### `bundleRenderer.renderToString([context, ]callback)`
+- #### `bundleRenderer.renderToString([context, callback]): ?Promise<string>`
 
   Рендерит сборку в строку. Объект контекста опционален. Коллбэк является обычным для Node.js коллбэком, где первый аргумент является ошибкой, а второй аргумент — отрендеренной строкой.
 
-- #### `bundleRenderer.renderToStream([context])`
+  С версии 2.5.0+ коллбэк является опциональным. Когда коллбэк не указан, метод возвращает Promise, который разрешается отрендеренным HTML.
+
+- #### `bundleRenderer.renderToStream([context]): stream.Readable`
 
-  Рендерит сборку в поток (stream) Node.js. Объект контекста опционален. См. также [Стриминг](./streaming.md) для подробностей.
+  Рендерит сборку в [Node.js readable stream](https://nodejs.org/dist/latest-v8.x/docs/api/stream.html#stream_readable_streams). Объект контекста опционален. См. также [Стриминг](./streaming.md) для подробностей.
 
 ## Настройки рендерера
 
@@ -67,6 +71,8 @@ const renderer = createBundleRenderer(serverBundle, { ... })
 
   - `context.state`: (Object) начальное состояние хранилища Vuex, которое должно быть внедрено в страницу как `window.__INITIAL_STATE__`. Внедряемый JSON автоматически обрабатывается с помощью [serialize-javascript](https://github.com/yahoo/serialize-javascript) для предотвращения XSS-уязвимостей.
 
+  С версии 2.5.0+, встраиваемый скрипт также автоматически удаляется в режиме production.
+
   Кроме того, когда предоставлен `clientManifest`, шаблон автоматически внедряет следующее:
 
   - JavaScript и CSS ресурсы для клиентской части, необходимые для рендеринга (с асинхронными фрагментами добавляемыми автоматически);
@@ -81,21 +87,21 @@ const renderer = createBundleRenderer(serverBundle, { ... })
 
 - #### `clientManifest`
 
-  - 2.3.0+
+  - Добавлено в версии 2.3.0+
 
   Предоставляет объект манифеста клиентской сборки, сгенерированный `vue-server-renderer/client-plugin`. Клиентский манифест предоставляет для рендерера сборки необходимую информацию для автоматического внедрения ресурсов в шаблон HTML. Подробнее в разделе [Генерация `clientManifest`](./build-config.md#generating-clientmanifest).
 
 - #### `inject`
 
-  - 2.3.0+
+  - Добавлено в версии 2.3.0+
 
   Контролирует, выполнять ли автоматические внедрения при использовании `template`. По умолчанию `true`.
 
   См. также: [Внедрение ресурсов вручную](./build-config.md#manual-asset-injection).
 
 - #### `shouldPreload`
 
-  - 2.3.0+
+  - Добавлено в версии 2.3.0+
 
   Функция, определяющая какие файлы должны иметь `<link rel="preload">` в генерируемых ресурсах.
 
@@ -125,10 +131,18 @@ const renderer = createBundleRenderer(serverBundle, { ... })
   })
   ```
 
+- #### `shouldPrefetch`
+
+  - Добавлено в версии 2.5.0+
+
+  Функция для управления файлами, которые должны содержаться в генерируемых `<link rel="prefetch">`.
+
+  По умолчанию все ресурсы в асинхронных частях будут предварительно загружены, так как это директива с низким приоритетом; однако вы можете настроить что требуется предзагружать для лучшего контроля над использованием канала загрузки. Этот параметр ожидает такую же сигнатуру функции, как `shouldPreload`.
+
 - #### `runInNewContext`
 
-  - 2.3.0+
-  - используется только в `createBundleRenderer`
+  - Добавлено в версии 2.3.0+
+  - Используется только в `createBundleRenderer`
   - Ожидается: `boolean | 'once'` (`'once'` поддерживается только с версии 2.3.1+)
 
   По умолчанию, рендерер сборки будет создавать новый контекст V8 для каждого рендеринга и повторно исполнять всю сборку. Это имеет некоторые преимущества — например, код приложения изолирован от процесса сервера и не нужно беспокоиться [о проблеме «синглтона с состоянием»](./structure.md#avoid-stateful-singletons), которая упоминалась ранее в руководстве. Однако этот режим требует значительных затрат производительности, поскольку повторное выполнение сборки обходится дорого, особенно когда приложение становится большим.
@@ -148,8 +162,8 @@ const renderer = createBundleRenderer(serverBundle, { ... })
 
 - #### `basedir`
 
-  - 2.2.0+
-  - используется только в `createBundleRenderer`
+  - Добавлено в версии 2.2.0+
+  - Используется только в `createBundleRenderer`
 
   Указание пути базового каталога для серверной сборки для разрешения зависимостей из `node_modules` в нём. Это необходимо только в том случае, если сгенерированный файл сборки располагается в другом месте, в отличии от используемых NPM-зависимостей, или когда ваш `vue-server-renderer` подключен NPM-ссылкой в вашем текущем проекте.
 

ru/basic.md

@@ -32,6 +32,13 @@ renderer.renderToString(app, (err, html) => {
   console.log(html)
   // => <div data-server-rendered="true">hello world</div>
 })
+
+// с версии 2.5.0+, возвращает Promise если коллбэк не указан:
+renderer.renderToString.then(html => {
+  console.log(html)
+}).catch(err => {
+  console.error(err)
+})
 ```
 
 ## Интеграция с сервером
@@ -112,7 +119,7 @@ renderer.renderToString(app, (err, html) => {
   <head>
     <!-- Используйте двойные фигурные скобки для экранированного HTML-кода -->
     <title>{{ title }}</title>
-    
+
     <!-- Используйте тройные фигурные скобки для подстановки сырого HTML -->
     {{{ meta }}}
   </head>

ru/hydration.md

@@ -9,13 +9,13 @@ app.$mount('#app')
 
 Поскольку сервер уже отобразил разметку, мы, очевидно, не хотели бы её выбрасывать и заново создавать все элементы DOM. Вместо этого мы хотим «гидрировать» статическую разметку и сделать её интерактивной.
 
-Если вы исследовали вывод после серверного рендеринга, вы могли заметить, что у корневого элемента приложения есть специальный атрибут:
+Если вы исследовали вывод после серверного рендеринга, вы могли заметить, что у корневого элемента приложения должен быть добавлен специальный атрибут:
 
 ``` js
 <div id="app" data-server-rendered="true">
 ```
 
-Специальный атрибут `data-server-rendered` позволяет клиентской части Vue знать, что разметка отображается сервером, и он должен монтироваться в режиме гидратации.
+Специальный атрибут `data-server-rendered` позволяет клиентской части Vue знать, что разметка отображается сервером, и он должен монтироваться в режиме гидратации. Обратите внимание, что он не добавляет `id="app"`, а только атрибут `data-server-rendered`: вам необходимо добавить ID или какой-либо другой селектор в корневой элемент самостоятельно или приложение не будет гидратироваться правильно.
 
 В режиме разработки Vue будет проверять, что виртуальное дерево DOM, сгенерированное на стороне клиента, совпадает с структурой DOM созданной на сервере. При нахождении несоответствия, он будет считать гидратацию неудачной, отказываться от существующего DOM и рендерить всё с нуля. **В режиме production, эта проверка отключена для достижения максимальной производительности.**
 

ru/non-node.md

@@ -0,0 +1,41 @@
+# Использование в не-Node.js окружениях
+
+По умолчанию сборка `vue-server-renderer` предполагает использование Node.js окружения, что делает её непригодной для использования в альтернативных JavaScript окружениях, таких как [PHP V8Js](https://github.com/phpv8/v8js) или [Oracle Nashorn](https://docs.oracle.com/javase/8/docs/technotes/guides/scripting/nashorn/). С версии 2.5+ мы предоставляем сборку в `vue-server-renderer/basic.js`, которая в значительной степени менее зависима от окружения, что делает её пригодной для использования в окружениях, упомянутых выше.
+
+Для обоих вариантов необходимо сначала подготовить окружение создав моки для объектов `global` и `process`, с переменной `process.env.VUE_ENV` установленной в значение `"server"`, и переменной `process.env.NODE_ENV` установленной в значение `"development"` или `"production"`.
+
+При использовании Nashorn также может потребоваться предоставить полифилл для `Promise` или `setTimeout` с использованием нативных таймеров Java.
+
+Пример использования в 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'
+  }
+})
+
+// предоставляется `vue-server-renderer/basic.js`
+renderVueComponentToString(vm, (err, res) => {
+  print(res)
+})
+```