Расширения файлов |
.csv |
Расширение API |
csv |
Импорт |
Да |
Экспорт |
Да |
Поддержка форм множественного числа |
Да |
Поддержка описания |
Да |
Варианты формата |
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 имеют три поля для одной строки, отражающие контент оригинала, перевод и комментарии (необязательно).
Параметр языкового стандарта
(хэш-карты типа) должен указывать, какой столбец в документе соответствует каждому языковому стандарту. Например, см. пример файла конфигурации и интерфейс приложений API для uploads.
Параметры формата
Идентификатор |
key_index |
Тип |
целые числа |
Загрузить |
Да |
Скачать |
Нет |
По умолчанию |
[ empty] |
Описание |
Индекс столбца, содержащего имена ключей. Индексы столбцов начинаются с 1. |
Идентификатор |
comment_index |
Тип |
целые числа |
Загрузить |
Да |
Скачать |
Нет |
По умолчанию |
[ empty] |
Описание |
Индекс столбца, содержащего описание для ключа. Индексы столбцов начинаются с 1. |
Идентификатор |
tag_column |
Тип |
целые числа |
Загрузить |
Да |
Скачать |
Нет |
По умолчанию |
[ empty] |
Описание |
Индекс столбца, содержащего тег для ключа. Индексы столбцов начинаются с 1. |
Идентификатор |
max_characters_allowed_column |
Тип |
целые числа |
Загрузить |
Да |
Скачать |
Нет |
По умолчанию |
[ empty] |
Описание |
Индекс столбца, содержащего максимальное количество символов для ключа. Индексы столбцов начинаются с 1. |
Идентификатор |
column_separator |
Тип |
строка |
Загрузить |
Да |
Скачать |
Нет |
По умолчанию |
, |
Описание |
Символ, используемый для разделения столбцов. |
Идентификатор |
quote_char |
Тип |
строка |
Загрузить |
Да |
Скачать |
Нет |
По умолчанию |
" |
Описание |
Знак, используемый для ценовых предложений новых строк и разделителя столбцов. |
Идентификатор |
header_content_row |
Тип |
булевский |
Загрузить |
Да |
Скачать |
Нет |
По умолчанию |
false |
Описание |
Указывает, содержит ли первая строка информацию только о заголовке, и ее следует пропустить. |
Идентификатор |
enable_pluralization |
Тип |
булевский |
Загрузить |
Да |
Скачать |
Нет |
По умолчанию |
true |
Описание |
Позволяет обнаруживать ключи во множественном числе. Все совпадающие ключи будут сохраняться во множественном числе. |
Идентификатор |
export_tags |
Тип |
булевский |
Загрузить |
Нет |
Скачать |
Да |
По умолчанию |
false |
Описание |
Экспортирует tags вместе с ключами и переводами. |
Идентификатор |
export_max_characters_allowed |
Тип |
булевский |
Загрузить |
Нет |
Скачать |
Да |
По умолчанию |
false |
Описание |
Экспортирует ограничение символов ключа вместе с ключами и переводами. |
Идентификатор |
custom_metadata_columns |
Тип |
хэш |
Загрузить |
Да |
Скачать |
Да |
По умолчанию |
[ empty] |
Описание |
Хэшкарта значений пользовательских метаданных, которые необходимо импортировать или экспортировать:
|
Идентификатор |
export_key_id |
Тип |
булевский |
Загрузить |
Нет |
Скачать |
Да |
По умолчанию |
false |
Описание |
Экспортирует ограничение символов ключа вместе с ключами и переводами. |
Идентификатор |
key_id_column |
Тип |
целые числа |
Загрузить |
Нет |
Скачать |
Да |
По умолчанию |
[ empty] |
Описание |
Индекс столбца, содержащего Идентификатор ключа. Индексы столбцов начинаются с 1. |
Образец кода
boolean_key,"-- true " empty_string_translation,"" key_with_description,Проверьте! This key has a description! (по крайней мере, в некоторых форматах),Это потрясающее описание для этого ключа! key_with_line-break,"This translations содержит\na line-break.", разрыв линии." nested.deeply.ключ": "Wow, this ключ is nested even deeper." nested.key,Этот ключ вложен в пространство имен. null_translation, pluralized_key.one: "Only one kitten found." pluralized_key.other,"Ого, у вас есть котята %s!" pluralized_key.zero,"You have no kittens." sample_collection",-- - первый элемент - второй элемент - третий элемент " simple_key,Простой простой ключ с простым сообщением. unподтверждено_key,Этот перевод еще не подтвержден и ждет его. (В некоторых форматах мы также экспортируем этот статус)
Структура файла
Типичная структура файла .CSV:
1 (столбец с ключ), 2 (столбец с переводами), 3 (столбец с комментировать) app_title, Мой программный проект, Это основное название apples.zero, одно яблоко, мой комментировать ...
Пример конфигурации
Пример для раздела push .phrase.yml для файлов .CSV:
push: sources: - файл: "./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 (столбец с ключ), 2 (столбец с переводами), 3 (столбец с комментировать) messages.zero: No messages received, сообщений.одно, получено одно сообщение, messages.other: %s messages received,