Генерация PDF документов из файлов Markdown во время сборки Maven - PullRequest
Новая
       23

Генерация PDF документов из файлов Markdown во время сборки Maven

3 голосов
/ 17 марта 2020

У меня есть Java проект с плагином Maven Assembly. Плагин Assembly создает окончательный файл релиза ZIP, который содержит двоичные файлы (* .war), файлы конфигурации и некоторую документацию в формате PDF.

Документы написаны в Markdown, а документы PDF для выпуска необходимо создавать вручную ( например, с Уценка к PDF онлайн-инструменту ) перед выполнением сборки с Maven. Затем плагин Assembly берет PDF-файлы и помещает их в окончательный ZIP-файл.

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

Я хотел бы автоматизировать создание PDF. Я проверил четыре плагина MD в PDF maven, но ни один из них не работает нормально. Я нашел плагин для генерации MD в HTML (без таблицы стилей по умолчанию) и, возможно, я смогу использовать другой плагин для конвертации HTML в PDF, но это так больно.

Что я пробовал:

  • maven-site-plugin + doxia : генерирует только HTML, а не PDF
  • markdown-page-generator -plugin : генерирует только HTML без таблицы стилей по умолчанию и должен иметь внешний заголовок, HTML-код шаблона нижнего колонтитула
  • maven-pdf-plugin : большой отчет содержит почти «весь мир», а не только * .md файлы
  • markdowndo c -maven-plugin : это происходит из другого репо и репозитория плагинов, к которому я не могу добавить pom. xml, и сложный в использовании.

Есть ли простой способ создания PDF-файлов с помощью Maven на основе файлов Markdown в процессе сборки?

...