.JSON - Phrase Strings

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

文件扩展名	.json
API 扩展	strings_json
导入	是
导出	是
复数形式支持	是
描述支持	是
状态支持	是
元数据支持	是
格式选项	ignore_translation_state export_translation_state export_description export_tags export_system_tags export_max_characters_allowed custom_metadata_columns export_use_ordinal_rules

Phrase Strings JSON 格式提供了一种结构化的方式来存储和管理翻译，结合了元数据、状态跟踪和工作流集成，以增强功能。

此格式包含元数据，例如本地化详细信息、字符限制、描述、复数形式类型以及翻译状态。状态支持功能可以更好地跟踪翻译进度并与自动化工作流集成。

字段定义

键对象

键对象包含每个翻译键的元数据和设置。

字段	必需的	类型	说明
`名称`	是	字符串	键的唯一标识符。
`description`	否	字符串	对键用途的简要说明。
`plural`	否	布尔值	指定键是否支持复数形式。
`use_ordinal_rules`	否	布尔值	指示键的复数形式是否为序数。如果省略，则默认为 `false`。在导入和导出期间使用。
`max_characters_allowed`	否	整数/空值	允许的最大字符数。`null` 表示无限制。
`tags`	否	大量	用于筛选和组织的标记。
`metadata`	否	对象	将附加元数据存储为键值对。它可以被添加或更新，但不能被移除。要移除元数据，请将其值设置为空字符串。

翻译对象

翻译对象包含给定键的本地化翻译。

字段	必需的	类型	说明
`区域`	是	字符串	项目/语言中配置的区域名称或标识符。此值决定了导入期间的匹配。如果它与现有的语言名称不完全匹配，则不会导入该翻译。
`locale_code`	否	字符串	区域的语言代码（例如，en-US，fr-FR）。
`内容`	是	字符串/对象	翻译后的内容。如果是复数形式，则是一个基于键的`use_ordinal_rules`设置来映射复数形式的对象。
`状态`	否	字符串	翻译的状态。支持的翻译状态：未翻译未验证已翻译已审校

格式选项

标识符	ignore_translation_state
类型	布尔值
上传	是
下载	否
默认	false
说明	如果为 true，则在导入的翻译中忽略状态值，这意味着上传的文件不会覆盖现有的翻译状态。

标识符	export_translation_state
类型	布尔值
上传	否
下载	是
默认	true
说明	在导出的翻译中包含状态值；如果设置为 false，则导出文件中将省略状态信息。

标识符	export_system_tags
类型	布尔值
上传	否
下载	是
默认	false
说明	如果为 true，则导出系统标记以及键和翻译。

标识符	export_tags
类型	布尔值
上传	否
下载	是
默认	false
说明	如果为 true，则导出标记以及键和翻译。

标识符	export_description
类型	布尔值
上传	否
下载	是
默认	true
说明	导出键描述。

标识符	export_max_characters_allowed
类型	布尔值
上传	否
下载	是
默认	true
说明	导出键字符限制以及键和翻译。

标识符	custom_metadata_columns
类型	哈希
上传	否
下载	是
默认	[empty]
说明	需要导入或导出的 custom metadata 值的 HashMap：键 = 自定义元数据属性的名称，定义于 Phrase Strings 中。值 = 属性在导入文件中的列索引（1、2、3 等）/属性在导出文件中应在的位置。

标识符	export_use_ordinal_rules
类型	布尔值
上传	否
下载	是
默认	false
说明	如果为 true，则 `use_ordinal_rules` 字段将显示在下载的文件中。如果通过 UI 下载文件，请使用相应的选项 Add plural type for each key。

代码示例

{
  "welcome_message": {
    "key": {
      "description": "欢迎屏幕上显示的消息",
      "plural": false,
      "max_characters_allowed": 100,
      "tags": ["UI", "greeting"],
      "metadata": {
        "created_by": "admin",
        "created_at": "2024-06-20T12:34:56Z"
      }
    },
    "translations": [
      {
        "locale": "英语（美国）",
        "locale_code": "en-US",
        "content": "欢迎使用我们的应用程序！",
        "state": "reviewed"
      },
      {
        法语（法国）
        "locale_code": "fr-FR",
        "content": "欢迎使用我们的应用程序！",
        "state": "translated"
      }
    ]
  }
}

复数形式

此格式使用命名的类别来标识键的不同复数形式。以下类别作为复数形式保留：

.zero | .one | .two | .few | .many | .other

正确识别、保留和标记复数键的名称示例：

inbox.messages.notification.one
inbox.messages.notification.other

复数形式的使用通过 use_ordinal_rules 字段进行配置。如果 use_ordinal_rules 为 false 或未设置，则将应用基数复数规则。

示例输入

{
  "rank": {
    "use_ordinal_rules": true,
    "values": {
      "one": "1st place",
      "two": "2nd place",
      "few": "3rd place",
      "other": "%dth place"
    }
  }