Skip to content

Commit ba8feba

Browse files
Alex-Sokolovktsn
authored andcommitted
[RU] Updates (#859)
* russian docs translation started * docs/ru/actions.md translated * docs/ru/api.md translated * docs/ru/forms.md translated * api translation fix * docs/ru/getters.md translated * docs/ru/getting-started.md translated * docs/ru/hot-reload.md translated * docs/ru/installation.md translated * docs/ru/intro.md translated * docs/ru/modules.md translated * docs/ru/README.md translated * docs/ru/strict.md translated * docs/ru/structure.md translated * docs/ru/SUMMARY.md translated (O_O for some reason it happens to be exactly the same as README.md) * docs/ru/mutations.md translated * docs/ru/plugins.md translated * docs/ru/state.md translated * docs/ru/testing.md translated * docs/ru/actions.md styling/proof-reading * docs/ru/api.md styling/proof-reading * docs/ru/forms.md styling/proof-reading * docs/ru/getters.md styling/proof-reading * docs/ru/getting-started.md styling/proof-reading * docs/ru/hot-reload.md styling/proof-reading * docs/ru/installation.md styling/proof-reading * docs/ru/intro.md styling/proof-reading * docs/ru/modules.md styling/proof-reading * docs/ru/mutations.md styling/proof-reading * docs/ru/plugins.md styling/proof-reading * docs/ru/state.md styling/proof-reading * docs/ru/strict.md styling/proof-reading * docs/ru/structure.md styling/proof-reading * docs/ru/testing.md styling/proof-reading * docs/ru/intro.md typo fix * Copyediting RU documentation * Fix typo * Change wording around alternative approaches to data handling * Fix typo * Fix typo * Better wording for linters * Fix header and change wording * fix typo * typos reported by @ipelekhan are fixed * Russian docs translation update * Fix typo * Sentence rephrasing and fix punctuation * Переключил на ветку translation-ru * - Исправлен пример * - getting-started.md исправлена ссылка на jsfiddle * - getters.md добавлена секция про возможность передачи функции в геттерах * - installation.md добавлен флаг --save * - modules.md мелкая правка в примере * Update modules.md * modules.md ещё мелкая правка в примере * modules.md добавлен пример регистрации модуля #634 * actions.md расширен пример * getters.md исправление * strict.md обновление и добавлено уточнение о затратности * testing.md исправлен пример конфига webpack * api.md изменены ссылки * intro.md изменена ссылка * state.md изменена ссылка * api.md добавлены уточнения при определении в модуле * mutations.md добавлено уточнение примера * modules.md обновление 2.3.0 * api.md исправлена ошибка * plugins.md добавлено уточнение в пример * modules.md исправлена опечатка * api.md добавлены описания options для dispatch/commit * state.md исправлен комментарий про standalone * Перефразировано * getters.md добавлены бэктики в пример * actions.md правки * modules.md правки * mutations.md * plugins.md правки * modules.md добавлена ссылка на SSR * getters.md добавлено уточнение * testing.md добавлены -loader * actions.md инстанс -> экземпляр * api.md инстанс -> экземпляр * state.md инстанс -> экземпляр
1 parent 0cee68b commit ba8feba

File tree

8 files changed

+32
-30
lines changed

8 files changed

+32
-30
lines changed

docs/ru/actions.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ const store = new Vuex.Store({
2525
})
2626
```
2727

28-
Обработчики действий получают объект контекста, содержащий те же методы и свойства, что и сам инстанс хранилища, так что вы можете вызвать `context.commit` для инициирования мутации или обратиться к состоянию и геттерам через `context.state` и `context.getters`. Позднее при рассмотрении [Модулей](modules.md) мы увидим, однако, что этот контекст — не то же самое, что инстанс хранилища.
28+
Обработчики действий получают объект контекста, содержащий те же методы и свойства, что и сам экземпляр хранилища, так что вы можете вызвать `context.commit` для инициирования мутации или обратиться к состоянию и геттерам через `context.state` и `context.getters`. Позднее при рассмотрении [Модулей](modules.md) мы увидим, однако, что этот контекст — не то же самое, что экземпляр хранилища.
2929

3030
На практике для упрощения кода часто используется [деструктуризация аргументов](https://github.com/lukehoban/es6features#destructuring) из ES2015 (особенно при необходимости многократного вызова `commit`):
3131

@@ -107,13 +107,13 @@ export default {
107107
// ...
108108
methods: {
109109
...mapActions([
110-
'increment' // проксирует this.increment() в this.$store.dispatch('increment')
110+
'increment' // проксирует `this.increment()` в `this.$store.dispatch('increment')`
111111

112-
// mapActions также поддерживают нагрузку (payloads):
113-
'incrementBy' // проксирует this.incrementBy(amount) в this.$store.dispatch('incrementBy', amount)
112+
// `mapActions` также поддерживают нагрузку (payloads):
113+
'incrementBy' // проксирует `this.incrementBy(amount)` в `this.$store.dispatch('incrementBy', amount)`
114114
]),
115115
...mapActions({
116-
add: 'increment' // проксирует this.add() в this.$store.dispatch('increment')
116+
add: 'increment' // проксирует `this.add()` в `this.$store.dispatch('increment')`
117117
})
118118
}
119119
}
@@ -162,14 +162,14 @@ actions: {
162162
И, в конце концов, используя [async / await](https://tc39.github.io/ecmascript-asyncawait/) — возможности, которые вот-вот станут общедоступны - можно компоновать действия таким образом:
163163

164164
``` js
165-
// предположим, что getData() и getOtherData() возвращают промисы
165+
// предположим, что `getData()` и `getOtherData()` возвращают промисы
166166

167167
actions: {
168168
async actionA ({ commit }) {
169169
commit('gotData', await getData())
170170
},
171171
async actionB ({ dispatch, commit }) {
172-
await dispatch('actionA') // дожидаемся завершения действия actionA
172+
await dispatch('actionA') // дожидаемся завершения действия `actionA`
173173
commit('gotOtherData', await getOtherData())
174174
}
175175
}

docs/ru/api.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ const store = new Vuex.Store({ ...options })
5656
```
5757

5858
При определении в модуле
59-
59+
6060
```
6161
state, // при использовании модулей — локальный state модуля
6262
getters, // локальные геттеры текущего модуля
@@ -109,7 +109,7 @@ const store = new Vuex.Store({ ...options })
109109

110110
[Подробнее](strict.md)
111111

112-
### Свойства инстанса Vuex.Store
112+
### Свойства экземпляра Vuex.Store
113113

114114
- **state**
115115

@@ -123,7 +123,7 @@ const store = new Vuex.Store({ ...options })
123123

124124
Зарегистрированные геттеры. Только для чтения.
125125

126-
### Методы инстанса Vuex.Store
126+
### Методы экземпляра Vuex.Store
127127

128128
- **`commit(type: string, payload?: any, options?: Object) | commit(mutation: Object, options?: Object)`**
129129

docs/ru/getters.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,9 @@ computed: {
1212

1313
Если этот функционал требуется более чем одному компоненту, понадобится либо дублировать функцию, либо выносить её в совместно используемый хелпер и импортировать в нескольких местах. Оба эти подхода далеки от идеала.
1414

15-
Vuex позволяет определять в хранилище "геттеры" (их можно считать вычисляемыми свойствами хранилища). Геттеры получают первым аргументом ссылку на состояние хранилища:
15+
Vuex позволяет определять в хранилище «геттеры». Вы можете считать их вычисляемыми свойствами для хранилища. Как и вычисляемые свойства, результаты геттера кэшируются, основываясь на своих зависимостях и будут пересчитаны только тогда, когда изменится одна из его зависимостей.
16+
17+
Геттеры получают первым аргументом ссылку на состояние хранилища:
1618

1719
``` js
1820
const store = new Vuex.Store({
@@ -100,7 +102,7 @@ export default {
100102

101103
``` js
102104
...mapGetters({
103-
// проксируем this.doneCount в store.getters.doneTodosCount
105+
// проксируем `this.doneCount` в `store.getters.doneTodosCount`
104106
doneCount: 'doneTodosCount'
105107
})
106108
```

docs/ru/modules.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -25,8 +25,8 @@ const store = new Vuex.Store({
2525
}
2626
})
2727

28-
store.state.a // -> состояние модуля moduleA
29-
store.state.b // -> состояние модуля moduleB
28+
store.state.a // -> состояние модуля `moduleA`
29+
store.state.b // -> состояние модуля `moduleB`
3030
```
3131

3232
### Локальное состояние модулей
@@ -38,7 +38,7 @@ const moduleA = {
3838
state: { count: 0 },
3939
mutations: {
4040
increment (state) {
41-
// state указывает на локальное состояние модуля
41+
// `state` указывает на локальное состояние модуля
4242
state.count++
4343
}
4444
},
@@ -248,7 +248,7 @@ store.registerModule(['nested', 'myModule'], {
248248

249249
Иногда нам может потребоваться создать несколько экземпляров модуля, например:
250250

251-
- Создание нескольких хранилищ, которые используются одним модулем;
251+
- Создание нескольких хранилищ, которые используются одним модулем (например, чтобы [избегать синглетонов в сохранением состояния в SSR](https://ssr.vuejs.org/ru/structure.html#избегайте-синглетонов-с-состоянием) при использовании опции `runInNewContext` в значении `false` или `'once'`);
252252
- Регистрация модуля несколько раз в одном хранилище.
253253

254254
Если мы используем просто объект для определения состояния модуля, тогда этот объект состояния будет использоваться по ссылке и вызывать загрязнение состояния хранилища / модуля при его мутациях.
@@ -264,4 +264,4 @@ const MyReusableModule = {
264264
},
265265
// мутации, действия, геттеры...
266266
}
267-
```
267+
```

docs/ru/mutations.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ const store = new Vuex.Store({
1616
})
1717
```
1818

19-
Вызывать функцию-обработчик напрямую — нельзя. Это больше похоже на обработку события: "Когда мутация типа `increment` инициирована, вызывается этот обработчик". Чтобы инициировать обработку мутации, необходимо вызвать **store.commit**, указав её тип:
19+
Вызывать функцию-обработчик напрямую — нельзя. Это больше похоже на обработку события: "Когда мутация типа `increment` инициирована, вызывается этот обработчик". Чтобы инициировать обработку мутации, необходимо вызвать `store.commit`, указав её тип:
2020

2121
``` js
2222
store.commit('increment')
@@ -146,13 +146,13 @@ export default {
146146
// ...
147147
methods: {
148148
...mapMutations([
149-
'increment', // this.increment() будет вызывать this.$store.commit('increment')
149+
'increment', // `this.increment()` будет вызывать `this.$store.commit('increment')`
150150
151151
// mapMutations также поддерживает нагрузку:
152-
'incrementBy' // this.incrementBy(amount) будет вызывать this.$store.commit('incrementBy', amount)
152+
'incrementBy' // `this.incrementBy(amount)` будет вызывать `this.$store.commit('incrementBy', amount)`
153153
]),
154154
...mapMutations({
155-
add: 'increment' // this.add() будет вызывать this.$store.commit('increment')
155+
add: 'increment' // `this.add()` будет вызывать `this.$store.commit('increment')`
156156
})
157157
}
158158
}

docs/ru/plugins.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ const myPlugin = store => {
77
// вызывается после инициализации хранилища
88
store.subscribe((mutation, state) => {
99
// вызывается после каждой мутации
10-
// мутация передаётся в формате { type, payload }.
10+
// мутация передаётся в формате `{ type, payload }`.
1111
})
1212
}
1313
```
@@ -62,7 +62,7 @@ const myPluginWithSnapshot = store => {
6262
store.subscribe((mutation, state) => {
6363
let nextState = _.cloneDeep(state)
6464

65-
// сравнение prevState и nextState...
65+
// сравнение `prevState` и `nextState`...
6666

6767
// сохранение состояния для следующей мутации
6868
prevState = nextState
@@ -103,8 +103,8 @@ const store = new Vuex.Store({
103103
const logger = createLogger({
104104
collapsed: false, // автоматически раскрывать залогированные мутации
105105
filter (mutation, stateBefore, stateAfter) {
106-
// возвращает true если мутация должна быть залогирована
107-
// `mutation` это объект { type, payload }
106+
// возвращает `true` если мутация должна быть залогирована
107+
// `mutation` это объект `{ type, payload }`
108108
return mutation.type !== "aBlacklistedMutation"
109109
},
110110
transformer (state) {
@@ -113,7 +113,7 @@ const logger = createLogger({
113113
return state.subTree
114114
},
115115
mutationTransformer (mutation) {
116-
// мутации логируются в формате { type, payload },
116+
// мутации логируются в формате `{ type, payload }`,
117117
// но это можно изменить
118118
return mutation.type
119119
}

docs/ru/state.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ const app = new Vue({
4343
})
4444
```
4545

46-
Указывая опцию `store` для корневого инстанса, мы обеспечиваем доступ к хранилищу всем дочерним компонентам в `this.$store`. Давайте обновим наш пример со счётчиком:
46+
Указывая опцию `store` для корневого экземпляра, мы обеспечиваем доступ к хранилищу всем дочерним компонентам в `this.$store`. Давайте обновим наш пример со счётчиком:
4747

4848
``` js
4949
const Counter = {
@@ -61,7 +61,7 @@ const Counter = {
6161
Если компонент использует множество свойств или геттеров хранилища, объявление доступа к ним всем вручную может заставить изрядно заскучать, да и код получится многословный. Чтобы обойти эту проблему, можно использовать хелпер `mapState`, автоматически генерирующий вычисляемые свойства, проксирующие доступ к состоянию и геттерам хранилища:
6262

6363
``` js
64-
// при использовании модульных систем, необходимо импортировать Vuex.mapState
64+
// с полной сборкой можно использовать как Vuex.mapState
6565
import { mapState } from 'vuex'
6666

6767
export default {

docs/ru/testing.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -72,7 +72,7 @@ export const getAllProducts = ({ commit }) => {
7272
// и inject-loader, возвращающий фабрику модулей, помогающую
7373
// подменять зависимости
7474
import { expect } from 'chai'
75-
const actionsInjector = require('inject!./actions')
75+
const actionsInjector = require('inject-loader!./actions')
7676

7777
// создаём поддельную зависимость
7878
const actions = actionsInjector({
@@ -213,7 +213,7 @@ mocha test-bundle.js
213213
#### Запуск в браузерах
214214

215215
1. Установите `mocha-loader`
216-
2. Измените `entry` в приведённой выше конфигурации webpack на `'mocha!babel!./test.js'`.
216+
2. Измените `entry` в приведённой выше конфигурации Webpack на `'mocha-loader!babel-loader!./test.js'`.
217217
3. Запустите `webpack-dev-server`, используя эту конфигурацию
218218
4. Откройте в браузере `localhost:8080/webpack-dev-server/test-bundle`.
219219

0 commit comments

Comments
 (0)