.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
Тип	хеш
Загрузить	Да
Скачать	Да
По умолчанию	[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,