翻译管理

键 (Strings)

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

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

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

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

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

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

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

可以通过在项目页面的 Keys 部分或 Strings Editor 窗格顶部选择 More/Duplicate key 来复制项目中的键。

跨一个或多个项目具有相同值的不同翻译键可以关联起来,以实现内容更新的自动化。Linked keys 用于确保跨项目的一致性,并消除对相同内容重复的工作。

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

注释

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

键类型

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

  • 字符串 (默认)

    注释

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

  • 大量

  • 布尔值

  • Markdown

  • 数字

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

键命名

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

命名键有多种策略:

  • 描述性

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

    示例:

    德语

    英语

    fem_char

    die Frau

    woman

    male_char

    der Mann

    man

  • 原文/源语 Strings (不推荐)

    使用原文/源语本身作为键,这使得识别文本的使用变得容易。这存在问题,因为如果原文/源语发生变化,它会破坏与翻译之间的关系。

    示例:

    德语

    法语

    Dog

    Hund

    Chien

    Cat

创建键

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

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

  1. Keys 选项卡中,点击 添加键

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

  2. General 选项卡中,提供 名称描述、任何可用的 标记 以及 默认翻译

  3. 如果需要,请从 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. 在项目页面中,选择 Blocked keys 选项卡。

  2. 点击 Add key to the blocked keys list

    Add key to the blocked keys list 窗口打开。

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

    该键已添加到列表。

    提示

    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.