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

.CSV (Strings)

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

ファイル拡張子 

.csv

API拡張 

csv

インポート 

はい

エクスポート 

はい

複数形のサポート 

はい

説明のサポート 

はい

フォーマットオプション 

ファイルがアップロードおよび/またはダウンロードされる際に指定できるオプションです。アップロード/ダウンロード方法(API、CLI、Repo syncなど)に応じて、クエリパラメータアップロードダウンロード、または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ファイルに原文コンテンツ、翻訳、コメント(オプション)を表す1行につき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セクションの例:

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.