.TXT (Strings)

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

Расширения файлов	.txt, .tsv
Расширение API	.txt, .tsv
Импорт	Да
Экспорт	Да
Поддержка форм множественного числа	Да
Поддержка описания	Да
Варианты формата Эти параметры можно указать при загрузить и/или Скачать файл. В зависимости от метода загрузить/Скачать (интерфейс приложений API, CLI, синхронизация репозитория и т. д.), их можно указать в запрос параметрах `загрузить`, `Скачать` или в файле конфигурации `phrase.yml`.	key_index comment_index: 4 tag_column: 5 max_characters_allowed_column column_separator: ";" расчет стоимости_char header_контент_row enable_pluralization экспортировать_теги экспортировать_max_characters_allowed custom_metadata_columns

TXT хранит информацию в виде простого текста без каких-либо встроенных параметров форматирования, таких как полужирный шрифт, курсив или изображения.

Параметр locale_mapping (типа hashmap) требуется для указания того, какой столбец в документ соответствует каждому языковой стандарт. Примеры см. в configuration file example и интерфейс приложений API documentation для загрузить.

Параметры формата

Идентификатор	key_index
Тип	integer
Загрузить	Да
Скачать	Нет
По умолчанию	[empty]
Описание	Индекс столбца, содержащего имена ключ. Индексы столбцов начинаются с 1.

Идентификатор	comment_index: 4
Тип	integer
Загрузить	Да
Скачать	Нет
По умолчанию	[empty]
Описание	Индекс столбца, содержащего комментировать для ключ. Индексы столбцов начинаются с 1.

Идентификатор	tag_column: 5
Тип	integer
Загрузить	Да
Скачать	Нет
По умолчанию	[empty]
Описание	Индекс столбца, содержащего тег для ключ. Индексы столбцов начинаются с 1.

Идентификатор	max_characters_allowed_column
Тип	integer
Загрузить	Да
Скачать	Нет
По умолчанию	[empty]
Описание	Индекс столбца, содержащего максимальное количество символов для ключа. Индексы столбцов начинаются с 1.

Идентификатор	column_separator: ";"
Тип	строка
Загрузить	Да
Скачать	Нет
По умолчанию	\t
Описание	Символ, который используется для разделения столбцов.

Идентификатор	расчет стоимости_char
Тип	строка
Загрузить	Да
Скачать	Нет
По умолчанию	"
Описание	Символ, который используется для заключения в расчет стоимости символов новой строки и разделителя столбцов.

Идентификатор	header_контент_row
Тип	булевский
Загрузить	Да
Скачать	Нет
По умолчанию	false
Описание	Указывает, содержит ли первая строка только информацию заголовка и должна ли она быть пропущена.

Идентификатор	enable_pluralization
Тип	булевский
Загрузить	Да
Скачать	Нет
По умолчанию	true
Описание	Позволяет обнаруживать ключи во множественном числе. Все совпадающие ключи будут сохраняться во множественном числе.

Идентификатор	экспортировать_теги
Тип	булевский
Загрузить	Нет
Скачать	Да
По умолчанию	false
Описание	Экспортирует теги вместе с ключами и переводами.

Идентификатор	экспортировать_max_characters_allowed
Тип	булевский
Загрузить	Нет
Скачать	Да
По умолчанию	false
Описание	Экспортирует ограничение на количество символов ключа вместе с ключами и переводами.

Идентификатор	custom_metadata_columns
Тип	хеш
Загрузить	Да
Скачать	Да
По умолчанию	[empty]
Описание	HashMap Пользовательских метаданных значений, которые необходимо импортировать или экспортировать: Ключ = Имя Пользовательского свойства метаданных, как определено в Phrase Strings. Значение = Индекс столбца (1, 2, 3 и т. д.), где свойство находится в импортируемом файле/где свойство должно находиться в экспортируемом файле.

Образец кода

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    "Найден только один котенок."
pluralized_key.other    "Ого, у вас %s котят!"
pluralized_key.zero    "У вас нет котят."
sample_collection    "---
- first item
- second item
- third item
"
simple_key    Просто простой ключ с простым сообщением.
unverified_key    Этот перевод еще не проверено и ждет подтверждения. (В некоторых форматах мы также экспортировать этот статус)

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

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

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

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

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

push:
    sources:
        - file: "./multi.txt"
          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    Сообщений не получено,
messages.one    Получено одно сообщение,
messages.other    получено сообщений: %s,