.XLSX — электронная таблица 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 Strings. Значение = Идентификатор столбца (A, B, C и т. д.), где находится свойства в импортируемом файле/где свойства должно находиться в экспортируемом файле.

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

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

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

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

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

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

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

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

push:
    sources:
        - file: \"./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