.XLSX - Spreadsheet Excel (Strings)

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

文件扩展名	.xlsx
API 扩展	xlsx
导入	是
导出	是
复数形式支持	是
描述支持	是
格式选项	key_name_column comment_column tag_column first_content_row enable_pluralization export_tags export_max_characters_allowed custom_metadata_columns

.XLSX 是一种广泛使用的本地化文件格式。虽然 .XLSX 文件的布局可能因特定设置而异，但它通常遵循每语言一列的惯例。要翻译 .XLSX，请至少提供键列和一个翻译列。默认情况下，内容假定在第一行开始。除了键和翻译外，还可以导入备注、tags 和允许翻译的最大字符数等元数据。

需要 `%区域_映射 `%参数（哈希图类型）来指定文档中的哪一列对应于每个区域。有关上传的示例，请参阅配置文件示例和 API Orchestratordocumentation。

格式选项

标识符	key_name_column
类型	字符串
上传	是
下载	否
默认	[ empty]
说明	包含键/标识的列。

标识符	comment_column
类型	字符串
上传	是
下载	否
默认	[ empty]
说明	包含键备注/说明的列。

标识符	tag_column
类型	字符串
上传	是
下载	否
默认	[ empty]
说明	包含键标签的列的索引。

标识符	first_content_row
类型	整数
上传	是
下载	否
默认	1
说明	包含翻译内容的第一行索引。

标识符	enable_pluralization
类型	布尔值
上传	是
下载	否
默认	true
说明	启用复数键检测。所有匹配的键将作为复数键保留。

标识符	export_tags
类型	布尔值
上传	否
下载	是
默认	false
说明	导出 tags 以及键和翻译。

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

标识符	custom_metadata_columns
类型	哈希
上传	是
下载	是
默认	[ empty]
说明	需要导入或导出的自定义元数据值的哈希图：键 = Phrase Strings 中定义的自定义义元数据属性的名称。值 = 属性在导入文件中/属性应该在导出文件中的列标识符（A、B、C 等）。

结构示例

key_name	en_US	de-DE*	备注*	tags*	max_characters*
app_title	我的项目	Mein Projekt	这是主标题	app，标题	30
问候语	您好“用户”！	您好“用户”!	礼貌点

*可选列

电子表格文件至少需要键和一种语言订单上传。除了添加语言外，还可以添加以下列来添加元信息：

备注:=%为键添加说明
tags:=%为文件中的单个键添加tags
max_字符：通过上传为键设置字符限制

配置示例

a=%.phraseapp.yml 中 push Orchestrator 部分的示例，适用于 XLSX 文件。

push:
    sources:
        - 文件：“./en.xlsx”
          params:
              file_format: xlsx
              update_translations: true
              format_options:
                  key_name_column:A
                  comment_column:C
                  first_content_row:2
                  tag_column:D
              locale_mapping:
                  en:B