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

.CSV (Strings)

Контент автоматически переведен с английского языка с помощью 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

Тип

булевский

Загрузить

Да

Скачать

Нет

По умолчанию

ложь

Описание

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

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

enable_pluralization

Тип

булевский

Загрузить

Да

Скачать

Нет

По умолчанию

истина

Описание

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

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

export_tags

Тип

булевский

Загрузить

Нет

Скачать

Да

По умолчанию

ложь

Описание

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

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

export_max_characters_allowed

Тип

булевский

Загрузить

Нет

Скачать

Да

По умолчанию

ложь

Описание

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

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

custom_metadata_columns

Тип

хэш

Загрузить

Да

Скачать

Да

По умолчанию

[пустой]

Описание

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

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

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

Образец кода

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

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

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

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

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

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

push:
    источники:
        - файл: "./multi.csv"
          парамы:
              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.