Skip to content

Commit

Permalink
docs: [RU] Translation update (#6417)
Browse files Browse the repository at this point in the history
* 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>
  • Loading branch information
Alex-Sokolov and Alex-Sokolov committed Apr 13, 2021
1 parent 65d5f7a commit 6563bc7
Show file tree
Hide file tree
Showing 6 changed files with 60 additions and 18 deletions.
12 changes: 11 additions & 1 deletion docs/ru/config/README.md
Expand Up @@ -271,7 +271,7 @@ module.exports = {
- Тип: `boolean | Object`
- По умолчанию: `true` в режиме production, `false` в режиме development

Извлечение CSS из ваших компонентов в отдельные CSS-файлы (вместо инлайна в JavaScript и динамического внедрения).
Извлечение CSS из ваших компонентов в отдельный CSS-файл (вместо инлайна в JavaScript и динамического внедрения).

Это всегда отключается при сборке веб-компонентов (в этом случае инлайн стили внедряются в shadowRoot).

Expand Down Expand Up @@ -377,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`
Expand Down
8 changes: 6 additions & 2 deletions docs/ru/core-plugins/eslint.md
Expand Up @@ -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`.
:::

## Конфигурация

Expand Down
11 changes: 4 additions & 7 deletions docs/ru/guide/cli-service.md
Expand Up @@ -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`, в том числе и для пользовательских команд, добавленных другими плагинами.
:::

Можно пропустить несколько подключаемых плагинов, передав их имена через запятую:
Expand Down Expand Up @@ -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"
}
}
```
Expand Down
9 changes: 9 additions & 0 deletions docs/ru/guide/css.md
Expand Up @@ -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
Expand Down
28 changes: 22 additions & 6 deletions docs/ru/guide/deployment.md
Expand Up @@ -39,7 +39,7 @@ serve -s dist

1. Установите корректное значение `publicPath` в `vue.config.js`.

Если вы публикуете по адресу `https://<USERNAME>.github.io/`, вы можете опустить `publicPath`, так как оно по умолчанию `"/"`.
Если публикуете по адресу `https://<USERNAME>.github.io/` или на пользовательский домен, то можно опустить `publicPath`, так как оно по умолчанию `"/"`.

Если вы публикуете по адресу `https://<USERNAME>.github.io/<REPO>/`, (т.е. ваш репозиторий находится по адресу `https://github.com/<USERNAME>/<REPO>`), установите `publicPath` в значение `"/<REPO>/"`. Например, если ваш репозиторий называется "my-project", то ваш `vue.config.js` будет выглядеть примерно так:

Expand Down Expand Up @@ -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` следующее:
Expand All @@ -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`

Expand Down
10 changes: 8 additions & 2 deletions docs/ru/guide/mode-and-env.md
Expand Up @@ -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`, плагинам и зависимостям.

Expand All @@ -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` если они существуют;
Expand Down

0 comments on commit 6563bc7

Please sign in to comment.