Trantor国际化(多语言配置)

1. 概述

1.1 简介

国际化功能最终的结果，指的是工作台透出的文本信息支持“多语言”切换，能够适配终端用户的多语言需求。

完整功能主要包括两个部分：

高效率的资源翻译配置；
工作台的多语言切换；

本文档主要阐述以上两点规则与配置方法

1.2 名词解释

名词	释义	举例
国际化资源点	所有需要国际化的文本都称为国际化资源点，包括：有归属的资源点 * 模型定义中的文本；无归属的资源点 * View DSL 中显式定义的文本； * 模型静态校验提示文本； * 业务异常文本	* 按钮label * 字段名 * ”请输入密码“等前端静态提示文案 * “网络异常”“订单生成失败”等业务异常文本
语言包	国际化资源点的单语种译文资源包	U.S English、简体中文、繁体中文（香港）
译文	对应语言包下，国际化资源点的翻译文本，最多100字不限制格式	英文包中的姓名，译文对应为“Name”

1.3 服务场景

终端用户：将系统切换成自己所需的语言版本
开发者/实施方配置：
- 为系统新增一种语言；
- 新业务的多语言翻译配置；
- 新/老业务的翻译校对配置；
协助翻译人员（PD、运营、译员等）：国际化资源点的译文表格批量导入

i18n方案：https://yuque.antfin.com/trantor/design/fev2c3

2. 多语言配置（交付控制台）

一个新的语言包上线，需经历以下流程：

语言包维护：新建一个”初始化“的语言包；
国际化资源点译文维护：定义上述”初始化“语言包中的译文资源
研发态环境发布：发布线上
（非必要）运行态环境配置：设定默认语言

2.1 研发中心（多语言维护）

通过应用去区分了多语言的内容，即需要先选择进入对应的应用后，才会看见对应的语言包的内容。

2.1.1 语言包维护

2.1.1.1 选择应用

2.1.1.2 应用下的语言包资源

只有启用了语言包才会在后续操作中或者项目运行中生效！！！

特别提醒：新增语言包只能进入最顶层的应用(左上角图标下的应用)，才会看见新增语言包的按钮操作。

如上图，主要包含的配置有：

新增语言：维护语言包名称与描述，创建出一个“初始化”的新语言包；（初始化语言包未包含任何译文资源）
编辑语言包：二次维护语言包名称与描述；
语言包状态：
- 停/启用：停启用决定了在运行态的统一工作台是否能切换到对应的语言
- 删除：逻辑删除；
机翻：机翻是调用第三方接口将指定资源进行翻译，会覆盖已经维护好的译文。机翻弹窗如下图：
- 机翻的目标语言取自语言包语言，不能修改；
- 指定一个源语言，以及对应的翻译范围（必选）。提交后将对应范围的资源进行“第三方”接口自动翻译；
- 处理过程非“异步”；
- 若选取了模型范围，源语言需对应上模型语言，否则校验失败；
导入：批量配置/替换语言包中的国际化资源点译文

(重要)目前导入的应用场景是要搭配”导出“使用，先导出文件线下翻译后，重新导回线上完成配置/替换译文

导出的模板如下图：

说明：
- 系统会导出当前语言包的全量”国际化资源点“信息，操作者需配置：
  - 文本sheet的”原文本“和”翻译“
  - 模型&字典&应用菜单&权限&消息sheet的”翻译“
- 导入过程中，只导入识别成功的资源译文。
  
  识别异常的如“校验失败、资源识别异常、查无此资源”的情况，不中断导入；
- 导入过程中，若原资源译文有值，执行的是译文覆盖操作；
- 导入过程是异步的；
- 导入的弹窗如下图，文件必传，且会校验格式(xlsx)与大小(≤100MB)
导出：将当前语言包的译文资源导出至本地excel，导出过程是异步的，通过链接下载”解析完毕“后的文件。文件内容同导入模板，仅包含当前语言包的译文资源”原文本——翻译“
语言包排序：”启用“状态的语言包在列表中的排序，决定了工作台切换语言时的排序，如下图
”翻译“：译文维护页面入口