Presentations on the Open Web

Reveal.js is a framework
for easily crafting
beautiful presentations
in HTML

Tips on using Reveal.js

There is a lot of great information about using Reveal.js in the project's README page on GitHub.

Their original slide deck sample conent also contains a lot of great examples.

Host your own slideshow service on Kubernetes

To create a kubernetes deployment and NodePort service, both named gist-reveal, run:

kubectl run gist-reveal --image=ryanj/gist-reveal \
--expose --port=8080 --service-overrides='{ "spec": { "type": "NodePort" } }' \
--env="DEFAULT_GIST=YOUR_DEFAULT_GIST_ID" \
--env="GH_CLIENT_SECRET=YOUR_GH_CLIENT_SECRET" \
--env="GH_CLIENT_ID=YOUR_GH_CLIENT_ID" \
--env="REVEAL_SOCKET_SECRET=0P3N-S0URC3" \
--env="GA_TRACKER=YOUR_GA_TRACKER"

minikube service gist-reveal

Host your own slideshow index with Docker

Start up a local development server on port 8080:

docker run ryanj/gist-reveal

For production, I like to daemonize the process, configure a default gist_id, and make the container available on port 80:

docker run -d -p 80:8080 -e "DEFAULT_GIST=af84d40e58c5c2a908dd" ryanj/gist-reveal

GITHUB API RATE LIMITS

Include your own GitHub application keys if you plan on making more than 60 requests in 2 hours:

docker run -e "GH_CLIENT_SECRET=11becbb840e0ff7414b19104e9e797556498fc3f" -e "GH_CLIENT_ID=639ffe9fd9dcc4f6eb4b" ryanj/gist-reveal

Built-in Analytics

Include your own GA-TRACKER key:

docker run -e "GA_TRACKER=UA-12345678" ryanj/gist-reveal

Broadcasting Your Slide Transitions

with Socket.IO

docker run -e "REVEAL_SOCKET_SECRET=0P3N-S0URC3" ryanj/gist-reveal

Configure your browser as a presentation device by setting the same key in your browser's localStorage

localStorage.secret="YOUR_SECRET_KEY"

Be sure to use two different devices or brower types when testing your broadcasting relay
(FireFox vs. Chrome, desktop vs. mobile, etc.)