Posted by Alexander Zobkov on Dec 20, 2015; 10:51am
URL: https://discuss.asciidoctor.org/Embedding-Javadoc-into-asciidoc-based-documentation-tp4116.html

Hello,

I'm looking for a way to include javadoc into asciidoc based documentation. important note is what asciidoc files are converted into PDF. As far as I understand existing asciidoclet can't help here, as it's to support asciidoc syntax in javadoc but not to output/generate javadoc into asciidoc format.

I can imagine the following approaches to achieve the goal:
1) javadoc with xml-doclet -> xslt -> javadoc.adoc ->  include javadoc.adoc as appendix of reference-guide.adoc -> asciidoctorj-pdf -> pdf
2) javadoc with db-doclet -> docbookrx -> javadoc.adoc ->  include javadoc.adoc as appendix of reference-guide.adoc -> asciidoctorj-pdf -> pdf
3) javadoc with freemaker-doclet -> javadoc.adoc ->  include javadoc.adoc as appendix of reference-guide.adoc -> asciidoctorj-pdf -> pdf
4) javadoc with pdf-doclet -> javadoc.pdf -> merge with reference-guide.pdf by using apache pdfbox
5) javadoc -> javadoc.html -> wkhtmltopdf -> javadoc.pdf -> merge with reference-guide.pdf by using apache pdfbox

Could you please suggest, probably there are better approaches that can be more easier to implement and does not require complex transformation pipelines?