翻译键

简介

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

用户自定义键

在某些文件格式中，必须显式定义翻译键。例如，在以下 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 会自动检测内容未变，并保留已有翻译。这样可以避免仅因键名变更而导致的重复翻译工作。

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

键锁定

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

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

键忽略

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

要了解更多信息，请参见 Key ignoring。