This document introduces DOPE, a developer-oriented presentation engine. It summarizes how to get started with DOPE by creating a Maven project, adding Markdown slides, and embedding media like images and videos. Slides can include syntax highlighted code samples and slide notes. The build outputs presentations in HTML, PNG images, PDF, and a JavaFX JAR file. Presentations can be controlled with a keyboard, Wiimote, or browser and viewed over HTTP.

1. Developer Oriented
Presentation Engine
Introduction
Pasi Niemi( ©2013 Nitor Creations )
version: 1.0

2. Contents
Getting started
Creating slides
Slide notes
Embedding media
Inline source code
Outputs
Presenting
Thank you

3. Getting started (1/2)
Maven drives the presentation build
You can create a maven project skeleton with the dope-archetype:
mvn archetype:generate -DarchetypeArtifactId=dope-archetype
-DarchetypeGroupId=com.nitorcreations -DgroupId=foo.bar
-DdeveloperName="Pasi Niemi" -DorganizationName="Nitor Creations"
-DinceptionYear=2013 -Dname="Baz Bar Awesomeness"
-Dtheme=light -DartifactId=baz-prez -DinteractiveMode=false
Parameters explained here: https://github.com/NitorCreations/dope-archetype

4. Getting started (2/2)
Add your slides in src/main/resources/markdown
JavaFX needs to be on your JDK classpath
You may need to run
mvn com.zenjava:javafx-maven-plugin:2.0:fix-classpath
One time only operation per JDK
Java 8 has this sorted
The project contains all of the runtime java code
You can change all runtime behaviour like:
controllers
http server
animations

5. Creating slides (1/2)
Slides shown in alphabetical order
Except the title slide is always first
Name your slide files to get correct order e.g.:
01_agenda.md
10_introduction.md
12_introduction_cont.md

6. Creating slides (2/2)
Slides are markdown interpreted with pegdown
Some extensions are enabled:
AUTOLINKS
URLs will be turned into a link to that URL
TABLES
simple multimarkdown-style tables
FENCED CODE BLOCKS code blocks will be syntax highlighted with pygments

7. Slide notes
Slide notes are markdown files named {slidename}.md.notes
They appear in the http interface for running the presentation
Need to have {slidename}.md for the notes to be added next to the slide
Slides are served as iframes, but notes are just embedded in the index html

8. Embedding media
You can embed images with a simple markdown element
Or embed html if you need more control with e.g. classes and ids for css
For videos you need to embed html
<video width="auto" controls>
<source src="oracle_event_final.mp4" type="video/mp4"/>
<img width="auto" src="oracle_event_final.jpeg"/>
</video>

9. Video handling
The build system finds video elements at compile time
Records the location and size of the placeholder image
At runtime during presentation initialization the engine extracts the video into a
temporary file
As you traverse past the slide with the video, the presentation zooms in on the
placeholder and starts an external player
videoplayer {video}
on my Raspberry Pi this is /usr/bin/videoplayer
#!/bin/bash
exec /usr/bin/omxplayer "$@"

10. Inline source code
pygments supports lots of languages - here are some samples
Python
print highlight(code, PythonLexer(), HtmlFormatter())
Haskell
let (a:b:c:[]) = "xyz" in a
D
import std.stdio;
void main() {
ulong lines = 0;
and lots more at http://pygments.org/languages/

11. Outputs
Maven build outputs the presentation in several formats
HTML is used as the source for png and pdf rendering
PNG images of each slide in FullHD and small sizes
PDF for easy sharing (naturally without videos)
JavaFX jar that can be run on any computer with JavaFX installed
HTML, PNG and PDF formats are downloadable from the http interface
HTML and PNG as Zip files with relevant files inside (including videos)
PDF as a single file

12. Presenting
You can run the presentation with any java that has JavaFX installed:
java -Dhttpport=9999 -Dhttprunpasswords=.passwords -Dnocache=true
-jar my-presentation-1.0-SNAPSHOT-jfx.jar
The presentation can then be controlled with a keyboard, a wiimote or a browser
Advanced usage explained here: https://github.com/NitorCreations/javaone-shanghai2013-javafx-presentation
Video detailing presentation use here: http://www.youtube.com/watch?v=1sdZpecv9a8

13. Thank You!
Hope you have fun with it
If you do come up with extensions you are willing to release, please let me
know
This presentation source available here:
https://github.com/NitorCreations/dope-intro
Pasi Niemi pasi.niemi@nitorcreations.com