This repository contains slides for our (humorous) talk “Every Author as First Author” at SIGTBD 2023 held April 7, 2023 in Cambridge, Massachusetts.
This repository uses the reveal-pug-talk template to make slides by combining the following technology (all free and open source):
- reveal.js: a flexible HTML presentation framework,
extendable by plugins and themes. Here we use:
- Chalkboard: enables live drawing annotation on the slides (using pen or touch or mouse)
- Merriweather font
- KaTeX: a library for translating LaTeX math into HTML
- Pug: a concise indentation-based notation for HTML, which makes it easier to express reveal.js slides, and to mix together other languages, such as the following
- Stylus: a concise indentation-based notation for CSS (styling of HTML)
- CoffeeScript: an indentation-based language that compiles to JavaScript
- Gulp: a tool that builds the Pug code into HTML
Here's an overview of the individual files and what they do:
gulpfile.coffee
: Definitions ofbuild
andwatch
rules that run Pug onindex.pug
and compile other.coffee
files to.js
.index.pug
: Top-level Pug file that calls all other files. Defines the top-level structure of the document, but has no slides.slides.pug
: Slides and specific animations are defined here.index.styl
: Custom reveal.js styling, and specific styling for the slides and author stacks (see.stack
rule in particular).stack.coffee
: Convertclass="autostack"
spans with semicolon-separated names into necessary HTML for author stacks.
To build the slides HTML (index.html
) from the source files:
-
Install NodeJS if you haven't already.
-
Clone the repository
-
Run the following:
npm install npm run build
If you're live-editing source files and want index.html
to continually build
and update, use the following command:
npm run watch
To assemble just the needed files into a dist
directory
(as defined by deploySet
in gulpfile.coffee
),
use the following command:
npm run dist
To deploy these files to GitHub Pages, use the following command:
npm run deploy