|
ファイル拡張子 |
.csv |
|
API拡張 |
csv |
|
インポート |
はい |
|
エクスポート |
はい |
|
複数形のサポート |
はい |
|
説明のサポート |
はい |
|
フォーマットオプション ファイルがアップロードまたはダウンロードされるときに指定できるオプションです。アップロード/ダウンロード方法(API、CLI、リポジトリ同期など)に応じて、クエリパラメータ |
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パラメータ(ハッシュマップ型)は、ドキュメント内の各ロケールに対応する列を指定するために必要です。例については、configuration file exampleおよびAPI documentationを参照してください。
ファイル形式オプション
|
識別子 |
comment_index |
|
タイプ |
integer |
|
アップロード |
はい |
|
ダウンロード |
いいえ |
|
デフォルト |
[空白] |
|
概要 |
キーの説明を含む列のインデックス。列のインデックスは1から始まります。 |
|
識別子 |
max_characters_allowed_column |
|
タイプ |
integer |
|
アップロード |
はい |
|
ダウンロード |
いいえ |
|
デフォルト |
[空白] |
|
概要 |
キーの最大文字数を含む列のインデックス。列のインデックスは1から始まります。 |
|
識別子 |
header_content_row |
|
タイプ |
ブール |
|
アップロード |
はい |
|
ダウンロード |
いいえ |
|
デフォルト |
false |
|
概要 |
最初の行がヘッダー情報のみを含み、スキップする必要があるかどうかを示します。 |
|
識別子 |
enable_pluralization |
|
タイプ |
ブール |
|
アップロード |
はい |
|
ダウンロード |
いいえ |
|
デフォルト |
true |
|
概要 |
複数化されたキーの検出を有効にします。一致するキーはすべて複数化されたキーとして保持されます。 |
|
識別子 |
export_max_characters_allowed |
|
タイプ |
ブール |
|
アップロード |
いいえ |
|
ダウンロード |
はい |
|
デフォルト |
false |
|
概要 |
キーと翻訳と共にキーIDをエクスポートします。 |
|
識別子 |
custom_metadata_columns |
|
タイプ |
ハッシュ |
|
アップロード |
はい |
|
ダウンロード |
はい |
|
デフォルト |
[空白] |
|
概要 |
インポートまたはエクスポートする必要があるカスタムメタデータ値のHashMap:
|
|
識別子 |
export_key_id |
|
タイプ |
ブール |
|
アップロード |
いいえ |
|
ダウンロード |
はい |
|
デフォルト |
false |
|
概要 |
キーと翻訳と共にキー文字制限をエクスポートします。 |
|
識別子 |
key_id_column |
|
タイプ |
integer |
|
アップロード |
いいえ |
|
ダウンロード |
はい |
|
デフォルト |
[空白] |
|
概要 |
キーのIDを含む列のインデックス。列のインデックスは1から始まります。 |
コードサンプル
boolean_key,"--- true " empty_string_translation,"" key_with_description,Check it out!このキーは説明です。(少なくとも一部のフォーマットでは)、これはこのキーの素晴らしい説明です! key_with_line-break,"This translations contains a line-break." nested.deeply.key,"Wow, this key is nested even deeper." nested.key,This key is nested inside a namespace. 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,"--- - first item - second item - third item " simple_key,Just a simple key with a simple message. unverified_key,This translation is not yet verified and waits for it.(一部のフォーマットでは、このステータスもエクスポートされます)
ファイル構造
典型的な.CSVファイル構造:
1 (Key column), 2 (Translation column), 3 (Comment column) app_title, My Software Project, This is the main title apples.zero, one apple, my comment ...
構成例
.CSVファイル用の.phrase.ymlのプッシュセクションの例:
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 (Key column), 2 (Translation column), 3 (Comment column) messages.zero, No messages received, messages.one, One message received, messages.other, %s messages received,