国くに际化

要よう使用しよう内ない置おけ的てき i18n (国くに际化) 功こう能のう，需要じゅよう创建类似于下面めん的てき目め录结构：

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

然しか后きさき在ざい docs/.vitepress/config.ts 中なか：

import { defineConfig } from 'vitepress'

export default defineConfig({
  // 共きょう享とおる属性ぞくせい和わ其他顶层内容ないよう...

  locales: {
    root: {
      label: 'English',
      lang: 'en'
    },
    fr: {
      label: 'French',
      lang: 'fr', // 可か选，将しょう作さく为 `lang` 属性ぞくせい添加てんか到いた `html` 标签中ちゅう
      link: '/fr/guide' // 默だま认 /fr/ -- 显示在ざい导航栏翻译菜单上，可か以是外部がいぶ的てき

      // 其余 locale 特定とくてい属性ぞくせい...
    }
  }
})

下面かめん的てき属ぞく性能せいのう够被每ごと个 locale 覆くつがえ盖 (包括ほうかつ root)：

interface LocaleSpecificConfig<ThemeConfig = any> {
  lang?: string
  dir?: string
  title?: string
  titleTemplate?: string | boolean
  description?: string
  head?: HeadConfig[] // 将はた与あずか现有的てき头部条目じょうもく合あい并，重じゅう复的元もと标签将はた自じ动删除じょ
  themeConfig?: ThemeConfig // 会かい进行浅あさ层合并，常つね见内容ないよう可か放ひ在ざい顶层的てき themeConfig 属性ぞくせい中ちゅう
}

有ゆう关自定てい义默认主题的文ぶん本ほん占うらない位い符ふ的てき信しん息いき，请参考さんこう DefaultTheme.Config 接せっ口こう。不要ふよう在ざい locale 级别覆盖 themeConfig.algolia 或ある themeConfig.carbonAds。想そう获取多た语言搜索そうさく的てき信しん息いき，请参考さんこう Algolia 文ぶん档。

提示ていじ：配置はいち文ぶん件けん也可以是 docs/.vitepress/config/index.ts。通つう过为每ごと个语言げん环境创建一いち个配置はいち文ぶん件けん，然しか后きさき从 index.ts 合ごう并并导出它们，可か以更好このみ的てき组织文ぶん件けん。

为本地ち化か设置子こ目め录

下面かめん是ぜ一个组织良好的结构：

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

但ただし是ぜ，VitePress 默だま认不会かい将はた / 重定しげさだ向こう到いた /en/。需要じゅよう配置はいち服ふく务器来らい实现这一いち点てん。例れい如，在ざい使用しよう Netlify 时，可か以添加てんか一いち个 docs/public/_redirects 文ぶん件けん，如下所しょ示しめせ：

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

提示ていじ： 如果使用しよう上述じょうじゅつ的てき方法ほうほう，可か以使用しようnf_lang cookie 来らい保存ほぞん用よう户的语言选择。例れい如，可か以在主ぬし题中添加てんか以下いか代だい码：

// 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 } 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 支持しじ (实验性せい功こう能のう)

支持しじ 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 特とく异性问题。