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