Skip to content

Commit acae8e7

Browse files
docs: [RU] Translation update (#6005)
* docs: [RU] update migrating-from-v3.md * docs: [RU] update prototyping.md * docs: [RU] update webpack.md * docs: [RU] fix typos in cli-service.md * Update docs/ru/guide/prototyping.md Co-Authored-By: Natalia Tepluhina <[email protected]> * docs: (ru) pwa.md update * docs: (ru) browser-compatibility.md fix import * docs: (ru) deployment.md fix example * docs: (ru) installation.md update * docs: (ru) deployment.md update link * docs: (ru) core-plugins/eslint fix * docs: (ru) pwa.md update * docs(ru): plugin-dev.md fix link * docs(ru): cli-service.md update * docs(ru): pwa.md update * docs(ru): pwa.md update * Update docs/ru/core-plugins/pwa.md Co-authored-by: Natalia Tepluhina <[email protected]> * Update docs/ru/core-plugins/pwa.md Co-authored-by: Natalia Tepluhina <[email protected]> * docs: (ru) eslint.md update * docs: (ru) deployment.md * docs: (ru) update plugins menu * docs: (ru) added WebdriverIO * Update docs/ru/core-plugins/e2e-webdriverio.md Co-authored-by: Natalia Tepluhina <[email protected]> * docs(ru): added tips for parallel option * docs(ru): plugin-dev.md update * docs(ru): installation.md update * docs(ru): consistent code blocks * docs(ru): deployment.md update * docs(ru): deployment.md change now to vercel * docs(ru): plugins-and-presets.md update * docs(ru): installation.md update * docs(ru): deployment.md update * docs(ru): webpack.md update * docs(ru): deployment.md update * docs(ru): mode-and-env.md update Co-authored-by: Alex Sokolov <[email protected]> Co-authored-by: Natalia Tepluhina <[email protected]>
1 parent 597b4b6 commit acae8e7

File tree

10 files changed

+73
-72
lines changed

10 files changed

+73
-72
lines changed

docs/ru/config/README.md

+4
Original file line numberDiff line numberDiff line change
@@ -380,6 +380,10 @@ module.exports = {
380380

381381
Использовать ли `thread-loader` для транспиляции Babel или TypeScript. Включается для production-сборок, когда система имеет более 1 процессорных ядер. Указание числа определит количество задействованных воркеров (workers).
382382

383+
::: warning Внимание
384+
Не используйте `parallel` в комбинации с не-сериализуемыми опциями загрузчика, такими как регулярные выражения, даты и функции. Такие опции не будут корректно переданы соответствующим загрузчикам, что может привести к неожиданным ошибкам.
385+
:::
386+
383387
### pwa
384388

385389
- Тип: `Object`

docs/ru/core-plugins/babel.md

+2
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,8 @@ module.exports = {
2626

2727
[thread-loader](https://github.com/webpack-contrib/thread-loader) используется по умолчанию, если машина имеет более 1 ядра CPU. Это можно отключить указав `parallel: false` в файле `vue.config.js`.
2828

29+
Опция `parallel` должна быть установлена в `false` при использовании Babel в комбинации с не-сериализуемыми опциями загрузчика, таким как регулярные выражения, даты и функции. Такие опции не будут корректно переданы в `babel-loader`, что может привести к неожиданным ошибкам.
30+
2931
## Установка в уже созданный проект
3032

3133
```sh

docs/ru/core-plugins/e2e-webdriverio.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@ tests/e2e/
4646

4747
## Установка в уже созданный проект
4848

49-
``` sh
49+
```sh
5050
vue add e2e-webdriverio
5151
```
5252

docs/ru/core-plugins/typescript.md

+2
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,8 @@ TypeScript может быть сконфигурирован через `tsconf
2424

2525
[thread-loader](https://github.com/webpack-contrib/thread-loader) используется по умолчанию, если машина имеет более 1 ядра CPU. Это можно отключить указав `parallel: false` в файле `vue.config.js`.
2626

27+
Опция `parallel` должна быть установлена в `false` при использовании Typescript в комбинации с не-сериализуемыми опциями загрузчика, таким как регулярные выражения, даты и функции. Такие опции не будут корректно переданы в `ts-loader`, что может привести к неожиданным ошибкам.
28+
2729
## Установка в уже созданный проект
2830

2931
```sh

docs/ru/dev-guide/plugin-dev.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -289,7 +289,7 @@ module.exports.hooks = (api) => {
289289
const renderIndex = lines.findIndex(line => line.match(/render/))
290290
lines[renderIndex] += `${EOL} router,`
291291
292-
fs.writeFileSync(api.entryFile, lines.join(EOL), { encoding: 'utf-8' })
292+
fs.writeFileSync(api.resolve(api.entryFile), lines.join(EOL), { encoding: 'utf-8' })
293293
})
294294
}
295295
```

docs/ru/guide/deployment.md

+42-61
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,8 @@ serve -s dist
4444
Если вы публикуете по адресу `https://<USERNAME>.github.io/<REPO>/`, (т.е. ваш репозиторий находится по адресу `https://github.com/<USERNAME>/<REPO>`), установите `publicPath` в значение `"/<REPO>/"`. Например, если ваш репозиторий называется "my-project", то ваш `vue.config.js` будет выглядеть примерно так:
4545

4646
```js
47+
// файл vue.config.js должен быть расположен в корневом каталоге проекта
48+
4749
module.exports = {
4850
publicPath: process.env.NODE_ENV === 'production'
4951
? '/my-project/'
@@ -170,6 +172,24 @@ module.exports = {
170172

171173
Подробнее можно изучить в [документации Netlify по перенаправлениям](https://www.netlify.com/docs/redirects/#history-pushstate-and-single-page-apps).
172174

175+
При использовании [@vue/cli-plugin-pwa](../core-plugins/pwa.md#vue-cli-plugin-pwa) убедитесь, что файл `_redirects` не кэшируется service worker.
176+
177+
Для этого добавьте в `vue.config.js` следующее:
178+
179+
```js
180+
// файл vue.config.js должен быть расположен в корневом каталоге проекта
181+
182+
module.exports = {
183+
pwa: {
184+
workboxOptions: {
185+
exclude: [/_redirects/]
186+
}
187+
}
188+
}
189+
```
190+
191+
Подробнее об опциях [workboxOptions](../core-plugins/pwa.md#configuration) и [exclude](https://developers.google.com/web/tools/workbox/reference-docs/latest/module-workbox-webpack-plugin.InjectManifest#InjectManifest).
192+
173193
### Render
174194

175195
[Render](https://render.com) предлагает [бесплатный хостинг статических сайтов](https://render.com/docs/static-sites) с полностью управляемым SSL, глобальным CDN и непрерывным автоматическим развёртыванием из GitHub.
@@ -259,79 +279,40 @@ firebase deploy --only hosting
259279

260280
Обратитесь к [документации Firebase](https://firebase.google.com/docs/hosting/deploying) для получения более подробной информации.
261281

262-
### Now
282+
### Vercel
263283

264-
В данном примере используется последняя версия платформы Now версии 2.
284+
[Vercel](https://vercel.com/home) — облачная платформа, позволяющая разработчикам хостить Jamstack веб-сайты и веб-сервисы, которые публикуются мгновенно, автоматически масштабируются и не требуют никакого контроля, всё это с zero-конфигурацией. Они обеспечивают глобальный доступ, SSL-шифрование, сжатие ресурсов, инвалидацию кэша и многое другое.
265285

266-
1. Установите Now CLI:
286+
#### Шаг 1: Публикация проекта Vue на Vercel
267287

268-
```bash
269-
npm install -g now
288+
Для публикации проекта Vue с помощью [Vercel для интеграции с Git](https://vercel.com/docs/git-integrations), убедитесь, что он был выложен в Git-репозиторий.
270289

271-
# Или если предпочитаете локальную установку
272-
npm install now
273-
```
290+
Импортируйте проект в Vercel с помощью [Import Flow](https://vercel.com/import/git). Во время импорта будут запрошены все соответствующие [опции](https://vercel.com/docs/build-step#build-&-development-settings), предварительно сконфигурированные, но с возможностью изменения при необходимости.
274291

275-
2. Добавьте файл `now.json` в корневой каталог проекта:
292+
После импорта проекта, все последующие 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).
276293

277-
```json
278-
{
279-
"name": "my-example-app",
280-
"version": 2,
281-
"builds": [
282-
{
283-
"src": "package.json",
284-
"use": "@now/static-build"
285-
}
286-
],
287-
"routes": [
288-
{
289-
"src": "/(js|css|img)/.*",
290-
"headers": { "cache-control": "max-age=31536000, immutable" }
291-
},
292-
{ "handle": "filesystem" },
293-
{ "src": ".*", "dest": "/" }
294-
],
295-
"alias": "example.com"
296-
}
297-
```
294+
После публикации вы получите URL-адрес для просмотра приложения вживую, например: https://vue-example-tawny.vercel.app/.
298295

299-
Если у вас есть другие/дополнительные каталоги, измените маршрут соответствующим образом:
300-
301-
```diff
302-
- {
303-
- "src": "/(js|css|img)/.*",
304-
- "headers": { "cache-control": "max-age=31536000, immutable" }
305-
- }
306-
+ {
307-
+ "src": "/(js|css|img|fonts|media)/.*",
308-
+ "headers": { "cache-control": "max-age=31536000, immutable" }
309-
+ }
310-
```
296+
#### Шаг 2 (опционально): Использование пользовательского домена
311297

312-
Когда значение `outputDir` вместо стандартного `dist` указано `build`:
313-
314-
```diff
315-
- {
316-
- "src": "package.json",
317-
- "use": "@now/static-build"
318-
- }
319-
+ {
320-
+ "src": "package.json",
321-
+ "use": "@now/static-build",
322-
+ "config": { "distDir": "build" }
323-
+ }
324-
```
298+
При необходимости использовать пользовательский домен при публикации Vercel, можно **Добавить** или **Перенаправить** домен через [настройки домена аккаунта](https://vercel.com/dashboard/domains) Vercel.
325299

326-
3. Добавьте `now-build` скрипт для публикации в `package.json`:
300+
Для добавления домена в проект, перейдите в раздел [Проект](https://vercel.com/docs/platform/projects) на панели Vercel. После выбора проекта перейдите на вкладку "Настройки", затем выберите пункт меню **Домены**. На странице **Домен** вашего проекта, укажите домен которые хотите использовать в проекте.
327301

328-
```json
329-
"now-build": "npm run build"
330-
```
302+
После добавления домена, будут предоставлены различные методы его настройки.
303+
304+
#### Публикация свежего проекта на Vue
305+
306+
Для публикации свежего проекта на Vue с настроенным Git-репозиторием, можно с помощью кнопки Deploy ниже:
307+
308+
[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/import/git?s=https%3A%2F%2Fgithub.com%2Fvercel%2Fvercel%2Ftree%2Fmaster%2Fexamples%2Fvue)
331309

332-
Для публикации запустите `now`.
310+
## Ресурсы:
333311

334-
Если необходим псевдоним публикации, запустите `now --target production`.
312+
- [Пример исходного кода](https://github.com/vercel/vercel/tree/master/examples/vue)
313+
- [Официальное руководство Vercel](https://vercel.com/guides/deploying-vuejs-to-vercel)
314+
- [Руководство по публикации Vercel](https://vercel.com/docs)
315+
- [Документация по пользовательским доменам Vercel](https://vercel.com/docs/custom-domains)
335316

336317
### Stdlib
337318

docs/ru/guide/installation.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
:::
77

88
::: tip Требования к версии Node
9-
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).
9+
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).
1010
:::
1111

1212
Для установки нового пакета используйте одну из следующих команд. Для их выполнения потребуются права администратора, если только npm не был установлен в системе через менеджер версий Node.js (например, n или nvm).
@@ -29,21 +29,21 @@ vue --version
2929

3030
Для обновления глобального пакета Vue CLI выполните команду:
3131

32-
``` bash
32+
```bash
3333
npm update -g @vue/cli
3434
# ИЛИ
3535
yarn global upgrade --latest @vue/cli
3636
```
3737

3838
#### Зависимости проекта
3939

40-
Команды обновления, показанные выше, только для глобально установленного пакета Vue CLI. Для обновления одного или нескольких пакетов, связанных с `@vue/cli` (включая пакеты, начинающиеся с `@vue/cli-plugin-`) внутри проекта, запустите `vue upgrade` в каталоге проекта:
40+
Команды обновления, показанные выше, только для глобально установленного пакета Vue CLI. Для обновления одного или нескольких пакетов, связанных с `@vue/cli` (включая пакеты, начинающиеся с `@vue/cli-plugin-` или `vue-cli-plugin-`) внутри проекта, запустите `vue upgrade` в каталоге проекта:
4141

4242
```
4343
Использование: upgrade [options] [plugin-name]
4444
(экспериментально) upgrade vue cli service / plugins
4545
Опции:
46-
-t, --to <version> Обновить <package-name> до определённой версии
46+
-t, --to <version> Обновить <plugin-name> до определённой версии
4747
-f, --from <version> Пропустить проверку установленного плагина, предполагая что он будет обновляться с указанной версии
4848
-r, --registry <url> Использовать указанный npm-регистр при установке зависимостей
4949
--all Обновить все плагины

docs/ru/guide/mode-and-env.md

+10-4
Original file line numberDiff line numberDiff line change
@@ -43,10 +43,16 @@ vue-cli-service build --mode development
4343

4444
```
4545
FOO=bar
46-
VUE_APP_SECRET=secret
46+
VUE_APP_NOT_SECRET_CODE=some_value
4747
```
4848

49-
Обратите внимание, что только переменные с префиксом `VUE_APP_` будут статически внедряться в клиентскую сборку с помощью `webpack.DefinePlugin`.
49+
::: warning ВНИМАНИЕ
50+
Не храните никаких секретов (например, приватных ключей API) в приложении!
51+
52+
Так как переменные окружения внедряются в сборку, то любой желающий сможет увидеть их, изучив файлы сборки приложения.
53+
:::
54+
55+
Обратите внимание, что только `NODE_ENV`, `BASE_URL` и переменные, именованные с префикса `VUE_APP_`, статически внедрятся в *клиентскую сборку* с помощью `webpack.DefinePlugin`. Это сделано во избежание случайного обнародования закрытого ключа на машине, которая может иметь такое же имя.
5056

5157
Подробнее о правилах парсинга env можно узнать [в документации `dotenv`](https://github.com/motdotla/dotenv#rules). Мы также используем [dotenv-expand](https://github.com/motdotla/dotenv-expand) для переменных расширения (доступно в Vue CLI 3.5+).
5258

@@ -86,10 +92,10 @@ VUE_APP_TITLE=My App (staging)
8692
Можно получить доступ к переменным окружения из кода приложения:
8793

8894
```js
89-
console.log(process.env.VUE_APP_SECRET)
95+
console.log(process.env.VUE_APP_NOT_SECRET_CODE)
9096
```
9197

92-
На этапе сборки `process.env.VUE_APP_SECRET` будет заменяться соответствующим значением. Когда в файле указано `VUE_APP_SECRET=secret` — после сборки значением будет `"secret"`.
98+
На этапе сборки `process.env.VUE_APP_NOT_SECRET_CODE` будет заменяться соответствующим значением. Когда в файле указано `VUE_APP_NOT_SECRET_CODE=some_value` — после сборки значением будет `"some_value"`.
9399

94100
В дополнение к переменным `VUE_APP_*` есть также две специальные переменные, которые всегда доступны в коде приложения:
95101

docs/ru/guide/plugins-and-presets.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -192,7 +192,7 @@ GitLab и BitBucket также поддерживаются. Убедитесь,
192192
vue create --preset gitlab:username/repo --clone my-project
193193
vue create --preset bitbucket:username/repo --clone my-project
194194

195-
# self-hosted repos
195+
# репозитории на собственном хостинге
196196
vue create --preset gitlab:my-gitlab-server.com:group/projectname --clone my-project
197197
vue create --preset direct:ssh://[email protected]/group/projectname.git --clone my-project
198198
```

docs/ru/guide/webpack.md

+6
Original file line numberDiff line numberDiff line change
@@ -161,6 +161,12 @@ module.exports = {
161161
vue inspect > output.js
162162
```
163163

164+
По умолчанию команда `inspect` показывает конфигурацию для разработки. Для отображения конфигурации для production необходимо запустить:
165+
166+
```bash
167+
vue inspect --mode production > output.prod.js
168+
```
169+
164170
Обратите внимание, что вывод не является файлом рабочей конфигурации webpack, это только сериализованный формат предназначенный для проверки.
165171

166172
Вы также можете указать подмножество конфигурации для проверки, указав путь:

0 commit comments

Comments
 (0)