翻译管理

键 (Strings)

文本由 Phrase Language AI 从英语机器翻译而得。

键用于标识软件代码中的可译字符串。这允许使用一个键(作为可译字符串的代码名称)仅被 Phrase 引用一次,而不是为该字符串的每个所需译文分别引用。

一个键可以关联多个译文,每个译文对应项目的不同 语言区域。该功能类似于关系数据库中的主键,译文是键的一个属性。键存储在资源文件中,用于标识原文和译文语言。

使用键可以让本地化管理平台向译员呈现可译文本,而无需呈现代码。

通常不需要将键添加到 项目 中,因为它们最好是在通过项目页面的 语言 选项卡上传资源文件时创建。

要防止上传或创建键,请使用 屏蔽键 功能。如果已屏蔽的键已存在,则无法在编辑器中对其进行翻译。

要从导出中排除键,请使用 排除键 功能。被排除的键也无法在编辑器中进行翻译。

可以通过在项目页面的 部分或 Strings Editor 窗格<3>顶部选择 更多/复制键 来复制项目中的键。

可以将一个或多个项目中具有相同值的不同翻译键链接起来,以自动化内容更新。链接键 用于确保项目间的一致性,并消除对相同内容重复的工作。

可以从 Strings Editor 的 侧边栏 活动窗口中撤销对键的更改。

注释

在使用存储库(GitHub、GitLab 等)并删除键时,必须同时从 Phrase 和存储库中删除这些键,才能将其永久删除。这是为了防止因 Phrase 或存储库中的错误或意外而导致键被意外删除。

键类型

在 Strings 中,根据上传文件的格式,键可以有不同的类型:

  • 字符串(默认)

    注释

    除非在高级 项目 设置中启用了 允许译员编辑所有类型的翻译 选项,否则译员只能编辑字符串键。

  • 大量

  • 布尔值

  • Markdown

  • 数字

键类型显示在 编辑器侧边栏Meta<1> 部分中。

键命名

键名称在一个项目内必须是唯一的。

有多种键命名策略:

  • 描述性

    通过功能来标识原文。这可能会使在阅读代码时更难识别文本,但它将保持不变。

    示例:

    德语

    英语

    fem_char

    die Frau

    woman

    male_char

    der Mann

    man

  • 原文字符串(不推荐)

    直接使用原文作为键,这样可以轻松识别文本的用途。这会带来问题,因为如果原文发生更改,它会破坏与翻译之间的关系。

    示例:

    德语

    法语

    Dog

    Hund

    Chien

    Cat

创建键

如果未上传键,则可以手动创建它们。

要创建键,请按照以下步骤操作:

  1. Keys 选项卡中,点击 Add key

    “添加键”窗口随即打开。

  2. General 选项卡中,提供 NameDescription、任何可用的 Tags 以及 Default translation

  3. 如果需要,请从 Plural forms 选项卡中启用 plural forms 并选择复数形式类型。

  4. 如果需要,请从 Excluded 选项卡中选择排除的语言。

  5. 如果需要,请在 Advanced 选项卡中提供技术细节。

    例如,可以在 Max.字符字段中设置翻译的字符限制。如果设置了该限制,当编辑相关键的翻译时,Strings Editor 中的指示器会显示该字符限制。

  6. 点击保存

    该键已添加到项目中,可以在 Keys 选项卡上查看。

从编辑器或 Keys 选项卡中删除键将删除该键的所有关联翻译,且此操作无法撤销。

在拥有超过 10,000 个键的项目中,未提及的键将不会在后续上传中进行计算。未提及的键是指未包含在当前上传中但仍存在于项目中的键。

已锁定键

锁定可防止将整个键添加到项目中;如果被锁定键的名称出现在上传的文件中,则该键会被忽略,不会添加到项目中。

阻止用于从项目中忽略键,以便它们完全不受管理。

通常被阻止的键:

  • 日期和时间格式 Strings。

  • 包含配置的键。

  • 使用 Phrase gem 管理时会导致问题的键。

在不被处理或维护的单独语言文件中管理被阻止的键。

有问题的键

这些键可能会导致问题,如果使用,应在创建项目时将其阻止。

  • activemodel.errors*

  • number.format*

  • number.currency*

  • number.percentage*

  • datetime.prompts*

阻止键

要阻止键,请按照以下步骤操作:

  1. 在项目页面中,选择 阻止键 选项卡。

  2. 点击 添加键到阻止键列表

    添加键到阻止键列表 窗口打开。

  3. 提供键的名称或 正则表达式 (regex),然后点击 保存

    该键已添加到列表中。

    提示

    AI 聊天机器人可以非常有效地生成和验证正则表达式。

    使用 Regex101 等工具来测试不同输入的正则表达式。

键稍后可以通过点击 Modify 进行修改,或通过 Recycle Bin 进行删除。

排除项

某些键可能需要从特定语言中排除,并可被标记为已排除。这些键已上传并存在于项目中,但会被忽略。

已排除的翻译包括:

  • 从相关语言的导出中排除。

  • 从相关语言报告中排除。

    如果内容为空,则不计为未翻译。

  • 在翻译编辑器中可见但不可编辑。

排除选项:

  • 在翻译编辑器中排除某种语言中的单个翻译。

  • 在翻译编辑器中排除某种语言中的多个翻译。

  • 在创建或编辑键时,通过选择语言来排除多个翻译。

排除键

要排除键,请遵循以下步骤:

  1. 在键页面中,点击需要排除的键的 Modify

    编辑键窗口随即打开。

  2. 选择 排除 选项卡。

  3. 选择要排除的语言。

  4. 点击保存

    所选内容已在指定的键中被排除。

也可以通过在 编辑器键列表<1> 中选择键,并使用 更新状态<2> 菜单,来单独或批量排除键。

这篇文章有帮助吗?

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.