サポートするファイル形式(Strings)

.CSV (Strings)

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

ファイル拡張子 

.csv

API拡張 

csv

インポート 

はい

エクスポート 

はい

複数形のサポート 

はい

説明のサポート 

はい

フォーマットオプション 

ファイルがアップロードまたはダウンロードされるときに指定できるオプションです。アップロード/ダウンロード方法(API、CLI、リポジトリ同期など)に応じて、クエリパラメータUploadDownload、または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パラメータ(ハッシュマップ型)は、ドキュメント内の各ロケールに対応する列を指定するために必要です。例については、configuration file exampleおよびAPI documentationを参照してください。

ファイル形式オプション

識別子 

key_index

タイプ 

integer

アップロード 

はい

ダウンロード 

いいえ

デフォルト 

[空白]

概要 

キー名を含む列のインデックス。列のインデックスは1から始まります。

識別子 

comment_index

タイプ 

integer

アップロード 

はい

ダウンロード 

いいえ

デフォルト 

[空白]

概要 

キーの説明を含む列のインデックス。列のインデックスは1から始まります。

識別子 

tag_column

タイプ 

integer

アップロード 

はい

ダウンロード 

いいえ

デフォルト 

[空白]

概要 

キーのタグを含む列のインデックス。列のインデックスは1から始まります。

識別子 

max_characters_allowed_column

タイプ 

integer

アップロード 

はい

ダウンロード 

いいえ

デフォルト 

[空白]

概要 

キーの最大文字数を含む列のインデックス。列のインデックスは1から始まります。

識別子 

column_separator

タイプ 

文字列

アップロード 

はい

ダウンロード 

いいえ

デフォルト 

,

概要 

列を区切るために使用される文字。

識別子 

quote_char

タイプ 

文字列

アップロード 

はい

ダウンロード 

いいえ

デフォルト 

"

概要 

改行と列区切りを引用するために使用される文字。

識別子 

header_content_row

タイプ 

ブール

アップロード 

はい

ダウンロード 

いいえ

デフォルト 

false

概要 

最初の行がヘッダー情報のみを含み、スキップする必要があるかどうかを示します。

識別子 

enable_pluralization

タイプ 

ブール

アップロード 

はい

ダウンロード 

いいえ

デフォルト 

true

概要 

複数化されたキーの検出を有効にします。一致するキーはすべて複数化されたキーとして保持されます。

識別子 

export_tags

タイプ 

ブール

アップロード 

いいえ

ダウンロード 

はい

デフォルト 

false

概要 

キーと翻訳と共にタグをエクスポートします。

識別子 

export_max_characters_allowed

タイプ 

ブール

アップロード 

いいえ

ダウンロード 

はい

デフォルト 

false

概要 

キーと翻訳と共にキーIDをエクスポートします。

識別子 

custom_metadata_columns

タイプ 

ハッシュ

アップロード 

はい

ダウンロード 

はい

デフォルト 

[空白]

概要 

インポートまたはエクスポートする必要があるカスタムメタデータ値のHashMap:

  • キー = Phrase Stringsで定義されたカスタムメタデータプロパティの名前。

  • 値 = インポートされたファイル内のプロパティがある列インデックス(123など)/エクスポートされたファイル内のプロパティがあるべき列インデックス。

識別子 

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,
この記事は役に立ちましたか?

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.