.CSV (Strings)

Контент автоматически переведен с английского языка с помощью Phrase Language AI.

Расширения файлов	.csv
Расширение API	csv
Импорт	Да
Экспорт	Да
Поддержка форм множественного числа	Да
Поддержка описания	Да
Варианты формата Эти параметры можно указать при загрузке и/или Скачать файла. В зависимости от метода загрузки/Скачать (интерфейс приложений API, CLI, синхронизация репозитория и т. д.), их можно указать в параметрах запрос `загрузить`, `Скачать` или в файле конфигурации `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-файлы имеют три поля для одной строки, представляющие оригинал контент, перевод и комментарии (необязательно).

Параметр locale_mapping (типа hashmap) необходим для указания того, какой столбец в документ соответствует каждому языковой стандарт. Примеры см. в примере файла конфигурации и документации интерфейса приложений API для загрузки.

Параметры формата

Идентификатор	key_index
Тип	integer
Загрузить	Да
Скачать	Нет
По умолчанию	[empty]
Описание	Индекс столбца, содержащего имена ключей. Индексы столбцов начинаются с 1.

Идентификатор	comment_index
Тип	integer
Загрузить	Да
Скачать	Нет
По умолчанию	[empty]
Описание	Индекс столбца, содержащего описание для ключа. Индексы столбцов начинаются с 1.

Идентификатор	tag_column
Тип	integer
Загрузить	Да
Скачать	Нет
По умолчанию	[empty]
Описание	Индекс столбца, содержащего тег для ключа. Индексы столбцов начинаются с 1.

Идентификатор	max_characters_allowed_column
Тип	integer
Загрузить	Да
Скачать	Нет
По умолчанию	[empty]
Описание	Индекс столбца, содержащего максимальное количество символов для ключа. Индексы столбцов начинаются с 1.

Идентификатор	column_separator
Тип	строка
Загрузить	Да
Скачать	Нет
По умолчанию	,
Описание	Символ, используемый для разделения столбцов.

Идентификатор	quote_char
Тип	строка
Загрузить	Да
Скачать	Нет
По умолчанию	"
Описание	Символ, используемый для расчет стоимости символов новой строки и разделителя столбцов.

Идентификатор	header_content_row
Тип	булевский
Загрузить	Да
Скачать	Нет
По умолчанию	false
Описание	Указывает, содержит ли первая строка только информацию заголовка и должна ли она быть пропущена.

Идентификатор	enable_pluralization
Тип	булевский
Загрузить	Да
Скачать	Нет
По умолчанию	true
Описание	Позволяет обнаруживать ключи во множественном числе. Все совпадающие ключи будут сохраняться во множественном числе.

Идентификатор	export_tags
Тип	булевский
Загрузить	Нет
Скачать	Да
По умолчанию	false
Описание	Экспортирует теги вместе с ключами и переводами.

Идентификатор	export_max_characters_allowed
Тип	булевский
Загрузить	Нет
Скачать	Да
По умолчанию	false
Описание	Экспортирует Идентификатор ключа вместе с ключами и переводами.

Идентификатор	custom_metadata_columns
Тип	hash
Загрузить	Да
Скачать	Да
По умолчанию	[empty]
Описание	HashMap значений Пользовательский метаданных, которые необходимо импортировать или экспортировать: Ключ = Имя Пользовательский свойства метаданных, как определено в Phrase Strings. Значение = Индекс столбца (1, 2, 3 и т. д.), где находится свойство в импортируемом файле/где свойство должно находиться в экспортируемом файле.

Идентификатор	export_key_id
Тип	булевский
Загрузить	Нет
Скачать	Да
По умолчанию	false
Описание	Экспортирует ограничение на количество символ ключа вместе с ключами и переводами.

Идентификатор	key_id_column
Тип	integer
Загрузить	Нет
Скачать	Да
По умолчанию	[empty]
Описание	Индекс столбца, содержащего Идентификатор для ключа. Индексы столбцов начинаются с 1.

Образец кода

boolean_key,"--- true
"
empty_string_translation,""
key_with_description,Check it out! This key has a description! (По крайней мере, в некоторых форматах), Это потрясающее описание для этого ключа!"
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
...

Пример конфигурации

Пример для раздела push файла .phrase.yml для файлов .CSV:

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,