/reveal-cljs

reveal.js + ClojureScript = Awesome presentations with joy

Primary LanguageClojureMIT LicenseMIT

reveal-cljs

Clojure CI https://github.com/n2o/reveal-cljs/releases https://github.com/n2o/reveal-cljs/blob/master/LICENSE

Inspired by the great work on reveal.js and the dislike towards JavaScript, this small project was created to provide a simple wrapper in ClojureScript to create awesome presentations. All features from reveal.js can be used. Check the official documentation of reveal.js for more information about it.

🌅 Find a demo of reveal-cljs on this page: https://n2o.github.io/reveal-cljs/

It uses Hiccup-syntax for templates, which makes it very easy to create slides.

Start the project with yarn dev and see your live slides. Start speaker-mode by pressing s in the slides in your browser.

sample.png

Requirements

Tested with AdoptOpenJDK 16, see CI Build Job for more details in the environment.

A JDK, Clojure's CLI Tools and yarn are necessary to build and run the project.

Usage

Set your desired options in core.cljs. More options can be found here.

Create your slides in slides.cljs and add them to the list in the function all.

Then start the development server as seen in the Setup section.

Installation & Setup

Everything in one command:

yarn install

To get an interactive development environment, run:

yarn dev

Figwheel opens your browser at localhost:9500. This will auto compile and send all changes to the browser without the need to reload.

Open Speaker Notes by pressing s.

Compile and Prepare for Deployment

You can compile the cljs-Code and put the assets together to make your presentation ready to be deployed on a webserver (e.g. on GitHub Pages). By following these steps, you can publish the presentation on a regular server, which only needs to serve HTML, CSS and JavaScript Files. This is all put into one task:

yarn build

Follow the steps on the terminal to find your prepared presentation.

Software

This project uses external packages, which can be removed by you, since most of them are not essential:

License

Copyright © 2016 – today Christian Meter and Contributors

Distributed under the MIT License.