name: kyx-i18n-translation description: 为博客 VitePress 多语言配置(src/.vitepress/config.ts)添加或更新翻译。当用户提到"添加新工具"、"更新关键词"、"翻译"、"多语言"、"i18n"、"新增功能描述"时使用此技能。负责同步更新所有 20 种语言的 description 和 keywords,以及必要时更新 zh-CN 的 UI 翻译文本。
VitePress 多语言翻译
配置文件:src/.vitepress/config.ts
语言列表(共 20 种)
| key | 语言 | 风格说明 |
|---|---|---|
| zh-CN | 简体中文 | 主语言,逗号分隔 |
| zh-TW | 繁體中文 | 繁体字,逗号分隔 |
| en | English | 逗号分隔 |
| ja | 日本語 | 读点(,)分隔 |
| ko | 한국어 | 逗号+空格分隔 |
| fr | Français | 逗号分隔 |
| de | Deutsch | 逗号分隔 |
| es | Español | 逗号分隔 |
| pt | Português | 逗号分隔 |
| ru | Русский | 逗号分隔 |
| ar | العربية | 逗号+空格分隔 |
| hi | हिन्दी | 逗号分隔 |
| it | Italiano | 逗号分隔 |
| nl | Nederlands | 逗号分隔 |
| tr | Türkçe | 逗号分隔 |
| vi | Tiếng Việt | 逗号分隔 |
| th | ภาษาไทย | 逗号分隔 |
| id | Indonesia | 逗号分隔 |
| pl | Polski | 逗号分隔 |
| sv | Svenska | 逗号分隔 |
每个语言条目的结构
每个语言 key 对应对象结构如下:
'zh-CN': {
lang: "zh-CN",
label: "简体中文",
description: "...", // <meta name="description"> 的内容
head: [
["meta", { name: "keywords", content: "..." }] // <meta name="keywords">
],
themeConfig: { ... } // 仅 zh-CN 有完整 UI 翻译
}
注意:
description和head[keywords].content内容完全一致,两处都要同步更新。
添加新工具/功能时的翻译流程
- 确定 zh-CN 的新词条(简体中文原文,如:
文字识别) - 将新词条翻译成所有其他 19 种语言
- 在每个语言 key 中,将翻译好的词追加到
description和head[keywords].content末尾 - 格式:保持与现有内容一致的分隔符风格(见语言列表中的风格说明)
参考现有词条对照
| zh-CN | zh-TW | en | ja | ko |
|---|---|---|---|---|
| 在线工具 | 線上工具 | Online tools | オンラインツール | 온라인 도구 |
| 图片压缩 | 圖片壓縮 | image compression | 画像圧縮 | 이미지 압축 |
| PDF转Word | PDF轉Word | PDF to Word | PDF to Word | PDF to Word |
| 视频压缩 | 視頻壓縮 | video compression | ビデオ圧縮 | 비디오 압축 |
| Base64编解码 | Base64編碼 | Base64 encoding | Base64エンコーディング | Base64 인코딩 |
更新 UI 翻译(themeConfig)
仅 zh-CN 区块有 themeConfig,包含:
- 搜索框文案(
search.options.translations) - 页面标签(
outlineTitle、lastUpdatedText、docFooter) - 404 页面文案(
notFound)
添加新的 UI 功能时,在 zh-CN.themeConfig 对应位置填写中文翻译。
快速检查清单
- zh-CN
description已更新 - zh-CN
head[keywords]已更新 - 其余 19 种语言的
description已更新 - 其余 19 种语言的
head[keywords]已更新 - 分隔符风格与原文一致
- 翻译准确(不使用机器翻译腔)