|
ファイル拡張子 |
.txt, .tsv |
|
API拡張 |
.txt, .tsv |
|
インポート |
はい |
|
エクスポート |
はい |
|
複数形のサポート |
はい |
|
説明のサポート |
はい |
|
フォーマットオプション ファイルがアップロードおよび/またはダウンロードされる際に指定できるオプションです。アップロード/ダウンロード方法（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 |
TXTは、太字、斜体、画像などの埋め込みフォーマットオプションを含まないプレーンテキスト情報を保存します。
locale_mappingパラメータ（ハッシュマップ型）は、ドキュメント内のどの列が各ロケールに対応するかを指定するために必要です。例については、設定ファイルの例およびアップロード用のAPIドキュメントを参照してください。
ファイル形式オプション
|
識別子 |
key_index |
|
タイプ |
integer |
|
アップロード |
はい |
|
ダウンロード |
いいえ |
|
デフォルト |
[空白] |
|
概要 |
キー名が含まれる列のインデックス。列のインデックスは1から始まります。 |
|
識別子 |
comment_index |
|
タイプ |
integer |
|
アップロード |
はい |
|
ダウンロード |
いいえ |
|
デフォルト |
[空白] |
|
概要 |
キーの説明が含まれる列のインデックス。列のインデックスは1から始まります。 |
|
識別子 |
tag_column |
|
タイプ |
integer |
|
アップロード |
はい |
|
ダウンロード |
いいえ |
|
デフォルト |
[空白] |
|
概要 |
キーのタグが含まれる列のインデックス。列のインデックスは1から始まります。 |
|
識別子 |
max_characters_allowed_column |
|
タイプ |
integer |
|
アップロード |
はい |
|
ダウンロード |
いいえ |
|
デフォルト |
[空白] |
|
概要 |
キーの最大文字数が含まれる列のインデックス。列のインデックスは1から始まります。 |
|
識別子 |
column_separator |
|
タイプ |
文字列 |
|
アップロード |
はい |
|
ダウンロード |
いいえ |
|
デフォルト |
\t |
|
概要 |
列の区切りに使用される文字。 |
|
識別子 |
quote_char |
|
タイプ |
文字列 |
|
アップロード |
はい |
|
ダウンロード |
いいえ |
|
デフォルト |
" |
|
概要 |
改行および列の区切り文字を囲むために使用される文字。 |
|
識別子 |
header_content_row |
|
タイプ |
ブール |
|
アップロード |
はい |
|
ダウンロード |
いいえ |
|
デフォルト |
false |
|
概要 |
最初の行にヘッダー情報のみが含まれており、スキップすべきかどうかを示します。 |
|
識別子 |
enable_pluralization |
|
タイプ |
ブール |
|
アップロード |
はい |
|
ダウンロード |
いいえ |
|
デフォルト |
true |
|
概要 |
複数化されたキーの検出を有効にします。一致するキーはすべて複数化されたキーとして保持されます。 |
|
識別子 |
export_tags |
|
タイプ |
ブール |
|
アップロード |
いいえ |
|
ダウンロード |
はい |
|
デフォルト |
false |
|
概要 |
キーおよび翻訳とともにタグをエクスポートします。 |
|
識別子 |
export_max_characters_allowed |
|
タイプ |
ブール |
|
アップロード |
いいえ |
|
ダウンロード |
はい |
|
デフォルト |
false |
|
概要 |
キーおよび翻訳とともにキーの文字制限をエクスポートします。 |
|
識別子 |
custom_metadata_columns |
|
タイプ |
ハッシュ |
|
アップロード |
はい |
|
ダウンロード |
はい |
|
デフォルト |
[空白] |
|
概要 |
インポートまたはエクスポートする必要があるカスタムメタデータ値のHashMap。
|
コードサンプル
boolean_key "--- true " empty_string_translation "" key_with_description チェックしてみてください！このキーは説明です。(少なくとも一部の形式では)、これはこのキーの素晴らしい説明です！ key_with_line-break "この翻訳には改行が含まれています。" a line-break." nested.deeply.key \"わあ、このキーはさらに深くネストされています。\" nested.key このキーは名前空間内にネストされています。 null_translation pluralized_key.one \"子猫が1匹見つかりました。\" pluralized_key.other \"わあ、%s匹の子猫がいますね！\" pluralized_key.zero \"子猫はいません。\" sample_collection "--- - first item - second item - third item " simple_key シンプルなメッセージを持つシンプルなキー。 unverified_key この翻訳は未検証で、まだ検証が完了していません。（一部のファイル形式では、このステータスもエクスポートされます）
ファイル構造
一般的な .TXT ファイル構造:
1 (キー列) 2 (翻訳列) 3 (コメント列) app_title マイソフトウェアプロジェクト これがメインタイトルです apples.zero 一つのリンゴ 私のコメント ...
設定例
.CSV ファイル用の .phrase.yml の push セクションの例:
push:
sources:
- file: "./multi.txt"
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 件のメッセージを受信しました,