本地化语言
Logto 支持多种预定义语言，并提供 113 个额外的语言标签。这个强大的工具允许你通过创建和管理自己的语言选项和翻译来定制登录体验。
在 Logto 控制台中的自定义步骤
在 Logto 控制台中轻松自定义语言设置，无需 编码。
- 导航到：Console > Sign-in experience > Content > Languages。
- 管理语言：点击“管理语言”按钮以访问你的语言库。
- 编辑现有语言： 自定义 Logto 提供的语言的翻译。这些语言不能被删除，但你的更改将覆盖默认值。
- 添加新语言：点击“添加语言”按钮，选择一个语言标签，提供你的翻译，然后保存更改以添加新语言。
- 启用自动检测：启用后，根据用户设备设置自动显示用户首选语言的登录页面。
- 设置默认语言： 你可以从语言库中选择一种默认语言。当检测到的用户语言不在当前语言库中时，将使用该默认语言。
以下是管理语言时需要了解的一些关键术语：
| 定义 | 描述 |
|---|---|
| 语言标签 | 语言标签用于标识内容的语言。语言标签由语言代码（例如，en, fr, zh）和国家/地区代码（例如，US, UK, KR）组成，中间用连字符分隔。语言标签看起来像这样：en-US。 |
| Logto 提供的语言 | Logto 提供的语言是 Logto 官方语言，存储在 Logto 原始代码库中。 |
| 添加的语言 | 添加的语言是用户添加的语言。 |
| Logto 源值 | Logto 源值是 Logto 提供的尚未被用户自定义的值。 |
| 自定义值 | 自定义值是用户已经自定义的值。 Logto 源值将被覆盖。 |
使用管理 API 进行自定义
你可以使用管理 API PUT /api/custom-phrases/{languageTag} 来自定义语言翻译。API 请求体是一个部分区域对象，如下所示：
{
"input": { "username": "Username", "password": "Password" },
"secondary": {
"social_bind_with": "Already had an account? Sign in to link {{methods, list(type: disjunction;)}} with your social identity."
},
"action": { "sign_in": "Sign in" },
"error": {
"general_required": "{{types, list(type: disjunction;)}} is required"
},
"list": { "or": "or" },
"user_scopes": {
"descriptions": { "custom_data": "Your custom data" }
}
}
请参考 源代码 查看所有可自定义的内容。
你还可以使用 PATCH /api/sign-in-exp API 来控制 语言检测策略。
使用案例
添加的语言如何呈现给终端客户？
假设你有一个网站，默认语言是英语，并且启用了自动检测。一位来自日本的用户偶然访问了你的网站，并决定创建一个账户。如果他/她使用日语作为应用语言，但 Logto 尚不支持该语言，登录界面将以英语显示。
Logto 登录体验 i18n 使自定义语言成为可能。
点击 ja 语言标签以添加你自己的日语翻译。
这样，访问你网站的日本用户将能够阅读你刚从英语翻译过来的日语内容。
常见问题
如果我添加的语言成为 Logto 提供的语言怎么办？
在左侧的语言标签旁边，将出现一个 Logto 提供的标签，你添加的语言将不再可移除。修改后的值将继续生效并替换原始的 Logto 值。删除用户提供的值以使用 Logto 默认配置提供的值。
如果我只添加了一些自定义值怎么办？
最终用户看到的是两列合并的结果。 假设你只想对 Logto 提供的原始内容副本的一个子集进行调整。你的注册界面与 Logto 提供的界面的唯一区别将是你编辑的键。其余内容将保持不变。