Presentation with Reveal.JS and AsciiDoctor

Remarks:

• In order to use the preview of the IntelliJ asciidoctor plugin, you need to set an attribute in the plugin settings: imagesdir = ../resources/images
• Any css adjustments can go to src/main/theme/apache.css as this is automatically embedded into the themes directory.

Building the presentation

Apache Training makes use of several tools in order to compile the presentations. The probably simplest way to build the project is using Docker, as we provide the Dockerfile for installing all prerequisites.

docker compose up

This should produce compiled versions of all presentations in your local working copy.

If you want to build the presentation on your local system the following command should do. However, if you are missing prerequisites, then this build will most probably fail.

By running the following command, you can generate the presentation:

mvn package

Running the presentation

In order to show the presentation, go into the target directory and look for a directory named {artifactId}-{version}. This direcotry contains an index.html file.

Simply open this in any browser of your choice.

Generating PDF versions

In order to generate a PDF version of the presentation just add ?print-pdf to the url. (Keep in mind, that you have to add it before any #blahblah)

The following link should do the trick:

http:///{someFilePath}/?print-pdf

As soon as that's loaded, the presentation will look a bit odd. Now just use the normal print functionality of the browser and select print as PDF.