Create an asciidoc index to generate a PDF

[glassfishrobot]

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

[glassfishrobot]

@grassit Commented
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?

[glassfishrobot]

@bshannon Commented
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.

[glassfishrobot]

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

[glassfishrobot]

@bshannon Commented
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?

[glassfishrobot]

@Lars-jnk Commented
Is there some progression on this topic?
I would like to read the tutorial on my kindle.

[glassfishrobot]

@bshannon Commented
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.

[glassfishrobot]

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

[glassfishrobot]

• Issue Imported From: Create an asciidoc index to generate a PDF javaee/tutorial#129
• Original Issue Raised By:@romain-grecourt
• Original Issue Assigned To: Unassigned

[ggam]

This will be possible with #191.