monking / presentation

Markdown-based slide presentation

Home Page:https://monking.github.io/presentation/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Presentation

Turn a Markdown file into an HTML/JavaScript presentation. Uses pandoc for Markdown-HTML conversion.

usage

Run bin/build [-i] [FILES...] to generate the presentation once. Optional markdown FILES input. Option -i will put HTML file next to the input FILES. Without this option, the files will be put in the dist folder. With no arguments, any .md files in the src folder will be processed.

Run bin/watch & to generate HTML from markdown in the background.

Press ? on a presentation to see keyboard shortcuts.


Note: The presentation uses some ES6 features: classes, arrow functions, const/let, default function parameters, etc. Basically, it won't run in Internet Explorer.

script changes considered and not made

TL;DR: keyboard control only, for now

I'd considered enabling the mouse to advance content with the mousewheel, and move the next and previous slides by clicking on the right and left sides, but I though it wouuld be more valuable to leave the mouse free to interact with the slides (scrolling and clicking).

I'd also originally made it so that advancing the content to the end of a slide wouuld automatically go to the next slide. This would be nice for a clicker or some simple input. But for me, it's too easy to spam the arrow key as I'm racing to the end of a slide, and shoot off to the next slide unintentionally. This way I don't have to worry about ditching a slide prematurely.

2019-01-31T11:27:34-0800 webinar delivered

The slides were very effective as a plan and visual aid, letting me confidently say that some early questions could be addressed in a future slide. And being able to zip backward and forward in revealing lists of content allowed me to highlight certain concepts. I also used my mouse a bunch to select text. Unfortunately, my dictionary extension in chrome was kicking in when I'd double-click a word.

  • I should disable it next time.

About

Markdown-based slide presentation

https://monking.github.io/presentation/

License:MIT License


Languages

Language:HTML 46.9%Language:JavaScript 32.6%Language:Shell 12.9%Language:CSS 7.5%