@farberg/reveal-template v1.0.66

reveal-template

This is a helper package to simplify the generation of reveal.js presentations using Markdown files only. It contains a set of (optional) reveal plugins to simplify the creation of lectures.

It is primarily used by myself so it is quite opinionated and makes certains assumptions on the structure of the lecture. Markdown files should follow a certain naming pattern:

• Single level: 00 - Introduction.md, 01 - Bla.md, etc.
• Two level: 00 - Introduction.md, 01 - Topic 1.md, 01a - Sub-Topic 1.md, 01b - Sub-Topic 1.md, 02 - Topic 2, etc.

The resulting files can be published on any web server and do not require server-side components. Everything is rendered by the browser.

Requirements and Installation

To use this project, node.js and npm are required.

Create a new lecture:

• Create a new folder and initialize an empty node.js project (e.g., npm init --yes)
• Add this package as a dependency (npm i @farberg/reveal-template)
• Read the documentation below

Usage

1. Create a file package.json describing your presentation (e.g., like this one).
2. Create an HTML file (e.g., index.html, see npm.html for an example)
3. Create your presentation in Markdown
   • See this file for an example).
   • Using npm (npm install @farberg/reveal-template), see npm.html for an example.

Plugins

Click on the link for documentation

Tested and working

Non-functional, untested or in development

Conversion to PDF

Run npx dennis_generate_pdfs to create PDFs. Requires a running Docker daemon.

Local Development

To start developing on this repository:

• Check out this repository (git clone https://github.com/pfisterer/reveal-template.git)
• Run npm install to install required dependencies
• Start a web server from the root directory (e.g., npx http-server -p 5500)
• Open http://localhost:5500/docs/local-dev.html

Publish a new version (maintainers only)

# Bump version in `package.json`

# Run this command to publish on npm
npm publish --access public