gist-reveal.it


Gist-Powered

reveal.js slides

Reveal.js is a framework

for crafting
beautiful presentations
in HTML
and Markdown

Gist-reveal makes it easy

to view and share reveal.js presentations
using GitHub's Gist service as a datastore

Slides are forkable using the "Presented by" link

Try it out!

1. Create a deck by placing revealjs <section> tag content into a fresh gist. Or, by forking a copy of this gist:
https://gist.github.com/c9427cb7829f4e4ba9c2614ac387105c

2. Copy the resulting Gist ID, then view your slides at:

https://gist-reveal.it/YOUR_GIST_ID_HERE

Try it out!

Broadcast Your Presentations

3. Use /login to authenticate and broadcast your slide transions to other viewers

NOTE: Broadcasting is restricted to the gist owner. See the web console output for additional details.

4. Visit /logout to exit presentation mode

## Reveal.js themes Reveal.js presentation themes are available using the "`theme`" querystring input: * [?theme=black](?theme=black#/themes) * [?theme=white](?theme=white#/themes) * [?theme=simple](?theme=simple#/themes) * [?theme=moon](?theme=moon#/themes) * [?theme=night](?theme=night#/themes) * [?theme=dracula](?theme=dracula#/themes) * [?theme=league](?theme=league#/themes) * [?theme=sky](?theme=sky#/themes)
## Gist-powered themes CSS themes can also be extended via [another gist](https://gist.github.com/450836bbaebcf4c4ae08b331343a7886): * [gist-reveal default theme](?theme=450836bbaebcf4c4ae08b331343a7886#/gist-themes) * [a dark winter theme](?theme=60e54843de11a545897e#/gist-themes) * [a theme from Kubecon 2020 NA](?theme=44a6634ee50a54b3bb4d0c06cdcb7d56#/gist-themes) * [a theme from NodeInteractive 2018](?theme=9181e48c0dd8e6b45d692a11d5a72bd5#/gist-themes)

Nicer presentation paths

Creating a bit.ly shortname for your gist-reveal/gist_id deck url will also make your slides available at an alternate path.

This url path is much easier on the eyes:

Running gist-reveal

gist-reveal in a container

Start gist-reveal on port 8080 using docker or podman:

docker run --rm -p 8080:8080 ryanj/gist-reveal

Optionally configure the default gist_id:

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

Include your own GitHub API Token to avoid rate limiting:

docker run --rm -p 8080:8080 -e "GH_API_TOKEN=YOUR_API_TOKEN" ryanj/gist-reveal

Running gist-reveal

Broadcast Presentations via Websockets

To enable websockets, create a GitHub OAuth app that redirects to: YOUR_SITE/github/callback

Then configure your CLIENT_ID and CLIENT_SECRET:

docker run --rm -p 8080:8080 -e "CLIENT_SECRET=YOUR_SECRET_KEY" \
                             -e "CLIENT_ID=YOUR_CLIENT_ID" ryanj/gist-reveal

Running gist-reveal

gist-reveal on kubernetes

Create a kubernetes pod and service:

kubectl run gist-reveal --image=ryanj/gist-reveal \
--expose --port=8080 \
--env="DEFAULT_GIST=YOUR_DEFAULT_GIST_ID" \
--env="GH_API_TOKEN=YOUR_GH_API_TOKEN" \
--env="CLIENT_SECRET=YOUR_GH_CLIENT_SECRET" \
--env="CLIENT_ID=YOUR_GH_CLIENT_ID"

See the README for additional app configuration options

THE END

gist-reveal by ryanj and fkautz

Revaljs by Hakim El Hattab / hakim.se

github.com/ryanj/gist-reveal
hub.docker.com/r/ryanj/gist-reveal

Presented by: @ryanj