Печать Javadocs

Question

Что-то, что у меня было хорошее, и я не смог найти, как эффективно получить бумажную копию Javadocs? Очевидно, что одним из решений является просто перейти на каждую страницу и выполнить печать в браузере, но это должен быть лучший способ! У вас есть идеи?

Answer 1

Вы можете использовать DocBook Doclet (dbdoclet) для создания DocBook XML из ваших комментариев JavaDoc. Затем DocBook XML можно преобразовать в PDF или (Singlepage-) HTML.

Вы можете вызвать инструмент из командной строки. Направьте его в файлы классов, и он будет генерировать DocBook XML. Это работает подобно команде javadoc, которая будет генерировать JavaDoc HTML. Пример:

./dbdoclet -sourcepath ~/my-java-program/src/main/java -subpackages org.example 

Результатом является XML-файл DocBook в dbdoclet подкаталоге, который может быть использован для создания PDF или HTML файл. Это также можно сделать из командной строки; Для этого я использую docbkx-maven-plugin.

Вы можете делать массовые конверсии с ним, но для этого потребуется некоторое время, чтобы он работал так, как вы хотите.