search

eclipse-ee4j / jakartaee-tutorial

Jakarta EE Tutorial
https://eclipse-ee4j.github.io/jakartaee-tutorial
Eclipse Public License 2.0
96 stars 63 forks source link

Create an asciidoc index to generate a PDF #129

Open glassfishrobot opened 6 years ago

glassfishrobot commented 6 years ago

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 commented 5 years ago
glassfishrobot commented 6 years ago

@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 commented 6 years ago

@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 commented 6 years ago

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

glassfishrobot commented 6 years ago

@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 commented 6 years ago

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

glassfishrobot commented 6 years ago

@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 commented 5 years ago

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

ggam commented 4 years ago

This will be possible with #191.