多语言配置
这些选项用于配置与语言相关的文本。
如果您的站点是以非内置语言支持以外的其他语言提供服务的，您应该为每个语言设置这些选项来提供翻译。
内置语言支持
主题内置了以下语言支持，包括:
- 简体中文 (
zh-CN) -/zh/ - 繁体中文 (
zh-TW) -/zh-tw/ - 英语 (
en-US) -/en/ - 法语 (
fr-FR) -/fr/ - 德语 (
de-DE) -/de/ - 俄语 (
ru-RU) -/ru/ - 日语 (
ja-JP) -/ja/ - 韩语 (
ko-KR) -/ko/
配置
您应该将配置写入到 theme.locales 中。
您可以在 .vuepress/config.ts ，或者在 .vuepress/plume.config.ts 中进行配置：
import { defineUserConfig } from 'vuepress'
import { plumeTheme } from 'vuepress-theme-plume'
export default defineUserConfig({
theme: plumeTheme({
locales: {
// 非内置语言的语言代码
'/xxx/': {
// 语言配置
}
}
})
})import { defineThemeConfig } from 'vuepress-theme-plume'
export default defineThemeConfig({
locales: {
// 非内置语言的语言代码
'/xxx/': {
// 语言配置
}
}
})详细配置方法请参考：国际化
路径映射
以下是一个多语言站点的目录结构与 URL 路径映射示例：
假设配置如下：
import { defineUserConfig } from 'vuepress'
import { plumeTheme } from 'vuepress-theme-plume'
export default defineUserConfig({
theme: plumeTheme({
locales: {
'/': {
selectLanguageName: '简体中文',
},
'/en/': {
selectLanguageName: 'English',
},
},
}),
})对应的目录结构和 URL 映射如下：
docs
要点说明：
locales对象的key（如/和/en/）决定了 URL 路径前缀- 中文（默认语言）使用
/作为前缀，对应docs/根目录下的文件 - 英文使用
/en/作为前缀，对应docs/en/目录下的文件 - 每种语言的 Markdown 文件结构在该语言的目录下保持一致
.vuepress/目录是共享的配置目录，不需要为每种语言单独配置
appearanceText
- 类型：
string - 默认值：
'Appearance' - 详情： 导航栏中的主题切换按钮的文本。
lightModeSwitchTitle
- 类型：
string - 默认值：
'Switch to light theme' - 详情： 切换到浅色主题按钮的标题（悬停提示）。
darkModeSwitchTitle
- 类型：
string - 默认值：
'Switch to dark theme' - 详情： 切换到深色主题按钮的标题（悬停提示）。
selectLanguageName
类型：
string默认值： 由语言预设提供（如
/→'简体中文'、/en/→'English'）详情：
Locale 的语言名称。
该配置项 仅能在主题配置的 locales 的内部生效 。它将被用作 locale 的语言名称，展示在 选择语言菜单 内。
selectLanguageText
类型：
string默认值：
'Languages'详情：
选择语言菜单 的文本。
如果你在站点配置中设置了多个 locales ，那么 选择语言菜单 就会显示在导航栏中仓库按钮的旁边。
homeText
类型：
string默认值：
'Home'详情： 主页链接的文本。
- 主题默认导航栏中的首页链接的文本。
- 面包屑导航中的首页链接的文本。
postsText
类型：
string默认值：
'Blog'详情： 文章列表页链接的文本。
- 主题默认导航栏中的文章列表页链接的文本。
- 面包屑导航中的文章列表页链接的文本。
postsExtractLabel
- 类型：
string - 默认值：
'Posts Navigation' - 详情： 文章导航面板（包含个人信息、标签、分类、归档入口）的展开按钮的无障碍标签，用于屏幕阅读器。
tagText
类型：
string默认值：
'Tags'详情： 标签链接的文本。
- 主题默认导航栏中的标签链接的文本。
- 博客页中的标签链接的文本。
- 博客标签页中的标题。
categoryText
类型：
string默认值：
'Categories'详情： 分类链接的文本。
- 主题默认导航栏中的分类链接的文本。
- 博客页中的分类链接的文本。
- 博客分类页中的标题。
archiveText
类型：
string默认值：
'Archives'详情： 归档链接的文本。
- 主题默认导航栏中的归档链接的文本。
- 博客页中的归档链接的文本。
- 博客归档页中的标题。
archiveTotalText
- 类型：
string - 默认值：
'{count} articles' - 详情： 归档页中的总文章数的文本。
sidebarMenuLabel
类型：
string默认值：
'Menu'详情：
移动设备下的导航栏中菜单选项的文本。
returnToTopLabel
类型：
string默认值：
'return to top'详情：
移动设备下的导航栏中返回顶部的文本。
closeLabel
类型：
string默认值：
'Close'详情：
关闭按钮的无障碍标签，用于弹窗、面板等关闭按钮。
skipToContentLabel
类型：
string默认值：
'Skip to content'详情：
跳转到主要内容链接的无障碍文本。
mobileNavLabel
类型：
string默认值：
'Mobile navigation'详情：
移动端导航菜单按钮的无障碍标签。
printLabel
类型：
string默认值：
'Print'详情：
打印按钮的无障碍标签。
scrollDownLabel
类型：
string默认值：
'Scroll down'详情：
首页向下滚动指示器的无障碍标签。
sidebarNavigationLabel
类型：
string默认值：
'Sidebar Navigation'详情：
侧边栏导航区域的无障碍名称。
toggleSidebarLabel
类型：
string默认值：
'Toggle sidebar'详情：
侧边栏折叠/展开按钮的无障碍标签。
outlineLabel
类型：
string默认值：
'On this page'详情：
移动设备下的导航栏中大纲标题的文本
editLinkText
- 类型：
string - 默认值：
'Edit this page' - 详情： 编辑链接文本
lastUpdatedText
- 类型：
string - 默认值：
'Last Updated' - 详情： 最近更新时间的文本
contributorsText
- 类型：
string - 默认值：
'Contributors' - 详情： 贡献者的文本
changelogText
- 类型：
string - 默认值：
'Changelog' - 详情： 变更记录的文本
changelogOnText
- 类型：
string - 默认值：
'On' - 详情： 单次变更记录的时间文本
changelogButtonText
- 类型：
string - 默认值：
'View All Changelog' - 详情： 变更记录的按钮文本
copyrightText
- 类型：
string - 默认值：
'Copyright' - 详情： 版权所有的文本
copyrightAuthorText
- 类型：
string - 默认值：
'Copyright Ownership:' - 详情： 版权所有者的文本
copyrightCreationOriginalText
- 类型：
string - 默认值：
'This article link:' - 详情： 本文链接的文本
copyrightCreationTranslateText
- 类型：
string - 默认值：
'This article is translated from:' - 详情： 本文翻译的文本
copyrightCreationReprintText
- 类型：
string - 默认值：
'This article reprint from:' - 详情： 本文转载的文本
copyrightLicenseText
- 类型：
string - 默认值：
'License under:' - 详情： 版权许可证的文本
openNewWindowText
- 类型：
string - 默认值：
'(Open in new window)' - 详情： 外部链接打开新窗口时的无障碍提示文本。
prevPageLabel
- 类型：
string - 默认值：
'Previous Page' - 详情： 上一页的文本
nextPageLabel
- 类型：
string - 默认值：
'Next Page' - 详情： 下一页的文本
notFound
- 类型：
NotFound | undefined - 默认值：
undefined - 详情： 404 页面配置
interface NotFound {
code?: string
title?: string
quote?: string
linkLabel?: string
linkText?: string
}页面上下文菜单（PageContextMenu）
以下选项用于 <PageContextMenu /> 组件的文本，应配置在 theme.locales 中。 该组件需要配合 @vuepress/plugin-llms 使用。
pageContextMenuLabel
- 类型：
string - 默认值：
'Open page actions menu' - 详情： 打开页面操作菜单按钮的无障碍标签。
copyPageText
- 类型：
string - 默认值：
'Copy page' - 详情： 复制页面按钮的文本。
copiedPageText
- 类型：
string - 默认值：
'Copied !' - 详情： 复制成功后的提示文本。
copingPageText
- 类型：
string - 默认值：
'Copying..' - 详情： 正在复制时的提示文本。
copyTagline
- 类型：
string - 默认值：
'Copy page as Markdown for LLMs' - 详情： 复制页面按钮的副标题。
viewMarkdown
- 类型：
string - 默认值：
'View as Markdown' - 详情： 以 Markdown 查看按钮的文本。
viewMarkdownTagline
- 类型：
string - 默认值：
'View this page as plain text' - 详情： 以 Markdown 查看按钮的副标题。
askAIText
- 类型：
string - 默认值：
'Open in {name}' - 详情： 在 AI 平台中打开按钮的文本，
{name}会被替换为平台名称。
askAITagline
- 类型：
string - 默认值：
'Ask {name} about this page' - 详情： 在 AI 平台中打开按钮的副标题，
{name}会被替换为平台名称。
askAIMessage
- 类型：
string - 默认值：
'Read {link} and answer content-related questions.' - 详情： 发送给 AI 平台的提问内容，
{link}会被替换为当前页面的 Markdown 地址。
加密相关文本
以下选项用于自定义加密功能中显示的文本，应配置在 theme.locales 中。详见 加密功能。
encryptGlobalText
类型：
string默认值：
'Only password can access this site'详情：
全站加密时，提示信息。支持 HTML。如果你期望为访客提供获取密码的联系方式，你可能会需要这个配置。
encryptPageText
类型：
string默认值：
'Only password can access this page'详情：
部分加密时，提示信息。支持 HTML。如果你期望为访客提供获取密码的联系方式，你可能会需要这个配置。
encryptButtonText
- 类型：
string - 默认值：
'Confirm' - 详情： 确认按钮的文本
encryptPlaceholder
- 类型：
string - 默认值：
'Enter password' - 详情： 密码输入框的占位符
encryptErrorText
- 类型：
string - 默认值：
'Incorrect password' - 详情： 密码错误时的提示文本，同时作为密码输入框
aria-describedby指向的错误提示内容。
配置示例
import { defineUserConfig } from 'vuepress'
import { plumeTheme } from 'vuepress-theme-plume'
export default defineUserConfig({
theme: plumeTheme({
locales: {
'/': {
encryptButtonText: 'Confirm',
encryptPlaceholder: 'Enter password',
encryptGlobalText: 'Only password can access this site',
encryptPageText: 'Only password can access this page',
}
}
})
})