Артефакты контента Payload
Переводите выбранные поля Payload CMS и поддерживаемый текст Lexical, сохраняя структуру для обратной записи через провайдер.
Страница Payload сочетает читаемый контент с ИД, связями, загруженными файлами и структурой редактора. Сначала интеграция выбирает локализуемые поля и собирает из них артефакт для перевода. Затем обработчик payload переводит поддерживаемые простые значения и текст Lexical внутри этого артефакта.
Используйте интеграцию с Payload, чтобы выбирать контент и записывать его обратно. Если передать запись CMS напрямую, без фильтрации, этап выбора полей на стороне провайдера будет пропущен. В перевод могут попасть данные, которые для него не предназначены.
Выбранные поля и форматированный текст #
Артефакт из выбранных полей может содержать заголовок и дерево Lexical:
{
"title": "Delivery options",
"body": {
"root": {
"type": "root",
"children": [
{
"type": "paragraph",
"children": [{ "type": "text", "text": "Choose your delivery method.", "format": 0 }]
}
]
}
}
}Заголовок и поддерживаемое текстовое содержимое — материал для перевода. Типы узлов Lexical, данные форматирования и поддерживаемая структура строчных элементов используются при восстановлении. Адреса ссылок, загруженные файлы, связи и структурные поля блоков не становятся обычным текстом только потому, что содержат строки. При этом выбранный локализуемый текст в поддерживаемых полях блоков можно переводить после фильтрации на стороне провайдера.
В Lexical поддерживаемые текстовые фрагменты сохраняют форматирование и структуру строчных элементов. Для пользовательских узлов нужно проверить совместимость с поддерживаемым представлением. Поддержка Lexical не означает поддержку дерева документа любого редактора.
Сопоставление оригинала и перевода #
Пути к исходным и целевым полям позволяют сопоставить значения. Если передан существующий перевод без предыдущей версии оригинала, обработчик использует уже имеющиеся целевые значения, для которых найдено соответствие, и переводит недостающие. Он не перезаписывает все существующие локализованные поля только потому, что это первая зарегистрированная синхронизация.
Если есть предыдущая версия оригинала, обработать нужно изменённые исходные единицы и недостающие целевые значения. Существующий документ CMS может быть переведён лишь частично, поэтому его наличие не означает, что перевод завершён. Восстановление начинается с выбранного исходного артефакта: в него вставляются поддерживаемые переведённые или сохранённые значения. При этом JSON сериализуется заново, а исходные байты не сохраняются.
После правок нужно проверить соответствие фрагментов форматированного текста. Изменение структуры абзацев или пользовательского узла может повлиять на сопоставление, даже если часть слов осталась прежней. Проверяйте итоговое поле CMS и отображаемый контент, а не только корректность артефакта.
От выбора полей к обратной записи #
Интеграция с Payload обеспечивает выбор полей по схеме, чтение данных локали, настройку подключения и обратную запись. Экспорты плагина описаны в документации пакета Payload CMS. Сохраните эти шаги на стороне провайдера до и после обработки артефакта, чтобы выбранные поля вернулись в нужный документ и локаль.
После обратной записи откройте локализованный документ CMS и проверьте простые поля и форматированный текст. Перейдите по ссылкам, проверьте встроенные связи и сравните набор полей перевода с выбранными исходными полями. Восстановление артефакта не предоставляет права на запись у провайдера и не определяет, готов ли контент к публикации.