Skip to content

Commit d328131

Browse files
Alex-Sokolovkazupon
authored andcommitted
[RU] Translation update (#1145)
* Russian translation update * options.md допереведено предложение * SUMMARY.md добавлен перечень настроек * options.md добавлена новая опция * testing-with-mocks.md добавлены -loader * testing.md исправлен пример * scoped-css.md добавлен раздел про вложенные селекторы * pre-processors.md добавлена новая секция * options.md нумерация версий * advanced.md нумерация версий * options.md уточнение * options.md уточнение * Fix merge * SUMMARY.md добавлены новые пункты * scoped-css.md новые правки * options.md новые свойства * hot-reload.md обновления * scoped-css.md правка * HTTP -> HTTPS * testing-with-mocks.md правка примера * SUMMARY.md добавлены новые пункты * functional-template.md добавлен новый файл * options.md новые разделы * functional-template.md переведён * functional.md правки * postcss.md исправлен пример * options.md новая секция * hot-reload.md новая секция * testing-with-mocks.md новые правки * postcss.md правки * options.md новые правки * options.md правки * asset-url.md добавлены разъяснения * Update SUMMARY.md * asset-url.md опечатка * advanced.md удалена настройка для вебпака 1 * options.md удалено о первом вебпаке * custom-block.md удалено о первом вебпаке * extract-css.md удалено о первом вебпаке * css-modules.md удалено о первом вебпаке * postcss.md удалено о первом вебпаке * setup.md обновление для @vue/cli * linting.md обновление для eslint-plugin-vue * production.md удалено о первом вебпаке * testing.md обновлено о @vue/test-utils
1 parent f408d01 commit d328131

File tree

12 files changed

+45
-302
lines changed

12 files changed

+45
-302
lines changed

docs/ru/SUMMARY.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,4 +33,4 @@
3333
- [transformToRequire](options.md#transformtorequire)
3434
- [buble](options.md#buble)
3535
- [extractCSS](options.md#extractcss)
36-
- [optimizeSSR](options.md#optimizessr)
36+
- [optimizeSSR](options.md#optimizessr)

docs/ru/configurations/advanced.md

Lines changed: 0 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,6 @@
1212

1313
> Опции `preLoaders` и `postLoaders` доступны только в версиях 10.3.0+
1414
15-
### webpack 2.x
16-
1715
``` js
1816
module.exports = {
1917
// другие настройки...
@@ -59,27 +57,4 @@ module.exports = {
5957
}
6058
```
6159

62-
### webpack 1.x
63-
64-
``` js
65-
// webpack.config.js
66-
module.exports = {
67-
// другие настройки...
68-
module: {
69-
loaders: [
70-
{
71-
test: /\.vue$/,
72-
loader: 'vue'
73-
}
74-
]
75-
},
76-
// настройки vue-loader
77-
vue: {
78-
loaders: {
79-
// такая же конфигурация правил как и выше
80-
}
81-
}
82-
}
83-
```
84-
8560
Примером использования продвинутой конфигурации может быть например [извлечение CSS из компонентов в отдельный файл](./extract-css.md).

docs/ru/configurations/asset-url.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Обработка вложенных URL
22

3-
По умолчанию `vue-loader` автоматически обрабатывает стили и файлы шаблонов с помощью [css-loader](https://github.com/webpack/css-loader) и компилятора шаблонов Vue. В процессе компиляции, все использованные URL, такие как `<img src="...">`, `background: url(...)` и CSS `@import` будут **обрабатаны как зависимости модуля**.
3+
По умолчанию `vue-loader` автоматически обрабатывает стили и файлы шаблонов с помощью [css-loader](https://github.com/webpack/css-loader) и компилятора шаблонов Vue. В процессе компиляции, все использованные URL, такие как `<img src="...">`, `background: url(...)` и CSS `@import` будут **обработаны как зависимости модуля**.
44

55
Например, `url(./image.png)` будет преобразовано в `require('./image.png')`, а затем
66

docs/ru/configurations/custom-blocks.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,6 @@ comp-a h2 {
4141
#### webpack.config.js
4242

4343
``` js
44-
// webpack 2.x
4544
var ExtractTextPlugin = require("extract-text-webpack-plugin")
4645

4746
module.exports = {

docs/ru/configurations/extract-css.md

Lines changed: 0 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -39,8 +39,6 @@ module.exports = {
3939

4040
Пример конфигурации для извлечения CSS из всех компонентов Vue в отдельный CSS-файл:
4141

42-
### webpack 2.x
43-
4442
``` js
4543
// webpack.config.js
4644
var ExtractTextPlugin = require("extract-text-webpack-plugin")
@@ -68,36 +66,3 @@ module.exports = {
6866
]
6967
}
7068
```
71-
72-
### webpack 1.x
73-
74-
``` bash
75-
npm install extract-text-webpack-plugin --save-dev
76-
```
77-
78-
``` js
79-
// webpack.config.js
80-
var ExtractTextPlugin = require("extract-text-webpack-plugin")
81-
82-
module.exports = {
83-
// другие настройки...
84-
module: {
85-
loaders: [
86-
{
87-
test: /\.vue$/,
88-
loader: 'vue'
89-
}
90-
]
91-
},
92-
vue: {
93-
loaders: {
94-
css: ExtractTextPlugin.extract("css"),
95-
// вы также можете добавить <style lang="less"> или другие языки
96-
less: ExtractTextPlugin.extract("css!less")
97-
}
98-
},
99-
plugins: [
100-
new ExtractTextPlugin("style.css")
101-
]
102-
}
103-
```

docs/ru/features/css-modules.md

Lines changed: 0 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -89,17 +89,6 @@ CSS-модули обрабатываются с помощью [css-loader](htt
8989
Вы можете использовать в `vue-loader` опцию `cssModules` чтобы добавить дополнительные параметры для `css-loader`:
9090

9191
``` js
92-
// webpack 1
93-
vue: {
94-
cssModules: {
95-
// другой шаблон для локального имени идентификатора
96-
localIdentName: '[path][name]---[local]---[hash:base64:5]',
97-
// использование camelCase
98-
camelCase: true
99-
}
100-
}
101-
102-
// webpack 2
10392
module: {
10493
rules: [
10594
{

docs/ru/features/postcss.md

Lines changed: 1 addition & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -27,20 +27,7 @@
2727

2828
В качестве альтернативы, вы можете указать конфигурацию PostCSS специально для `*.vue` файлов с помощью опции `postcss` для `vue-loader`.
2929

30-
Пример использования с webpack 1.x:
31-
32-
``` js
33-
// webpack.config.js
34-
module.exports = {
35-
// другие настройки...
36-
vue: {
37-
// использование плагинов PostCSS
38-
postcss: [require('postcss-cssnext')()]
39-
}
40-
}
41-
```
42-
43-
Для webpack 2.x:
30+
Пример:
4431

4532
``` js
4633
// webpack.config.js

docs/ru/options.md

Lines changed: 25 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,9 @@
11
# Перечень настроек
22

3-
## Отличия в использовании с webpack 1 & 2
4-
5-
Для webpack 2: настройки можно передавать непосредственно в правилах загрузчиков.
3+
## Где указывать настройки
64

75
``` js
6+
// webpack.config.js
87
module.exports = {
98
// ...
109
module: {
@@ -21,20 +20,9 @@ module.exports = {
2120
}
2221
```
2322

24-
Для webpack 1.x: добавить блок `vue` в корень конфигурации webpack:
25-
26-
``` js
27-
module.exports = {
28-
// ...
29-
vue: {
30-
// настройки vue-loader
31-
}
32-
}
33-
```
34-
3523
### loaders
3624

37-
- Тип: `{ [lang: string]: string }`
25+
- Тип: `{ [lang: string]: string | Object | Array }`
3826

3927
Объект определяющий какие загрузчики webpack переопределят стандартные загрузчики, используемые для обработки секций `*.vue` файлов. Ключ соответствует атрибуту `lang` у секции файла, если таковой был указан. Значения `lang` по умолчанию:
4028

@@ -45,7 +33,6 @@ module.exports = {
4533
Например, чтобы использовать `babel-loader` и `eslint-loader` для обработки всех секций `<script>`:
4634

4735
``` js
48-
// Конфигурация webpack 2.x
4936
module: {
5037
rules: [
5138
{
@@ -61,17 +48,36 @@ module.exports = {
6148
}
6249
```
6350

51+
Вы также можете использовать синтаксис объектов или массивов (обратите внимание, что параметры должны быть сериализуемы):
52+
53+
``` js
54+
module: {
55+
rules: [
56+
{
57+
test: /\.vue$/,
58+
loader: 'vue-loader',
59+
options: {
60+
loaders: {
61+
js: [
62+
{ loader: 'cache-loader' },
63+
{ loader: 'babel-loader', options: { presets: ['env'] } }
64+
]
65+
}
66+
}
67+
}
68+
]
69+
}
70+
```
71+
6472
### preLoaders
6573

6674
- Тип: `{ [lang: string]: string }`
67-
- поддерживается только в версиях 10.3.0+
6875

6976
Конфигурация подобна как и в `loaders`, но `preLoaders` будут применены к соответствующим секциям перед стандартными загрузчиками. Вы можете использовать это для предварительной обработки секций - например для локализации на этапе сборки.
7077

7178
### postLoaders
7279

7380
- Тип: `{ [lang: string]: string }`
74-
- поддерживается только в версиях 10.3.0+
7581

7682
Конфигурация подобна как и в `loaders`, но `postLoaders` применяются после загрузчиков по умолчанию. Вы можете использовать это для пост-обработки языков. Обратите внимание, что тем не менее всё несколько сложнее:
7783

@@ -81,7 +87,7 @@ module.exports = {
8187

8288
### postcss
8389

84-
> Примечание: в версиях 11.0.0+ рекомендуется использовать файл конфигурации PostCSS вместо описания секции. [Использование аналогично как в `postcss-loader`](https://github.com/postcss/postcss-loader#usage).
90+
> Примечание: рекомендуется использовать файл конфигурации PostCSS, чтобы ваши стили в файлах vue и обычном CSS могли использовать одну и ту же конфигурацию. [Использование аналогично как в `postcss-loader`](https://github.com/postcss/postcss-loader#usage).
8591
8692
- Тип: `Array` или `Function` или `Object`
8793

@@ -208,21 +214,6 @@ module.exports = {
208214
Пример конфигурации:
209215

210216
``` js
211-
// webpack 1
212-
vue: {
213-
buble: {
214-
// enable object spread operator
215-
// ПРИМЕЧАНИЕ: вам нужно самостоятельно подключить полифилл для Object.assign!
216-
objectAssign: 'Object.assign',
217-
218-
// отключение удаления `with`
219-
transforms: {
220-
stripWith: false
221-
}
222-
}
223-
}
224-
225-
// webpack 2
226217
module: {
227218
rules: [
228219
{

docs/ru/start/setup.md

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,12 @@
11
# Создание проекта
22

3-
### Использование `vue-cli`
3+
### Использование `@vue/cli`
44

5-
Рекомендуем создавать проекты, использующие `vue-loader`, с помощью `vue-cli`:
5+
Рекомендуем создавать проекты, использующие `vue-loader`, с помощью `@vue/cli`:
66

77
``` bash
8-
npm install -g vue-cli
9-
vue init webpack-simple hello-vue
8+
npm install -g @vue/cli
9+
vue create hello-vue
1010
cd hello-vue
11-
npm install
12-
npm run dev # можно начинать!
11+
npm run serve # можно начинать!
1312
```

docs/ru/workflow/linting.md

Lines changed: 8 additions & 67 deletions
Original file line numberDiff line numberDiff line change
@@ -2,90 +2,31 @@
22

33
Вы, возможно, гадаете, как же прогонять код в `*.vue` файлах через статические анализаторы, поскольку это не JavaScript. Мы предполагаем, что вы используете [ESLint](https://eslint.org/) (если нет, настоятельно рекомендуем!).
44

5-
Вам также понадобится [eslint-html-plugin](https://github.com/BenoitZugmeyer/eslint-plugin-html) с поддержкой извлечения и анализа JavaScript в `*.vue` файлах.
5+
Вам также понадобится официальный [eslint-plugin-vue](https://github.com/vuejs/eslint-plugin-vue), который поддерживает анализа шаблона и скриптов в `*.vue` файлах.
66

7-
Убедитесь в том, что вы добавили плагин в конфигурацию ESLint:
7+
Убедитесь, что используете поставляемую с плагином конфигурацию в вашей конфигурации ESLint:
88

99
``` json
10-
"plugins": [
11-
"html"
12-
]
13-
```
14-
15-
Затем в командной строке:
16-
17-
``` bash
18-
eslint --ext js,vue MyComponent.vue
19-
```
20-
21-
Другой вариант – использовать [eslint-loader](https://github.com/MoOx/eslint-loader), который будет автоматически анализировать `*.vue` файлы после сохранения во время разработки:
22-
23-
``` bash
24-
npm install eslint eslint-loader --save-dev
25-
```
26-
27-
``` js
28-
// webpack.config.js
29-
module.exports = {
30-
// ... прочие опции
31-
module: {
32-
loaders: [
33-
{
34-
test: /\.vue$/,
35-
loader: 'vue!eslint'
36-
}
37-
]
38-
}
10+
{
11+
"extends": [
12+
"plugin:vue/essential"
13+
]
3914
}
4015
```
4116

42-
Обратите внимание, что загрузчики webpack применяются **справа-налево**. Убедитесь, что `eslint` прописан перед `vue`, чтобы код сначала проходил через анализатор, а затем компилировался.
43-
44-
Стоит упомянуть об использовании сторонних `*.vue` компонентов, поставляемых в NPM пакетах. В таком случае нам нужно воспользоваться `vue-loader`? чтобы подключить сторонние компоненты, но не анализировать их. Мы можем вынести анализ в [предзагрузчики](https://webpack.github.io/docs/loaders.html#loader-order) webpack:
45-
46-
``` js
47-
// webpack.config.js
48-
module.exports = {
49-
// ... прочие опции
50-
module: {
51-
// анализировать только локальные *.vue файлы
52-
preLoaders: [
53-
{
54-
test: /\.vue$/,
55-
loader: 'eslint',
56-
exclude: /node_modules/
57-
}
58-
],
59-
// но использовать vue-loader для всех *.vue файлов
60-
loaders: [
61-
{
62-
test: /\.vue$/,
63-
loader: 'vue'
64-
}
65-
]
66-
}
67-
}
68-
```
69-
70-
Для webpack 2.x:
17+
Убедитесь, что он применяется как предварительный загрузчик:
7118

7219
``` js
7320
// webpack.config.js
7421
module.exports = {
7522
// ... прочие опции
7623
module: {
7724
rules: [
78-
// анализировать только локальные *.vue файлы
7925
{
8026
enforce: 'pre',
81-
test: /\.vue$/,
27+
test: /\.(js|vue)$/,
8228
loader: 'eslint-loader',
8329
exclude: /node_modules/
84-
},
85-
// но использовать vue-loader для всех *.vue файлов
86-
{
87-
test: /\.vue$/,
88-
loader: 'vue-loader'
8930
}
9031
]
9132
}

docs/ru/workflow/production.md

Lines changed: 2 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -19,18 +19,12 @@ module.exports = {
1919
}
2020
}),
2121
// минифицируем, устраняя весь ненужный код
22-
new webpack.optimize.UglifyJsPlugin({
23-
compress: {
24-
warnings: false
25-
}
26-
}),
27-
// только для webpack 1 – оптимизируем идентификаторы модулей по числу использований
28-
new webpack.optimize.OccurrenceOrderPlugin()
22+
new webpack.optimize.UglifyJsPlugin()
2923
]
3024
}
3125
```
3226

33-
Очевидно, нам ни к чему использовать эту конфигурацию во время разработки, для этого есть несколько вариантов:
27+
Нам ни к чему использовать эту конфигурацию во время разработки, для этого есть несколько вариантов:
3428

3529
1. Динамически собирать объект конфигурации на основе переменных окружения;
3630

0 commit comments

Comments
 (0)