.XLSX - Spreadsheet 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，至少需要提供键名列和一个翻译列。默认情况下，内容假定从第一行开始。除了键和翻译外，还可以导入元信息，如备注、标签和翻译允许的最大字符数。

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

区域映射参数（类型为哈希映射）是必需的，以指定文档中每个区域对应的列。有关示例，请参见配置文件示例和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
类型	哈希
上传	是
下载	是
默认	[empty]
说明	需要导入或导出的自定义元数据值的哈希映射：键=在Phrase Strings中定义的自定义元数据属性的名称。值 = 列标识符 (A, B, C, 等等) 其中属性在导入的文件中/属性应该在导出的文件中。

标识符	translation_columns
类型	哈希
上传	是
下载	是
默认	[empty]
说明	语言 ID/名称 = 自定义元数据属性的列，如在短语字符串中定义。值 = 列标识符 (A, B, C, 等等) 其中属性在导入的文件中/属性应该在导出的文件中。

结构示例

key_name	en_US	de-DE*	comment*	tags*	max_characters*
app_title	我的项目	我的项目	这是主要标题	应用程序，标题	30
问候	嗨 '用户'！	你好 '用户'！	要有礼貌

*可选列

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

备注: 为键添加描述
标记: 为文件中的单个键添加标签
最大字符数: 通过上传设置键的字符限制

配置示例

在.phraseapp.yml中针对XLSX文件的push部分的示例。

push:
    sources:
        - 文件: "./en.xlsx"
          params:
              文件格式: xlsx
              update_translations: true
              format_options:
                  key_name_column:A
                  comment_column:C
                  first_content_row:2
                  tag_column:D
              locale_mapping:
                  en:B