diff --git a/docs/ru/guide/asset-handling.md b/docs/ru/guide/asset-handling.md index f852ad9a..c24bfa73 100644 --- a/docs/ru/guide/asset-handling.md +++ b/docs/ru/guide/asset-handling.md @@ -34,7 +34,7 @@ PDF-файлы или другие документы, на которые ес Если ваш сайт развёрнут на URL-адресе, не являющемся корневым, вам нужно установить параметр `base` в файле `.vitepress/config.js`. Например, если вы планируете развернуть свой сайт на `https://foo.github.io/bar/`, то параметр `base` следует установить на `'/bar/'` (он всегда должен начинаться и заканчиваться слэшем). -Все пути к статическим ресурсам автоматически обрабатываются с учётом различных значений конфигурации `base`. Например, если у вас есть абсолютная ссылка на ресурс в разделе `public` в вашей разметке: +Все пути к статическим ресурсам автоматически обрабатываются с учётом различных значений конфигурации `base`. Например, если в вашей разметке есть абсолютная ссылка на ресурс в директории `public`: ```md ![Изображение](/image-inside-public.png) diff --git a/docs/ru/guide/data-loading.md b/docs/ru/guide/data-loading.md index 904794c6..a611dc88 100644 --- a/docs/ru/guide/data-loading.md +++ b/docs/ru/guide/data-loading.md @@ -56,7 +56,7 @@ export default { Если вам нужно генерировать данные на основе локальных файлов, используйте опцию `watch` в загрузчике данных, чтобы изменения, внесённые в эти файлы, вызывали горячие обновления. -Опция `watch` удобна еще и тем, что вы можете использовать [шаблоны glob](https://github.com/mrmlnc/fast-glob#pattern-syntax) для соответствия нескольким файлам. Шаблоны могут быть относительными к самому файлу загрузчика, а функция `load()` будет получать совпадающие файлы в виде абсолютных путей. +Опция `watch` удобна ещё и тем, что вы можете использовать [шаблоны glob](https://github.com/mrmlnc/fast-glob#pattern-syntax) для соответствия нескольким файлам. Шаблоны могут быть относительными к самому файлу загрузчика, а функция `load()` будет получать совпадающие файлы в виде абсолютных путей. В следующем примере показана загрузка CSV-файлов и их преобразование в JSON с помощью [csv-parse](https://github.com/adaltas/node-csv/tree/master/packages/csv-parse/). Поскольку этот файл выполняется только во время сборки, вы не будете передавать CSV-парсер клиенту! diff --git a/docs/ru/guide/deploy.md b/docs/ru/guide/deploy.md index c174c71b..d8ed1c53 100644 --- a/docs/ru/guide/deploy.md +++ b/docs/ru/guide/deploy.md @@ -49,7 +49,7 @@ outline: deep ## Установка публичного базового пути {#setting-a-public-base-path} -По умолчанию предполагается, что сайт будет развёрнут по корневому пути домена (`/`). Если ваш сайт будет обслуживаться по подпути, например, `https://mywebsite.com/blog/`, то в конфигурации VitePress необходимо установить опцию [`base`](../reference/site-config#base) на `'/blog/'`. +По умолчанию предполагается, что сайт будет развёрнут по корневому пути домена (`/`). Если ваш сайт будет обслуживаться по подпути, например, `https://mywebsite.com/blog/`, то в конфигурации VitePress необходимо установить для опции [`base`](../reference/site-config#base) значение `'/blog/'`. **Пример:** Если вы используете Github (или GitLab) Pages и развёртываете на `user.github.io/repo/`, то установите `base` на `/repo/`. @@ -189,7 +189,7 @@ Cache-Control: max-age=31536000,immutable ``` ::: warning ПРЕДУПРЕЖДЕНИЕ - Убедитесь, что опция `base` в вашем VitePress настроена правильно. Дополнительные сведения см. в разделе [Установка публичного базового пути](#setting-a-public-base-path). + Убедитесь, что опция `base` в вашем VitePress настроена правильно. Дополнительные сведения см. в секции [Установка публичного базового пути](#setting-a-public-base-path). ::: 2. В настройках вашего репозитория в разделе «Pages» выберите пункт меню «GitHub Actions» в секции «Build and deployment > Source». @@ -282,8 +282,12 @@ Cache-Control: max-age=31536000,immutable ### Edgio {#edgio} -См. раздел [Создание и развёртывание приложения VitePress в Edgio](https://docs.edg.io/guides/vitepress). +См. [Создание и развёртывание приложения VitePress в Edgio](https://docs.edg.io/applications/v6/sites_frameworks/getting_started/vitepress). ### Хостинг статических файлов Kinsta {#kinsta-static-site-hosting} Вы можете развернуть свой сайт Vitepress на [Kinsta](https://kinsta.com/static-site-hosting/), следуя этим [инструкциям](https://kinsta.com/docs/vitepress-static-site-example/). + +### Stormkit + +Вы можете развернуть свой проект VitePress на [Stormkit](https://www.stormkit.io), следуя следующим [инструкциям](https://stormkit.io/blog/how-to-deploy-vitepress). diff --git a/docs/ru/guide/extending-default-theme.md b/docs/ru/guide/extending-default-theme.md index 55e989e7..ef43dd5d 100644 --- a/docs/ru/guide/extending-default-theme.md +++ b/docs/ru/guide/extending-default-theme.md @@ -4,7 +4,7 @@ outline: deep # Расширение темы по умолчанию {#extending-the-default-theme} -Тема VitePress по умолчанию оптимизирована для документации и может быть настроена по своему усмотрению. Полный список опций можно найти в разделе [Настройки темы по умолчанию](../reference/default-theme-config). +Тема VitePress по умолчанию оптимизирована для документации и может быть настроена по своему усмотрению. Полный список опций можно найти в главе [Настройки темы по умолчанию](../reference/default-theme-config). Однако есть ряд случаев, когда одной лишь конфигурации будет недостаточно. Например: diff --git a/docs/ru/guide/getting-started.md b/docs/ru/guide/getting-started.md index db0ed8fc..f4e0e1d1 100644 --- a/docs/ru/guide/getting-started.md +++ b/docs/ru/guide/getting-started.md @@ -125,7 +125,7 @@ export default { } ``` -Вы также можете настроить поведение темы с помощью опции `themeConfig`. Загляните в раздел [Настройка сайта](../reference/site-config) для получения подробной информации обо всех параметрах конфигурации. +Вы также можете настроить поведение темы с помощью опции `themeConfig`. Загляните в главу [Настройка сайта](../reference/site-config) для получения подробной информации обо всех параметрах конфигурации. ### Исходные файлы {#source-files} @@ -191,7 +191,7 @@ $ bunx vitepress dev docs ::: -Более подробная информация об использовании командной строки описана в разделе [Командная строка](../reference/cli). +Более подробная информация об использовании командной строки описана в главе [Командная строка](../reference/cli). Dev-сервер должен быть запущен по адресу `http://localhost:5173`. Перейдите по URL-адресу в браузере, чтобы увидеть новый сайт в действии! @@ -199,10 +199,10 @@ Dev-сервер должен быть запущен по адресу `http:// - Чтобы лучше понять, как Markdown-файлы сопоставляются с генерируемым HTML, перейдите к [Руководству по маршрутизации](./routing). -- Чтобы узнать больше о том, что вы можете делать на странице, например, писать содержимое в формате Markdown или использовать компонент Vue, обратитесь к разделу «Написание». Начать стоит с изучения раздела [Расширения Markdown](./markdown). +- Чтобы узнать больше о том, что вы можете делать на странице, например, писать содержимое в формате Markdown или использовать компоненты Vue, обратитесь к разделу «Написание». Начать стоит с изучения главы [Расширения Markdown](./markdown). -- Чтобы изучить возможности, предоставляемые темой документации по умолчанию, ознакомьтесь с разделом [Настройка темы по умолчанию](../reference/default-theme-config). +- Чтобы изучить возможности, предоставляемые темой документации по умолчанию, ознакомьтесь с главой [Настройка темы по умолчанию](../reference/default-theme-config). -- Если вы хотите еще больше изменить внешний вид своего сайта, изучите разделы [Расширение темы по умолчанию](./extending-default-theme) или [Пользовательская тема](./custom-theme). +- Если вы хотите ещё больше изменить внешний вид своего сайта, изучите главы [Расширение темы по умолчанию](./extending-default-theme) или [Пользовательская тема](./custom-theme). - Как только ваш сайт документации обретёт форму, обязательно прочитайте [Руководство по развёртыванию](./deploy). diff --git a/docs/ru/guide/i18n.md b/docs/ru/guide/i18n.md index ee00d680..93321758 100644 --- a/docs/ru/guide/i18n.md +++ b/docs/ru/guide/i18n.md @@ -49,7 +49,7 @@ interface LocaleSpecificConfig { } ``` -Подробнее о настройке текстов-заготовок темы по умолчанию см. в интерфейсе [`DefaultTheme.Config`](https://github.com/vuejs/vitepress/blob/main/types/default-theme.d.ts). Не переопределяйте `themeConfig.algolia` или `themeConfig.carbonAds` на локальном уровне. Использование многоязычного поиска описано в разделе [Поиск Algolia](../reference/default-theme-search#algolia-search-i18n). +Подробнее о настройке текстов-заготовок темы по умолчанию см. в интерфейсе [`DefaultTheme.Config`](https://github.com/vuejs/vitepress/blob/main/types/default-theme.d.ts). Не переопределяйте `themeConfig.algolia` или `themeConfig.carbonAds` на локальном уровне. Использование многоязычного поиска описано в главе [Поиск Algolia](../reference/default-theme-search#algolia-search-i18n). **Совет:** Конфигурационный файл можно хранить и в `docs/.vitepress/config/index.ts`. Это может помочь вам организовать работу, создав конфигурационный файл для каждой локали, а затем объединить и экспортировать их из `index.ts`. diff --git a/docs/ru/guide/markdown.md b/docs/ru/guide/markdown.md index 4766bcf2..65bd897f 100644 --- a/docs/ru/guide/markdown.md +++ b/docs/ru/guide/markdown.md @@ -74,7 +74,7 @@ lang: ru-RU Эти данные будут доступны остальной части страницы, а также всем пользовательским и тематическим компонентам. -Более подробную информацию можно найти в разделе [Метаданные](../reference/frontmatter-config). +Более подробную информацию можно найти в главе [Метаданные](../reference/frontmatter-config). ## Таблицы в стиле GitHub {#github-style-tables} @@ -345,7 +345,7 @@ export default { [Список всех поддерживаемых языков](https://shiki.style/languages). -Вы также можете настроить тему подсветки синтаксиса в конфигурации приложения. Более подробную информацию см. в разделе [Секция `markdown`](../reference/site-config#markdown). +Вы также можете настроить тему подсветки синтаксиса в конфигурации приложения. Более подробную информацию см. в секции [`markdown`](../reference/site-config#markdown). ## Выделение строк в блоках кода {#line-highlighting-in-code-blocks} @@ -552,7 +552,7 @@ export default { } ``` -Более подробную информацию см. в разделе [Секция `markdown`](../reference/site-config#markdown). +Более подробную информацию см. в секции [`markdown`](../reference/site-config#markdown). Вы можете добавить метки `:line-numbers` / `:no-line-numbers` в ваши ограждённые блоки кода, чтобы переопределить значение, установленное в конфиге. @@ -930,4 +930,4 @@ export default defineConfig({ }) ``` -Полный список настраиваемых свойств см. в разделе [Опция `markdown`](../reference/site-config#markdown). +Полный список настраиваемых свойств см. в секции [`markdown`](../reference/site-config#markdown). diff --git a/docs/ru/guide/mpa-mode.md b/docs/ru/guide/mpa-mode.md index 7f3d7bf7..81843708 100644 --- a/docs/ru/guide/mpa-mode.md +++ b/docs/ru/guide/mpa-mode.md @@ -18,6 +18,6 @@ # Привет ``` -`