From 6563bc71a889dedecaf985a1295691f8274eff42 Mon Sep 17 00:00:00 2001 From: Alexander Sokolov Date: Tue, 13 Apr 2021 16:31:15 +0300 Subject: [PATCH] docs: [RU] Translation update (#6417) * docs: (ru) config/readme.md update * docs: (ru) eslint.md update * docs: (ru) cli-service.md update * docs: (ru) css.md update * docs: (ru) mode-and-env.md update * docs: (ru) deployment.md update Co-authored-by: Alex Sokolov <4497128+Alex-Sokolov@users.noreply.github.com> --- docs/ru/config/README.md | 12 +++++++++++- docs/ru/core-plugins/eslint.md | 8 ++++++-- docs/ru/guide/cli-service.md | 11 ++++------- docs/ru/guide/css.md | 9 +++++++++ docs/ru/guide/deployment.md | 28 ++++++++++++++++++++++------ docs/ru/guide/mode-and-env.md | 10 ++++++++-- 6 files changed, 60 insertions(+), 18 deletions(-) diff --git a/docs/ru/config/README.md b/docs/ru/config/README.md index b61e28110b..f290869fee 100644 --- a/docs/ru/config/README.md +++ b/docs/ru/config/README.md @@ -271,7 +271,7 @@ module.exports = { - Тип: `boolean | Object` - По умолчанию: `true` в режиме production, `false` в режиме development - Извлечение CSS из ваших компонентов в отдельные CSS-файлы (вместо инлайна в JavaScript и динамического внедрения). + Извлечение CSS из ваших компонентов в отдельный CSS-файл (вместо инлайна в JavaScript и динамического внедрения). Это всегда отключается при сборке веб-компонентов (в этом случае инлайн стили внедряются в shadowRoot). @@ -377,6 +377,16 @@ module.exports = { } ``` +### devServer.inline + +- Тип: `boolean` +- По умолчанию: `true` + + Переключение между двумя режимами работы сервера разработки. Более подробная информация об опции — [devServer.inline](https://webpack.js.org/configuration/dev-server/#devserverinline). Обратите внимание: + + - При использовании `iframe mode` дополнительная конфигурация не требуется. Просто перейдите в браузере по адресу `http://:/webpack-dev-server/` для отладки приложения. В верхней части страницы будут появляться уведомления. + - При использовании `inline mode`, просто перейдите в браузере по адресу `http://:/` для отладки приложения. Сообщения о сборке будут появляться в консоли браузера. + ### parallel - Тип: `boolean | number` diff --git a/docs/ru/core-plugins/eslint.md b/docs/ru/core-plugins/eslint.md index 0cc2566019..a956e0d37e 100644 --- a/docs/ru/core-plugins/eslint.md +++ b/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`. + ::: ## Конфигурация diff --git a/docs/ru/guide/cli-service.md b/docs/ru/guide/cli-service.md index 35eeea09e5..bf688e058f 100644 --- a/docs/ru/guide/cli-service.md +++ b/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`, в том числе и для пользовательских команд, добавленных другими плагинами. ::: Можно пропустить несколько подключаемых плагинов, передав их имена через запятую: @@ -166,10 +166,7 @@ npx vue-cli-service build --skip-plugins @vue/cli-plugin-pwa "pre-commit": "lint-staged" }, "lint-staged": { - "*.{js,vue}": [ - "vue-cli-service lint", - "git add" - ] + "*.{js,vue}": "vue-cli-service lint" } } ``` diff --git a/docs/ru/guide/css.md b/docs/ru/guide/css.md index 5e38485a97..f4032ada72 100644 --- a/docs/ru/guide/css.md +++ b/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 diff --git a/docs/ru/guide/deployment.md b/docs/ru/guide/deployment.md index ca4d532324..632fb9e005 100644 --- a/docs/ru/guide/deployment.md +++ b/docs/ru/guide/deployment.md @@ -39,7 +39,7 @@ serve -s dist 1. Установите корректное значение `publicPath` в `vue.config.js`. - Если вы публикуете по адресу `https://.github.io/`, вы можете опустить `publicPath`, так как оно по умолчанию `"/"`. + Если публикуете по адресу `https://.github.io/` или на пользовательский домен, то можно опустить `publicPath`, так как оно по умолчанию `"/"`. Если вы публикуете по адресу `https://.github.io//`, (т.е. ваш репозиторий находится по адресу `https://github.com//`), установите `publicPath` в значение `"//"`. Например, если ваш репозиторий называется "my-project", то ваш `vue.config.js` будет выглядеть примерно так: @@ -163,15 +163,32 @@ module.exports = { Также посмотрите [vue-cli-plugin-netlify-lambda](https://github.com/netlify/vue-cli-plugin-netlify-lambda). -Для получения прямых хитов при использовании `режима history` во Vue Router, необходимо создавать файл `_redirects` в каталоге `/public` со следующим содержимым: +#### Использование режима history во Vue Router + +Для получения прямых хитов при использовании `режима history` во Vue Router, необходимо перенаправлять весь трафик в файл `/index.html`. + +> Подробнее можно изучить в [документации Netlify по перенаправлениям](https://docs.netlify.com/routing/redirects/rewrites-proxies/#history-pushstate-and-single-page-apps). + +##### Рекомендуемый метод + +Создать файл `netlify.toml` в корневом каталоге репозитория со следующим содержимым: + +```toml +[[redirects]] + from = "/*" + to = "/index.html" + status = 200 +``` + +##### Альтернативный метод + +Создать файл `_redirects` в каталоге `/public` со следующим содержимым: ``` # Настройки Netlify для одностраничных приложений (SPA) /* /index.html 200 ``` -Подробнее можно изучить в [документации 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` следующее: @@ -194,11 +211,10 @@ module.exports = { [Render](https://render.com) предлагает [бесплатный хостинг статических сайтов](https://render.com/docs/static-sites) с полностью управляемым SSL, глобальным CDN и непрерывным автоматическим развёртыванием из GitHub. -1. Создайте новый Web Service в Render, и предоставьте доступ для GitHub-приложения Render в репозиторий. +1. Создайте новый Static Site в Render, и предоставьте доступ для GitHub-приложения Render в репозиторий. 2. При создании используйте следующие значения: - - **Окружение:** `Static Site` - **Команда сборки:** `npm run build` или `yarn build` - **Каталог публикации:** `dist` diff --git a/docs/ru/guide/mode-and-env.md b/docs/ru/guide/mode-and-env.md index 07cf7dfee1..2fbde776ba 100644 --- a/docs/ru/guide/mode-and-env.md +++ b/docs/ru/guide/mode-and-env.md @@ -54,7 +54,13 @@ VUE_APP_NOT_SECRET_CODE=some_value Обратите внимание, что только `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+). +Подробнее о правилах парсинга env [в документации `dotenv`](https://github.com/motdotla/dotenv#rules). Можно также использовать [dotenv-expand](https://github.com/motdotla/dotenv-expand) для переменных расширения (доступно с версии Vue CLI 3.5+). Например: + +```bash +FOO=foo +BAR=bar +CONCAT=$FOO$BAR # CONCAT=foobar +``` Загруженные переменные станут доступны всем командам `vue-cli-service`, плагинам и зависимостям. @@ -78,7 +84,7 @@ VUE_APP_TITLE=My App ``` NODE_ENV=production -VUE_APP_TITLE=My App (staging) +VUE_APP_TITLE=My Staging App ``` - `vue-cli-service build` собирает приложение для production, загружает `.env`, `.env.production` и `.env.production.local` если они существуют;