Поддерживаемые типы файлов (Strings)

.CSV (Строки)

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

Файлы с расширениями

.csv

Расширение API

csv

Импорт

Да

Экспорт

Да, за исключением CLI/API

Поддержка форм множественного числа

Да

Поддержка описания

Да

Варианты формата

locale_mapping

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

CSV (значения, разделенные запятыми) — популярный формат файла, используемый преимущественно для передачи данных в различных приложениях и программах. В файле CSV каждая строка является записью данных. Каждая запись состоит из нескольких полей, разделенных запятыми. Перед импортом убедитесь, что в файлах CSV три поля для одной строки, представляющие исходный контент, перевод и комментарии (необязательно).

Варианты формата

Идентификатор

locale_mapping

Тип

хэш

Загрузить

Да

Скачать

Нет

По умолчанию

[необязательно]

Описание

Хэш сопоставления каждого названия языкового стандарта с индексом столбца, в котором оно содержится. Индексы столбцов начинаются с 1

Идентификатор

key_index

Тип

целые числа

Загрузить

Да

Скачать

Нет

По умолчанию

[пустое]

Описание

Индекс столбца, содержащего имена ключей. Индексы столбцов начинаются с 1.

Идентификатор

comment_index

Тип

целые числа

Загрузить

Да

Скачать

Нет

По умолчанию

[пустое]

Описание

Индекс столбца, содержащего описание для ключа. Индексы столбцов начинаются с 1 .

Идентификатор

tag_column

Тип

целые числа

Загрузить

Да

Скачать

Нет

По умолчанию

[пустое]

Описание

Индекс столбца, содержащего тег для ключа. Индексы столбцов начинаются с 1.

Идентификатор

max_characters_allowed_column

Тип

целые числа

Загрузить

Да

Скачать

Нет

По умолчанию

[пустое]

Описание

Индекс столбца, содержащего максимальное количество символов для ключа. Индексы столбцов начинаются с 1.

Идентификатор

column_separator

Тип

строка

Загрузить

Да

Скачать

Нет

По умолчанию

,

Описание

Символ, используемый для разделения столбцов.

Идентификатор

quote_char

Тип

строка

Загрузить

Да

Скачать

Нет

По умолчанию

"

Описание

Символ, используемый для кавычек новых строк и разделителя столбцов.

Идентификатор

header_content_row

Тип

boolean

Загрузить

Да

Скачать

Нет

По умолчанию

false

Описание

Указывает, следует ли пропустить первую строку, содержащую только информацию о заголовке.

Идентификатор

enable_pluralization

Тип

boolean

Загрузить

Да

Скачать

Нет

По умолчанию

true

Описание

Позволяет обнаруживать ключи во множественном числе. Все соответствующие ключи будут сохраняться во множественном числе.

Идентификатор

export_tags

Тип

boolean

Загрузить

Нет

Скачать

Да

По умолчанию

false

Описание

Экспортирует теги вместе с ключами и переводами.

Идентификатор

export_max_characters_allowed

Тип

boolean

Загрузить

Нет

Скачать

Да

По умолчанию

false

Описание

Экспортирует ограничение количества символов ключа вместе с ключами и переводами.

Идентификатор

custom_metadata_columns

Тип

хэш

Загрузить

Да

Скачать

Да

По умолчанию

[пустое]

Описание

HashMap настраиваемых значений метаданных, которые необходимо импортировать или экспортировать:

  • Ключ = имя пользовательского свойства метаданных, определенного в Phrase Strings.

  • Значение = индекс столбца (1, 2, 3 и т. д.), в котором свойство находится в импортированном файле/в котором свойство должно быть в экспортированном файле.

Образец кода

boolean_key",--- true
"
empty_string_translation,""
key_with_description,Check it! В этом ключе есть описание! (По крайней мере, в некоторых форматах),Это потрясающее описание для этого ключа!
key_with_line-break,"Эти переводы содержат
a line-break."
nest.deeply.key,"Вау, этот ключ вложен еще глубже."
nested.key,Этот ключ вложен в пространство имен.
null_translation,
pluralized_key.one: "Найден только один котенок".
pluralized_key.other,"Вау, у вас есть котята %s!"
pluralized_key.zero,"You have no kittens."
sample_collection,"---
- первый элемент
- второй элемент
- третий элемент
"
simple_key,Просто простой ключ с простым сообщением.
unverified_key,Этот перевод еще не подтвержден и ждет его. (В некоторых форматах мы также экспортируем этот статус)boolean_key,"-- true"empty_string_translation,"key_with_description,Check it! В этом ключе есть описание! (По крайней мере, в некоторых форматах),Это удивительное описание для этого ключа!key_with_line-break,"Эти переводы содержат разрыв строки."nested.deeply.key,"Вау, этот ключ вложен еще глубже."nested.key,Этот ключ вложен внутри пространства имен.null_translation,pluralized_key.one, "Найден только один котенок".pluralized_key.other,"Вау, у вас есть %s котят!"pluralized_key.zero,"У вас нет котят."sample_collection",--первый элемент- второй элемент- третий элемент"simple_key,Просто простой ключ с простым сообщением.unverified_key,Этот перевод еще не подтвержден и ждет его. (В некоторых форматах мы также экспортируем этот статус)

Структура файла

Типичная структура файла .CSV:

1 (ключевой столбец), 2 (столбец «Перевод»), 3 (столбец «Комментарий»)
app_title, Мой программный проект, Это основное название
apples.zero, одно яблоко, мой комментарий
...

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

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

push:
    источники:
        - файл: "./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 (столбец «Комментарий»)
сообщений.ноль, Нет полученных сообщений,
сообщений.одно, Одно полученное сообщение,
сообщений.другое, получено %s сообщений,
Была ли эта статья полезной?

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.