.CSV (Strings)

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

文件扩展名	.csv
API 扩展	csv
导入	是
导出	是
复数形式支持	是
描述支持	是
格式选项	locale_mapping（必填） key_index comment_index tag_column max_characters_allowed_column column_separator quote_char header_content_row enable_pluralization export_tags export_max_characters_allowed custom_metadata_columns export_key_id key_id_column

CSV（以逗号分隔的值）是一种流行的文件格式，主要用于各种应用程序和程序中的数据传输。在 CSV 文件中，每一行都是一个数据记录。每条记录由几个字段组成，以逗号分隔。导入前，确保 CSV 文件一行有三个字段，分别代表原文/源语内容、译文和备注（可选）。

格式选项

标识符	locale_mapping（必填）
类型	哈希
上传	是
下载	否
说明	将每个区域名称映射到其所包含的列索引的哈希值。列索引从 1 开始。

标识符	key_index
类型	整数
上传	是
下载	否
默认	[ empty]
说明	包含键的列的索引。列索引从 1 开始。

标识符	comment_index
类型	整数
上传	是
下载	否
默认	[ empty]
说明	包含键描述的列的索引。列索引从 1 开始。

标识符	tag_column
类型	整数
上传	是
下载	否
默认	[ empty]
说明	包含键标签的列的索引。列索引从 1 开始。

标识符	max_characters_allowed_column
类型	整数
上传	是
下载	否
默认	[ empty]
说明	包含键最大字符数的列的索引。列索引从 1 开始。

标识符	column_separator
类型	字符串
上传	是
下载	否
默认	，
说明	用于分隔列的字符。

标识符	quote_char
类型	字符串
上传	是
下载	否
默认	"
说明	用于报价换行符和列分隔符的字符。

标识符	header_content_row
类型	布尔值
上传	是
下载	否
默认	false
说明	指示第一行是否仅包含标题信息，是否应跳过。

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

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

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

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

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

标识符	key_id_column
类型	整数
上传	否
下载	是
默认	[ empty]
说明	包键 ID 的列的索引。列索引从 1 开始。

代码示例

boolean_key,"--- true
"
empty_string_translation,""
key_with_description,查看！This key has a description!（至少在某些格式下），这是这个键的惊人描述！
key_with_line-break,"This translations contains
换行符"
nested.deeply.键,"哇，此键嵌套得更深.""nested.deeply.key]:"哇，此键嵌套得更深.",
nested.key,此键嵌套在命名空间内。“nested.key”：“此键嵌套在命名空间内。”,
null_translation,
pluralized_key.one, "仅找到一只小猫.""pluralized_key.one]: "仅找到一只小猫.",
pluralized_key.other,“哇，你有 %s 只小猫！”“pluralized_key.other”:“哇，你有 %s 只小猫！”,
pluralized_key.zero, "您没有小猫。""pluralized_key.zero]: "您没有小猫.",
sample_collection,"---
- 第一项
- 第二项
- 第三项
"
simple_key,只是一个带有简单信息的简单键。“simple_key”：“只是一个带有简单信息的简单键。”,
un已验证_key,此翻译尚未验证并等待它"此翻译尚未验证并等待它。(在某些格式中，我们也导出此状态)

文件结构

典型的 .CSV 文件结构：

1（键列）、2（翻译列）、3（备备注）
app_title，我的软件项目，这是主标题
apples.zero,一个苹果,我备注
...

配置示例

.CSV 文件的 .phrase.yml push 部分示例：

push:
    sources:
        - file: "./multi.csv"
          params:
              update_translations: true
              locale_mapping:
                  en:2
                  de:3
              format_options:
                  comment_index:4
                  tag_column:5

复数形式

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

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

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

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

文件应遵循以下结构：

1（键列）、2（翻译列）、3（备备注）
messages.zero: No messages received,
messages.one: One message received.,
messages.other, %s messages received,