Skip to content

Commit f30b848

Browse files
authored
docs(ru): update translation guide/deploy.md (#3807)
1 parent 47570a1 commit f30b848

File tree

1 file changed

+44
-0
lines changed

1 file changed

+44
-0
lines changed

docs/ru/guide/deploy.md

+44
Original file line numberDiff line numberDiff line change
@@ -291,3 +291,47 @@ Cache-Control: max-age=31536000,immutable
291291
### Stormkit
292292

293293
Вы можете развернуть свой проект VitePress на [Stormkit](https://www.stormkit.io), следуя следующим [инструкциям](https://stormkit.io/blog/how-to-deploy-vitepress).
294+
295+
### Nginx
296+
297+
Вот пример конфигурации блока сервера Nginx. Эта настройка включает сжатие gzip для общих текстовых ресурсов, правила обслуживания статических файлов вашего сайта VitePress с правильными заголовками кэширования и обработку параметра `cleanUrls: true`.
298+
299+
```nginx
300+
server {
301+
gzip on;
302+
gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
303+
304+
listen 80;
305+
server_name _;
306+
index index.html;
307+
308+
location / {
309+
# расположение контента
310+
root /app;
311+
312+
# точные совпадения -> обратные чистые URL-адреса -> папки -> не найдены
313+
try_files $uri $uri.html $uri/ =404;
314+
315+
# несуществующие страницы
316+
error_page 404 /404.html;
317+
318+
# папка без index.html вызывает ошибку 403 в этой настройке
319+
error_page 403 /404.html;
320+
321+
# настройка заголовков кэширования
322+
# файлы в папке с ресурсами имеют хэши имён файлов
323+
location ~* ^/assets/ {
324+
expires 1y;
325+
add_header Cache-Control "public, immutable";
326+
}
327+
}
328+
}
329+
```
330+
331+
Эта конфигурация предполагает, что ваш собранный сайт VitePress находится в директории `/app`. При необходимости измените директиву `root`, если файлы вашего сайта расположены в другом месте.
332+
333+
::: warning Не используйте index.html по умолчанию
334+
Разрешение try_files не должно использовать index.html, как это делается в других приложениях Vue. Это может привести к недопустимому состоянию страницы.
335+
:::
336+
337+
Дополнительную информацию можно найти в официальной документации [Nginx](https://nginx.org/ru/docs/), а также в следующих обсуждениях: [#2837](https://github.com/vuejs/vitepress/discussions/2837), [#3235](https://github.com/vuejs/vitepress/issues/3235), а также в [блоге Mehdi Merah](https://blog.mehdi.cc/articles/vitepress-cleanurls-on-nginx-environment#readings).

0 commit comments

Comments
 (0)