多语言

  • 配置
  • 多语言
大约 2 分钟

设置语言 重要

你需要为每个语言设置 lang 选项。即使你只在使用单个语言,你也必须在 .vuepress/config.{js,ts} 中设置 lang

为什么要这样做?

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

多语言配置

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

相关信息

有关多语言的详细配置,请见 官方文档open in new window

你应当为每个语言设置 lang 选项,以便主题和插件能够正确的处理它们。

如果站点和主题配置中的 locales 对象只包含 "/" 一个键,则主题不会显示语言切换菜单。当你通过 locales 设置多个键,即存在多个语言的时候,我们会在导航栏显示语言切换菜单。

语言适配

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

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

也欢迎向此仓库中名为 locale.tslocale 文件夹下的所有文件提交 PR。

为每个语言设置主题选项

与站点配置和 @vuepress/theme-default 的主题配置相同,vuepress-theme-hope 也支持你在主题选项中设置 locale 选项,并为每种语言设置不同的配置。

Loading...