chore: Merge branch 'master' into dev

Author: haoqunjiang

docs/config/index.md

@@ -22,6 +22,10 @@ The file should export an object containing options:
 
 ``` js
 // vue.config.js
+
+/**
+ * @type {import('@vue/cli-service').ProjectOptions}
+ */
 module.exports = {
   // options...
 }

docs/core-plugins/unit-jest.md

@@ -60,7 +60,7 @@ transformIgnorePatterns: ['/node_modules/']
 We have to add exceptions to this pattern with a RegExp negative lookahead:
 
 ```javascript
-transformIgnorePatterns: ['/node_modules/(?!name-of-lib-o-transform)']
+transformIgnorePatterns: ['/node_modules/(?!name-of-lib-to-transform)']
 ```
 
 To exclude multiple libraries:

docs/guide/creating-a-project.md

@@ -53,9 +53,11 @@ Options:
   -g, --git [message|false]       Force / skip git initialization, optionally specify initial commit message
   -n, --no-git                    Skip git initialization
   -f, --force                     Overwrite target directory if it exists
+  --merge                         Merge target directory if it exists
   -c, --clone                     Use git clone when fetching remote preset
   -x, --proxy                     Use specified proxy when creating project
   -b, --bare                      Scaffold project without beginner instructions
+  --skipGetStarted                Skip displaying "Get started" instructions
   -h, --help                      Output usage information
 ```
 

docs/guide/css.md

@@ -21,6 +21,15 @@ npm install -D less-loader less
 npm install -D stylus-loader stylus
 ```
 
+::: tip Note on webpack 4
+When using `webpack` version 4, the default in Vue CLI 4, you need to make sure your loaders are compatible with it. Otherwise you will get errors about confliciting peer dependencies. In this case you can use an older version of the loader that is still compatible with `webpack` 4.
+
+``` bash
+# Sass
+npm install -D sass-loader@^10 sass
+```
+:::
+ 
 Then you can import the corresponding file types, or use them in `*.vue` files with:
 
 ``` vue

docs/guide/deployment.md

@@ -39,7 +39,7 @@ If you are using the PWA plugin, your app must be served over HTTPS so that [Ser
 
 1. Set correct `publicPath` in `vue.config.js`.
 
-    If you are deploying to `https://<USERNAME>.github.io/`, you can omit `publicPath` as it defaults to `"/"`.
+    If you are deploying to `https://<USERNAME>.github.io/` or to a custom domain, you can omit `publicPath` as it defaults to `"/"`.
 
     If you are deploying to `https://<USERNAME>.github.io/<REPO>/`, (i.e. your repository is at `https://github.com/<USERNAME>/<REPO>`), set `publicPath` to `"/<REPO>/"`. For example, if your repo name is "my-project", your `vue.config.js` should look like this:
 
@@ -75,10 +75,10 @@ If you are using the PWA plugin, your app must be served over HTTPS so that [Ser
     git commit -m 'deploy'
 
     # if you are deploying to https://<USERNAME>.github.io
-    # git push -f [email protected]:<USERNAME>/<USERNAME>.github.io.git master
+    # git push -f [email protected]:<USERNAME>/<USERNAME>.github.io.git main
 
     # if you are deploying to https://<USERNAME>.github.io/<REPO>
-    # git push -f [email protected]:<USERNAME>/<REPO>.git master:gh-pages
+    # git push -f [email protected]:<USERNAME>/<REPO>.git main:gh-pages
 
     cd -
     ```
@@ -112,7 +112,7 @@ If you are using the PWA plugin, your app must be served over HTTPS so that [Ser
      github_token: $GITHUB_TOKEN
      local_dir: dist
      on:
-       branch: master
+       branch: main
     ```
 
 6. Push the `.travis.yml` file to your repository to trigger the first build.
@@ -363,7 +363,7 @@ heroku login
 heroku create
 heroku buildpacks:add heroku/nodejs
 heroku buildpacks:add https://github.com/heroku/heroku-buildpack-static
-git push heroku master
+git push heroku main
 ```
 
 More info: [Getting started with SPAs on Heroku](https://gist.github.com/hone/24b06869b4c1eca701f9)

docs/guide/mode-and-env.md

@@ -86,7 +86,7 @@ And the following `.env.staging` file:
 
 ```
 NODE_ENV=production
-VUE_APP_TITLE=My App (staging)
+VUE_APP_TITLE=My Staging App
 ```
 
 - `vue-cli-service build` builds a production app, loading `.env`, `.env.production` and `.env.production.local` if they are present;

docs/ru/config/index.md

@@ -22,6 +22,10 @@ sidebar: auto
 
 ```js
 // vue.config.js
+
+/**
+ * @type {import('@vue/cli-service').ProjectOptions}
+ */
 module.exports = {
   // настройки...
 }
@@ -267,7 +271,7 @@ module.exports = {
 - Тип: `boolean | Object`
 - По умолчанию: `true` в режиме production, `false` в режиме development
 
-  Извлечение CSS из ваших компонентов в отдельные CSS-файлы (вместо инлайна в JavaScript и динамического внедрения).
+  Извлечение CSS из ваших компонентов в отдельный CSS-файл (вместо инлайна в JavaScript и динамического внедрения).
 
   Это всегда отключается при сборке веб-компонентов (в этом случае инлайн стили внедряются в shadowRoot).
 
@@ -373,6 +377,16 @@ module.exports = {
   }
   ```
 
+### devServer.inline
+
+- Тип: `boolean`
+- По умолчанию: `true`
+
+  Переключение между двумя режимами работы сервера разработки. Более подробная информация об опции — [devServer.inline](https://webpack.js.org/configuration/dev-server/#devserverinline). Обратите внимание:
+
+  - При использовании `iframe mode` дополнительная конфигурация не требуется. Просто перейдите в браузере по адресу `http://<host>:<port>/webpack-dev-server/<path>` для отладки приложения. В верхней части страницы будут появляться уведомления.
+  - При использовании `inline mode`, просто перейдите в браузере по адресу `http://<host>:<port>/<path>` для отладки приложения. Сообщения о сборке будут появляться в консоли браузера.
+
 ### parallel
 
 - Тип: `boolean | number`

docs/ru/core-plugins/eslint.md

@@ -17,9 +17,13 @@
     --max-warnings       количество предупреждений, по достижению которого сборка заканчивается ошибкой (по умолчанию: Infinity)
   ```
 
-  Проверяет и исправляет файлы. Если конкретные файлы для проверки не указаны, то будут проверяться все файлы в `src` и `tests`.
+  Проверяет и исправляет файлы. Если не указаны конкретные файлы для проверки, то будут проверяться все файлы в `src` и `tests`, а также все файлы JavaScript в корневом каталоге (чаще всего это файлы конфигурации, например `babel.config.js` или `.eslintrc.js`).
 
-  Другие [настройки ESLint CLI](https://eslint.org/docs/user-guide/command-line-interface#options) также поддерживаются.
+  Также поддерживаются и другие [настройки ESLint CLI](https://eslint.org/docs/user-guide/command-line-interface#options).
+
+  :::tip Совет
+  По умолчанию `vue-cli-service lint` проверяет файлы, именуемые с точки `.*.js`. Если вместо этого требуется поведение ESLint по умолчанию, то следует добавить в проект файл `.eslintignore`.
+  :::
 
 ## Конфигурация
 

docs/ru/guide/cli-service.md

@@ -123,16 +123,16 @@ npx vue-cli-service help
 npx vue-cli-service help [command]
 ```
 
-## Пропуск плагинов
+## Исключение плагинов при запуске
 
-Иногда при выполнении команды может понадобиться не использовать определённый плагин CLI. К примеру, для создания сборки приложения без плагина PWA. Такого можно добиться передав имя плагина в опцию `--skip-plugins`.
+Можно исключить определённые плагины при запуске команды, передав имя плагина опцией `--skip-plugins`.
 
 ```bash
 npx vue-cli-service build --skip-plugins pwa
 ```
 
 ::: tip СОВЕТ
-Опция доступна для _любых_ команд `vue-cli-service`, включая пользовательские команды, добавленные другими плагинами.
+Опция доступна для _любых_ команд `vue-cli-service`, в том числе и для пользовательских команд, добавленных другими плагинами.
 :::
 
 Можно пропустить несколько подключаемых плагинов, передав их имена через запятую:

docs/ru/guide/css.md

@@ -21,6 +21,15 @@ npm install -D less-loader less
 npm install -D stylus-loader stylus
 ```
 
+:::tip Примечание при использовании webpack 4
+При использовании `webpack` версии 4, по умолчанию во Vue CLI 4, следует убедиться в совместимости используемых загрузчиков. В противном случае будут появляться ошибки о конфликтующих зависимостях. В таких случаях можно использовать более старую версию загрузчика, которая всё ещё совместима с `webpack` 4.
+
+```bash
+# Sass
+npm install -D sass-loader@^10 sass
+```
+:::
+
 Теперь вы можете импортировать соответствующие типы файлов, или использовать их синтаксис внутри файлов `*.vue` с помощью:
 
 ```vue