From 09c10b24e5beb8ac41b98423ae61442da3d79e02 Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Sun, 19 Jan 2020 20:58:10 +0300 Subject: [PATCH 01/35] docs: [RU] update migrating-from-v3.md --- docs/ru/migrating-from-v3/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ru/migrating-from-v3/README.md b/docs/ru/migrating-from-v3/README.md index d79818e955..dca2a7baf7 100644 --- a/docs/ru/migrating-from-v3/README.md +++ b/docs/ru/migrating-from-v3/README.md @@ -261,7 +261,7 @@ Nightwatch.js обновлён с версии 0.9 до 1.x. Рекоменду ### `@vue/cli-plugin-typescript` -При использовании Typescript, webpack в настройках разрешения модулей теперь [отдаёт предпочтение файлам с расширениями `ts(x)`, а не `js(x)`](https://github.com/vuejs/vue-cli/pull/3909). +При импорте файла без расширения, настройки webpack по разрешению модулей теперь [отдают предпочтение файлам с расширениями `ts(x)` вместо `js(x)` и `.vue`](https://github.com/vuejs/vue-cli/pull/3909). Настоятельно рекомендуется всегда указывать расширение файла при импорте `.vue` файлов. ### `@vue/cli-plugin-unit-jest` From 1c458e64aed65fc48126aaf3e7a6be1697f7b396 Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Sun, 19 Jan 2020 20:59:54 +0300 Subject: [PATCH 02/35] docs: [RU] update prototyping.md --- docs/ru/guide/prototyping.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/ru/guide/prototyping.md b/docs/ru/guide/prototyping.md index f60f4b2e13..01a047d364 100644 --- a/docs/ru/guide/prototyping.md +++ b/docs/ru/guide/prototyping.md @@ -1,11 +1,11 @@ # Мгновенное прототипирование -Вы можете быстро создавать прототип в одном файле `*.vue` с помощью команд `vue serve` и `vue build`, но для них сначала потребуется глобально установить дополнительный плагин: +Вы можете быстро создавать прототип в одном файле `*.vue` с помощью команд `vue serve` и `vue build`, но для них сначала потребуется глобально установить дополнение к Vue CLI: ```bash -npm install -g @vue/cli-service-global +npm install -g @vue/cli @vue/cli-service-global # или -yarn global add @vue/cli-service-global +yarn global add @vue/cli @vue/cli-service-global ``` Недостаток `vue serve` в том, что он полагается на глобально установленные зависимости, которые могут отличаться на разных машинах. Поэтому его рекомендуется использовать только для быстрого прототипирования. From 71a6501a708810a47763ce9b5c905abac71823e6 Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Sun, 19 Jan 2020 21:00:43 +0300 Subject: [PATCH 03/35] docs: [RU] update webpack.md --- docs/ru/guide/webpack.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/ru/guide/webpack.md b/docs/ru/guide/webpack.md index 0dd02a874c..8811953aa7 100644 --- a/docs/ru/guide/webpack.md +++ b/docs/ru/guide/webpack.md @@ -81,6 +81,10 @@ module.exports = { .use('graphql-tag/loader') .loader('graphql-tag/loader') .end() + // Добавление ещё одного загрузчика + .use('other-loader') + .loader('other-loader') + .end() } } ``` From b93530cf507e4eb71d7fc4efba38988bcbc8ed6d Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Sun, 19 Jan 2020 21:34:42 +0300 Subject: [PATCH 04/35] docs: [RU] fix typos in cli-service.md --- docs/ru/guide/cli-service.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/ru/guide/cli-service.md b/docs/ru/guide/cli-service.md index 20ffeec0ca..bab720a5cc 100644 --- a/docs/ru/guide/cli-service.md +++ b/docs/ru/guide/cli-service.md @@ -51,7 +51,7 @@ npx vue-cli-service serve --port определить порт (по умолчанию: 8080) --https использовать https (по умолчанию: false) --public указать URL-адрес публичной сети для клиента HMR - --skip-plugins имёна плагинов через запятую, которые следует пропустить при запуске + --skip-plugins имена плагинов через запятую, которые следует пропустить при запуске ``` ::: tip --copy @@ -83,7 +83,7 @@ npx vue-cli-service serve --no-clean не удалять каталог dist перед сборкой проекта --report сгенерировать report.html для анализа содержимого сборки --report-json сгенерировать report.json для анализа содержимого сборки - --skip-plugins имёна плагинов через запятую, которые следует пропустить при запуске + --skip-plugins имена плагинов через запятую, которые следует пропустить при запуске --watch отслеживать изменения ``` From 9d3614b8e83c173e22ac50d157e4410ce2637ba9 Mon Sep 17 00:00:00 2001 From: Alexander Sokolov Date: Sun, 19 Jan 2020 22:03:08 +0300 Subject: [PATCH 05/35] Update docs/ru/guide/prototyping.md Co-Authored-By: Natalia Tepluhina --- docs/ru/guide/prototyping.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ru/guide/prototyping.md b/docs/ru/guide/prototyping.md index 01a047d364..553a46c603 100644 --- a/docs/ru/guide/prototyping.md +++ b/docs/ru/guide/prototyping.md @@ -1,6 +1,6 @@ # Мгновенное прототипирование -Вы можете быстро создавать прототип в одном файле `*.vue` с помощью команд `vue serve` и `vue build`, но для них сначала потребуется глобально установить дополнение к Vue CLI: +Вы можете быстро создавать прототип в одном файле `*.vue` с помощью команд `vue serve` и `vue build`, но для них сначала потребуется глобально установить плагин в дополнение к Vue CLI: ```bash npm install -g @vue/cli @vue/cli-service-global From e5fb676e8c402e2393105e987d5e8a9d7809de31 Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Tue, 3 Mar 2020 00:26:51 +0300 Subject: [PATCH 06/35] docs: (ru) pwa.md update --- docs/ru/core-plugins/pwa.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ru/core-plugins/pwa.md b/docs/ru/core-plugins/pwa.md index 23fa477334..f69cab16e1 100644 --- a/docs/ru/core-plugins/pwa.md +++ b/docs/ru/core-plugins/pwa.md @@ -67,7 +67,7 @@ - По умолчанию: `'manifest.json'` - Путь к манифесту приложения. + Путь к манифесту приложения. Если в качестве пути указан URL, то плагин не будет во время сборки генерировать manifest.json в каталоге dist. - **pwa.manifestOptions** From f656fdbdea1ade2196174818e8bc7d0abd6eae94 Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Tue, 3 Mar 2020 00:27:38 +0300 Subject: [PATCH 07/35] docs: (ru) browser-compatibility.md fix import --- docs/ru/guide/browser-compatibility.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ru/guide/browser-compatibility.md b/docs/ru/guide/browser-compatibility.md index 0a57cbb427..e5a220eab3 100644 --- a/docs/ru/guide/browser-compatibility.md +++ b/docs/ru/guide/browser-compatibility.md @@ -38,7 +38,7 @@ Рекомендуется добавлять полифилы таким образом, а не напрямую импортировать их в коде, потому что полифилы перечисленные здесь, могут быть автоматически исключены, если целевым браузерам, указанным в `browserslist`, они не нужны. ::: -3. **Если зависимость предоставляет ES5 код, но использует возможности ES6+ без явного перечисления необходимых полифилов (например, Vuetify):** Используйте `useBuiltIns: 'entry'` и затем добавьте `import '@babel/polyfill'` в файл точки входа. Это будет импортировать **ВСЕ** полифилы на основе целей, перечисленных в `browserslist`, так что вам больше не нужно будет беспокоиться о полифилах для зависимостей, но это скорее всего увеличит размер финальной сборки некоторыми неиспользуемыми полифилами. +3. **Если зависимость предоставляет ES5 код, но использует возможности ES6+ без явного перечисления необходимых полифилов (например, Vuetify):** Используйте `useBuiltIns: 'entry'` и затем добавьте `import 'core-js/stable'; import 'regenerator-runtime/runtime';` в файл точки входа. Это будет импортировать **ВСЕ** полифилы на основе целей, перечисленных в `browserslist`, так что вам больше не нужно будет беспокоиться о полифилах для зависимостей, но это скорее всего увеличит размер финальной сборки некоторыми неиспользуемыми полифилами. Подробнее можно изучить в [документации @babel-preset/env](https://new.babeljs.io/docs/en/next/babel-preset-env.html#usebuiltins-usage). From c5a57b45174af872f409156d9de0c47444749bc5 Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Tue, 3 Mar 2020 00:27:57 +0300 Subject: [PATCH 08/35] docs: (ru) deployment.md fix example --- docs/ru/guide/deployment.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ru/guide/deployment.md b/docs/ru/guide/deployment.md index 177a9a8f26..80b6ed91c4 100644 --- a/docs/ru/guide/deployment.md +++ b/docs/ru/guide/deployment.md @@ -89,7 +89,7 @@ serve -s dist 3. Сгенерируйте [токен доступа](https://help.github.com/en/articles/creating-a-personal-access-token-for-the-command-line) на GitHub с правами доступа к репозиторию. -4. Разрешите доступ Travis к репозиторию: `travis set GITHUB_TOKEN=xxx` (`xxx` — это персональный токен доступа из шага 3.) +4. Разрешите доступ Travis к репозиторию: `travis env set GITHUB_TOKEN xxx` (`xxx` — это персональный токен доступа из шага 3.) 5. Создайте файл `.travis.yml` в корневом каталоге проекта. From f935e809cfbf6222dc8bc2c0018be324d1676eec Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Tue, 3 Mar 2020 00:30:31 +0300 Subject: [PATCH 09/35] docs: (ru) installation.md update --- docs/ru/guide/installation.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/docs/ru/guide/installation.md b/docs/ru/guide/installation.md index 980b126f69..50fafe4621 100644 --- a/docs/ru/guide/installation.md +++ b/docs/ru/guide/installation.md @@ -24,3 +24,29 @@ yarn global add @vue/cli ```bash vue --version ``` + +### Обновление + +Для обновления глобального пакета Vue CLI выполните команду: + +``` bash +npm update -g @vue/cli +# ИЛИ +yarn global upgrade --latest @vue/cli +``` + +#### Зависимости проекта + +Команды обновления, показанные выше, только для глобально установленного пакета Vue CLI. Для обновления одного или нескольких пакетов, связанных с `@vue/cli` (включая пакеты, начинающиеся с `@vue/cli-plugin-`) внутри проекта, запустите `vue upgrade` в каталоге проекта: + +``` +Использование: upgrade [options] [plugin-name] +(экспериментально) upgrade vue cli service / plugins +Опции: + -t, --to Обновить до определённой версии + -f, --from Пропустить проверку установленного плагина, предполагая что он будет обновляться с указанной версии + -r, --registry Использовать указанный npm-регистр при установке зависимостей + --all Обновить все плагины + --next Также проверять на наличие alpha / beta / rc версий при обновлении + -h, --help Вывести информацию об использовании команды +``` From 622b2c879c02fb086ac00fdd88b17f192cdae930 Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Sun, 12 Apr 2020 16:00:30 +0300 Subject: [PATCH 10/35] docs: (ru) deployment.md update link --- docs/ru/guide/deployment.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ru/guide/deployment.md b/docs/ru/guide/deployment.md index 80b6ed91c4..a1635a6c62 100644 --- a/docs/ru/guide/deployment.md +++ b/docs/ru/guide/deployment.md @@ -370,7 +370,7 @@ npm install now git push heroku master ``` -Подробная информация: [https://gist.github.com/hone/24b06869b4c1eca701f9](https://gist.github.com/hone/24b06869b4c1eca701f9) +Подробная информация: [Начало работы с SPA на Heroku](https://gist.github.com/hone/24b06869b4c1eca701f9) ### Surge From 311409c631229414aee5141b6497f94799c13637 Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Sun, 12 Apr 2020 16:01:23 +0300 Subject: [PATCH 11/35] docs: (ru) core-plugins/eslint fix --- docs/ru/core-plugins/eslint.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ru/core-plugins/eslint.md b/docs/ru/core-plugins/eslint.md index a96bfb1a34..889967544a 100644 --- a/docs/ru/core-plugins/eslint.md +++ b/docs/ru/core-plugins/eslint.md @@ -17,7 +17,7 @@ --max-warnings количество предупреждений, по достижению которого сборка заканчивается ошибкой (по умолчанию: Infinity) ``` - Проверяет и исправляет файлы. Если конкретные файлы для проверки не указаны, то будут проверяться все файлы в `src` и `test`. + Проверяет и исправляет файлы. Если конкретные файлы для проверки не указаны, то будут проверяться все файлы в `src` и `tests`. Другие [настройки ESLint CLI](https://eslint.org/docs/user-guide/command-line-interface#options) также поддерживаются. From c41cbc1cf5f258b4c2383784d8b746e4f99e02cb Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Mon, 11 May 2020 18:57:31 +0300 Subject: [PATCH 12/35] docs: (ru) pwa.md update --- docs/ru/core-plugins/pwa.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/docs/ru/core-plugins/pwa.md b/docs/ru/core-plugins/pwa.md index f69cab16e1..282967971a 100644 --- a/docs/ru/core-plugins/pwa.md +++ b/docs/ru/core-plugins/pwa.md @@ -81,6 +81,30 @@ - start_url: `'.'` - display: `'standalone'` - theme_color: `pwa.themeColor` + - icons: `[ + { + 'src': './img/icons/android-chrome-192x192.png', + 'sizes': '192x192', + 'type': 'image/png' + }, + { + 'src': './img/icons/android-chrome-512x512.png', + 'sizes': '512x512', + 'type': 'image/png' + }, + { + 'src': './img/icons/android-chrome-maskable-192x192.png', + 'sizes': '192x192', + 'type': 'image/png', + 'purpose': 'maskable' + }, + { + 'src': './img/icons/android-chrome-maskable-512x512.png', + 'sizes': '512x512', + 'type': 'image/png', + 'purpose': 'maskable' + } + ]` - **pwa.iconPaths** @@ -98,6 +122,8 @@ Измените эти значения при необходимости использовать различные пути для иконок. + *ПРИМЕЧАНИЕ:* Эти иконки используются только для генерации мета-тегов в `` HTML-документа. Для изменения пути к иконкам в манифесте используйте `pwa.manifestOptions.icons` + ### Пример конфигурации ```js From c8847700d573459e25e23fa87e32bc58198f5529 Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Sat, 13 Jun 2020 10:31:35 +0300 Subject: [PATCH 13/35] docs(ru): plugin-dev.md fix link --- docs/ru/dev-guide/plugin-dev.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ru/dev-guide/plugin-dev.md b/docs/ru/dev-guide/plugin-dev.md index 191e7ddb27..912598697e 100644 --- a/docs/ru/dev-guide/plugin-dev.md +++ b/docs/ru/dev-guide/plugin-dev.md @@ -859,7 +859,7 @@ module.exports = [ ## Публикация плагина в npm -Для публикации плагина необходимо быть зарегистрированным на [npmjs.com](npmjs.com) и глобально установить `npm`. Если публикуете ваш первый npm-модуль, то сначала запустите команду: +Для публикации плагина необходимо быть зарегистрированным на [npmjs.com](https://www.npmjs.com) и глобально установить `npm`. Если публикуете ваш первый npm-модуль, то сначала запустите команду: ```bash npm login From 751f25c5549967d541fcf919a38c284ba5ae64f4 Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Sat, 13 Jun 2020 10:31:50 +0300 Subject: [PATCH 14/35] docs(ru): cli-service.md update --- docs/ru/guide/cli-service.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ru/guide/cli-service.md b/docs/ru/guide/cli-service.md index 92466cf76a..35eeea09e5 100644 --- a/docs/ru/guide/cli-service.md +++ b/docs/ru/guide/cli-service.md @@ -62,7 +62,7 @@ npx vue-cli-service serve Кроме флагов командной строки, также можно настраивать сервер для разработки с помощью поля [devServer](../config/#devserver) в файле `vue.config.js`. -В команде CLI `[entry]` означает *входной файл*, а не *дополнительный входной файл*. Если вы перезапишете запись в CLI, тогда записи из `config.pages` больше не будут учитываться, что может привести к ошибке. По умолчанию [entryFile](../dev-guide/generator-api.html#entryfile). +В команде CLI `[entry]` означает *входной файл* (по умолчанию: `src/main.js` или `src/main.ts` в проектах с TypeScript), а не *дополнительный входной файл*. Если вы перезапишете запись в CLI, тогда записи из `config.pages` больше не будут учитываться, что может привести к ошибке. ## vue-cli-service build From 7c256a190bda75bbf5608ce855e5fb6b5a8d3591 Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Sat, 13 Jun 2020 10:35:32 +0300 Subject: [PATCH 15/35] docs(ru): pwa.md update --- docs/ru/core-plugins/pwa.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/ru/core-plugins/pwa.md b/docs/ru/core-plugins/pwa.md index 282967971a..70fe8e46e5 100644 --- a/docs/ru/core-plugins/pwa.md +++ b/docs/ru/core-plugins/pwa.md @@ -106,6 +106,12 @@ } ]` +- **pwa.manifestCrossorigin** + + - По умолчанию:: `undefined` + + Значение атрибута `crossorigin` в теге ссылки на манифест в сгенерированном HTML. Это значение может потребоваться установить, когда PWA находится за аутентифицированном прокси-сервером. Для более подробной информации смотрите [варианты значений cross-origin](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/link#attr-crossorigin). + - **pwa.iconPaths** - По умолчанию: From 6f6e4332b115779938a3e45db1ceeab19ddbc581 Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Sat, 13 Jun 2020 10:37:08 +0300 Subject: [PATCH 16/35] docs(ru): pwa.md update --- docs/ru/core-plugins/pwa.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ru/core-plugins/pwa.md b/docs/ru/core-plugins/pwa.md index 70fe8e46e5..1238c43672 100644 --- a/docs/ru/core-plugins/pwa.md +++ b/docs/ru/core-plugins/pwa.md @@ -126,7 +126,7 @@ } ``` - Измените эти значения при необходимости использовать различные пути для иконок. + Измените эти значения при необходимости использовать различные пути для иконок. Начиная с версии 4.3.0, можно указывать `null` в качестве значения, чтобы не включать эту иконку. *ПРИМЕЧАНИЕ:* Эти иконки используются только для генерации мета-тегов в `` HTML-документа. Для изменения пути к иконкам в манифесте используйте `pwa.manifestOptions.icons` From c0cbe2bf73b28011458cfbee7123a6515488f239 Mon Sep 17 00:00:00 2001 From: Alexander Sokolov Date: Sat, 13 Jun 2020 12:16:32 +0300 Subject: [PATCH 17/35] Update docs/ru/core-plugins/pwa.md Co-authored-by: Natalia Tepluhina --- docs/ru/core-plugins/pwa.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ru/core-plugins/pwa.md b/docs/ru/core-plugins/pwa.md index 1238c43672..8acdc3907b 100644 --- a/docs/ru/core-plugins/pwa.md +++ b/docs/ru/core-plugins/pwa.md @@ -108,7 +108,7 @@ - **pwa.manifestCrossorigin** - - По умолчанию:: `undefined` + - По умолчанию: `undefined` Значение атрибута `crossorigin` в теге ссылки на манифест в сгенерированном HTML. Это значение может потребоваться установить, когда PWA находится за аутентифицированном прокси-сервером. Для более подробной информации смотрите [варианты значений cross-origin](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/link#attr-crossorigin). From 49ddfa29f38494baaa4dd520b11cde24758c651e Mon Sep 17 00:00:00 2001 From: Alexander Sokolov Date: Sat, 13 Jun 2020 12:16:42 +0300 Subject: [PATCH 18/35] Update docs/ru/core-plugins/pwa.md Co-authored-by: Natalia Tepluhina --- docs/ru/core-plugins/pwa.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ru/core-plugins/pwa.md b/docs/ru/core-plugins/pwa.md index 8acdc3907b..e278c155f5 100644 --- a/docs/ru/core-plugins/pwa.md +++ b/docs/ru/core-plugins/pwa.md @@ -110,7 +110,7 @@ - По умолчанию: `undefined` - Значение атрибута `crossorigin` в теге ссылки на манифест в сгенерированном HTML. Это значение может потребоваться установить, когда PWA находится за аутентифицированном прокси-сервером. Для более подробной информации смотрите [варианты значений cross-origin](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/link#attr-crossorigin). + Значение атрибута `crossorigin` в теге ссылки на манифест в сгенерированном HTML. Это значение может потребоваться установить, когда PWA находится за аутентифицированным прокси-сервером. Для более подробной информации смотрите [варианты значений cross-origin](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/link#attr-crossorigin). - **pwa.iconPaths** From 7ff461eccf21a19b5e4ea851e8363cc65d1d60a2 Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Sat, 8 Aug 2020 14:35:08 +0300 Subject: [PATCH 19/35] docs: (ru) eslint.md update --- docs/ru/core-plugins/eslint.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/ru/core-plugins/eslint.md b/docs/ru/core-plugins/eslint.md index 889967544a..0cc2566019 100644 --- a/docs/ru/core-plugins/eslint.md +++ b/docs/ru/core-plugins/eslint.md @@ -23,7 +23,11 @@ ## Конфигурация -ESLint можно настраивать через `.eslintrc` или поле `eslintConfig` в файле `package.json`. +ESLint можно настраивать через `.eslintrc` или поле `eslintConfig` в файле `package.json`. Подробнее см. в [документации конфигурации ESLint](https://eslint.org/docs/user-guide/configuring). + +::: tip СОВЕТ +Следующая опция находится в разделе [`vue.config.js`](../config/README.md#vue-config-js). Это соблюдается только при установке `@vue/cli-plugin-eslint`. +::: Линтинг при сохранении (Lint-on-save) при разработке с помощью `eslint-loader` включён по умолчанию. Это можно отключить с помощью опции `lintOnSave` в файле `vue.config.js`: From 5b1f3790c115c29c40bcf244d2c38c962ab04281 Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Sat, 8 Aug 2020 14:37:31 +0300 Subject: [PATCH 20/35] docs: (ru) deployment.md --- docs/ru/guide/deployment.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ru/guide/deployment.md b/docs/ru/guide/deployment.md index 5321bbcf85..264c19b879 100644 --- a/docs/ru/guide/deployment.md +++ b/docs/ru/guide/deployment.md @@ -255,7 +255,7 @@ firebase deploy --only hosting Если вы хотите использовать другие возможности Firebase CLI, которые вы используете в своём проекте для публикации, запустите `firebase deploy` без опции `--only`. -Теперь можно открыть проект по адресу `https://.firebaseapp.com`. +Теперь можно открыть проект по адресу `https://.firebaseapp.com` или `https://.web.app`. Обратитесь к [документации Firebase](https://firebase.google.com/docs/hosting/deploying) для получения более подробной информации. From 7735519d3a64ba2124407e3d8bd5a6a2df249029 Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Sat, 8 Aug 2020 14:43:58 +0300 Subject: [PATCH 21/35] docs: (ru) update plugins menu --- docs/.vuepress/config.js | 49 +++++++++++++++++++++++++++++++--------- 1 file changed, 38 insertions(+), 11 deletions(-) diff --git a/docs/.vuepress/config.js b/docs/.vuepress/config.js index dc70466902..c594b83f8f 100644 --- a/docs/.vuepress/config.js +++ b/docs/.vuepress/config.js @@ -288,20 +288,47 @@ module.exports = { text: 'Конфигурация', link: '/ru/config/' }, - { - text: 'Создание плагинов', - items: [ - { text: 'Руководство по разработке', link: '/ru/dev-guide/plugin-dev.md' }, - { text: 'Информация о плагине в UI', link: '/ru/dev-guide/ui-info.md' }, - { text: 'API плагина в UI', link: '/ru/dev-guide/ui-api.md' }, - { text: 'Локализация в UI', link: '/ru/dev-guide/ui-localization.md' } - ] - }, { text: 'Плагины', items: [ - { text: 'Основные плагины', link: '/ru/core-plugins/' }, - { text: 'Просмотр плагинов', link: 'https://awesomejs.dev/for/vue-cli/' } + { + text: 'Конфигурация', + items: + [ + { text: 'Основные плагины', link: '/ru/core-plugins/' }, + ] + }, + { + text: 'Поиск', + items: + [ + { text: 'Обзор плагинов', link: 'https://awesomejs.dev/for/vue-cli/' } + ] + }, + { + text: 'Разработка', + items: + [ + { text: 'Руководство по разработке', link: '/ru/dev-guide/plugin-dev.md' }, + ] + }, + { + text: 'API', + items: + [ + { text: 'Плагин', link: '/ru/dev-guide/plugin-api.md' }, + { text: 'Генератор', link: '/ru/dev-guide/generator-api.md' }, + ] + }, + { + text: 'UI', + items: + [ + { text: 'Информация о плагине', link: '/ru/dev-guide/ui-info.md' }, + { text: 'API', link: '/ru/dev-guide/ui-api.md' }, + { text: 'Локализация', link: '/ru/dev-guide/ui-localization.md' } + ] + }, ] }, { From 2fc609960b8aad1bb40dfff47f0e95ffb2efb1ba Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Sat, 8 Aug 2020 14:58:11 +0300 Subject: [PATCH 22/35] docs: (ru) added WebdriverIO --- docs/.vuepress/config.js | 3 +- docs/ru/config/README.md | 5 ++ docs/ru/core-plugins/README.md | 1 + docs/ru/core-plugins/e2e-webdriverio.md | 77 +++++++++++++++++++++++++ 4 files changed, 85 insertions(+), 1 deletion(-) create mode 100644 docs/ru/core-plugins/e2e-webdriverio.md diff --git a/docs/.vuepress/config.js b/docs/.vuepress/config.js index c594b83f8f..1a46784a78 100644 --- a/docs/.vuepress/config.js +++ b/docs/.vuepress/config.js @@ -400,7 +400,8 @@ module.exports = { '/ru/core-plugins/unit-jest.md', '/ru/core-plugins/unit-mocha.md', '/ru/core-plugins/e2e-cypress.md', - '/ru/core-plugins/e2e-nightwatch.md' + '/ru/core-plugins/e2e-nightwatch.md', + '/ru/core-plugins/e2e-webdriverio.md', ] }] } diff --git a/docs/ru/config/README.md b/docs/ru/config/README.md index a616a91332..16b7e7b835 100644 --- a/docs/ru/config/README.md +++ b/docs/ru/config/README.md @@ -446,3 +446,8 @@ TypeScript можно настроить через `tsconfig.json`. ### Nightwatch Подробнее на странице плагина [@vue/cli-plugin-e2e-nightwatch](https://github.com/vuejs/vue-cli/tree/dev/packages/%40vue/cli-plugin-e2e-nightwatch). + + +### WebdriverIO + +Подробнее на странице плагина [@vue/cli-plugin-e2e-webdriverio](https://github.com/vuejs/vue-cli/tree/dev/packages/%40vue/cli-plugin-e2e-webdriverio). diff --git a/docs/ru/core-plugins/README.md b/docs/ru/core-plugins/README.md index 5e4a27c30f..27ee42fb3b 100644 --- a/docs/ru/core-plugins/README.md +++ b/docs/ru/core-plugins/README.md @@ -12,3 +12,4 @@ Vue CLI использует архитектуру на основе плаги - [Mocha](unit-mocha.md) - [Cypress](e2e-cypress.md) - [Nightwatch](e2e-nightwatch.md) +- [WebdriverIO](e2e-webdriverio.md) diff --git a/docs/ru/core-plugins/e2e-webdriverio.md b/docs/ru/core-plugins/e2e-webdriverio.md new file mode 100644 index 0000000000..81cf2cf030 --- /dev/null +++ b/docs/ru/core-plugins/e2e-webdriverio.md @@ -0,0 +1,77 @@ +# @vue/cli-plugin-e2e-webdriverio + +> e2e-webdriverio plugin for vue-cli + +## Внедряемые команды + +- **`vue-cli-service test:e2e`** + + Запуск E2E тестов с помощью [WebdriverIO](https://webdriver.io/). + + Опции: + + ``` + --remote Запустить тесты удалённо на SauceLabs + ``` + + Поддерживаются все [опции WebdriverIO CLI](https://webdriver.io/docs/clioptions.html). Например: `--baseUrl`, `--bail` и т.д. + + +## Структура проекта + +При установке плагина генерируется следующая структура каталогов: + +``` +tests/e2e/ + ├── pageobjects/ + | └── app.page.js + ├── specs/ + | ├── app.spec.js + └── .eslintrc.js +``` + +Кроме того будут сгенерированы 3 конфигурационных файла: + +- `wdio.shared.conf.js`: общая конфигурация со всеми опциями, определёнными для всех окружений +- `wdio.local.conf.js`: конфигурация для локального тестирования +- `wdio.sauce.conf.js`: конфигурация для удалённого тестирования в облачном провайдере, таком как [Sauce Labs](https://saucelabs.com/) + +Каталоги содержат: + +#### `pageobjects` +Содержит пример для объекта страницы. Подробнее об использовании [PageObjects](https://webdriver.io/docs/pageobjects.html) в WebdriverIO. + +#### `specs` +Файлы e2e тестов. + +## Установка в уже созданный проект + +``` sh +vue add e2e-webdriverio +``` + +Для пользователей со старыми версиями CLI потребуется выполнить `vue add @vue/e2e-webdriverio`. + +## Запуск тестов + +По умолчанию все тесты в каталоге `specs` будут запущены с помощью Chrome. Если необходимо запустить end-to-end тесты в Chrome (или Firefox) в безголовом режим следует передать аргумент `--headless`. Тесты будут автоматически запускаться параллельно при выполнении в облаке. + +```sh +$ vue-cli-service test:e2e +``` + +**Запуск одного теста** + +Для запуска одного теста укажите путь к файлу. Например: + +```sh +$ vue-cli-service test:e2e --spec tests/e2e/specs/test.js +``` + +**Пропустить автоматический запуск сервера разработки** + +Если сервер разработки уже запущен и необходимо пропустить автоматический запуск, укажите аргумент `--url`: + +```sh +$ vue-cli-service test:e2e --baseUrl=http://localhost:8080/ +``` From 46a7f1af726eda4e67a6c217995553fa55fbc333 Mon Sep 17 00:00:00 2001 From: Alexander Sokolov Date: Sun, 9 Aug 2020 00:05:33 +0300 Subject: [PATCH 23/35] Update docs/ru/core-plugins/e2e-webdriverio.md Co-authored-by: Natalia Tepluhina --- docs/ru/core-plugins/e2e-webdriverio.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ru/core-plugins/e2e-webdriverio.md b/docs/ru/core-plugins/e2e-webdriverio.md index 81cf2cf030..e8084dd120 100644 --- a/docs/ru/core-plugins/e2e-webdriverio.md +++ b/docs/ru/core-plugins/e2e-webdriverio.md @@ -54,7 +54,7 @@ vue add e2e-webdriverio ## Запуск тестов -По умолчанию все тесты в каталоге `specs` будут запущены с помощью Chrome. Если необходимо запустить end-to-end тесты в Chrome (или Firefox) в безголовом режим следует передать аргумент `--headless`. Тесты будут автоматически запускаться параллельно при выполнении в облаке. +По умолчанию все тесты в каталоге `specs` будут запущены с помощью Chrome. Если необходимо запустить end-to-end тесты в Chrome (или Firefox) в безголовом режиме следует передать аргумент `--headless`. Тесты будут автоматически запускаться параллельно при выполнении в облаке. ```sh $ vue-cli-service test:e2e From e232529cb835295eb40827b1f11de1dd627eb5af Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Sat, 24 Oct 2020 22:01:04 +0300 Subject: [PATCH 24/35] docs(ru): added tips for parallel option --- docs/ru/config/README.md | 4 ++++ docs/ru/core-plugins/babel.md | 2 ++ docs/ru/core-plugins/typescript.md | 2 ++ 3 files changed, 8 insertions(+) diff --git a/docs/ru/config/README.md b/docs/ru/config/README.md index 16b7e7b835..2f31f0dd49 100644 --- a/docs/ru/config/README.md +++ b/docs/ru/config/README.md @@ -380,6 +380,10 @@ module.exports = { Использовать ли `thread-loader` для транспиляции Babel или TypeScript. Включается для production-сборок, когда система имеет более 1 процессорных ядер. Указание числа определит количество задействованных воркеров (workers). +::: warning Внимание +Не используйте `parallel` в комбинации с не-сериализуемыми опциями загрузчика, такими как регулярные выражения, даты и функции. Такие опции не будут корректно переданы соответствующим загрузчикам, что может привести к неожиданным ошибкам. +::: + ### pwa - Тип: `Object` diff --git a/docs/ru/core-plugins/babel.md b/docs/ru/core-plugins/babel.md index 0182ee71c7..f231c68f15 100644 --- a/docs/ru/core-plugins/babel.md +++ b/docs/ru/core-plugins/babel.md @@ -26,6 +26,8 @@ module.exports = { [thread-loader](https://github.com/webpack-contrib/thread-loader) используется по умолчанию, если машина имеет более 1 ядра CPU. Это можно отключить указав `parallel: false` в файле `vue.config.js`. +Опция `parallel` должна быть установлена в `false` при использовании Babel в комбинации с не-сериализуемыми опциями загрузчика, таким как регулярные выражения, даты и функции. Такие опции не будут корректно переданы в `babel-loader`, что может привести к неожиданным ошибкам. + ## Установка в уже созданный проект ```sh diff --git a/docs/ru/core-plugins/typescript.md b/docs/ru/core-plugins/typescript.md index 5ce2c61e8c..b5c9c47a07 100644 --- a/docs/ru/core-plugins/typescript.md +++ b/docs/ru/core-plugins/typescript.md @@ -24,6 +24,8 @@ TypeScript может быть сконфигурирован через `tsconf [thread-loader](https://github.com/webpack-contrib/thread-loader) используется по умолчанию, если машина имеет более 1 ядра CPU. Это можно отключить указав `parallel: false` в файле `vue.config.js`. +Опция `parallel` должна быть установлена в `false` при использовании Typescript в комбинации с не-сериализуемыми опциями загрузчика, таким как регулярные выражения, даты и функции. Такие опции не будут корректно переданы в `ts-loader`, что может привести к неожиданным ошибкам. + ## Установка в уже созданный проект ```sh From d062e6250f59408f4c99395d5751e16862c8a467 Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Sat, 24 Oct 2020 22:01:48 +0300 Subject: [PATCH 25/35] docs(ru): plugin-dev.md update --- docs/ru/dev-guide/plugin-dev.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ru/dev-guide/plugin-dev.md b/docs/ru/dev-guide/plugin-dev.md index 912598697e..5f806869bd 100644 --- a/docs/ru/dev-guide/plugin-dev.md +++ b/docs/ru/dev-guide/plugin-dev.md @@ -289,7 +289,7 @@ module.exports.hooks = (api) => { const renderIndex = lines.findIndex(line => line.match(/render/)) lines[renderIndex] += `${EOL} router,` - fs.writeFileSync(api.entryFile, lines.join(EOL), { encoding: 'utf-8' }) + fs.writeFileSync(api.resolve(api.entryFile), lines.join(EOL), { encoding: 'utf-8' }) }) } ``` From 880677f79785bb7ec2ec829b9508ca8e018d3c29 Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Sat, 24 Oct 2020 22:07:26 +0300 Subject: [PATCH 26/35] docs(ru): installation.md update --- docs/ru/guide/installation.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/docs/ru/guide/installation.md b/docs/ru/guide/installation.md index 50fafe4621..de8f0f8e86 100644 --- a/docs/ru/guide/installation.md +++ b/docs/ru/guide/installation.md @@ -6,7 +6,11 @@ ::: ::: tip Требования к версии Node -Vue CLI требуется [Node.js](https://nodejs.org/) версии 8.9 или выше (рекомендуется 8.11.0+). Управлять несколькими версиями Node на машине можно с помощью [nvm](https://github.com/creationix/nvm) или [nvm-windows](https://github.com/coreybutler/nvm-windows). +Vue CLI 4.x требуется [Node.js](https://nodejs.org/) версии 8.9 или выше (рекомендуется v10+). Управлять несколькими версиями Node на машине можно через [n](https://github.com/tj/n), [nvm](https://github.com/creationix/nvm) или [nvm-windows](https://github.com/coreybutler/nvm-windows). + +Так как Node.js v8 достигла конца периода поддержки, для лучшей совместимости рекомендуется использовать Node.js v10+. + +Если необходимо остаться на Node.js v8, убедитесь что используете npm v6 в качестве менеджера пакетов по умолчанию. (`npm -v` для проверки версии и `vue config --set packageManager npm` для установки менеджера пакетов по умолчанию.) ::: Для установки нового пакета используйте одну из следующих команд. Для их выполнения потребуются права администратора, если только npm не был установлен в системе через менеджер версий Node.js (например, n или nvm). @@ -37,13 +41,13 @@ yarn global upgrade --latest @vue/cli #### Зависимости проекта -Команды обновления, показанные выше, только для глобально установленного пакета Vue CLI. Для обновления одного или нескольких пакетов, связанных с `@vue/cli` (включая пакеты, начинающиеся с `@vue/cli-plugin-`) внутри проекта, запустите `vue upgrade` в каталоге проекта: +Команды обновления, показанные выше, только для глобально установленного пакета Vue CLI. Для обновления одного или нескольких пакетов, связанных с `@vue/cli` (включая пакеты, начинающиеся с `@vue/cli-plugin-` или `vue-cli-plugin-`) внутри проекта, запустите `vue upgrade` в каталоге проекта: ``` Использование: upgrade [options] [plugin-name] (экспериментально) upgrade vue cli service / plugins Опции: - -t, --to Обновить до определённой версии + -t, --to Обновить до определённой версии -f, --from Пропустить проверку установленного плагина, предполагая что он будет обновляться с указанной версии -r, --registry Использовать указанный npm-регистр при установке зависимостей --all Обновить все плагины From fd6172edad6fe5ee8e37ac20a7937c8d17b6879c Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Sat, 24 Oct 2020 22:09:30 +0300 Subject: [PATCH 27/35] docs(ru): consistent code blocks --- docs/ru/core-plugins/e2e-webdriverio.md | 2 +- docs/ru/guide/installation.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/ru/core-plugins/e2e-webdriverio.md b/docs/ru/core-plugins/e2e-webdriverio.md index e8084dd120..ff6b169eac 100644 --- a/docs/ru/core-plugins/e2e-webdriverio.md +++ b/docs/ru/core-plugins/e2e-webdriverio.md @@ -46,7 +46,7 @@ tests/e2e/ ## Установка в уже созданный проект -``` sh +```sh vue add e2e-webdriverio ``` diff --git a/docs/ru/guide/installation.md b/docs/ru/guide/installation.md index de8f0f8e86..871be3b417 100644 --- a/docs/ru/guide/installation.md +++ b/docs/ru/guide/installation.md @@ -33,7 +33,7 @@ vue --version Для обновления глобального пакета Vue CLI выполните команду: -``` bash +```bash npm update -g @vue/cli # ИЛИ yarn global upgrade --latest @vue/cli From fe0883da2690f7c88138dfead3eaf46e918a1a74 Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Sat, 24 Oct 2020 22:09:41 +0300 Subject: [PATCH 28/35] docs(ru): deployment.md update --- docs/ru/guide/deployment.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/ru/guide/deployment.md b/docs/ru/guide/deployment.md index 264c19b879..f514bebd82 100644 --- a/docs/ru/guide/deployment.md +++ b/docs/ru/guide/deployment.md @@ -44,6 +44,8 @@ serve -s dist Если вы публикуете по адресу `https://.github.io//`, (т.е. ваш репозиторий находится по адресу `https://github.com//`), установите `publicPath` в значение `"//"`. Например, если ваш репозиторий называется "my-project", то ваш `vue.config.js` будет выглядеть примерно так: ```js + // файл vue.config.js должен быть расположен в корневом каталоге проекта + module.exports = { publicPath: process.env.NODE_ENV === 'production' ? '/my-project/' From 14870c2acbd418ce34668da24115339c6bf5adde Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Sat, 24 Oct 2020 22:11:18 +0300 Subject: [PATCH 29/35] docs(ru): deployment.md change now to vercel --- docs/ru/guide/deployment.md | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/ru/guide/deployment.md b/docs/ru/guide/deployment.md index f514bebd82..28b123b2be 100644 --- a/docs/ru/guide/deployment.md +++ b/docs/ru/guide/deployment.md @@ -261,20 +261,20 @@ firebase deploy --only hosting Обратитесь к [документации Firebase](https://firebase.google.com/docs/hosting/deploying) для получения более подробной информации. -### Now +### Vercel -В данном примере используется последняя версия платформы Now версии 2. +В данном примере используется последняя версия платформы Vercel версии 2. -1. Установите Now CLI: +1. Установите Vercel CLI: ```bash -npm install -g now +npm install -g vercel # Или если предпочитаете локальную установку -npm install now +npm install vercel ``` -2. Добавьте файл `now.json` в корневой каталог проекта: +2. Добавьте файл `vercel.json` в корневой каталог проекта: ```json { @@ -283,7 +283,7 @@ npm install now "builds": [ { "src": "package.json", - "use": "@now/static-build" + "use": "@vercel/static-build" } ], "routes": [ @@ -316,24 +316,24 @@ npm install now ```diff - { - "src": "package.json", - - "use": "@now/static-build" + - "use": "@vercel/static-build" - } + { + "src": "package.json", - + "use": "@now/static-build", + + "use": "@vercel/static-build", + "config": { "distDir": "build" } + } ``` -3. Добавьте `now-build` скрипт для публикации в `package.json`: +3. Добавьте `vercel-build` скрипт для публикации в `package.json`: ```json - "now-build": "npm run build" + "vercel-build": "npm run build" ``` - Для публикации запустите `now`. + Для публикации запустите `vercel`. - Если необходим псевдоним публикации, запустите `now --target production`. + Если необходим псевдоним публикации, запустите `vercel --target production`. ### Stdlib From cbe34ab32709bbe53fc6064c9871c92dcd7e46a3 Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Sat, 24 Oct 2020 22:12:16 +0300 Subject: [PATCH 30/35] docs(ru): plugins-and-presets.md update --- docs/ru/guide/plugins-and-presets.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ru/guide/plugins-and-presets.md b/docs/ru/guide/plugins-and-presets.md index 6d8d2ee2a1..425f089dca 100644 --- a/docs/ru/guide/plugins-and-presets.md +++ b/docs/ru/guide/plugins-and-presets.md @@ -192,7 +192,7 @@ GitLab и BitBucket также поддерживаются. Убедитесь, vue create --preset gitlab:username/repo --clone my-project vue create --preset bitbucket:username/repo --clone my-project -# self-hosted repos +# репозитории на собственном хостинге vue create --preset gitlab:my-gitlab-server.com:group/projectname --clone my-project vue create --preset direct:ssh://git@my-gitlab-server.com/group/projectname.git --clone my-project ``` From c251cc55f495b67cfd6d4b89ca964618f3da06bf Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Sat, 24 Oct 2020 22:20:55 +0300 Subject: [PATCH 31/35] docs(ru): installation.md update --- docs/ru/guide/installation.md | 4 ---- 1 file changed, 4 deletions(-) diff --git a/docs/ru/guide/installation.md b/docs/ru/guide/installation.md index 871be3b417..90150989dd 100644 --- a/docs/ru/guide/installation.md +++ b/docs/ru/guide/installation.md @@ -7,10 +7,6 @@ ::: tip Требования к версии Node Vue CLI 4.x требуется [Node.js](https://nodejs.org/) версии 8.9 или выше (рекомендуется v10+). Управлять несколькими версиями Node на машине можно через [n](https://github.com/tj/n), [nvm](https://github.com/creationix/nvm) или [nvm-windows](https://github.com/coreybutler/nvm-windows). - -Так как Node.js v8 достигла конца периода поддержки, для лучшей совместимости рекомендуется использовать Node.js v10+. - -Если необходимо остаться на Node.js v8, убедитесь что используете npm v6 в качестве менеджера пакетов по умолчанию. (`npm -v` для проверки версии и `vue config --set packageManager npm` для установки менеджера пакетов по умолчанию.) ::: Для установки нового пакета используйте одну из следующих команд. Для их выполнения потребуются права администратора, если только npm не был установлен в системе через менеджер версий Node.js (например, n или nvm). From 139428b2275bd01dd702a075fe0e9710f7f3eaad Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Sat, 24 Oct 2020 22:25:00 +0300 Subject: [PATCH 32/35] docs(ru): deployment.md update --- docs/ru/guide/deployment.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/docs/ru/guide/deployment.md b/docs/ru/guide/deployment.md index 28b123b2be..9c049b2038 100644 --- a/docs/ru/guide/deployment.md +++ b/docs/ru/guide/deployment.md @@ -172,6 +172,24 @@ module.exports = { Подробнее можно изучить в [документации Netlify по перенаправлениям](https://www.netlify.com/docs/redirects/#history-pushstate-and-single-page-apps). +При использовании [@vue/cli-plugin-pwa](../core-plugins/pwa.md#vue-cli-plugin-pwa) убедитесь, что файл `_redirects` не кэшируется service worker. + +Для этого добавьте в `vue.config.js` следующее: + +```js +// файл vue.config.js должен быть расположен в корневом каталоге проекта + +module.exports = { + pwa: { + workboxOptions: { + exclude: [/_redirects/] + } + } +} +``` + +Подробнее об опциях [workboxOptions](../core-plugins/pwa.md#configuration) и [exclude](https://developers.google.com/web/tools/workbox/reference-docs/latest/module-workbox-webpack-plugin.InjectManifest#InjectManifest). + ### Render [Render](https://render.com) предлагает [бесплатный хостинг статических сайтов](https://render.com/docs/static-sites) с полностью управляемым SSL, глобальным CDN и непрерывным автоматическим развёртыванием из GitHub. From 82dd915edaac892f0271bfa7cc578757909545ab Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Sat, 24 Oct 2020 22:28:52 +0300 Subject: [PATCH 33/35] docs(ru): webpack.md update --- docs/ru/guide/webpack.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/ru/guide/webpack.md b/docs/ru/guide/webpack.md index 8811953aa7..9bf7d96d95 100644 --- a/docs/ru/guide/webpack.md +++ b/docs/ru/guide/webpack.md @@ -161,6 +161,12 @@ module.exports = { vue inspect > output.js ``` +По умолчанию команда `inspect` показывает конфигурацию для разработки. Для отображения конфигурации для production необходимо запустить: + +```bash +vue inspect --mode production > output.prod.js +``` + Обратите внимание, что вывод не является файлом рабочей конфигурации webpack, это только сериализованный формат предназначенный для проверки. Вы также можете указать подмножество конфигурации для проверки, указав путь: From 021948ce7c00fe2d43b47cb2db5552595c23231e Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Sat, 24 Oct 2020 22:47:27 +0300 Subject: [PATCH 34/35] docs(ru): deployment.md update --- docs/ru/guide/deployment.md | 81 ++++++++++--------------------------- 1 file changed, 21 insertions(+), 60 deletions(-) diff --git a/docs/ru/guide/deployment.md b/docs/ru/guide/deployment.md index 9c049b2038..ca4d532324 100644 --- a/docs/ru/guide/deployment.md +++ b/docs/ru/guide/deployment.md @@ -281,77 +281,38 @@ firebase deploy --only hosting ### Vercel -В данном примере используется последняя версия платформы Vercel версии 2. +[Vercel](https://vercel.com/home) — облачная платформа, позволяющая разработчикам хостить Jamstack веб-сайты и веб-сервисы, которые публикуются мгновенно, автоматически масштабируются и не требуют никакого контроля, всё это с zero-конфигурацией. Они обеспечивают глобальный доступ, SSL-шифрование, сжатие ресурсов, инвалидацию кэша и многое другое. -1. Установите Vercel CLI: +#### Шаг 1: Публикация проекта Vue на Vercel -```bash -npm install -g vercel +Для публикации проекта Vue с помощью [Vercel для интеграции с Git](https://vercel.com/docs/git-integrations), убедитесь, что он был выложен в Git-репозиторий. -# Или если предпочитаете локальную установку -npm install vercel -``` +Импортируйте проект в Vercel с помощью [Import Flow](https://vercel.com/import/git). Во время импорта будут запрошены все соответствующие [опции](https://vercel.com/docs/build-step#build-&-development-settings), предварительно сконфигурированные, но с возможностью изменения при необходимости. -2. Добавьте файл `vercel.json` в корневой каталог проекта: +После импорта проекта, все последующие push в ветку будут генерировать [публикации для предпросмотра](https://vercel.com/docs/platform/deployments#preview), а все изменения внесённые в [ветку Production](https://vercel.com/docs/git-integrations#production-branch) (обычно "master" или "main") будут приводить к [публикации Production](https://vercel.com/docs/platform/deployments#production). - ```json - { - "name": "my-example-app", - "version": 2, - "builds": [ - { - "src": "package.json", - "use": "@vercel/static-build" - } - ], - "routes": [ - { - "src": "/(js|css|img)/.*", - "headers": { "cache-control": "max-age=31536000, immutable" } - }, - { "handle": "filesystem" }, - { "src": ".*", "dest": "/" } - ], - "alias": "example.com" - } - ``` +После публикации вы получите URL-адрес для просмотра приложения вживую, например: https://vue-example-tawny.vercel.app/. - Если у вас есть другие/дополнительные каталоги, измените маршрут соответствующим образом: - - ```diff - - { - - "src": "/(js|css|img)/.*", - - "headers": { "cache-control": "max-age=31536000, immutable" } - - } - + { - + "src": "/(js|css|img|fonts|media)/.*", - + "headers": { "cache-control": "max-age=31536000, immutable" } - + } - ``` +#### Шаг 2 (опционально): Использование пользовательского домена - Когда значение `outputDir` вместо стандартного `dist` указано `build`: - - ```diff - - { - - "src": "package.json", - - "use": "@vercel/static-build" - - } - + { - + "src": "package.json", - + "use": "@vercel/static-build", - + "config": { "distDir": "build" } - + } - ``` +При необходимости использовать пользовательский домен при публикации Vercel, можно **Добавить** или **Перенаправить** домен через [настройки домена аккаунта](https://vercel.com/dashboard/domains) Vercel. -3. Добавьте `vercel-build` скрипт для публикации в `package.json`: +Для добавления домена в проект, перейдите в раздел [Проект](https://vercel.com/docs/platform/projects) на панели Vercel. После выбора проекта перейдите на вкладку "Настройки", затем выберите пункт меню **Домены**. На странице **Домен** вашего проекта, укажите домен которые хотите использовать в проекте. - ```json - "vercel-build": "npm run build" - ``` +После добавления домена, будут предоставлены различные методы его настройки. + +#### Публикация свежего проекта на Vue + +Для публикации свежего проекта на Vue с настроенным Git-репозиторием, можно с помощью кнопки Deploy ниже: + +[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/import/git?s=https%3A%2F%2Fgithub.com%2Fvercel%2Fvercel%2Ftree%2Fmaster%2Fexamples%2Fvue) - Для публикации запустите `vercel`. +## Ресурсы: - Если необходим псевдоним публикации, запустите `vercel --target production`. +- [Пример исходного кода](https://github.com/vercel/vercel/tree/master/examples/vue) +- [Официальное руководство Vercel](https://vercel.com/guides/deploying-vuejs-to-vercel) +- [Руководство по публикации Vercel](https://vercel.com/docs) +- [Документация по пользовательским доменам Vercel](https://vercel.com/docs/custom-domains) ### Stdlib From f415ef052de4383289b5c048670d11c6ad497e48 Mon Sep 17 00:00:00 2001 From: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> Date: Sat, 24 Oct 2020 22:58:58 +0300 Subject: [PATCH 35/35] docs(ru): mode-and-env.md update --- docs/ru/guide/mode-and-env.md | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/docs/ru/guide/mode-and-env.md b/docs/ru/guide/mode-and-env.md index 424dd48efa..07cf7dfee1 100644 --- a/docs/ru/guide/mode-and-env.md +++ b/docs/ru/guide/mode-and-env.md @@ -43,10 +43,16 @@ vue-cli-service build --mode development ``` FOO=bar -VUE_APP_SECRET=secret +VUE_APP_NOT_SECRET_CODE=some_value ``` -Обратите внимание, что только переменные с префиксом `VUE_APP_` будут статически внедряться в клиентскую сборку с помощью `webpack.DefinePlugin`. +::: warning ВНИМАНИЕ +Не храните никаких секретов (например, приватных ключей API) в приложении! + +Так как переменные окружения внедряются в сборку, то любой желающий сможет увидеть их, изучив файлы сборки приложения. +::: + +Обратите внимание, что только `NODE_ENV`, `BASE_URL` и переменные, именованные с префикса `VUE_APP_`, статически внедрятся в *клиентскую сборку* с помощью `webpack.DefinePlugin`. Это сделано во избежание случайного обнародования закрытого ключа на машине, которая может иметь такое же имя. Подробнее о правилах парсинга env можно узнать [в документации `dotenv`](https://github.com/motdotla/dotenv#rules). Мы также используем [dotenv-expand](https://github.com/motdotla/dotenv-expand) для переменных расширения (доступно в Vue CLI 3.5+). @@ -86,10 +92,10 @@ VUE_APP_TITLE=My App (staging) Можно получить доступ к переменным окружения из кода приложения: ```js -console.log(process.env.VUE_APP_SECRET) +console.log(process.env.VUE_APP_NOT_SECRET_CODE) ``` -На этапе сборки `process.env.VUE_APP_SECRET` будет заменяться соответствующим значением. Когда в файле указано `VUE_APP_SECRET=secret` — после сборки значением будет `"secret"`. +На этапе сборки `process.env.VUE_APP_NOT_SECRET_CODE` будет заменяться соответствующим значением. Когда в файле указано `VUE_APP_NOT_SECRET_CODE=some_value` — после сборки значением будет `"some_value"`. В дополнение к переменным `VUE_APP_*` есть также две специальные переменные, которые всегда доступны в коде приложения: