.XLSX - 电子表格 Excel (字符串)

文本由 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
类型	字符串
上传	是
下载	否
默认	[空]
说明	包含键名称/标识的列。

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

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

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

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

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

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

标识符	custom_metadata_columns
类型	哈希
上传	是
下载	是
默认	[空]
说明	需要导入或导出的自定义元数据值的哈希映射：键 = 自定义元数据属性的名称，如在Phrase Strings中定义。值 = 列标识符（A，B，C等），表示属性在导入文件中的位置/属性在导出文件中的位置。

标识符	translation_columns
类型	哈希
上传	是
下载	是
默认	[空]
说明	语言ID/名称 = 自定义元数据属性的列，如在Phrase Strings中定义。值 = 列标识符（A，B，C等），表示属性在导入文件中的位置/属性在导出文件中的位置。

结构示例

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

*可选列

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

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

配置示例

在.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