.XLSX - Spreadsheet Excel (Strings)

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

Расширения файлов	.xlsx
Расширение API	xlsx
Импорт	Да
Экспорт	Да
Поддержка форм множественного числа	Да
Поддержка описания	Да
Варианты формата	key_name_column comment_column tag_column first_content_row enable_pluralization export_tags export_max_characters_allowed custom_metadata_columns

.XLSX — широко используемый формат файла для локализации. Хотя формат файла .XLSX может отличаться в зависимости от конкретных настроек, в целом он соответствует правилу «один столбец на язык». Чтобы перевести .XLSX, укажите как минимум столбец с именем ключа и один столбец перевода. Предполагается, что по умолчанию контент начинается с первой строки. Вместе с ключами и переводом можно импортировать метаинформацию, такую как комментарии, tags и максимально допустимое количество символов для переводов.

Параметр языкового стандарта (хэш-карты типа) должен указывать, какой столбец в документе соответствует каждому языковому стандарту. Например, см. пример файла конфигурации и интерфейс приложений API для uploads.

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

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

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

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

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

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

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

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

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

Пример структуры

key_name	en_US	de-DE*	комментировать*	tags	max_characters*
app_title	Мой проект	Проект Mein	Это основное название	приложение, название	30
Приветствие	Привет 'Пользователь'!	Привет 'Пользователь'!	Будьте вежливы

*необязательные столбцы

Для заказа загрузки файла электронной таблицы необходимы как минимум столбец ключа и один язык. Кроме добавленных языков, для добавления метаинформации можно добавить следующие столбцы:

комментарий: чтобы добавить описание к ключу
теги: добавлять теги к отдельным ключам в файле
max_символов: установить ограничение количества символов для ключа через загрузить

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

Пример для раздела push в .phraseapp.yml для файлов XLSX.

push:
    sources:
        - файл: "./en.xlsx"
          params:
              file_format: xlsx
              update_translations: true
              format_options:
                  key_name_column: A
                  comment_column: C
                  first_content_row: 2
                  tag_column: D
              locale_mapping:
                  en: B