docker-reveal - A Docker image for reveal.js presentations
This docker image is useful for creating reveal.js presentations. It uses the Yeoman generator
generator-reveal under the hoods.
- Based on Alpine Linux
- Butterfly, a HTML 5 terminal emulation,
for inline terminal demos.
- Docker client
- Live Reload
- Java 8 and Maven 3.5.0
All your slides will be stored belong a certain directory, referred to
$SLIDES from now on. In order to initialize a first simple set of slides (as
yo reveal would do) mount
$SLIDES into the container and run this image with the option
docker run -ti \ -p 9000:9000 -p 57575:57575 -p 35729:35729 \ -v $SLIDES:/slides \ rhuss/docker-reveal -i
This will copy over a set of slides and start an HTTP server on port 9000. You can visit the demo slides by opening your browser at
dockerhost is the IP address of you docker host (e.g.
You can now edit the files in
$SLIDES. Any change will be picked up immediately and if you have LiveReload installed your browser will refresh immediately.
Slides can be created easily with
docker run -ti \ -v $SLIDES:/slides \ rhuss/docker-reveal -n "Slide title" [--markdown|--notes|--attributes]
This can be also done manually:
- Create a new slide in
$SLIDES/slides/, either as HTML (
.html) or Markdown (
- Add this slide to the list in
More options are available, please refer to
generator-reveal's documentation for details.
- If you are using
mvnin you demos, you might want to mount your local Maven repository to avoid unnecessary download times. This can be done by adding a
-v ~/.m2:/root/.m2to the Docker command line. Otherwise the container starts up with an empty local repository.
- In order to access the outer Docker daemon a
-v /var/run/docker.sock:/var/run/docker.sockmust be added so that the Unix socket is also available within the container. See The Docker Wormhole Pattern for more information.
When you are finished with authoring you can create your own image containing your full presentation. This could also contain the source of your applications which you demo. An example
Dockerfile could look like:
FROM rhuss/docker-reveal:latest # Add presentation slides (add here the $SLIDES dir as source directory ADD slides/ / # Optionally checkout your source code and warm it up RUN cd / && \ git clone https://github.com/rhuss/docker-maven-sample.git && \ cd docker-maven-sample && \ mvn install
8bitdo Zero support
In case you own a 8bitdo Zero and want to use it as remote control, set in you Browser's
localStorage (see Developer console) the key
true. Then you can use the following buttons for the following actions:
|Up||Up one slide|
|Down||Down one slide|
|Left||Left one slide|
|Right||Right one slide|
When in menu mode the button mappings is:
|L||Select menu item|
|Up||Up in menu list|
|Down||Down in menu list|
|A||First position in list|
|Y||Last position in list|
|X||Page up in list|
|Y||Page down in list|
The terminal emulation works quite nicely but is of course completely insecure with respect to your container. Please keep this in mind. Also, the dynamic sizing of the iframe providing the Butterfly terminal emulation could be improved. I happily will apply pull requests here ;-)