Auto Translate (LibreTranslate)

Описание

После создания или обновления документа в исходной локали afterChange-хук ставит его в очередь в памяти. Фоновый воркер отправляет переводимые строки в LibreTranslate и записывает результат в каждую целевую локаль. Черновики переводятся без публикации, если у коллекции включены versions. Плагин обходит локализованные поля и пропускает всё, что не является текстом, а также поля, исключённые для коллекции или глобально. Lexical обрабатывается на уровне AST: переводятся только текстовые листья, а заголовки, ссылки, таблицы и пользовательские блоки остаются на месте. Массивы и блоки сливаются, а не перезаписываются. Текст, который редактор уже исправил в целевой локали, сохраняется, изменённый текст источника обновляется, новые блоки добавляются в конец, а блоки с разным blockType не смешиваются. Генерация slug опциональна. При включении slug строится из исходного поля, например title: немецкие умлауты раскрываются, для латинских локалей диакритика удаляется, а при latinLocalesOnly нелатинские локали получают ASCII-slug. Функцию slugify можно заменить своей. Исключения задаются через customFieldExclusions, customValueExclusions, customValuePatterns (строки или RegExp) и excludedFields для каждой коллекции. Если список коллекций не задан, пропускаются media, users, payload-preferences, payload-migrations и submissions. Строки, которые LibreTranslate вернул без изменений, можно повторно перевести через fallbackRetry. Для заполнения существующих данных есть DatabaseCrawler и CLI payload-auto-translate, экспортируемые через ./crawler. Они читают таблицы PostgreSQL напрямую и требуют @payloadcms/db-postgres и pg. Для работы нужен доступный сервер LibreTranslate, API-ключ при этом необязателен. В Next.js с App Router потребуется указать пакет в transpilePackages.

О пакете

Имя пакета

@itpyx/payload-auto-translate

Последняя версия

1.2.3

Размер

378 кБ

Лицензия

MIT

Загрузок в неделю

328

Последняя публикация

14 окт. 2026 г.