Folders and files
Controller image for official Mirantis training courses.
docker-present is a custom controller image that compiles/serves presentations using RevealJS.
Provides:
- The option to split up the different sections of your presentation into 'modules' (instead of only using one file)
- Create a presentation outline file and specify which modules you want included in each presentation
- On launch, provides a prompt menu for selecting a presentation to serve
- After selecting a presentation. The controller compiles the presentation and serves it on the port specified
- The controller & presentations are bundled and distributed using Docker images
For instructions on how to create modules and presentations see the related Github repository: https://github.com/docker-training/presentations
Pull the image:
kizbitz@docker:~$ docker pull mirantistraining/docker-present Using default tag: latest latest: Pulling from mirantistraining/docker-present dbacfa057b30: Pull complete --- removed --- 0df5b3ba9e25: Pull complete Digest: sha256:168922341fcec9f2ec78ec8b1f62ca461b8218624c79501acfec80c49c2441bb Status: Downloaded newer image for mirantistraining/docker-present:latest
Launching a container from the image without any arguments will display the help (or use the -h flag):
kizbitz@docker:~$ docker run -ti --rm -v /var/run/docker.sock:/var/run/docker.sock mirantistraining/docker-present
docker-present
Available Options:
-h Display help
-p Specify port (required)
Usage:
docker run -ti --rm --name=mirantis-present -v /var/run/docker.sock:/var/run/docker.sock mirantistraining/docker-present -p <port>
Note: Mounting the Docker socket and specifying a port is required.
kizbitz@docker:~$ docker run -ti --rm -v /var/run/docker.sock:/var/run/docker.sock mirantistraining/docker-present -p 8000
Select a presentation to serve from the menu:
kizbitz@docker:~$ docker run -ti --rm -v /var/run/docker.sock:/var/run/docker.sock mirantistraining/docker-present -p 8000 Available Presentations: 1) presentation1 3) presentation3 2) presentation2 4) presentation4 Enter selection: 2 Attempting to start presentation 'presentation2' on port: 8000 ... bfaf705df7ea57419e5d9d33c9e50b72e183e81a34cc3a1d25a61f0fb0d72304 kizbitz@docker:~$
You can use a custom/one-off presentation file by:
- Creating a new temporary presentation file on your local host (See: https://github.com/docker-training/presentations)
- Launch a new container and pass in your file by mounting it to the path: /full/host/path/to/<file>:/opt/revealjs/src/presentations/<filename>
Example:
kizbitz@docker:~$ docker run -ti -v /var/run/docker.sock:/var/run/docker.sock -v $(pwd)/custom:/opt/revealjs/src/presentations/custom mirantistraining/docker-present -p 8000 Available Presentations: 1) custom 3) presentation3 2) presentation1 4) presentation4 Enter selection: 1
If you're currently developing modules/presentations or want to use a different repository, mount the entire directory to: /tmp/src. Note that your presentations must be in a directory called presentations. In the below example your presentations would be in $(pwd)/mypresentations/presentations.
kizbitz@docker:~/sandbox$ git clone https://github.com/kizbitz/mypresentations Cloning into 'mypresentations'... remote: Counting objects: 107, done. remote: Compressing objects: 100% (93/93), done. remote: Total 107 (delta 22), reused 29 (delta 3), pack-reused 0 Receiving objects: 100% (107/107), 28.69 KiB | 0 bytes/s, done. Resolving deltas: 100% (22/22), done. Checking connectivity... done. kizbitz@docker:~/sandbox$ docker run -ti -v /var/run/docker.sock:/var/run/docker.sock -v $(pwd)/mypresentations:/tmp/src miranitstraining/docker-present -p 8000
To customize the theme modify the following files:
- The base index.html: https://github.com/docker-training/docker-present/blob/master/present/templates/index.html
- Note: These lines must stay in the template. The controller replaces them with the presentation sections: https://github.com/docker-training/docker-present/blob/master/present/templates/index.html#L39-L43
- The primary css file: https://github.com/docker-training/docker-present/blob/master/present/css/docker.css
- The code syntax highlighting css file: https://github.com/docker-training/docker-present/blob/master/present/css/docker-code.css