多语言
在配置文件 artalk.yml
中设置:
yaml
locale: "zh-CN"
locale: "zh-CN"
locale 配置项格式遵循 Unicode BCP 47 规范,默认为 "zh-CN" (简体中文)。
目前 Artalk 支持语言如下:
- "zh-CN" (简体中文)
- "en-US" (English)
贡献翻译
欢迎提交 PR 帮助翻译 Artalk 的多语言,为社区贡献一份力量!
翻译内容 | 语言文件目录 | 模板文件 |
---|---|---|
后端程序 | /i18n/[LANG].yml | zh-CN.yml |
前端界面 | /ui/packages/artalk/src/i18n/[LANG].ts | zh-CN.ts |
配置文件 | /conf/artalk.example.[LANG].yml | artalk.example.zh-CN.yml |
说明文档 | /docs/[LANG]/**/*.md | /docs/**/*.md |
更多参考:开发文档 / CONTRIBUTING.md
进阶配置
前端临时修改语言
前端会默认使用后端的语言配置,但你也可以在前端修改配置项 locale
来设定语言:
js
Artalk.init({
locale: 'en-US'
})
Artalk.init({
locale: 'en-US'
})
前端语言自动切换
可将前端 locale 配置为 "auto"
,根据用户浏览器自动切换语言,当语言不存在时,将被设置为 "en-US"。
js
Artalk.init({
locale: "auto"
})
Artalk.init({
locale: "auto"
})
前端自定义 locale 内容
在前端可传入 Object 类型,按照 模板文件 中的 Keys 编写自定义 locale 内容。
js
Artalk.init({
locale: {
placeholder: 'こんにちは',
//...
}
})
Artalk.init({
locale: {
placeholder: 'こんにちは',
//...
}
})