.XLSX - Excel 电子表格 (Strings)

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

文件扩展名	.xlsx
API 扩展	xlsx
导入	是
导出	是
复数形式支持	是
描述支持	是
格式选项这些选项可以在上传和/或下载文件时指定。根据上传/下载方法（API、CLI、Repo 同步等），它们可以在查询参数 `上传`、`下载` 或 `phrase.yml` 配置文件中指定。	key_name_column comment_column tag_column first_content_row enable_pluralization export_tags export_max_characters_allowed custom_metadata_columns translation_columns

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

如果上传的文件包含多个工作表或标签页，则仅检测第一个工作表。如果需要本地化内容，请将工作表或标签页保存为单独的文件

需要 locale_mapping 参数（类型为 hashmap）来指定文档中的哪一列对应于每个区域。有关示例，请参阅配置文件示例以及用于上传的 API 文档。

格式选项

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

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

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

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

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

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

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

标识符	custom_metadata_columns
类型	hash
上传	是
下载	是
默认	[empty]
说明	需要导入或导出的自定义元数据值的 hashmap：键 = 自定义元数据属性的名称，定义于 Phrase Strings 中。值 = 列 ID (A, B, C 等)，即属性在导入文件中的位置/属性在导出文件中应在的位置。

标识符	translation_columns
类型	hash
上传	是
下载	是
默认	[empty]
说明	语言 ID/名称 = 自定义元数据属性的列，定义于 Phrase Strings 中。值 = 列 ID (A, B, C 等)，即属性在导入文件中的位置/属性在导出文件中应在的位置。

结构示例

key_name	en-US	de-DE*	备注*	标记*	max_characters*
app_title	我的项目	Mein Projekt	这是主标题	app, title	30
greeting	Hi '用户'!	Hallo '用户'!	请保持礼貌

*可选列

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

备注：用于为键添加描述
标记：用于为文件中的各个键添加标记
max_characters：通过上传为键设置字符限制

配置示例

.phraseapp.yml 中用于 XLSX 文件的 push 部分示例。

push:
    sources:
        - file: "./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