ru/essentials proof-reading

vuejs · posva · Feb 8, 2017 · Nov 14, 2016 · Nov 14, 2016 · Nov 27, 2016
commit bb852f3fae367b4008a54cb3e4c560f61dc81ef1
diff --git a/docs/ru/essentials/dynamic-matching.md b/docs/ru/essentials/dynamic-matching.md
@@ -1,6 +1,6 @@
 # Динамические пути
 
-Очень часто требуется поставить компонент в соответствие со множеством путей по некоторому шаблону. Например, мы можем захотеть отображать один и тот же компонент `User` для всего множества пользователей в соответствии с их ID. Во `vue-router` для этой цели мы можем указать динамический сегмент пути:
+Очень часто требуется поставить компонент в соответствие со множеством путей по некоторому шаблону. Например, может потребоваться отображать один и тот же компонент `User` для всего множества пользователей в соответствии с их ID. Во `vue-router` для этой цели мы можем указать динамический сегмент пути:
 
 ``` js
 const User = {
@@ -55,7 +55,7 @@ const User = {
 
 ### Продвинутые возможности
 
-`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`.
+`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`.
 
 ### Приоритеты путей
 

diff --git a/docs/ru/essentials/getting-started.md b/docs/ru/essentials/getting-started.md
@@ -2,9 +2,9 @@
 
 > В примерах этого руководства мы будем использовать синтаксис [ES2015](https://github.com/lukehoban/es6features).
 
-Создать одностраничное приложение используя Vue.js и vue-router — проще простого. Используя Vue.js, мы уже собираем своё приложение из компонентов. Добавляя vue-router, мы просто сопоставляем компонентам пути, и указываем где именно их отображать. Вот простой пример:
+Создать одностраничное приложение используя Vue.js и vue-router — проще простого. Используя Vue.js, мы уже собираем своё приложение из компонентов. Добавляя vue-router, мы просто сопоставляем компонентам пути, и указываем, где именно их отображать. Вот простой пример:
 
-> Во всех примерах мы используем standalone-версию Vue, что позволяет использовать парсинг шаблонов. Более подробно о разнице версий можно почитать [здесь](http://vuejs.org/guide/installation.html#Standalone-vs-Runtime-only-Build).
+> Во всех примерах руководства применяется standalone-версия Vue, что позволяет использовать парсинг шаблонов. Более подробно о разнице версий можно почитать [здесь](http://vuejs.org/guide/installation.html#Standalone-vs-Runtime-only-Build).
 
 ### HTML
 
@@ -29,7 +29,8 @@
 ### JavaScript
 
 ``` js
-// 0. Если вы используете модульную системы (напр. через vue-cli), импортируйте Vue и VueRouter и вызовите Vue.use(VueRouter).
+// 0. Если вы используете модульную системы (напр. через vue-cli),
+// импортируйте Vue и VueRouter и вызовите Vue.use(VueRouter).
 
 // 1. Определите используемые компоненты.
 // Их можно импортировать из внешних файлов
@@ -52,14 +53,14 @@ const router = new VueRouter({
   routes // сокращение от routes: routes
 })
 
-// 4. Создайте и примонтируйте корневой инстанс приложения
+// 4. Создайте и примонтируйте корневой инстанс приложения.
 // Удостоверьтесь, что передали инстанс роутера в одноимённой опции,
-// что даст приложению знать о его присутствии
+// что позволит приложению знать о его наличии
 const app = new Vue({
   router
 }).$mount('#app')
 
-// Всё, приложение работает ;)
+// Всё, приложение работает! ;)
 ```
 
 Вживую этот пример доступен [здесь](http://jsfiddle.net/yyx990803/xgrjzsup/).

diff --git a/docs/ru/essentials/named-routes.md b/docs/ru/essentials/named-routes.md
@@ -1,6 +1,6 @@
 # Именованые пути
 
-Зачастую удобно ссылаться на путь по его имени при создании ссылок и вызове навигационных методов. Можно присвоить имя пути при его определении в `routes` при создании инстанса Router'а:
+Зачастую, при создании ссылок и вызове навигационных методов, удобно ссылаться на путь по его имени. Имя можно присвоить пути при его определении в `routes` при создании инстанса Router'а:
 
 ``` js
 const router = new VueRouter({

diff --git a/docs/ru/essentials/named-views.md b/docs/ru/essentials/named-views.md
@@ -1,14 +1,14 @@
 # Именованные представления
 
-Иногда необходимо отобразить сразу несколько компонентов, не вкладывая их один в другой — например, при создании разметки с сайдбаром и основным контентом. В этой ситуации может быть удобно использовать именованные представления. Вместо указания единственного `<router-view>`, можно использовать несколько, присвоив каждому имя. Безымянный `router-view` автоматически получает имя `default`.
+Иногда необходимо отобразить сразу несколько компонентов, не вкладывая их один в другой — например, при создании разметки с сайдбаром и основным контентом. В этой ситуации может быть удобно использовать именованные представления. Вместо указания единственного `<router-view>`, можно использовать несколько, присвоив каждому собственгое имя. Безымянный `router-view` автоматически получает имя `default`.
 
 ``` html
 <router-view class="view one"></router-view>
 <router-view class="view two" name="a"></router-view>
 <router-view class="view three" name="b"></router-view>
 ```
 
-При использовании нескольких представлений, вместо единственного компонента при описании пути необходимо указывать объект. Удостоверьтесь, что используете окончание множественного числа (s) в ключе `components`:
+При использовании нескольких представлений, вместо единственного компонента при описании пути необходимо указывать объект. Удостоверьтесь, что используете окончание множественного числа (`s`) в ключе `components`:
 
 ``` js
 const router = new VueRouter({

diff --git a/docs/ru/essentials/navigation.md b/docs/ru/essentials/navigation.md
@@ -1,16 +1,16 @@
 # Императивная навигация
 
-Помимо декларативного использования `<router-link>` для создания ссылок, мы можем использовать роутер и императивно, вызывая методы его инстанса.
+Помимо декларативного использования `<router-link>` для создания ссылок, можно использовать роутер и императивно, напрямую вызывая методы его инстанса.
 
 #### `router.push(location)`
 
-Для перехода к новому URL, используйте `router.push`. Этот метод добавляет новую запись в стек истории навигации, так что клик по кнопке "назад" сработает привычным образом.
+Для перехода к новому URL, используйте `router.push`. Этот метод добавляет новую запись в стек истории навигации, что позволяет клику пользователя по кнопке "назад" в браузере сработать привычным образом.
 
 При клике на `<router-link>` этот метод вызывается автоматически. Клик по `<router-link :to="...">` эквивалентен императивному вызову `router.push(...)`.
 
-| Декларативная запись | Императивная запись |
-|-------------|--------------|
-| `<router-link :to="...">` | `router.push(...)` |
+| Декларативная запись      | Императивная запись |
+|---------------------------|---------------------|
+| `<router-link :to="...">` | `router.push(...)`  |
 
 В качестве аргумента можно передать строку или объект, описывающий путь. Например:
 
@@ -21,7 +21,7 @@ router.push('home')
 // объект
 router.push({ path: 'home' })
 
-// именованый путь
+// именованный путь
 router.push({ name: 'user', params: { userId: 123 }})
 
 // со строкой запроса, получится /register?plan=private
@@ -32,14 +32,14 @@ router.push({ path: 'register', query: { plan: 'private' }})
 
 Действует подобно `router.push`, с той лишь разницей, что вместо добавления новой записи к стеку истории переходов, заменяет текущую запись в нём.
 
-| Декларативная запись | Императивная запись |
-|-------------|--------------|
+| Декларативная запись              |  Императивная запись  |
+|-----------------------------------|-----------------------|
 | `<router-link :to="..." replace>` | `router.replace(...)` |
 
 
 #### `router.go(n)`
 
-Единственным параметром этого метода является целое число, указывающее на сколько шагов необходимо перейти по стеку истории навигации (вперёд или назад, аналогично `window.history.go(n)`).
+Единственным параметром этого метода является целое число, указывающее на сколько шагов необходимо перейти по стеку истории навигации (вперёд или назад, аналогично `window.history.go(n)`.
 
 Примеры
 
@@ -53,15 +53,15 @@ router.go(-1)
 // перейти на 3 записи вперёд
 router.go(3)
 
-// если записей в истории недостаточно много, просто ничего не произойдёт
+// если записей в истории недостаточно много, перехода просто не произойдёт
 router.go(-100)
 router.go(100)
 ```
 
 #### Манипулирование историей переходов
 
-Вы могли заметить6 что `router.push`, `router.replace` и `router.go` соответствуют [`window.history.pushState`, `window.history.replaceState` и `window.history.go`](https://developer.mozilla.org/en-US/docs/Web/API/History), имитируя таким образом API `window.history`.
+Вы могли заметить, что `router.push`, `router.replace` и `router.go` соответствуют [`window.history.pushState`, `window.history.replaceState` и `window.history.go`](https://developer.mozilla.org/en-US/docs/Web/API/History), имитируя таким образом API `window.history`.
 
-По этой причине, если вы уже знакомы с [API истории переходов браузера](https://developer.mozilla.org/en-US/docs/Web/API/History_API), и со vue-router неожиданностей не возникнет.
+По этой причине, если вы уже знакомы с [API истории переходов браузера](https://developer.mozilla.org/en-US/docs/Web/API/History_API), то и со vue-router неожиданностей не возникнет.
 
 Стоит отметить, что методы навигации vue-router'а (`push`, `replace`, `go`) работают консистентно во всех режимах роутера (`history`, `hash` и `abstract`).
diff --git a/docs/ru/essentials/nested-routes.md b/docs/ru/essentials/nested-routes.md
@@ -1,6 +1,6 @@
 # Вложенные пути
 
-Пользовательский интерфейс реальных приложений обычно составлен многоуровневой иерархией компонентов. Столь же обычно и соответствие сегментов URL некоторой структуре вложенности компонентов, например:
+Пользовательский интерфейс реальных приложений обычно представлен многоуровневой иерархией компонентов. Столь же обычно и соответствие сегментов URL некоторой структуре вложенности компонентов, например:
 
 ```
 /user/foo/profile                     /user/foo/posts
@@ -35,7 +35,7 @@ const router = new VueRouter({
 })
 ```
 
-Здесь `<router-view>` — это точка, в которой будет отображён компонент, соответствующий пути верхнего уровня. Аналогично, отображённый там компонент может и сам содержать вложенный `<router-view>`. Изменим немного шаблон компонента `User`:
+Здесь `<router-view>` — это точка, в которой будет отображён компонент, соответствующий пути верхнего уровня. Аналогичным образом, отображаемый там компонент может и сам содержать вложенный `<router-view>`. Изменим немного шаблон компонента `User`:
 
 ``` js
 const User = {
@@ -48,8 +48,7 @@ const User = {
 }
 ```
 
-Для отображения компонентов в этой вложенной точке, нам понадобится опция `children`
-в конфигурации конструктора `VueRouter`:
+Для отображения компонентов в этой вложенной точке, нам понадобится опция `children` в конфигурации конструктора `VueRouter`:
 
 ``` js
 const router = new VueRouter({
@@ -76,7 +75,7 @@ const router = new VueRouter({
 
 **Обратите внимание, что вложенные пути, начинающиеся с `/`, будут считаться корневыми. Это позволяет задействовать вложенную структуру компонентов независимо от структуры URL.**
 
-Как вы могли заметить, опция `children` — это просто массив объектов конфигурации путей, такой же как и сам `routes`. Так что вложенность по глубине не ограничена.
+Как вы могли заметить, опция `children` принимает обыкновенный массив объектов конфигурации путей, такой же как и сам `routes`. Таким образом, вложенность путей в теории по глубине ничем не ограничена.
 
 С текущим кодом, если перейти по пути `/user/foo`, внутри компонента `User` ничего отображено не будет, так как не произойдёт совпадения по второй части пути. Может быть, что-то в таких случаях отобразить всё же захочется — тогда стоит указать пустой путь: