.XLSX - Spreadsheet Excel (Strings)

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

Расширения файлов	.xlsx
Расширение API	xlsx
Импорт	Да
Экспорт	Да
Поддержка форм множественного числа	Да
Поддержка описания	Да
Варианты формата Эти параметры могут быть указаны при загрузке и/или скачивании файла. В зависимости от метода загрузки/скачивания (API, CLI, синхронизация репозитория и т.д.) они могут быть указаны в параметрах запроса `Загрузить`, `Скачать` или в конфигурационном файле `phrase.yml`.	key_name_column comment_column tag_column first_content_row enable_pluralization export_tags export_max_characters_allowed custom_metadata_columns translation_columns

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Пример для секции 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