1 # About PresentAPL
   2 
   3 [Data]:author="Kai Jaeger"
   4 [Data]:company="APL Team Ltd"
   5 [Data]:date="2016-03-10"
   6 
   7 ## About PresentAPL
   8 
   9 ### \{$author\}, \{$company\}
  10 ### \{$date\}
  11 
  12 
  13 ## PresentAPL -1-
  14 
  15 * **PresentAPL** is a Dyalog class.
  16 * It takes a Markdown file as input
  17 * It uses MarkAPL to parse the Markdown.
  18 * It creates a slide show from the Markdown. 
  19 * It uses HTML5, CSS and a bit of JavaScript to achieve that.
  20 * All it needs is a modern browser.  
  21 
  22 
  23 ## PresentAPL -2-
  24 
  25 * Creates a slide show (or presentation) from a Markdown file.
  26 * Uses the MarkAPL class (parser) for the conversion.
  27 * See the Markdown file this presentation was created from as a template.
  28 * There is a file `Example.md` available discussing all formatting options.
  29 * There is an EXE available and a class script.
  30 * In order to use the EXE you don't even need Dyalog APL.
  31 
  32 One can use all the stuff supported by MarkAPL: paragraphs, lists, code blocks, tables, images, blockquotes, horizontal rulers, in-line markup (**bold**, _italic_, `APL code`, ~~deleted~~...) and more.
  33 
  34 
  35 <div class="handout">
  36 
  37 This is a paragraph **with** in-line mark-up that shows in print view only. The blank lines above and underneath this paragraph are essential. Only then are the two `<div>`s recognized as two rather than one HTML block, and only then is anything between the two `<div>`s interpreted as Markdown. 
  38 
  39 </div>
  40 
  41 
  42 ## Advantages  
  43 
  44 * Single stand-alone HTML file.
  45 * It's just HTML5, CSS and a bit of JavaScript.
  46 * Open Source.
  47 * Simple and easy to use.
  48 * Allows testing code expressions used in a presentation. 
  49 
  50 ⍝ This file acts also as an example of how to create such a slide show.
  51 
  52 
  53 ## Disadvantages
  54 * No animations other than animated GIFs.
  55 
  56 
  57 ## Workflow
  58 
  59 1. Create a presentation by editing a Markdown file. `AboutPresentAPL.md` is an excellent starting point
  60 2. Drag the `*.md` file onto `PresentAPL.exe`
  61 3. View the resulting HTML file - your presentation.
  62 
  63 
  64 ## Keyboard shortcuts
  65 
  66 The following keys are used to control a PresentAPL presentation:{.nonincremental}
  67 
  68 | Key        | Comment |
  69 | - | - |
  70 | <PgDn> | Show the next slide |
  71 | <PgUp> | Show previous slide | 
  72 | <Home>| First slide |
  73 | <End>	  | Last slide |
  74 | Cursor-right | Show next item |
  75 | Cursor-left | Hide current item | 
  76 | M	         | Toggle mouse navigation (default=off) |
  77 | S | Toggle status bar visibility |
  78 | P  | For "Print": shows all slides at once including any `<div>`s of the class "handout". 
  79 
  80 ## Incremental
  81 
  82 * All elements are always incremental.
  83 
  84   That means that by pressing <CursorRight> just one element at a time is revealed.
  85   
  86 * If you don't want this just press <PgDn> - this shows a whole slide at once.
  87   
  88 ## Misc
  89 
  90 I like to know when the last topic on a slide has been revealed.
  91 
  92 The bottom-left corner shows an arrow as long as not all items are revealed.