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