From 6ea60f5d0c1a11c275fe37a9ec59ee89fa5df685 Mon Sep 17 00:00:00 2001 From: Bugo Date: Wed, 9 Oct 2024 08:07:50 +0500 Subject: [PATCH] docs(ru): update translations (#4257) --- docs/ru/guide/asset-handling.md | 2 +- docs/ru/guide/data-loading.md | 4 ++-- docs/ru/guide/deploy.md | 16 +++++++-------- docs/ru/guide/extending-default-theme.md | 6 +++--- docs/ru/guide/frontmatter.md | 2 +- docs/ru/guide/getting-started.md | 8 ++++---- docs/ru/guide/markdown.md | 20 +++++++++---------- docs/ru/guide/mpa-mode.md | 2 +- docs/ru/guide/routing.md | 4 ++-- docs/ru/guide/using-vue.md | 4 ++-- docs/ru/reference/default-theme-carbon-ads.md | 6 +++--- docs/ru/reference/frontmatter-config.md | 6 ++++++ 12 files changed, 43 insertions(+), 37 deletions(-) diff --git a/docs/ru/guide/asset-handling.md b/docs/ru/guide/asset-handling.md index c24bfa73..3b002e13 100644 --- a/docs/ru/guide/asset-handling.md +++ b/docs/ru/guide/asset-handling.md @@ -10,7 +10,7 @@ Вы можете ссылаться на статические ресурсы в ваших файлах разметки, компоненты `*.vue` в теме, стили и обычные файлы `.css`, используя абсолютные пути (основанные на корне проекта) или относительные пути (основанные на вашей файловой системе). Последнее похоже на поведение, к которому вы привыкли, если использовали Vite, Vue CLI или `file-loader` в webpack. -Распространенные типы файлов изображений, мультимедиа и шрифтов определяются и включаются в качестве ресурсов автоматически. +Распространённые типы файлов изображений, мультимедиа и шрифтов определяются и включаются в качестве ресурсов автоматически. ::: tip Связанные файлы не рассматриваются как ресурсы PDF-файлы или другие документы, на которые есть ссылки в файлах с разметкой, не рассматриваются автоматически как ресурсы. Чтобы сделать связанные файлы доступными, вы должны вручную поместить их в каталог [`public`](#the-public-directory) вашего проекта. diff --git a/docs/ru/guide/data-loading.md b/docs/ru/guide/data-loading.md index a611dc88..f7cfd26d 100644 --- a/docs/ru/guide/data-loading.md +++ b/docs/ru/guide/data-loading.md @@ -175,7 +175,7 @@ export default { } ``` -**Types** +**Типы** ```ts interface ContentOptions { @@ -226,7 +226,7 @@ interface ContentOptions { ## Загрузчики типизированных данных {#typed-data-loaders} -При использовании TypeScript вы можете ввести свой загрузчик и экспортировать `data` следующим образом: +При использовании TypeScript можно ввести свой загрузчик и экспортировать `data` следующим образом: ```ts import { defineLoader } from 'vitepress' 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` в корне вашего проекта с приведённым ниже содержимым. Это позволит создавать и развёртывать ваш сайт каждый раз, когда вы вносите изменения в его содержимое: diff --git a/docs/ru/guide/extending-default-theme.md b/docs/ru/guide/extending-default-theme.md index 2a8531bf..30308a7b 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). Однако есть ряд случаев, когда одной лишь конфигурации будет недостаточно. Например: @@ -12,7 +12,7 @@ outline: deep 2. Вам нужно изменить экземпляр приложения Vue, например, чтобы зарегистрировать глобальные компоненты; 3. Вам нужно внедрить пользовательский контент в тему через слоты макета. -Эти расширенные настройки потребуют использования пользовательской темы, которая «расширяет» тема по умолчанию. +Эти расширенные настройки потребуют использования пользовательской темы, которая «расширяет» тему по умолчанию. ::: tip СОВЕТ Прежде чем приступить к работе, обязательно прочитайте главу [Пользовательская тема](./custom-theme), чтобы понять, как работают пользовательские темы. @@ -124,7 +124,7 @@ export default { } satisfies Theme ``` -Поскольку мы используем Vite, вы также можете использовать [глобальную функцию импорта](https://vitejs.dev/guide/features.html#glob-import) Vite для автоматической регистрации каталога компонентов. +Поскольку мы используем Vite, можно применять [глобальную функцию импорта](https://vitejs.dev/guide/features.html#glob-import) Vite для автоматической регистрации каталога компонентов. ## Слоты макета {#layout-slots} diff --git a/docs/ru/guide/frontmatter.md b/docs/ru/guide/frontmatter.md index 967338f8..b09693f7 100644 --- a/docs/ru/guide/frontmatter.md +++ b/docs/ru/guide/frontmatter.md @@ -11,7 +11,7 @@ editLink: true --- ``` -Многие параметры конфигурации сайта или темы по умолчанию имеют соответствующие опции в блоке метаданных. Вы можете использовать метаданные, чтобы переопределить определённое поведение только для текущей страницы. Подробности см. в [Справочнике по настройке метаданных](../reference/frontmatter-config). +Многие параметры конфигурации сайта или темы по умолчанию имеют соответствующие опции в блоке метаданных. Вы можете использовать метаданные, чтобы переопределить заданное поведение только для текущей страницы. Подробности см. в [Справочнике по настройке метаданных](../reference/frontmatter-config). Вы также можете определить собственные метаданные, которые будут использоваться в динамических выражениях Vue на странице. diff --git a/docs/ru/guide/getting-started.md b/docs/ru/guide/getting-started.md index 515cb5a2..540f4278 100644 --- a/docs/ru/guide/getting-started.md +++ b/docs/ru/guide/getting-started.md @@ -63,7 +63,7 @@ VitePress — это пакет, предназначенный только д ### Мастер настройки {#setup-wizard} -VitePress поставляется с мастером настройки командной строки, который поможет вам создать базовый проект. После установки запустите мастер, запустив его: +VitePress поставляется с мастером настройки командной строки, который поможет вам создать базовый проект. После установки запустите мастер, выполнив команду: ::: code-group @@ -133,13 +133,13 @@ export default { } ``` -Вы также можете настроить поведение темы с помощью опции `themeConfig`. Загляните в главу [Настройка сайта](../reference/site-config) для получения подробной информации обо всех параметрах конфигурации. +Вы также можете настроить поведение темы с помощью опции `themeConfig`. Загляните в главу [Конфигурация сайта](../reference/site-config) для получения подробной информации обо всех настраиваемых параметрах. ### Исходные файлы {#source-files} Файлы Markdown за пределами директории `.vitepress` считаются **исходными файлами**. -VitePress использует **маршрутизацию на основе файлов**: Каждый файл `.md` компилируется в соответствующий файл `.html` с тем же путем. Например, `index.md` будет скомпилирован в `index.html`, и его можно будет посетить по корневому пути `/` результирующего сайта VitePress. +VitePress использует **маршрутизацию на основе файлов**: Каждый файл `.md` компилируется в соответствующий файл `.html` с тем же путём. Например, `index.md` будет скомпилирован в `index.html`, и его можно будет посетить по корневому пути `/` результирующего сайта VitePress. VitePress также предоставляет возможность генерировать чистые URL-адреса, переписывать пути и динамически генерировать страницы. Всё это будет рассмотрено в [Руководстве по маршрутизации](./routing). @@ -159,7 +159,7 @@ VitePress также предоставляет возможность гене } ``` -Скрипт `docs:dev` запустит локальный dev-сервер с мгновенными горячими обновлениями. Запустите его с помощью следующей команды: +Скрипт `docs:dev` запустит локальный dev-сервер с мгновенными горячими обновлениями. Выполните следующую команду: ::: code-group diff --git a/docs/ru/guide/markdown.md b/docs/ru/guide/markdown.md index a021cd18..ffc66f51 100644 --- a/docs/ru/guide/markdown.md +++ b/docs/ru/guide/markdown.md @@ -210,7 +210,7 @@ console.log('Привет, VitePress!') ::: -Кроме того, вы можете установить пользовательские заголовки глобально, добавив следующее содержимое в конфигурацию сайта, полезное, если вы пишете не на английском языке: +Кроме того, можно установить пользовательские заголовки глобально, добавив следующее содержимое в конфигурацию сайта, полезное, если вы пишете не на английском языке: ```ts // config.ts @@ -269,7 +269,7 @@ export default defineConfig({ ## Оповещения в стиле GitHub {#github-flavored-alerts} -VitePress также поддерживает [Оповещения в стиле GitHub](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts) для отображения в виде призывов. Они будут отображаться так же, как и [пользовательские контейнеры](#custom-containers). +VitePress также поддерживает [Оповещения в стиле GitHub](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts) для отображения в виде вставок. Они будут отображаться так же, как и [пользовательские контейнеры](#custom-containers). ```md > [!NOTE] @@ -305,7 +305,7 @@ VitePress также поддерживает [Оповещения в стил ## Подсветка синтаксиса в блоках кода {#syntax-highlighting-in-code-blocks} -VitePress использует [Shiki](https://github.com/shikijs/shiki) для выделения синтаксиса языка в блоках кода Markdown с помощью цветного текста. Shiki поддерживает широкий спектр языков программирования. Всё, что вам нужно сделать, это добавить правильный псевдоним языка к начальным значкам блока кода: +VitePress использует [Shiki](https://github.com/shikijs/shiki) для выделения синтаксиса языка в блоках кода Markdown с помощью цветного текста. Shiki поддерживает широкий спектр языков программирования. Всё, что вам нужно сделать, это добавить правильный псевдоним языка к начальным обратным кавычкам блока кода: **Разметка** @@ -375,7 +375,7 @@ export default { } ``` -Помимо одной строки, вы можете указать несколько отдельных строк, диапазонов или и то, и другое: +Помимо одной строки, можно указать несколько отдельных строк, диапазонов или и то, и другое: - Диапазоны строк, например: `{5-8}`, `{3-10}`, `{10-17}` - Несколько одиночных строк, например: `{4,7,9}` @@ -477,7 +477,7 @@ export default { ## Подсветка различий в блоках кода {#colored-diffs-in-code-blocks} -Добавление в строку комментариев `// [!code --]` или `// [!code ++]` создаст diff этой строки, сохраняя цвета блока кода. +Добавление в строку комментариев `// [!code --]` или `// [!code ++]` подсветит различие этой строки от другой, сохраняя цвета блока кода. **Разметка** @@ -553,9 +553,9 @@ export default { Более подробную информацию см. в секции [`markdown`](../reference/site-config#markdown). -Вы можете добавить метки `:line-numbers` / `:no-line-numbers` в ваши ограждённые блоки кода, чтобы переопределить значение, установленное в конфиге. +Вы можете добавить метки `:line-numbers` / `:no-line-numbers` в ваши изолированные блоки кода, чтобы переопределить значение, установленное в конфиге. -Вы также можете настроить номер начальной строки, добавив `=` после `:line-numbers`. Например, `:line-numbers=2` означает, что номера строк в блоках кода будут начинаться с `2`. +Вы также можете настроить номер начальной строки, добавив `=` после `:line-numbers`. Например, `:line-numbers=2` означает, что нумерация строк в блоках кода будет начинаться с `2`. **Разметка** @@ -628,7 +628,7 @@ const line4 = 'Строка 4' <<< @/snippets/snippet.js{2} ::: tip СОВЕТ -Значение `@` соответствует корню источника. По умолчанию это корень проекта VitePress, если не настроен `srcDir`. Альтернативно вы также можете импортировать из относительных путей: +Значение `@` соответствует корню источника. По умолчанию это корень проекта VitePress, если не настроен параметр `srcDir`. Альтернативно вы также можете импортировать из относительных путей: ```md <<< ../snippets/snippet.js @@ -652,7 +652,7 @@ const line4 = 'Строка 4' <<< @/snippets/snippet-with-region.js#snippet{1} -Вы также можете указать язык внутри фигурных скобок (`{}`) следующим образом: +Кроме того, можно указать язык внутри фигурных скобок (`{}`) следующим образом: ```md <<< @/snippets/snippet.cs{c#} @@ -670,7 +670,7 @@ const line4 = 'Строка 4' ## Группы кодов {#code-groups} -Вы можете сгруппировать несколько блоков кода следующим образом: +Можно сгруппировать несколько блоков кода следующим образом: **Разметка** diff --git a/docs/ru/guide/mpa-mode.md b/docs/ru/guide/mpa-mode.md index 81843708..f3d32537 100644 --- a/docs/ru/guide/mpa-mode.md +++ b/docs/ru/guide/mpa-mode.md @@ -6,7 +6,7 @@ Однако из-за отсутствия навигации SPA межстраничные ссылки будут приводить к полной перезагрузке страницы. После загрузки навигация в режиме MPA будет не такой мгновенной, как в режиме SPA. -Также обратите внимание, что «no-JS-by-default» («без JS по умолчанию») означает, что вы используете Vue исключительно как серверный язык шаблонов. Никаких обработчиков событий в браузере не будет, поэтому интерактивности не будет. Чтобы загрузить JavaScript со стороны клиента, вам нужно использовать специальный тег `