多语言

设置语言 重要

你需要为每个语言设置 lang 选项。

即使你只在使用单个语言，你也必须在并非使用默认 en-US 的情况下，在 .vuepress/config.{js,ts} 中设置 lang。

为什么要这样做?

要提供正确的语言环境文本，主题需要知道根文件夹以及每个多语言文件夹正在使用哪种语言。

单语言

.vuepress/config.ts

import { 
defineUserConfig
 } from "vuepress";

export default 
defineUserConfig
({
  // 设置正在使用的语言
  
lang
: "zh-CN",
});

多语言

.vuepress/config.ts

import { 
defineUserConfig
 } from "vuepress";

export default 
defineUserConfig
({
  
locales
: {
    "/": {
      // 设置正在使用的语言
      
lang
: "zh-CN",
    },
    "/en/": {
      // 设置正在使用的语言
      
lang
: "en-US",
    },
  },
});

多语言配置

locales 是一个对象，其键为每个语言的路径前缀，值为该语言的配置，可以包含 title, description, lang 等。

如果站点和主题配置中的 locales 对象只包含 "/" 一个键，那么站点不会被视为多语言的。

相关信息

有关多语言的详细配置，请见 官方文档。

语言适配

• 简体中文 (zh-CN)
• 繁体中文 (zh-TW)
• 英文(美国) (en-US)
• 德语 (de-DE)
• 德语(澳大利亚) (de-AT)
• 俄语 (ru-RU)
• 乌克兰语 (uk-UA)
• 越南语 (vi-VN)
• 葡萄牙语(巴西) (pt-BR)
• 波兰语 (pl-PL)
• 法语 (fr-FR)
• 西班牙语 (es-ES)
• 斯洛伐克 (sk-SK)
• 日语 (ja-JP)
• 土耳其语 (tr-TR)
• 韩语 (ko-KR)
• 芬兰语 (fi-FI)
• 印尼语 (id-ID)
• 荷兰语 (nl-NL)

注

如果你需要其他语言的多语言支持，你可以为主题和插件设置多语言，这也使你能够自定义内置多语言配置。有关详细信息，请参阅 主题多语言选项。

我们也欢迎你向仓库中名为 locale.ts 或 locale 文件夹下的所有文件提交 PR 增加新语言。

为每个语言设置主题选项

类似站点配置和 @vuepress/theme-default 的主题配置，vuepress-theme-hope 也在主题选项中支持 locales，因此你可以为每种语言设置不同的配置。

.vuepress/config.ts

import { 
defineUserConfig
 } from "vuepress";
import { 
hopeTheme
 } from "vuepress-theme-hope";

export default 
defineUserConfig
({
  
locales
: {
    "/": {
      
lang
: "en-US",
    },
    "/zh/": {
      
lang
: "zh-CN",
    },
  },

  
theme
: 
hopeTheme
({
    // 通用配置
    // ...
    
locales
: {
      "/": {
        // 英文配置
        // ...
      },
      "/zh/": {
        // 中文配置
        // ...
      },
    },
  }),
});