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