.CSV (Strings)

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

ファイル拡張子	.csv
API拡張	csv
インポート	はい
エクスポート	はい
複数形のサポート	はい
説明のサポート	はい
フォーマットオプション	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 ファイルに 1 行の原文コンテンツ、翻訳、およびコメントを表す 3 つのフィールドがあることを確認してください（任意）。

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

ファイル形式オプション

識別子	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]
概要	インポートまたはエクスポートする必要のあるカスタムメタデータ値の HashMap：キー = Phrase Strings で定義されたカスタムメタデータプロパティの名前。値 = プロパティがインポートファイル内にある列インデックス (1、2、3 など)。プロパティがエクスポートファイル内にある必要があります。

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

識別子	key_id_column
タイプ	整数
アップロード	いいえ
ダウンロード	はい
デフォルト	[empty]
概要	キーの 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.キー,このキーは名前空間内でネストされています。
null_translation,
pluralized_key.one,"Only one kitten found."
pluralized_key.other,"Wow, you have %s kittens!"
pluralized_key.zero,"You have no kittens."
sample_collection,"---
- 最初の項目
- second item
- 三つ目の項目
"
simple_key,シンプルなメッセージを持つシンプルなキー
un検証済み_key,この翻訳は検証待ちです。（一部のファイル形式では、このステータスもエクスポートされます）

ファイル構造

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

1キー列）、2（翻訳列）、3（コメント列）
app_title、マイソフトウェアプロジェクト、メインタイトル
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 messages received、