mvn archetype:generate -DarchetypeGroupId=org.apache.training -DarchetypeArtifactId=content-archetype -DarchetypeVersion=1.0.0
Creating Presentation with Apache Training
Currently the setup uses Asciidoctor to write content and builds the presentation using Apache Maven and Reveal.JS.
We have prepared everything that it should be pretty simple to get started with creating a new presentation.
Java 8 or newer
Maven 3.3 or newer
Until we have released the tooling, you will need to build it locally first or the archetype plugin will fail to run. Please read the following chapter on how to do this.
In order to create an empty presentation to start with, please execute the following command:
For Windows, you need to wrap every argument in double-quotes:
mvn archetype:generate "-DarchetypeGroupId=org.apache.training" "-DarchetypeArtifactId=content-archetype" "-DarchetypeVersion=1.0.0"
package there should be a new directory that matches the
artifactId that you selected.
Change into this directory and run the following command to build the presentation:
After that, there should be a directory
If you open the
index.html in that directory your presentation should open in the browser.
Using the latest development version
If you want to use the latest development version of the Apache Training tooling, please still use the latest released archetype. Otherwise, the archetype plugin will not be able to find the
SNAPSHOT version of the archetype. As generally most changes apply to the parent being used in the slides module, you can update to the latest version by:
Adding the following section to the generated
<!-- Make Snapshots of Apache projects available --> <repositories> <repository> <id>apache-snapshots</id> <url>https://repository.apache.org/content/repositories/snapshots</url> <releases> <enabled>false</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </repository> </repositories>
After adding this you can update the parent version to the latest
SNAPSHOT version and Maven should be able to find it.
Building the Apache Training Tooling
In order to build Apache Training Tooling, please checkout the git repo from:
git clone https://gitbox.apache.org/repos/asf/incubator-training.git cd incubator-training mvn install