Интернационализация

Чтобы использовать встроенные функции i18n, необходимо создать следующую структуру каталогов:

docs/ ├─ es/ │ ├─ foo.md ├─ ru/ │ ├─ foo.md ├─ foo.md

Затем в docs/.vitepress/config.ts:

docs/.vitepress/config.ts

import { defineConfig } from 'vitepress'  export default defineConfig({  // общие свойства и другие вещи верхнего уровня...   locales: {  root: {  label: 'English',  lang: 'en'  },  ru: {  label: 'Русский',  lang: 'ru', // необязательный, будет добавлен как атрибут `lang` в тег `html`  link: '/ru/guide' // по умолчанию /ru/ -- отображается в меню переводов на панели навигации, может быть внешним   // другие свойства, специфичные для локали...  }  } })

Следующие свойства могут быть переопределены для каждой локали (включая корневую):

interface LocaleSpecificConfig<ThemeConfig = any> {  lang?: string  dir?: string  title?: string  titleTemplate?: string | boolean  description?: string  head?: HeadConfig[] // будут объединены с существующими записями в заголовке, дублирующие метатеги будут автоматически удалены  themeConfig?: ThemeConfig // будут неглубоко объединены, общие вещи можно поместить в запись themeConfig верхнего уровня }

Подробнее о настройке текстов-заготовок темы по умолчанию см. в интерфейсе DefaultTheme.Config. Не переопределяйте themeConfig.algolia или themeConfig.carbonAds на локальном уровне. Использование многоязычного поиска описано в главе Поиск Algolia.

Совет: Конфигурационный файл можно хранить и в docs/.vitepress/config/index.ts. Это может помочь вам организовать работу, создав конфигурационный файл для каждой локали, а затем объединить и экспортировать их из index.ts.

Отдельный каталог для каждой локали

Пример многоязычной структуры:

docs/ ├─ en/ │ ├─ foo.md ├─ es/ │ ├─ foo.md ├─ ru/  ├─ foo.md

Однако по умолчанию VitePress не будет перенаправлять / на /en/. Для этого вам нужно будет настроить свой сервер. Например, в Netlify вы можете добавить файл docs/public/_redirects следующим образом:

/* /es/:splat 302 Language=es /* /ru/:splat 302 Language=ru /* /en/:splat 302

Совет: Если вы используете описанный выше подход, вы можете использовать куки nf_lang, чтобы сохранить выбор языка пользователя:

docs/.vitepress/theme/index.ts

import DefaultTheme from 'vitepress/theme' import Layout from './Layout.vue'  export default {  extends: DefaultTheme,  Layout }

docs/.vitepress/theme/Layout.vue

<script setup lang="ts"> import DefaultTheme from 'vitepress/theme' import { useData, inBrowser } from 'vitepress' import { watchEffect } from 'vue'  const { lang } = useData() watchEffect(() => {  if (inBrowser) {  document.cookie = `nf_lang=${lang.value}; expires=Mon, 1 Jan 2030 00:00:00 UTC; path=/`  } }) </script>  <template>  <DefaultTheme.Layout /> </template>

Поддержка RTL (экспериментально)

Для поддержки языков с написанием справа налево укажите dir: 'rtl' в конфиге и используйте какой-нибудь плагин RTLCSS PostCSS, например https://github.com/MohammadYounes/rtlcss, https://github.com/vkalinichev/postcss-rtl или https://github.com/elchininet/postcss-rtlcss. Вам нужно настроить плагин PostCSS на использование :where([dir="ltr"]) и :where([dir="rtl"]) в качестве префиксов, чтобы избежать проблем со спецификой CSS.