n8n-nodes-sotoros-gotenberg

Кастомный узел n8n для интеграции с API Gotenberg для конвертации документов в PDF.

Возможности

• Конвертация документов Office (Word, Excel, PowerPoint) в PDF
• Конвертация HTML в PDF
• Конвертация Markdown в PDF
• Конвертация URL в PDF
• Объединение нескольких PDF файлов
• Поддержка одиночных бинарных файлов и массивов бинарных файлов
• Автоматическая обработка всех бинарных свойств из предыдущих узлов
• Настраиваемые опции конвертации (альбомная ориентация, диапазоны страниц, масштаб и т.д.)

Установка

1. Клонируйте этот репозиторий или скопируйте файлы в директорию кастомных узлов n8n
2. Установите зависимости:

   npm install

3. Соберите проект:

   npm run build

4. Скопируйте папку dist в директорию кастомных узлов n8n, или установите как пакет

Конфигурация

Gotenberg URL

Базовый URL вашего сервера Gotenberg (по умолчанию: http://localhost:3000)

Операция

Выберите тип конвертации:

• Convert Office Documents: Конвертация файлов Word, Excel, PowerPoint в PDF
• Convert HTML: Конвертация HTML контента в PDF
• Convert Markdown: Конвертация Markdown контента в PDF
• Convert URL: Конвертация веб-страницы по URL в PDF
• Merge PDFs: Объединение нескольких PDF файлов в один

Binary Property

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

Output Binary Property

Имя бинарного свойства, в которое будет сохранен сконвертированный PDF (по умолчанию: data)

Опции

• Landscape: Использовать альбомную ориентацию
• Page Ranges: Указать диапазоны страниц (например, "1-2,4-5")
• Scale: Коэффициент масштабирования для PDF (от 0.1 до 2)
• Wait Timeout: Максимальное время ожидания конвертации (например, "30s", "1m")
• Wait Delay: Задержка перед началом конвертации (например, "1s")

Примеры использования

Пример 1: Конвертация одного документа Office

1. Используйте узел, который читает файл (например, "Read Binary File")
2. Подключите его к узлу Gotenberg
3. Настройте:
   • Operation: "Convert Office Documents"
   • Binary Property: (оставьте пустым для использования всех бинарных свойств)
   • Gotenberg URL: URL вашего сервера Gotenberg

Пример 2: Конвертация нескольких файлов из массива

1. Используйте узел, который возвращает несколько бинарных файлов (например, "Read Binary Files" с несколькими файлами)
2. Узел Gotenberg автоматически обработает все файлы в массиве
3. Все файлы будут сконвертированы и объединены в один PDF

Пример 3: Конвертация HTML в PDF

1. Используйте узел, который предоставляет HTML контент как бинарные данные
2. Настройте:
   • Operation: "Convert HTML"
   • Binary Property: Имя свойства, содержащего HTML

Обработка бинарных данных

Узел поддерживает как одиночные бинарные файлы, так и массивы бинарных файлов:

• Одиночный файл: Если бинарное свойство содержит один файл, он будет обработан напрямую
• Массив файлов: Если бинарное свойство содержит массив файлов, все файлы будут обработаны и отправлены в Gotenberg
• Несколько свойств: Если конкретное бинарное свойство не указано, будут обработаны все бинарные свойства из предыдущего узла

Требования

• n8n (self-hosted или cloud)
• Работающий и доступный сервер Gotenberg
• Node.js 18+ и npm

Разработка

# Установка зависимостей
npm install

# Сборка проекта
npm run build

# Режим наблюдения для разработки
npm run dev

# Проверка кода линтером
npm run lint

# Форматирование кода
npm run format

Лицензия

MIT

Автор

Danila Fokin [email protected]

Ссылки

• Документация Gotenberg
• Документация n8n