mirror of
https://gitee.com/dify_ai/dify.git
synced 2024-12-05 04:38:37 +08:00
2.9 KiB
2.9 KiB
前端 i18n 修改
后端多语言支持
api/libs/helper.py:117
中添加对应的语言支持。如:
def supported_language(lang):
if lang in ['en-US', 'zh-Hans', 'de', 'de-AT']:
return lang
添加多语言文件
在 web/i18n/lang
下添加不同模块的多语言文件。文件命令为 模块名.{LANG}.ts。详细参考LANG
引入新添加的多语言文件
在 web/i18n/i18next-config.ts
中 resources 对象中中引入新添加的多语言文件。如:
const resources = {
'en': {...},
'zh-Hans': {...},
// 引入新添加的语言
'new LANG': {
translation: {
common: commonNewLan,
layout: layoutNewLan,
...
}
}
}
翻译过程中的改动
日期格式化的多语言处理
目前日期做多语言格式化的文件涉及到如下 2 个:
1. web/app/components/header/account-setting/members-page/index.tsx
// Line: 78
{dayjs(Number((account.last_login_at || account.created_at)) * 1000).locale(locale === 'zh-Hans' ? 'zh-cn' : 'en').fromNow()}
2. web/app/components/develop/secret-key/secret-key-modal.tsx
// Line:82
const formatDate = (timestamp: any) => {
if (locale === 'en') {
return new Intl.DateTimeFormat('en-US', { year: 'numeric', month: 'long', day: 'numeric' }).format((+timestamp) * 1000)
} else {
return new Intl.DateTimeFormat('fr-CA', { year: 'numeric', month: '2-digit', day: '2-digit' }).format((+timestamp) * 1000)
}
}
看需求做对应的改动。
翻译中带变量的内容的处理
翻译中会存在带变量的情况,变量的值会在运行时被替换。翻译中的变量会用{{ 和 }} 包裹。 翻译带变量的内容时:
- 不能改变量的名称。即:变量的名称不需要做翻译。
- 确保变量填充后,语句仍保持通顺。
查找所有翻译中带变量的方式:在 ./web/i18n/lang 下搜索:{{。
翻译内容太长破坏 UI
如果某个翻译的内容比其他语言的长很多,检查下是否会破坏 UI。
帮助文档
目前的帮助文档的调整逻辑是:中文跳转中文,其他语言跳英文。如果帮助文档也做了多语言。需要做这块的改动。
验证
新增语言包建议通过本地部署最新代码来验证,可参考:https://docs.dify.ai/getting-started/install-self-hosted/local-source-code 验证点:
- 首次初始化安装是否存在新语言下拉选项,以及是否可以用新语言进行初始化
- 个人设置中是否存在新语言下拉选项,以及是否可以选择并保存新语言
- 界面各处文案是否使用新语言来展示,以及文案是否破坏 UI
- 从模板创建应用内容是否均为新语言
- (CLOUD 版)通过 OAuth 授权登录后,是否直接设置当前浏览器语言为界面语言