[RU] Translation update

docs/ru/SUMMARY.md

@@ -26,6 +26,8 @@
   - [cssSourceMap](options.md#csssourcemap)
   - [esModule](options.md#esmodule)
   - [preserveWhitespace](options.md#preservewhitespace)
+  - [compilerModules](options.md#compilermodules)
+  - [compilerDirectives](options.md#compilerdirectives)
   - [transformToRequire](options.md#transformtorequire)
   - [buble](options.md#buble)
   - [extractCSS](options.md#extractcss)

docs/ru/configurations/pre-processors.md

@@ -69,7 +69,7 @@ scss: generateLoaders('sass').concat(
 ),
 ```
 
-В этот файл рекомендуется включать только переменные, примеси и т.п., чтобы предотвратить дублирование CSS в финальных скомпилированных файлах. 
+В этот файл рекомендуется включать только переменные, примеси и т.п., чтобы предотвратить дублирование CSS в финальных скомпилированных файлах.
 
 ### JavaScript
 

docs/ru/features/hot-reload.md

@@ -4,4 +4,18 @@
 
 ![hot-reload](http://blog.evanyou.me/images/vue-hot.gif)
 
+## Правила сохранения текущего состояния компонента
+
+- При редактировании `<template>` компонента, экземпляры изменённого компонента будут повторно отрендерены, сохраняя всё текущее собственное состояние. Это возможно, потому что шаблоны компилируются в новые render-функции, которые не создают побочных эффектов.
+
+- При редактировании `<script>` компонента, экземпляры редактируемого компонента будут уничтожены и созданы заново (состояние других компонентов в приложении сохраняется). Это связано с тем, что `<script>` может включать в себя хуки жизненного цикла, которые могут создавать побочные эффекты, поэтому для обеспечения согласованности поведения требуется "перезагрузка", а не просто повторный рендеринг. Это также означает, что вам нужно быть осторожным в отношении глобальных побочных эффектов, таких как использование таймеров внутри хуков жизненного цикла компонентов. Иногда вам может потребоваться полная перезагрузка страницы, если ваш компонент создаёт глобальные побочные эффекты.
+
+- Горячая перезагрузка `<style>` работает самостоятельно через `vue-style-loader`, поэтому никак не затрагивает состояние приложения.
+
+## Использование
+
 При создании проекта с помощью `vue-cli`, горячая замена включена по умолчанию.
+
+При настройке проекта вручную горячая перезагрузка включится автоматически, когда вы запускаете ваш проект с помощью `webpack-dev-server --hot`.
+
+Продвинутые пользователи могут изучить [vue-hot-reload-api](https://github.com/vuejs/vue-hot-reload-api), который используется внутри `vue-loader`.

docs/ru/features/scoped-css.md

@@ -28,40 +28,50 @@
 </template>
 ```
 
-#### Примечания
+#### Советы
 
-1. Вы можете использовать в компоненте локальные и глобальные стили одновременно:
+### Использование локальных и глобальных стилей
 
-  ``` html
-  <style>
-  /* глобальные стили */
-  </style>
+Вы можете сочетать использование в компоненте локальных и глобальных стили одновременно:
 
-  <style scoped>
-  /* локальные стили */
-  </style>
-  ```
+``` html
+<style>
+/* глобальные стили */
+</style>
+
+<style scoped>
+/* локальные стили */
+</style>
+```
+
+### Корневой узел дочернего компонента
+
+С помощью `scoped`, стили родительского компонента не будут влиять на содержимое дочерних компонентов. Тем не менее, корневой узел дочернего компонента будет зависеть как от scoped CSS из родительского элемента, так и от scoped CSS дочернего. Это предусмотрено специально, чтобы родительский элемент мог стилизовать корневой элемент дочернего компонента например для целей макета.
+
+### Глубокие селекторы
+
+Если вы хотите, чтобы селектор в `scoped` стилях был "глубоким", т.е. влиял на дочерние компоненты, вы можете использовать комбинатор `>>>`:
+
+``` html
+<style scoped>
+.a >>> .b { /* ... */ }
+</style>
+```
+
+Указанное выше будет скомпилировано в:
+
+``` css
+.a[data-v-f3f3eg9] .b { /* ... */ }
+```
 
-2. Корневой тег компонента потомка будет попадать под область видимости родительского локального CSS и своего локального CSS.
+Некоторые пре-процессоры, такие как SASS, не могут правильно обработать `>>>`. В таких случаях вы можете использовать комбинатор `/deep/` — это псевдоним для `>>>` работающий точно также.
 
-3. Partials не затрагиваются локальными стилями.
+### Динамически генерируемый контент
 
-4. **Локальные стили не устраняют необходимость классов**. Из-за того как браузеры рендерят различные CSS-селекторы, `p { color: red }` может быть в разы медленнее при использовании в локальных стилях (например, когда комбинируется с селектором по атрибуту). Если же вы используете классы или ID, такие как `.example { color: red }`, тогда вы практически полностью исключаете ухудшение производительности. [Вот пример](http://stevesouders.com/efws/css-selectors/csscreate.php) где вы можете проверить разницу самостоятельно.
+DOM-содержимое, создаваемое с помощью `v-html` не попадает под область действия scoped-стилей, но вы всё равно можете его стилизовать воспользовавшись deep-селекторами.
 
-5. **Будьте внимательны с селекторами потомков в рекурсивных компонентах!** Для CSS-правила с селектором `.a .b`, если элемент, который соответствует `.a` содержит рекурсивный компонент потомок, тогда все `.b` в этом компоненте потомке будут также соответствовать правилу.
+### О чём следует помнить
 
-6. Если вам нужны вложенные селекторы в `scoped` стилях, вам нужно будет использовать оператор `>>>` для CSS и `/deep/` для `scss`:
+- **Локальные стили не устраняют необходимость классов**. Из-за того как браузеры рендерят различные CSS-селекторы, `p { color: red }` может быть в разы медленнее при использовании в локальных стилях (например, когда комбинируется с селектором по атрибуту). Если же вы используете классы или ID, такие как `.example { color: red }`, тогда вы практически полностью исключаете ухудшение производительности. [Вот пример](http://stevesouders.com/efws/css-selectors/csscreate.php) где вы можете проверить разницу самостоятельно.
 
-  ``` html
-  <style scoped>
-  .a >>> .b {
-
-  }
-  </style>
-
-  <style lang="scss" scoped>
-  .a /deep/ .b {
-
-  }
-  </style>
-  ```
+- **Будьте внимательны с селекторами потомков в рекурсивных компонентах!** Для CSS-правила с селектором `.a .b`, если элемент, который соответствует `.a` содержит рекурсивный компонент потомок, тогда все `.b` в этом компоненте потомке будут также соответствовать правилу.

docs/ru/options.md

@@ -137,6 +137,22 @@ module.exports = {
 
   При установке в `false` пробельные символы между HTML тегами в шаблонах будут проигнорированы.
 
+### compilerModules
+
+- Тип: `Array<ModuleOptions>`
+- По умолчанию: `[]`
+
+  Настройка опции `modules` для `vue-template-compiler`. См. подробнее в документации `vue-template-compiler` [опция `modules`](https://github.com/vuejs/vue/blob/dev/packages/vue-template-compiler/README.md#compilercompiletemplate-options).
+
+### compilerDirectives
+
+- Тип: `{ [tag: string]: Function }`
+- По умолчанию: `{}` (v13.0.5+)
+
+  > Примечание: в версиях v12.x поддержка добавлена с v12.2.3+
+
+  Настройка опции `directives` для `vue-template-compiler`. См. подробнее в документации `vue-template-compiler` [опция `directives`](https://github.com/vuejs/vue/blob/dev/packages/vue-template-compiler/README.md#compilercompiletemplate-options).
+
 ### transformToRequire
 
 - Тип: `{ [tag: string]: string | Array<string> }`