国际化

Teek 已经兼容 Vitepress 的 国际化 功能。

特殊场景

这里对一个特殊场景进行说明。

Vitepress 支持的国际化文档目录如下：

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

根目录下的 foo.md 是 root 语言（默认语言）的文档，当 Markdown 文件多起来时，根目录下文件显得很拥挤，那么可以将这些文档放到一个目录下，假设默认语言是 zh，则：

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

但是 Vitepress 无法感知到 root 语言（默认语言）的文档已经放到 zh 目录下，它依然只扫描根目录的 Markdown 文件作为默认语言的文档，因此需要使用 Vitepress 提供的 rewrites 进行重定向，同时 Teek 也无法感知文档进行了移动，因此需要配置 vitePlugins.sidebarOption.localeRootDir

import { defineConfig } from "vitepress";
import defineTeekConfig from "vitepress-theme-teek/config";

// Teek 主题配置
const teekConfig = defineTeekConfig({
  vitePlugins: {
    sidebarOption: {
      localeRootDir: "zh",
    },
  },
});

// Vitepress 配置
export default defineConfig({
  rewrites: {
    "zh/:rest*": ":rest*",
  },
});