Create an asciidoc index to generate a PDF

[romain-grecourt]

Since the current tutorial is currently composed of many distinct asciidoc documents, we cannot use the asciidoctor tool chain to generate a PDF.

We should create an index.adoc with include directives to all documents in order to create a single asciidoctor document that can be used to generate a PDF.

This file shouldn't be outside of src/main/jbake/content so that it's not included in the jbake output.

The asciidoctor maven plugin can be use to render the PDF, see https://github.com/asciidoctor/asciidoctor-maven-examples/tree/master/asciidoctor-pdf-example

[grassit]

I agree with the proposal, and also appreciate if anyone can convert the tutorials into a pdf file and make it available. Has there been some work on it?

[bshannon]

No one is working on this. Since all of these projects are in the process of being contributed to
the Eclipse Foundation as part of the EE4J project, it's probably best if the EE4J community
picks up this work.

[grassit]

Are there programmatic ways to convert the files into a pdf file?

[bshannon]

Discovering or creating a way to do this is why this issue was created.
Romain describes one possible approach above, but there may be
other ways to do it. Did you have specific questions about Romain's
proposal?

[Lars-jnk]

Is there some progression on this topic?
I would like to read the tutorial on my kindle.

[bshannon]

No, and we don't expect anyone to even start working on this until this project is
transferred to the Eclipse Foundation, which we hope will happen in the next few months.

[jimmymain]

A PDF containing the tutorial would be really useful. IMHO It's really not that useful in it's current form.

[glassfishrobot]

Closing this as this issue is migrated to eclipse-ee4j/jakartaee-tutorial#129