Skip to content

多语言

你可以在 Artalk 控制中心的设置页面选择语言,或通过环境变量 ATK_LOCALE 和配置文件 artalk.ymllocale 配置项设置 Artalk 的语言。

yml
locale: zh-CN

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


目前 Artalk 支持语言如下:

  • "en" (English)
  • "zh-CN" (简体中文)
  • "zh-TW" (繁体中文)
  • "ja" (日本語)
  • "ko" (한국어)
  • "fr" (Français)
  • "ru" (Русский)

贡献翻译

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

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

更多参考:开发文档 / 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: {
    email: 'Eメール',
    //...
  },
})