From 7bf9d8ce9c613142280258d59717c76cebee6606 Mon Sep 17 00:00:00 2001 From: Bugo Date: Tue, 8 Oct 2024 11:52:58 +0500 Subject: [PATCH] Update ru/guide/deploy.md --- docs/ru/guide/deploy.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/ru/guide/deploy.md b/docs/ru/guide/deploy.md index 11ee0c74..7825cbdd 100644 --- a/docs/ru/guide/deploy.md +++ b/docs/ru/guide/deploy.md @@ -4,7 +4,7 @@ outline: deep # Развёртывание вашего сайта VitePress {#deploy-your-vitepress-site} -Следующие руководства основаны на некоторых общих предположениях: +Следующие инструкции основаны на некоторых общих предположениях: - Сайт VitePress находится в директории `docs` вашего проекта. - Вы используете выходной каталог сборки по умолчанию (`.vitepress/dist`). @@ -19,7 +19,7 @@ outline: deep } ``` -## Создание и локальное тестирование {#build-and-test-locally} +## Сборка и локальное тестирование {#build-and-test-locally} 1. Выполните эту команду, чтобы собрать документацию: @@ -33,9 +33,9 @@ outline: deep $ npm run docs:preview ``` - Команда `preview` загрузит локальный статический веб-сервер, который будет обслуживать выходной каталог `.vitepress/dist` по адресу `http://localhost:4173`. Вы можете использовать это, чтобы убедиться, что всё выглядит хорошо, прежде чем отправлять в производство. + Команда `preview` загрузит локальный статический веб-сервер, который будет обслуживать выходной каталог `.vitepress/dist` по адресу `http://localhost:4173`. Вы можете использовать его для теста, чтобы убедиться, что всё выглядит хорошо, прежде чем отправлять в производство. -3. Вы можете настроить порт сервера, передав `--port` в качестве аргумента. +3. Можно указать порт сервера, передав `--port` в качестве аргумента. ```json { @@ -55,11 +55,11 @@ outline: deep ## Заголовки кэша HTTP {#http-cache-headers} -Если вы контролируете HTTP-заголовки на своем рабочем сервере, вы можете настроить заголовки `cache-control` для достижения лучшей производительности при повторных посещениях. +Если вы контролируете HTTP-заголовки на своем рабочем сервере, можно настроить заголовки `cache-control` для достижения лучшей производительности при повторных посещениях. -В производственной сборке используются хэшированные имена файлов для статических ресурсов (JavaScript, CSS и другие импортированные ресурсы, не находящиеся в `public`). Если вы просмотрите предварительную версию с помощью сетевой вкладки devtools вашего браузера, вы увидите файлы типа `app.4f283b18.js`. +В производственной сборке используются хэшированные имена файлов для статических ресурсов (JavaScript, CSS и другие импортированные ресурсы, не находящиеся в `public`). Если вы просмотрите предварительную версию с помощью вкладки «Network» («Сеть») инструментов разработчика вашего браузера, вы увидите файлы типа `app.4f283b18.js`. -Этот хэш `4f283b18` генерируется из содержимого этого файла. Один и тот же хэшированный URL гарантированно обслуживает одно и то же содержимое файла — если содержимое меняется, то и URL тоже. Это означает, что вы можете смело использовать самые сильные заголовки кэша для этих файлов. Все такие файлы будут помещены в каталог `assets/` в выходном каталоге, поэтому вы можете настроить для них следующий заголовок: +Этот хэш `4f283b18` генерируется из содержимого этого файла. Один и тот же хэшированный URL гарантированно обслуживает одно и то же содержимое файла — если содержимое меняется, то и URL тоже. Это означает, что можно смело использовать самые сильные настройки кэширования для этих файлов. Все такие файлы будут помещены в каталог `assets/` в выходном каталоге, поэтому вы можете настроить для них следующий заголовок: ``` Cache-Control: max-age=31536000,immutable @@ -198,7 +198,7 @@ Cache-Control: max-age=31536000,immutable ### GitLab Pages {#gitlab-pages} -1. Установите значение `../public` для параметра `outDir` в конфигурации VitePress. Настройте опцию `base` на `'/<репозиторий>/'`, если вы хотите развернуть ваш проект по адресу `https://<имя пользователя>.gitlab.io/<репозиторий>/`. Вам не нужна опция `base`, если вы выполняете развёртывание на личном домене, страницах пользователя или группы или если в GitLab включен параметр «Использовать уникальный домен». +1. Установите значение `../public` для параметра `outDir` в конфигурации VitePress. Настройте опцию `base` на `'/<репозиторий>/'`, если вы хотите развернуть ваш проект по адресу `https://<имя пользователя>.gitlab.io/<репозиторий>/`. Вам не нужна опция `base`, если вы выполняете развёртывание на личном домене, страницах пользователя или группы, или если в GitLab включен параметр «Использовать уникальный домен». 2. Создайте файл с именем `.gitlab-ci.yml` в корне вашего проекта с приведённым ниже содержимым. Это позволит создавать и развёртывать ваш сайт каждый раз, когда вы вносите изменения в его содержимое: