[JUST MERGE ME] Russian Translation Update (#1364)

gbezyuk · posva · commit 00f4f43b15a1 · 2017-04-24T11:08:25.000+02:00
* add entry for Russian docs

* copy en docs for ru translation

* translation for ru/installation.md

* ru/README.md translation

* ru/SUMMARY.md translation (same as README.md)

* ru/essentials/getting-started.md ru translation

* ru/essentials/dynamic-matching.md ru translation

* ru/essentials/nested-routes.md ru translation

* ru/essentials/navigation.md ru translation

* ru/essentials/named-routes.md ru translation

* ru/essentials/named-views.md ru translation

* ru/essentials/redirect-and-alias.md ru translation

* ru/essentials/history-mode.md ru translation

* ru/advanced/navigation-guards.md translation

* ru/advanced/meta.md translation

* ru/advanced/transitions.md translation

* ru/advanced/data-fetching.md translation

* ru/advanced/scroll-behavior.md translation

* ru/advanced/lazy-loading.md translation

* README.md and SUMMARY.md translation updates

* ru/api/component-injections.md translation

* ru/api/options.md translation

* ru/api/route-object.md translation

* ru/api/router-instance.md translation

* ru/api/router-view.md translation

* ru/api/router-link.md translation

* Update scroll-behavior.md

* ru/essentials proof-reading

* ru/advanced proof-reading

* ru/api proof-reading

* updated to match 2.1.1

* Typofix

* Fix typo

* Правки по сторожевых хуков

* Правки по странице Route-object

* Исправление свойства на странице router-link

* Исправление ссылки на странице getting-started

* Исправления в оглавлении

* Исправления по странице установки

* Правки на странице введения

* Добавлен пункт для страницы введения (чтобы локализовался в боковой панели)

* Добавилась пустая строка в конце файла

* Капитализация Vue-router

* Исправлена капитализация CSS

* Исправлена ошибка на странице router-link

* Изменены врапперы на обертки на странице router-view

* Правка на странице component-injections

* Изменения по странице dynamic-matching

* Изменение капитализации Vue-router

* Исправлена ошибка в заголовке на странице named-routes

* Изменен сайдбар на боковую панель на странице named-views.md

* Изменения по странице navigation.md

* Изменена капитализация Vue-router

* Исправлена капитализация Vue-router и ошибка на странице navigation-guards

* Мелкие правки по странице scroll-behaviour

* Исправления на странице navigation-guards

* Исправления на странице navigation-guards

* - router-link.md добавлено уточнение

* - navigation.md перевод новой секции для 2.2.0

* -navigation-guards переведен новый коллбек

* - options.md добавлена опция props

* - router-instance добавлено новое в 2.2.0

* - passing-props.md переведена новая страница

* - Правка

* - route-object.md исправление упоминания хэша

* passing-props.md расширен пример

* component-injections.md добавлена опция

* navigation.md добавлено примечание

* options.md добавления для 2.4.0

* router-instance.md добавления для 2.4.0

* navigation-guards.md добавления для 2.4.0

* lazy-loading.md изменена ссылка

* transitions.md изменена ссылка

* getting-started.md изменена ссылка

* redirect-and-alias.md удалены пробелы

* data-fetching.md обновления к 2.5.0

* dynamic-matching.md добавлен пример с beforeRouteUpdate

* router-instance.md добавлен метод router.beforeResolve(guard)

* navigation-guards.md доработки к 2.5.0

* component-injections.md исправлен якорь в ссылке

* Update navigation-guards.md

* Update navigation-guards.md
diff --git a/docs/ru/advanced/data-fetching.md b/docs/ru/advanced/data-fetching.md
@@ -42,7 +42,7 @@ export default {
       error: null
     }
   },
-  created () {    
+  created () {
     // запрашиваем данные когда реактивное представление уже создано
     this.fetchData()
   },
@@ -82,31 +82,28 @@ export default {
   },
   beforeRouteEnter (to, from, next) {
     getPost(to.params.id, (err, post) => {
-      if (err) {
-        // здесь стоит отобразить некоторое глобальное сообщение ошибке
-        next(false)
-      } else {
-        next(vm => {
-          vm.post = post
-        })
-      }
+      next(vm => vm.setData(err, post))
     })
   },
   // если путь изменяется, а компонент уже отображён,
   // логика будет немного иной
-  watch: {
-    $route () {
-      this.post = null
-      getPost(this.$route.params.id, (err, post) => {
-        if (err) {
-          this.error = err.toString()
-        } else {
-          this.post = post
-        }
-      })
+  beforeRouteUpdate (to, from, next) {
+    this.post = null
+    getPost(to.params.id, (err, post) => {
+      this.setData(err, post)
+      next()
+    })
+  },
+  methods: {
+    setData (err, post) {
+      if (err) {
+        this.error = err.toString()
+      } else {
+        this.post = post
+      }
     }
   }
 }
 ```
 
-Пользователь останется на старой странице, пока не загрузятся данные новой. По этой причине мы советуем отображать какой-нибудь индикатор загрузки. Кроме того, если загрузка данных не удастся, следует отобразить глобальное сообщение об ошибке.
+Пользователь останется на предыдущей странице, пока не загрузятся данные новой. По этой причине мы советуем отображать какой-нибудь индикатор загрузки. Кроме того, если загрузка данных не удастся, следует отобразить глобальное сообщение об ошибке.
diff --git a/docs/ru/advanced/navigation-guards.md b/docs/ru/advanced/navigation-guards.md
@@ -2,7 +2,7 @@
 
 Как следует из названия, сторожевые хуки `Vue-router` используются для редиректов или отмены навигационных переходов. Есть несколько способов внедрить сторожевой хук: глобально, для конкретного пути, или для конкретного компонента.
 
-Запомните **изменение параметров не вызывает сторожевые хуки**. Просто добавьте [watch на объект `$route`](../essentials/dynamic-matching.md#reacting-to-params-changes) для отслеживания этих изменений.
+Следует помнить, что **изменение параметров маршрута не вызывает выполнения сторожевых хуков enter/leave**. Вы можете добавить [watch на объект `$route`](../essentials/dynamic-matching.md#отслеживание-изменений-параметров) для отслеживания этих изменений, или использовать хук `beforeRouteUpadte`.
 
 ### Глобальные хуки
 
@@ -36,6 +36,14 @@ router.beforeEach((to, from, next) => {
 
 **Удостоверьтесь, что функция `next` так или иначе будет вызвана, иначе хук никогда не будет разрешён.**
 
+### Глобальные хуки разрешения перехода
+
+> Добавлено в версии 2.5.0
+
+В 2.5.0+ вы можете зарегистрировать глобальный хук с помощью `router.beforeResolve`. Это похоже на `router.beforeEach`, с той разницей, что разрешающий хук будет вызван непосредственно перед подтверждением навигации, **после того, как будут разрешены все хуки компонента и асинхронные компоненты для маршрута**.
+
+### Глобальные хуки завершения перехода
+
 Можно также зарегистрировать глобальные хуки, вызываемые после завершения перехода. Однако, в отличие от сторожевых хуков, в них не передаётся функция `next`, и на ход перехода они повлиять не могут:
 
 ``` js
@@ -108,3 +116,18 @@ beforeRouteEnter (to, from, next) {
 ```
 
 Внутри `beforeRouteLeave` можно обращаться к `this` напрямую. Этот сторожевой хук обычно используется для предотвращения случайного ухода пользователя с пути, содержащего несохранённые отредактированные данные. Переход можно отменить, вызвав `next(false)`.
+
+### Полная цепочка обработки навигации
+
+1. Срабатывание навигации
+2. Вызов leave-хуков в деактивируемых компонентах
+3. Вызов глобальных `beforeEach` хуков
+4. Вызов `beforeRouteUpdate` хука в переиспользуемых компонентах (2.2+)
+5. Вызов `beforeEnter` в конфигурации маршрута
+6. Разрешение асинхронных компонентов для маршрута
+7. Вызов `beforeRouteEnter` в активируемых компонентах
+8. Вызов глобальных `beforeResolve` хуков (2.5+)
+9. Навигация подтверждена
+10. Вызов глобальных `afterEach` хуков.
+11. Выполняется обновление DOM.
+12. Вызов коллбэков, переданных в `next` в `beforeRouteEnter` хуке с созданными экземплярами.
diff --git a/docs/ru/api/component-injections.md b/docs/ru/api/component-injections.md
@@ -18,4 +18,4 @@
 - **beforeRouteUpdate** (добавлено в версии 2.2)
 - **beforeRouteLeave**
 
-  См. [раздел документации о сторожевых хуках](../advanced/navigation-guards.md#incomponent-guards).
+  См. [раздел документации о сторожевых хуках](../advanced/navigation-guards.md#указание-хука-для-конкретного-компонента).
diff --git a/docs/ru/api/router-instance.md b/docs/ru/api/router-instance.md
@@ -23,6 +23,7 @@
 ### Методы
 
 - **router.beforeEach(guard)**
+- **router.beforeResolve(guard)** (добавлено в версии 2.5.0+)
 - **router.afterEach(hook)**
 
   См. [сторожевые хуки](../advanced/navigation-guards.md).
diff --git a/docs/ru/essentials/dynamic-matching.md b/docs/ru/essentials/dynamic-matching.md
@@ -53,6 +53,18 @@ const User = {
 }
 ```
 
+Или можно воспользоваться хуком `beforeRouteUpdate`, добавленным в версии 2.2:
+
+``` js
+const User = {
+  template: '...',
+  beforeRouteUpdate (to, from, next) {
+    // обработка изменений параметров пути...
+    // не забудьте вызывать next()
+  }
+}
+```
+
 ### Продвинутые возможности
 
 `Vue-router` использует [path-to-regexp](https://github.com/pillarjs/path-to-regexp) в качестве движка для проверки совпадения путей, что позволяет задействовать многие продвинутые возможности, включая опциональные динамические сегменты и регулярные выражения. [Документация библиотеки](https://github.com/pillarjs/path-to-regexp#parameters) содержит информацию об этих возможностях роутинга, а [этот пример](https://github.com/vuejs/vue-router/blob/dev/examples/route-matching/app.js) — о том, как использовать их совместно с `Vue-router`.
