The slides application that uses reveal.js as the JS Slides engine

Sonatype helps open source projects to set up Maven repositories on https://oss.sonatype.org/

License	The Apache Software License, Version 2.0 Eclipse Public License - v 1.0
Categories	IDE Development Tools
GroupId	io.github.gaol.slides
ArtifactId	slides
Last Version	1.0.3
Release Date	Sep 4, 2019
Type	jar
Description	The slides application that uses reveal.js as the JS Slides engine Sonatype helps open source projects to set up Maven repositories on https://oss.sonatype.org/
Project Organization	Eclipse
Source Code Management	https://github.com/gaol/slides

Download slides

Filename	Size
slides-1.0.3.pom
slides-1.0.3.jar	16 KB
slides-1.0.3-tests.jar	2 KB
slides-1.0.3-sources.jar	7 KB
slides-1.0.3-javadoc.jar	28 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/io.github.gaol.slides/slides/ -->
<dependency>
    <groupId>io.github.gaol.slides</groupId>
    <artifactId>slides</artifactId>
    <version>1.0.3</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/io.github.gaol.slides/slides/
implementation 'io.github.gaol.slides:slides:1.0.3'

Gradle Kotlin

// https://jarcasting.com/artifacts/io.github.gaol.slides/slides/
implementation ("io.github.gaol.slides:slides:1.0.3")

Apache Buildr

'io.github.gaol.slides:slides:jar:1.0.3'

Apache Ivy

<dependency org="io.github.gaol.slides" name="slides" rev="1.0.3">
  <artifact name="slides" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='io.github.gaol.slides', module='slides', version='1.0.3')
)

Scala SBT

libraryDependencies += "io.github.gaol.slides" % "slides" % "1.0.3"

Leiningen

[io.github.gaol.slides/slides "1.0.3"]

Dependencies

compile (6)

Group / Artifact	Type	Version
io.vertx : vertx-core	jar
io.vertx : vertx-web	jar
io.vertx : vertx-rx-java2	jar
io.vertx : vertx-web-templ-freemarker	jar
org.slf4j : slf4j-api	jar	1.7.25
org.slf4j : slf4j-simple	jar	1.7.25

provided (2)

Group / Artifact	Type	Version
org.webjars.bowergithub.hakimel : reveal.js	jar	3.8.0
org.webjars : bootstrap	jar	4.3.1

Project Modules

There are no modules declared in this project.

Slides

This project provides an easy way to produce HTML slides based on reveal.js

How to use

The recommended way to use it is to run the Docker container.

In case you have a slides directory in your working directory, run the following command can start a ready-to-use slides webapp for you.

docker run --rm -p 8080:8080 -v `pwd`:/opt/app aoingl/slides-app

Now you can visit the slides:

http://localhost:8080/slides/

Slides in 'slides' directory:

The most common way to design your reveal.js based slides using this project is to have a slides directory in the current working directory.

Suppose you are in working directory samples:

cd samples

The structure in samples directory is:

tree samples

samples
└── slides
    └── free_talk                  # the slide name can be overriden 
        ├── reactive-traits.svg    # the image can be refered as relative link in the slide.html
        ├── Server.java            # sample file that can be refered to in the side.html as well
        ├── server.js              # sample file that can be refered to in the side.html as well
        ├── slide.html             # the main slide content (reveal.js defined content)
        └── slide.json             # customized freemarker context used in default slide template

After running above command, the slide in slides/free_talk can be accessed using link:

http://localhost:8080/slides/free_talk/

Any changes in the slides will take effect immediately.

Slides in a zip file

Sometime you may want to share your slides, it is better to have it zipped.

You can simply put the zip file in the slides_zip directory in the current working directory.

If the slides are packaged into a zip file, like the my_talk.zip in the slides_zip directory in the working directory, it can be accessed using link:

http://localhost:8080/slides/my_talk/

The my_talk.zip file structure is just like the free_talk directory:

[🎩 lgao@lgao slides]$ unzip -l slides_zip/my_talk.zip 
Archive:  slides_zip/my_talk.zip
  Length      Date    Time    Name
---------  ---------- -----   ----
    27360  06-19-2019 16:37   use_mouse.jpg
      141  06-19-2019 16:40   slide.html
       40  06-19-2019 16:40   slide.json
---------                     -------
    27541                     3 files

How to build

mvn clean install -Papp

Use the profile app to build the slides-app.jar

How to release

mvn clean install -Psonatype-oss-release

This will build the all ready to deploy artifiacts

Versions

Version
1.0.3 Sep 4, 2019