Skip to content

多语言

在配置文件 artalk.yml 中设置:

yaml
locale: "zh-CN"

locale 配置项格式遵循 Unicode BCP 47 规范,默认为 "zh-CN" (简体中文)。


目前 Artalk 支持语言如下:

  • "zh-CN" (简体中文)
  • "en-US" (English)

贡献翻译

欢迎提交 PR 帮助翻译 Artalk 的多语言,为社区贡献一份力量!

翻译内容语言文件目录模板文件
后端程序/i18n/[LANG].ymlzh-CN.yml
前端界面/ui/artalk/src/i18n/[LANG].tszh-CN.ts
配置文件/conf/artalk.example.[LANG].ymlartalk.example.zh-CN.yml
说明文档/docs/[LANG]/**/*.md/docs/**/*.md

更多参考:开发文档 / CONTRIBUTING.md

进阶配置

前端临时修改语言

前端会默认使用后端的语言配置,但你也可以在前端修改配置项 locale 来设定语言:

js
Artalk.init({
  locale: 'en-US'
})

前端语言自动切换

可将前端 locale 配置为 "auto",根据用户浏览器自动切换语言,当语言不存在时,将被设置为 "en-US"。

js
Artalk.init({
  locale: "auto"
})

前端自定义 locale 内容

在前端可传入 Object 类型,按照 模板文件 中的 Keys 编写自定义 locale 内容。

js
Artalk.init({
  locale: {
    placeholder: 'こんにちは',
    //...
  }
})