翻译键

简介

一个 翻译键 是一个唯一标识符，用于将一段内容与其在不同语言中的对应翻译连接起来。在配置某些类型的存储桶时，可以使用这些键启用特定于存储桶的功能，例如 键锁定 或 键忽略。

用户定义的键

在某些文件格式中，翻译键必须显式定义。例如，在以下 JSON 文件中，title、description 和 version 是翻译键：

{
  "title": "Hello, world!",
  "description": "A simple demo app",
  "version": "1.0.0"
}

您可以完全控制这些键的命名。

自动生成的键

在某些文件格式中，翻译键是根据文件的结构自动生成的。例如，以下是 HTML 文件的自动生成键的示例：

• head/0/0
• head/1#content
• body/0/0
• body/1/0
• body/1/1/0

要识别特定内容的自动生成键，请浏览项目的 i18n.lock 文件。

重命名键

当您重构代码并重命名键以便更好地组织时，Lingo.dev CLI 会自动检测内容相同并保留现有翻译。这可以防止仅键标识符更改而实际内容未变时产生不必要的重新翻译工作。

要了解更多信息，请参阅 键重命名。

锁定键

某些内容如技术标识符、组件名称或品牌术语应在所有语言中保持一致。键锁定允许您将特定键排除在翻译处理之外，直接将源值复制到所有目标文件中。

要了解更多信息，请参阅 键锁定。

忽略键

开发、测试或内部内容通常不需要翻译，也不应出现在生产文件中。键忽略完全将这些键排除在翻译处理之外，完全不包含在目标文件中。

要了解更多信息，请参阅 键忽略。