键用于标识软件代码中的可译的字符串。这允许使用一个键(作为可译的字符串的代码名称)仅被 Phrase 引用一次,而不是为该字符串的每个所需翻译引用一次。
一个键可以关联多个译文,每个译文对应项目的不同 language locale。该功能类似于关系数据库中的主键,译文是键的一个属性。键存储在资源文件中,用于标识原文和译文语言。
使用键允许本地化管理平台向译员呈现可译的文本,而无需呈现代码。
通常不需要将键添加到 project 中,因为它们最好是在通过项目页面的 选项卡上传资源文件时创建。
要防止键被上传或创建,请使用 blocking key 功能。如果已阻止的键已经存在,则无法在编辑器中对其进行翻译。
要从导出中排除键,请使用 exclude keys 功能。被排除的键也无法在编辑器中进行翻译。
可以通过在项目页面的 部分或 Strings Editor 窗格顶部选择 More/Duplicate key 来复制项目中的键。
跨一个或多个项目具有相同值的不同翻译键可以关联起来,以实现内容更新的自动化。Linked keys 用于确保跨项目的一致性,并消除对相同内容重复的工作。
对键的更改可以从 Strings Editor 中的 sidebar 活动窗口撤销。
注释
在使用存储库(GitHub、GitLab 等)并删除键时,必须同时从 Phrase 和存储库中删除这些键,才能将其永久删除。这是为了防止因 Phrase 或存储库中的错误或意外而导致键被意外删除。
在 Strings 中,根据上传文件的格式,键可以有不同的类型:
-
字符串 (默认)
注释
译员只能编辑字符串键,除非在高级 项目 设置中启用了 选项。
-
大量
-
布尔值
-
Markdown
-
数字
键类型显示在 编辑器侧边栏 的
键名称在一个项目内必须是唯一的。
命名键有多种策略:
如果未上传键,则可以手动创建它们。
要创建键,请按照以下步骤操作:
-
在 选项卡中,点击 添加键。
“添加键”窗口随即打开。
-
在 选项卡中,提供 、、任何可用的 以及 。
-
如果需要,请从 选项卡中启用 复数形式 并选择复数形式类型。
-
如果需要,请从 选项卡中选择排除的语言。
-
如果需要,请在 选项卡中提供技术详细信息。
例如,可以在 字段中设置翻译的字符限制。如果设置了字符限制,当编辑相关键的翻译时,Strings Editor 中会显示一个指示器。
-
点击保存。
该键已添加到项目中,可以在 选项卡上查看。
从编辑器或 选项卡中删除键将删除该键的所有关联翻译,且无法撤消。
在拥有超过 10,000 个键的项目中,未提及的键将不会在后续上传中计算。未提及的键是指未包含在当前上传中但仍存在于项目中的键。
阻止功能可防止将整个键添加到项目中;如果被阻止键的名称出现在上传的文件中,则该键会被忽略,不会添加到项目中。
阻止用于从项目中省略键,以便它们根本不被管理。
通常被阻止的键:
-
日期和时间格式 Strings。
-
包含配置的键。
-
使用 Phrase gem 管理时会导致问题的键。
在不被处理或维护的单独语言文件中管理被阻止的键。
这些键可能会导致问题,如果使用,则应在创建项目时将其阻止。
-
activemodel.errors* -
number.format* -
number.currency* -
number.percentage* -
datetime.prompts*
要阻止键,请按照以下步骤操作:
-
在项目页面中,选择 选项卡。
-
点击 Add key to the blocked keys list。
窗口打开。
-
提供键的名称或 正则表达式 (regex),然后点击 Save。
该键已添加到列表。
键稍后可以通过点击 进行修改,或通过
进行删除。
某些键可能需要从特定语言中排除,并可被标记为已排除。这些键已上传并存在于项目中,但会被忽略。
已排除的翻译为:
-
从相关语言的导出中排除。
-
从相关语言报告中排除。
如果内容为空,则不计为未翻译。
-
在翻译编辑器中可见但不可编辑。
排除选项:
-
在翻译编辑器中排除某种语言中的单个翻译。
-
在翻译编辑器中排除某种语言中的多个翻译。
-
在创建或编辑键时,通过选择语言来排除多个翻译。
要排除键,请按照以下步骤操作:
也可以通过在 编辑器键列表<1> 中选择键并使用