jakartaee-tutorial icon indicating copy to clipboard operation
jakartaee-tutorial copied to clipboard

Create an asciidoc index to generate a PDF

Open glassfishrobot opened this issue 8 years ago • 9 comments

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 avatar Oct 03 '17 22:10 glassfishrobot

  • Issue Imported From: https://github.com/javaee/tutorial/issues/129
  • Original Issue Raised By:@romain-grecourt
  • Original Issue Assigned To: Unassigned

glassfishrobot avatar Jan 28 '19 14:01 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 avatar Dec 20 '17 13:12 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 avatar Dec 21 '17 04:12 glassfishrobot

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

glassfishrobot avatar Jan 17 '18 03:01 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 avatar Jan 17 '18 20:01 glassfishrobot

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

glassfishrobot avatar Aug 19 '18 05:08 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 avatar Aug 20 '18 18:08 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 avatar Dec 07 '18 08:12 glassfishrobot

This will be possible with #191.

ggam avatar Apr 26 '20 13:04 ggam