Skip to content

[RU] Translation update #1145

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 65 commits into from
Feb 1, 2018
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
65 commits
Select commit Hold shift + click to select a range
1c5f6de
Russian translation update
gbezyuk Apr 27, 2017
10347b6
options.md допереведено предложение
Alex-Sokolov Apr 27, 2017
ccff7dc
Merge pull request #23 from Alex-Sokolov/master
gbezyuk Apr 27, 2017
dbbcea2
Merge pull request #24 from vuejs/master
gbezyuk Apr 27, 2017
781e254
Merge pull request #25 from vuejs/master
Alex-Sokolov May 27, 2017
fbb27a1
SUMMARY.md добавлен перечень настроек
Alex-Sokolov May 27, 2017
8dde9f1
options.md добавлена новая опция
Alex-Sokolov May 27, 2017
121efd4
Merge pull request #26 from Alex-Sokolov/master
gbezyuk May 29, 2017
c447e10
testing-with-mocks.md добавлены -loader
Alex-Sokolov Jun 29, 2017
010629d
testing.md исправлен пример
Alex-Sokolov Jun 29, 2017
903362e
scoped-css.md добавлен раздел про вложенные селекторы
Alex-Sokolov Jun 29, 2017
3fa6e7b
pre-processors.md добавлена новая секция
Alex-Sokolov Jun 29, 2017
b0b6b20
Merge pull request #27 from Alex-Sokolov/master
gbezyuk Jun 29, 2017
6524235
options.md нумерация версий
Alex-Sokolov Jul 30, 2017
fd29083
advanced.md нумерация версий
Alex-Sokolov Jul 30, 2017
3412861
options.md уточнение
Alex-Sokolov Jul 30, 2017
bf8d772
options.md уточнение
Alex-Sokolov Jul 30, 2017
9ca8e8a
Merge pull request #28 from Alex-Sokolov/master
Alex-Sokolov Jul 30, 2017
216c5c8
Merge branch 'master' into master
Alex-Sokolov Jul 31, 2017
5f41756
Sync with master
Alex-Sokolov Sep 3, 2017
004e4d0
Fix merge
Alex-Sokolov Sep 3, 2017
841b749
SUMMARY.md добавлены новые пункты
Alex-Sokolov Sep 20, 2017
b209521
scoped-css.md новые правки
Alex-Sokolov Sep 20, 2017
4ba0799
options.md новые свойства
Alex-Sokolov Sep 20, 2017
6e6355d
hot-reload.md обновления
Alex-Sokolov Sep 20, 2017
0e169ab
scoped-css.md правка
Alex-Sokolov Sep 20, 2017
1c01356
Merge pull request #30 from Alex-Sokolov/master
Alex-Sokolov Sep 20, 2017
fcbcd0f
HTTP -> HTTPS
Alex-Sokolov Sep 27, 2017
d185ef3
Merge pull request #31 from Alex-Sokolov/master
Alex-Sokolov Sep 27, 2017
a2a24a7
Sync with master
Alex-Sokolov Sep 27, 2017
8327552
Merge remote-tracking branch 'upstream/master'
Alex-Sokolov Oct 12, 2017
0d9dc32
testing-with-mocks.md правка примера
Alex-Sokolov Oct 12, 2017
a16dc7c
SUMMARY.md добавлены новые пункты
Alex-Sokolov Oct 12, 2017
70bb007
functional-template.md добавлен новый файл
Alex-Sokolov Oct 12, 2017
e84e03d
options.md новые разделы
Alex-Sokolov Oct 12, 2017
d4c972c
functional-template.md переведён
Alex-Sokolov Oct 12, 2017
7914094
Merge remote-tracking branch 'upstream/master'
Alex-Sokolov Oct 12, 2017
78142cb
functional.md правки
Alex-Sokolov Oct 12, 2017
644f183
Merge remote-tracking branch 'upstream/master'
Alex-Sokolov Nov 3, 2017
5583727
postcss.md исправлен пример
Alex-Sokolov Nov 3, 2017
b2ae0dc
Merge remote-tracking branch 'upstream/master'
Alex-Sokolov Nov 7, 2017
4a9f61e
options.md новая секция
Alex-Sokolov Nov 7, 2017
7e4587c
hot-reload.md новая секция
Alex-Sokolov Nov 7, 2017
012e706
sync with master
Alex-Sokolov Dec 19, 2017
18fedc7
testing-with-mocks.md новые правки
Alex-Sokolov Dec 19, 2017
383f4e3
postcss.md правки
Alex-Sokolov Dec 19, 2017
d9b94c7
options.md новые правки
Alex-Sokolov Dec 19, 2017
61bc0b9
Merge remote-tracking branch 'upstream/master'
Alex-Sokolov Jan 1, 2018
cb71954
options.md правки
Alex-Sokolov Jan 1, 2018
18bc084
Merge remote-tracking branch 'upstream/master'
Alex-Sokolov Jan 14, 2018
088de1b
asset-url.md добавлены разъяснения
Alex-Sokolov Jan 14, 2018
32594d5
Update SUMMARY.md
Alex-Sokolov Jan 15, 2018
07e5678
sync with master
Alex-Sokolov Jan 15, 2018
f084bf5
Merge remote-tracking branch 'upstream/master'
Alex-Sokolov Jan 31, 2018
f40206d
asset-url.md опечатка
Alex-Sokolov Jan 31, 2018
f5e16b8
advanced.md удалена настройка для вебпака 1
Alex-Sokolov Jan 31, 2018
ab6c57a
options.md удалено о первом вебпаке
Alex-Sokolov Jan 31, 2018
95b1c18
custom-block.md удалено о первом вебпаке
Alex-Sokolov Jan 31, 2018
651f7ed
extract-css.md удалено о первом вебпаке
Alex-Sokolov Jan 31, 2018
4df672b
css-modules.md удалено о первом вебпаке
Alex-Sokolov Jan 31, 2018
28c4676
postcss.md удалено о первом вебпаке
Alex-Sokolov Jan 31, 2018
6a4b391
setup.md обновление для @vue/cli
Alex-Sokolov Jan 31, 2018
a1b7b4c
linting.md обновление для eslint-plugin-vue
Alex-Sokolov Jan 31, 2018
e8066de
production.md удалено о первом вебпаке
Alex-Sokolov Jan 31, 2018
46b3465
testing.md обновлено о @vue/test-utils
Alex-Sokolov Jan 31, 2018
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/ru/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,4 +33,4 @@
- [transformToRequire](options.md#transformtorequire)
- [buble](options.md#buble)
- [extractCSS](options.md#extractcss)
- [optimizeSSR](options.md#optimizessr)
- [optimizeSSR](options.md#optimizessr)
25 changes: 0 additions & 25 deletions docs/ru/configurations/advanced.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,6 @@

> Опции `preLoaders` и `postLoaders` доступны только в версиях 10.3.0+

### webpack 2.x

``` js
module.exports = {
// другие настройки...
Expand Down Expand Up @@ -59,27 +57,4 @@ module.exports = {
}
```

### webpack 1.x

``` js
// webpack.config.js
module.exports = {
// другие настройки...
module: {
loaders: [
{
test: /\.vue$/,
loader: 'vue'
}
]
},
// настройки vue-loader
vue: {
loaders: {
// такая же конфигурация правил как и выше
}
}
}
```

Примером использования продвинутой конфигурации может быть например [извлечение CSS из компонентов в отдельный файл](./extract-css.md).
2 changes: 1 addition & 1 deletion docs/ru/configurations/asset-url.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Обработка вложенных URL

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

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

Expand Down
1 change: 0 additions & 1 deletion docs/ru/configurations/custom-blocks.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,6 @@ comp-a h2 {
#### webpack.config.js

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

module.exports = {
Expand Down
35 changes: 0 additions & 35 deletions docs/ru/configurations/extract-css.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,8 +39,6 @@ module.exports = {

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

### webpack 2.x

``` js
// webpack.config.js
var ExtractTextPlugin = require("extract-text-webpack-plugin")
Expand Down Expand Up @@ -68,36 +66,3 @@ module.exports = {
]
}
```

### webpack 1.x

``` bash
npm install extract-text-webpack-plugin --save-dev
```

``` js
// webpack.config.js
var ExtractTextPlugin = require("extract-text-webpack-plugin")

module.exports = {
// другие настройки...
module: {
loaders: [
{
test: /\.vue$/,
loader: 'vue'
}
]
},
vue: {
loaders: {
css: ExtractTextPlugin.extract("css"),
// вы также можете добавить <style lang="less"> или другие языки
less: ExtractTextPlugin.extract("css!less")
}
},
plugins: [
new ExtractTextPlugin("style.css")
]
}
```
11 changes: 0 additions & 11 deletions docs/ru/features/css-modules.md
Original file line number Diff line number Diff line change
Expand Up @@ -89,17 +89,6 @@ CSS-модули обрабатываются с помощью [css-loader](htt
Вы можете использовать в `vue-loader` опцию `cssModules` чтобы добавить дополнительные параметры для `css-loader`:

``` js
// webpack 1
vue: {
cssModules: {
// другой шаблон для локального имени идентификатора
localIdentName: '[path][name]---[local]---[hash:base64:5]',
// использование camelCase
camelCase: true
}
}

// webpack 2
module: {
rules: [
{
Expand Down
15 changes: 1 addition & 14 deletions docs/ru/features/postcss.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,20 +27,7 @@

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

Пример использования с webpack 1.x:

``` js
// webpack.config.js
module.exports = {
// другие настройки...
vue: {
// использование плагинов PostCSS
postcss: [require('postcss-cssnext')()]
}
}
```

Для webpack 2.x:
Пример:

``` js
// webpack.config.js
Expand Down
59 changes: 25 additions & 34 deletions docs/ru/options.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,9 @@
# Перечень настроек

## Отличия в использовании с webpack 1 & 2

Для webpack 2: настройки можно передавать непосредственно в правилах загрузчиков.
## Где указывать настройки

``` js
// webpack.config.js
module.exports = {
// ...
module: {
Expand All @@ -21,20 +20,9 @@ module.exports = {
}
```

Для webpack 1.x: добавить блок `vue` в корень конфигурации webpack:

``` js
module.exports = {
// ...
vue: {
// настройки vue-loader
}
}
```

### loaders

- Тип: `{ [lang: string]: string }`
- Тип: `{ [lang: string]: string | Object | Array }`

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

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

``` js
// Конфигурация webpack 2.x
module: {
rules: [
{
Expand All @@ -61,17 +48,36 @@ module.exports = {
}
```

Вы также можете использовать синтаксис объектов или массивов (обратите внимание, что параметры должны быть сериализуемы):

``` js
module: {
rules: [
{
test: /\.vue$/,
loader: 'vue-loader',
options: {
loaders: {
js: [
{ loader: 'cache-loader' },
{ loader: 'babel-loader', options: { presets: ['env'] } }
]
}
}
}
]
}
```

### preLoaders

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

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

### postLoaders

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

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

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

### postcss

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

- Тип: `Array` или `Function` или `Object`

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

``` js
// webpack 1
vue: {
buble: {
// enable object spread operator
// ПРИМЕЧАНИЕ: вам нужно самостоятельно подключить полифилл для Object.assign!
objectAssign: 'Object.assign',

// отключение удаления `with`
transforms: {
stripWith: false
}
}
}

// webpack 2
module: {
rules: [
{
Expand Down
11 changes: 5 additions & 6 deletions docs/ru/start/setup.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,12 @@
# Создание проекта

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

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

``` bash
npm install -g vue-cli
vue init webpack-simple hello-vue
npm install -g @vue/cli
vue create hello-vue
cd hello-vue
npm install
npm run dev # можно начинать!
npm run serve # можно начинать!
```
75 changes: 8 additions & 67 deletions docs/ru/workflow/linting.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,90 +2,31 @@

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

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

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

``` json
"plugins": [
"html"
]
```

Затем в командной строке:

``` bash
eslint --ext js,vue MyComponent.vue
```

Другой вариант – использовать [eslint-loader](https://github.com/MoOx/eslint-loader), который будет автоматически анализировать `*.vue` файлы после сохранения во время разработки:

``` bash
npm install eslint eslint-loader --save-dev
```

``` js
// webpack.config.js
module.exports = {
// ... прочие опции
module: {
loaders: [
{
test: /\.vue$/,
loader: 'vue!eslint'
}
]
}
{
"extends": [
"plugin:vue/essential"
]
}
```

Обратите внимание, что загрузчики webpack применяются **справа-налево**. Убедитесь, что `eslint` прописан перед `vue`, чтобы код сначала проходил через анализатор, а затем компилировался.

Стоит упомянуть об использовании сторонних `*.vue` компонентов, поставляемых в NPM пакетах. В таком случае нам нужно воспользоваться `vue-loader`? чтобы подключить сторонние компоненты, но не анализировать их. Мы можем вынести анализ в [предзагрузчики](https://webpack.github.io/docs/loaders.html#loader-order) webpack:

``` js
// webpack.config.js
module.exports = {
// ... прочие опции
module: {
// анализировать только локальные *.vue файлы
preLoaders: [
{
test: /\.vue$/,
loader: 'eslint',
exclude: /node_modules/
}
],
// но использовать vue-loader для всех *.vue файлов
loaders: [
{
test: /\.vue$/,
loader: 'vue'
}
]
}
}
```

Для webpack 2.x:
Убедитесь, что он применяется как предварительный загрузчик:

``` js
// webpack.config.js
module.exports = {
// ... прочие опции
module: {
rules: [
// анализировать только локальные *.vue файлы
{
enforce: 'pre',
test: /\.vue$/,
test: /\.(js|vue)$/,
loader: 'eslint-loader',
exclude: /node_modules/
},
// но использовать vue-loader для всех *.vue файлов
{
test: /\.vue$/,
loader: 'vue-loader'
}
]
}
Expand Down
10 changes: 2 additions & 8 deletions docs/ru/workflow/production.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,18 +19,12 @@ module.exports = {
}
}),
// минифицируем, устраняя весь ненужный код
new webpack.optimize.UglifyJsPlugin({
compress: {
warnings: false
}
}),
// только для webpack 1 – оптимизируем идентификаторы модулей по числу использований
new webpack.optimize.OccurrenceOrderPlugin()
new webpack.optimize.UglifyJsPlugin()
]
}
```

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

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

Expand Down
Loading