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

.CSV (Strings)

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

Расширения файлов 

.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]

Описание 

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

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

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

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

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,
Была ли эта статья полезной?

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.