Skip to content

i18n & 翻译指南

在翻译之前,您需要先理解fmt库对于字符串格式化的规则

举个例子:

Hello {} 或者 Hello {0}{} 或者 {0} 是占位符,{} 中的数字表示第几个参数,从 0 开始
Hello {0}, {1}{0}{1} 分别表示第 0 个和第 1 个参数

插件默认的翻译文件占位符没有标明数字,但如果语境需要,您可以自行添加数字

例如: 我是{},来自{} 格式化后为 我是abc,来自xxx
您可以按自己需要改成 来自 {1} 的 {0},这样格式化后为 来自 xxx 的 abc

翻译文件格式

插件默认提供简体中文为默认语言,您可以在 plugins/PLand/lang 下找到默认的翻译文件

翻译文件的格式为 json,其中 key 为原句, value 为翻译后的句子

  • zh_CN => en_US
json
{
  "我是{},来自{}": "I am {}, from {}"
}

翻译时,您无需修改键,修改后会导致 i18n 找不到对应的翻译,从而使用内置的翻译

关于贡献

我们非常欢迎您为插件贡献翻译,但请注意以下几点:

  1. 不要减少、删除占位符,除非您知道这样做不会影响翻译
  2. PR 时,请提交到 assets/lang 文件夹下
  3. Pr 前,请先进行测试,确保占位符正常工作

AGPL-3.0 Licensed