docs: [RU] Translation update (#4917)

* docs: (ru) config/README.md update devServer example * docs: (ru) creating-a-project.md update * docs: css.md add less examples * docs: browser-compatibility.md update * docs: deployment.md update * docs: (ru) config/readme.md update * docs: (ru) deployment.md update * docs: (ru) prototyping.md add yarn command * docs: config.md fix * docs: ui-localization.md typo * docs: [RU] Translation update * docs: [RU] Translation update * docs: vuex.md added * docs: router.md added * docs: migration from v3 added * docs: config.js updated * docs: config/readme.md updated * docs: unit-mocha.md updated * docs: css.md updated * docs: cli-service.md updated * docs: generator-api.md updated * docs: build-target.md update * docs: deployment.md update * docs: e2e-nightwatch.md update * docs: unit-jest.md update * docs: e2e-nightwatch.md update * docs: migrating-from-v3.md update * docs: plugin-dev.md update * docs: plugin-dev.md update * docs: plugin-dev.md update * docs: plugin-dev.md update
vuejs · Dec 6, 2019 · 02f2436 · 02f2436
1 parent c7961cd
commit 02f2436
Show file tree

Hide file tree

Showing 33 changed files with 2,570 additions and 401 deletions.
diff --git a/docs/.vuepress/config.js b/docs/.vuepress/config.js
@@ -272,16 +272,14 @@ module.exports = {
           {
             text: 'Плагины',
             items: [
-              { text: 'Babel', link: 'https://github.com/vuejs/vue-cli/tree/dev/packages/%40vue/cli-plugin-babel' },
-              { text: 'TypeScript', link: 'https://github.com/vuejs/vue-cli/tree/dev/packages/%40vue/cli-plugin-typescript' },
-              { text: 'ESLint', link: 'https://github.com/vuejs/vue-cli/tree/dev/packages/%40vue/cli-plugin-eslint' },
-              { text: 'PWA', link: 'https://github.com/vuejs/vue-cli/tree/dev/packages/%40vue/cli-plugin-pwa' },
-              { text: 'Jest', link: 'https://github.com/vuejs/vue-cli/tree/dev/packages/%40vue/cli-plugin-unit-jest' },
-              { text: 'Mocha', link: 'https://github.com/vuejs/vue-cli/tree/dev/packages/%40vue/cli-plugin-unit-mocha' },
-              { text: 'Cypress', link: 'https://github.com/vuejs/vue-cli/tree/dev/packages/%40vue/cli-plugin-e2e-cypress' },
-              { text: 'Nightwatch', link: 'https://github.com/vuejs/vue-cli/tree/dev/packages/%40vue/cli-plugin-e2e-nightwatch' }
+              { text: 'Основные плагины', link: '/ru/core-plugins/' },
+              { text: 'Просмотр плагинов', link: 'https://awesomejs.dev/for/vue-cli/' }
             ]
           },
+          {
+            text: 'Миграция с v3',
+            link: '/ru/migrating-from-v3/'
+          },
           {
             text: 'История изменений',
             link: 'https://github.com/vuejs/vue-cli/blob/dev/CHANGELOG.md'
@@ -311,12 +309,21 @@ module.exports = {
                 '/ru/guide/webpack',
                 '/ru/guide/mode-and-env',
                 '/ru/guide/build-targets',
-                '/ru/guide/deployment'
+                '/ru/guide/deployment',
+                '/ru/guide/troubleshooting'
               ]
             }
           ],
           '/ru/dev-guide/': [
             '/ru/dev-guide/plugin-dev.md',
+            {
+              title: 'Справочник API',
+              collapsable: false,
+              children: [
+                '/ru/dev-guide/plugin-api.md',
+                '/ru/dev-guide/generator-api.md',
+              ]
+            },
             {
               title: 'Разработка UI',
               collapsable: false,
@@ -326,7 +333,21 @@ module.exports = {
                 '/ru/dev-guide/ui-localization.md'
               ]
             }
-          ]
+          ],
+          '/ru/core-plugins/': [{
+            title: 'Основные плагины Vue CLI',
+            collapsable: false,
+            children: [
+              '/ru/core-plugins/babel.md',
+              '/ru/core-plugins/typescript.md',
+              '/ru/core-plugins/eslint.md',
+              '/ru/core-plugins/pwa.md',
+              '/ru/core-plugins/unit-jest.md',
+              '/ru/core-plugins/unit-mocha.md',
+              '/ru/core-plugins/e2e-cypress.md',
+              '/ru/core-plugins/e2e-nightwatch.md'
+            ]
+          }]
         }
       }
     }

diff --git a/docs/ru/README.md b/docs/ru/README.md
@@ -37,15 +37,15 @@ footer: MIT Licensed | Copyright © 2018-present Evan You
 
 Установка:
 
-``` bash
+```bash
 npm install -g @vue/cli
 # ИЛИ
 yarn global add @vue/cli
 ```
 
 Создание проекта:
 
-``` bash
+```bash
 vue create my-project
 # ИЛИ
 vue ui

diff --git a/docs/ru/config/README.md b/docs/ru/config/README.md
@@ -20,7 +20,7 @@ sidebar: auto
 
 Файл должен экспортировать объект с настройками:
 
-``` js
+```js
 // vue.config.js
 module.exports = {
   // настройки...
@@ -52,7 +52,7 @@ module.exports = {
 
   Опция может быть полезна и на этапе разработки. Если вы хотите запускать сервер разработки из корня сайта, то можно устанавливать значение по условию:
 
-  ``` js
+  ```js
   module.exports = {
     publicPath: process.env.NODE_ENV === 'production'
       ? '/production-sub-path/'
@@ -106,7 +106,7 @@ module.exports = {
   - объектом, который определяет свои `entry`, `template`, `filename`, `title` и `chunks` (все опциональные, за исключением `entry`). Любые другие свойства, указанные рядом с ними будут переданы непосредственно в `html-webpack-plugin`, для возможности более тонкой настройки этого плагина;
   - или строкой, определяющей свою `entry`.
 
-  ``` js
+  ```js
   module.exports = {
     pages: {
       index: {
@@ -120,7 +120,7 @@ module.exports = {
         // должен быть <title><%= htmlWebpackPlugin.options.title %></title>
         title: 'Index Page',
         // все фрагменты, добавляемые на этой странице, по умолчанию
-        // это извлеченные общий фрагмент и вендорный фрагмент.
+        // это извлечённые общий фрагмент и вендорный фрагмент.
         chunks: ['chunk-vendors', 'chunk-common', 'index']
       },
       // когда используется строковый формат точки входа, то
@@ -138,18 +138,20 @@ module.exports = {
 
 ### lintOnSave
 
-- Тип: `boolean | 'error'`
+- Тип: `boolean | 'warning' | 'default' | 'error'`
 - По умолчанию: `true`
 
   Выполнять ли линтинг кода при сохранении во время разработки с помощью [eslint-loader](https://github.com/webpack-contrib/eslint-loader). Эта опция действует только когда установлен плагин [`@vue/cli-plugin-eslint`](https://github.com/vuejs/vue-cli/tree/dev/packages/%40vue/cli-plugin-eslint).
 
-  Когда значение `true`, `eslint-loader` показывает ошибки линтинга как предупреждения. По умолчанию предупреждения выводятся в терминал и не останавливают сборку ошибкой.
+  Когда значение `true` или `'warning'`, `eslint-loader` показывает ошибки линтинга как предупреждения. По умолчанию предупреждения выводятся в терминал и не останавливают сборку ошибкой, поэтому это хорошее значение по умолчанию для разработки.
 
-  Чтобы ошибки линтинга отображались в браузере, можно указать `lintOnSave: 'error'`. Тогда `eslint-loader` будет всегда генерировать ошибки. Это также означает, что ошибки линтинга будут останавливать сборку ошибкой.
+  Для отображения ошибок линтинга в браузере можно указать `lintOnSave: 'default'`. Это заставит `eslint-loader` генерировать ошибки и любые ошибки линтинга приведут к неудаче компиляции сборки.
 
-  Кроме того, вы можете настроить отображение в браузере предупреждений и ошибок:
+  Установка значения в `'errors'` заставит `eslint-loader` считать все предупреждения ошибками, а значит и они будут отображены в браузере.
 
-  ``` js
+  Кроме того, можно настроить отображение в браузере предупреждений и ошибок:
+
+  ```js
   // vue.config.js
   module.exports = {
     devServer: {
@@ -163,7 +165,7 @@ module.exports = {
 
   Когда значение `lintOnSave` приводится к `true`, `eslint-loader` будет применяться как в разработке, так и в production. Если вы хотите отключить `eslint-loader` при сборке в production, можете воспользоваться следующей конфигурацией:
 
-  ``` js
+  ```js
   // vue.config.js
   module.exports = {
     lintOnSave: process.env.NODE_ENV !== 'production'
@@ -186,6 +188,14 @@ module.exports = {
 
   По умолчанию `babel-loader` игнорирует все файлы из `node_modules`. Если вы хотите явно транспилировать зависимость с помощью Babel, то вы можете перечислить её в этой опции.
 
+::: warning Конфигурация Jest
+Эта опция не поддерживается [плагином cli-unit-jest](#jest), потому что в Jest мы не должны транспилировать код из `node_modules`, если в нём не используются нестандартные возможности — Node >8.11 уже поддерживает последние нововведения ECMAScript.
+
+Однако, Jest иногда требуется преобразовывать содержимое из `node_modules`, например если в этом коде используется синтаксис ES6 `import`/`export`. В таком случае используйте опцию `transformIgnorePatterns` в файле `jest.config.js`.
+
+См. [README плагина](../core-plugins/unit-jest.md) для получения дополнительной информации.
+:::
+
 ### productionSourceMap
 
 - Тип: `boolean`
@@ -235,10 +245,20 @@ module.exports = {
 
 ### css.modules
 
+Устаревшая опция, начиная с версии v4, используйте вместо неё [`css.requireModuleExtension`](#css-requireModuleExtension).
+
+В версии v3 это противоположность опции `css.requireModuleExtension`.
+
+### css.requireModuleExtension
+
 - Тип: `boolean`
-- По умолчанию: `false`
+- По умолчанию: `true`
+
+  По умолчанию, только файлы заканчивающиеся на `*.module.[ext]` обрабатываются как CSS-модули. Установка в значение `false` позволит вам убрать `.module` из имён файлов и обрабатывать все `*.(css|scss|sass|less|styl(us)?)` файлы как CSS-модули.
 
-  По умолчанию, только файлы заканчивающиеся на `*.module.[ext]` обрабатываются как CSS-модули. Установка в значение `true` позволит вам убрать `.module` из имён файлов и обрабатывать все `*.(css|scss|sass|less|styl(us)?)` файлы как CSS-модули.
+  ::: tip СОВЕТ
+  Если в `css.loaderOptions.css` есть настроенные конфигурации CSS-модулей, то поле `css.requireModuleExtension` должно быть явно указано в `true` или `false`, иначе нельзя быть уверенным необходимо ли применять эти параметры ко всем CSS-файлам или нет.
+  :::
 
   См. также: [Работа с CSS — CSS-модули](../guide/css.md#css-модуnи)
 
@@ -255,6 +275,8 @@ module.exports = {
 
   Извлечение CSS отключено по умолчанию в режиме `development`, поскольку оно несовместимо с горячей перезагрузкой CSS. Тем не менее, вы всё равно можете принудительно использовать извлечение стилей всегда, установив значение в `true`.
 
+  Вместо `true` также можно передать объект с настройками для [mini-css-extract-plugin](https://github.com/webpack-contrib/mini-css-extract-plugin) если необходимо детальнее настроить работу этого плагина.
+
 ### css.sourceMap
 
 - Тип: `boolean`
@@ -269,7 +291,7 @@ module.exports = {
 
   Передача настроек в загрузчики относящиеся к CSS. Например:
 
-  ``` js
+  ```js
   module.exports = {
     css: {
       loaderOptions: {
@@ -292,6 +314,8 @@ module.exports = {
   - [less-loader](https://github.com/webpack-contrib/less-loader)
   - [stylus-loader](https://github.com/shama/stylus-loader)
 
+  Также можно настроить синтаксис `scss` отдельно от `sass` через опцию `scss`.
+
   См. также: [Передача настроек в загрузчики пре-процессоров](../guide/css.md#передача-настроек-в-загрузчики-пре-процессоров)
 
   ::: tip Совет
@@ -316,7 +340,7 @@ module.exports = {
 
   `devServer.proxy` может быть строкой, указывающей на сервер API для разработки:
 
-  ``` js
+  ```js
   module.exports = {
     devServer: {
       proxy: 'http://localhost:4000'
@@ -326,9 +350,13 @@ module.exports = {
 
   Это скажет серверу разработки проксировать любые неизвестные запросы (запросы, которые не соответствуют статическому файлу) на адрес `http://localhost:4000`.
 
+  ::: warning ПРЕДУПРЕЖДЕНИЕ
+  При указании `devServer.proxy` строкой будут проксироваться только XHR-запросы. Если необходимо протестировать API URL, не открывайте его в браузере, а вместо этого используйте инструмент для работы с API (например, Postman).
+  :::
+
   Если вам нужно больше контроля поведения прокси-сервера, вы также можете использовать объект с парами опций `path: options`. См. полный список опций [http-proxy-middleware](https://github.com/chimurai/http-proxy-middleware#proxycontext-config):
 
-  ``` js
+  ```js
   module.exports = {
     devServer: {
       proxy: {
@@ -347,10 +375,10 @@ module.exports = {
 
 ### parallel
 
-- Тип: `boolean`
+- Тип: `boolean | number`
 - По умолчанию: `require('os').cpus().length > 1`
 
-  Использовать ли `thread-loader` для транспиляции Babel или TypeScript. Включается для production-сборок, когда система имеет более 1 процессорных ядер.
+  Использовать ли `thread-loader` для транспиляции Babel или TypeScript. Включается для production-сборок, когда система имеет более 1 процессорных ядер. Указание числа определит количество задействованных воркеров (workers).
 
 ### pwa
 
@@ -364,7 +392,7 @@ module.exports = {
 
   Этот объект не проходит никакой валидации своей структуры, поэтому можно его использовать для передачи произвольных параметров сторонним плагинам. Например:
 
-  ``` js
+  ```js
   module.exports = {
     pluginOptions: {
       foo: {

diff --git a/docs/ru/core-plugins/README.md b/docs/ru/core-plugins/README.md
@@ -0,0 +1,14 @@
+# Плагины
+
+Vue CLI использует архитектуру на основе плагинов. Если изучить `package.json` в только что созданном проекте, можно обнаружить зависимости, которые начинаются с `@vue/cli-plugin-`. Плагины могут модифицировать внутреннюю конфигурацию webpack и внедрять команды в `vue-cli-service`. Большинство возможностей, перечисленных в процессе создания проекта, реализованы в виде плагинов.
+
+Этот раздел содержит документацию для основных плагинов Vue CLI:
+
+- [Babel](babel.md)
+- [TypeScript](typescript.md)
+- [ESLint](eslint.md)
+- [PWA](pwa.md)
+- [Jest](unit-jest.md)
+- [Mocha](unit-mocha.md)
+- [Cypress](e2e-cypress.md)
+- [Nightwatch](e2e-nightwatch.md)
diff --git a/docs/ru/core-plugins/babel.md b/docs/ru/core-plugins/babel.md
@@ -0,0 +1,39 @@
+# @vue/cli-plugin-babel
+
+> Плагин babel для vue-cli
+
+## Конфигурация
+
+По умолчанию используется Babel 7 + `babel-loader` + [@vue/babel-preset-app](https://github.com/vuejs/vue-cli/tree/dev/packages/%40vue/babel-preset-app), но есть возможность конфигурации через `babel.config.js` для использования любых других пресетов Babel или плагинов.
+
+По умолчанию `babel-loader` исключает файлы внутри зависимостей из `node_modules`. Если вы хотите явно транспилировать модуль какой-то зависимости, необходимо указать его в опции `transpileDependencies` в файле `vue.config.js`:
+
+```js
+module.exports = {
+  transpileDependencies: [
+    // может быть строкой или regex
+    'my-dep',
+    /other-dep/
+  ]
+}
+```
+
+## Кэширование
+
+[cache-loader](https://github.com/webpack-contrib/cache-loader) используется по умолчанию, кэш хранится в `<projectRoot>/node_modules/.cache/babel-loader`.
+
+## Параллелизация
+
+[thread-loader](https://github.com/webpack-contrib/thread-loader) используется по умолчанию, если машина имеет более 1 ядра CPU. Это можно отключить указав `parallel: false` в файле `vue.config.js`.
+
+## Установка в уже созданный проект
+
+```sh
+vue add babel
+```
+
+## Внедряемые правила webpack-chain
+
+- `config.rule('js')`
+- `config.rule('js').use('babel-loader')`
+- `config.rule('js').use('cache-loader')`