diff --git a/docs/ru/guide/i18n.md b/docs/ru/guide/i18n.md index 87858c68..6ef839fe 100644 --- a/docs/ru/guide/i18n.md +++ b/docs/ru/guide/i18n.md @@ -57,6 +57,37 @@ interface LocaleSpecificConfig { **Совет:** Конфигурационный файл можно хранить и в `docs/.vitepress/config/index.ts`. Это может помочь вам организовать работу, создав конфигурационный файл для каждой локали, а затем объединить и экспортировать их из `index.ts`. +## Локализованные Markdown-строки {#per-locale-markdown-strings} + +Строки, встраиваемые в страницы Markdown-рендерером, — стандартные заголовки [пользовательских контейнеров](./markdown#custom-containers), [оповещений в стиле GitHub](./markdown#github-flavored-alerts), а также строки кнопки копирования кода — можно переопределить для каждой локали с помощью ключа `markdown` в записи соответствующей локали: + +```ts [docs/.vitepress/config.ts] +import { defineConfig } from 'vitepress' + +export default defineConfig({ + locales: { + root: { label: 'English', lang: 'en' }, + zh: { + label: 'Русский', + lang: 'ru', + markdown: { + container: { + tipLabel: 'Подсказка', + warningLabel: 'Предупреждение' + // ...остальные метки, а также заголовки `customContainers` + }, + codeCopyButton: { + tooltipText: 'Копировать код', + copiedText: 'Скопировано' + } + } + } + } +}) +``` + +Если значение не задано для конкретной локали, используется соответствующее значение из параметров `markdown` корневого уровня. Записи локалей могут переопределять только заголовки контейнеров, зарегистрированных на корневом уровне — регистрация новых контейнеров отдельно для каждой локали не поддерживается. Также обратите внимание, что, поскольку Markdown-рендерер создаётся один раз для всего сайта, эти параметры можно объявлять только в основном файле конфигурации, а не в дополнительных конфигурационных файлах. + ## Отдельный каталог для каждой локали {#separate-directory-for-each-locale} Пример многоязычной структуры: