|
ファイル拡張子 |
.csv |
|
API拡張 |
csv |
|
インポート |
はい |
|
エクスポート |
はい |
|
複数形のサポート |
はい |
|
説明のサポート |
はい |
|
フォーマットオプション ファイルがアップロードおよび/またはダウンロードされる際に指定できるオプションです。アップロード/ダウンロード方法(API、CLI、Repo syncなど)に応じて、クエリパラメータ |
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パラメータ(ハッシュマップ型)が必要です。例については、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セクションの例:
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,