.CSV (文字列)

本コンテンツはPhrase Language AIの機械翻訳により、英語から翻訳されています。

ファイル拡張子	.csv
API拡張	csv
インポート	はい
エクスポート	はい
複数形のサポート	はい
説明のサポート	はい
フォーマットオプションファイルがアップロードまたはダウンロードされる際に指定できるオプションです。アップロード/ダウンロード方法（API、CLI、リポジトリ同期など）に応じて、クエリパラメータ `アップロード`、`ダウンロード` または `phrase.yml` 設定ファイルに指定できます。	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ファイルには、ソースコンテンツ、翻訳、およびコメント（オプション）を表す単一行のための3つのフィールドがあることを確認してください。

locale_mapping パラメータ（ハッシュマップ型）は、ドキュメント内の各ロケールに対応する列を指定するために必要です。例については、設定ファイルの例と APIドキュメントを参照してください。

ファイル形式オプション

識別子	key_index
タイプ	整数
アップロード	はい
ダウンロード	いいえ
デフォルト	空欄
概要	キー名を含む列のインデックス。列のインデックスは1から始まります。

識別子	comment_index
タイプ	整数
アップロード	はい
ダウンロード	いいえ
デフォルト	空欄
概要	キーの説明を含む列のインデックス。列のインデックスは1から始まります。

識別子	tag_column
タイプ	整数
アップロード	はい
ダウンロード	いいえ
デフォルト	空欄
概要	キーのタグを含む列のインデックス。列のインデックスは1から始まります。

識別子	max_characters_allowed_column
タイプ	整数
アップロード	はい
ダウンロード	いいえ
デフォルト	空欄
概要	キーの最大文字数を含む列のインデックス。列のインデックスは1から始まります。

識別子	column_separator
タイプ	string
アップロード	はい
ダウンロード	いいえ
デフォルト	,
概要	列を区切るために使用される文字。

識別子	quote_char
タイプ	string
アップロード	はい
ダウンロード	いいえ
デフォルト	"
概要	改行と列区切りを引用するために使用される文字。

識別子	header_content_row
タイプ	ブール
アップロード	はい
ダウンロード	いいえ
デフォルト	false
概要	最初の行がヘッダー情報のみを含むかどうかを示します。

識別子	enable_pluralization
タイプ	ブール
アップロード	はい
ダウンロード	いいえ
デフォルト	true
概要	複数化されたキーの検出を有効にします。一致するキーはすべて複数化されたキーとして保持されます。

識別子	export_tags
タイプ	ブール
アップロード	いいえ
ダウンロード	はい
デフォルト	false
概要	キーと翻訳と共にタグをエクスポートします。

識別子	export_max_characters_allowed
タイプ	ブール
アップロード	いいえ
ダウンロード	はい
デフォルト	false
概要	キーと翻訳と共にキーIDをエクスポートします。

識別子	custom_metadata_columns
タイプ	ハッシュ
アップロード	はい
ダウンロード	はい
デフォルト	空欄
概要	インポートまたはエクスポートする必要があるカスタムメタデータ値のHashMap：キー = Phrase Stringsで定義されたカスタムメタデータプロパティの名前。値 = インポートファイル内のプロパティがある列インデックス（1、2、3など）/エクスポートファイル内のプロパティがあるべき列インデックス。

識別子	export_key_id
タイプ	ブール
アップロード	いいえ
ダウンロード	はい
デフォルト	false
概要	キーと翻訳と共にキー文字数制限をエクスポートします。

識別子	key_id_column
タイプ	整数
アップロード	いいえ
ダウンロード	はい
デフォルト	空欄
概要	キーのIDを含む列のインデックス。列のインデックスは1から始まります。

コードサンプル

boolean_key,"--- true
"
empty_string_translation,""
key_with_description,チェックしてみてください！このキーには説明があります！（少なくとも一部のフォーマットでは）、これはこのキーの素晴らしい説明です！
key_with_line-break,"This translations contains
a line-break."
nested.deeply.key,"わあ、このキーはさらに深くネストされています。"
nested.key、このキーは名前空間内にネストされています。
null_translation,
pluralized_key.one, "子猫が1匹見つかりました。"
pluralized_key.other,"わあ、あなたは%s匹の子猫を飼っています！"
pluralized_key.zero,"子猫は1匹もいません。"
sample_collection,"---
- 最初のアイテム
- 2番目のアイテム
- 3番目のアイテム
"
simple_key,シンプルなメッセージを持つシンプルなキーです。
unverified_key,この翻訳はまだ検証されておらず、待機中です。（一部のフォーマットでは、このステータスもエクスポートされます）

ファイル構造

一般的な.CSVファイル構造：

1 (キー列), 2 (翻訳列), 3 (コメント列)
app_title,      My Software Project,    これはメインタイトルです
apples.zero,    1つのリンゴ,              私のコメント
...

設定例

.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,  メッセージは受信されませんでした、
messages.one,   メッセージが1件受信されました、
messages.other,  %s 件のメッセージが受信されました、