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

License

Categories

Categories

IDE Development Tools
GroupId

GroupId

io.github.gaol.slides
ArtifactId

ArtifactId

slides
Last Version

Last Version

1.0.3
Release Date

Release Date

Type

Type

jar
Description

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

Project Organization

Eclipse
Source Code Management

Source Code Management

https://github.com/gaol/slides

Download slides

How to add to project

<!-- 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>
// https://jarcasting.com/artifacts/io.github.gaol.slides/slides/
implementation 'io.github.gaol.slides:slides:1.0.3'
// https://jarcasting.com/artifacts/io.github.gaol.slides/slides/
implementation ("io.github.gaol.slides:slides:1.0.3")
'io.github.gaol.slides:slides:jar:1.0.3'
<dependency org="io.github.gaol.slides" name="slides" rev="1.0.3">
  <artifact name="slides" type="jar" />
</dependency>
@Grapes(
@Grab(group='io.github.gaol.slides', module='slides', version='1.0.3')
)
libraryDependencies += "io.github.gaol.slides" % "slides" % "1.0.3"
[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.

Sample Talk

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