ReadMe for PresentAPL

Overview

PresentAPL.exe is a program that allows you to convert a Markdown file into a presentation that can be viewed like a slide show with any modern browser by following some simple rules .

How to create a presentation

The simplest way to use PresentAPL is to drag and drop one or more presentation files (*.md) onto PresentAPL.exe.

Alternatively you can add a context menu entry “Create presentation with PresentAPL”; see below for details how to do that.

The resulting presentation is a stand-alone html file that has the same name as the Markdown file it was created from; it has just “html” as extension rather than “md”. This file will be a sibling of the Markdown file it was created from. If there is already a file with that name it will be overwritten.

If you want to change default parameters then you have several choices:

Using PresentAPL from within APL code

You can also use the class PresentAPL from within your Dyalog APL workspace. It needs the class MarkAPL and the namespace script APLTreeUtils. For details see the class PresentAPL.

Add a command “Create presentation with PresentAPL” to context menu.

You can quite easily add such a context menu command so that whenever you right-click on a file with the extension .md or .markdown it will make an appearance.

That would have the same effect as drag-and-drop but is certainly more convinient.

To make the context command available first check and amend the file MarkdownFile.reg. When done just double-click the file and it will be imported into your Windows Registry. You will need admin rights for this. The new (additional) context menu command will be available straight away.

When the command is issued on a Markdown file PresentAPL will create a presentation from that Markdown file and save it as a sibling of the Markdown file.

Misc

Please send comments, suggestions and bug reports to kai@aplteam.com.

License: http://creativecommons.org/licenses/LGPL/2.1/

A big thank you to:

Kai Jaeger APL Team Ltd
Created 2016-04-12
Last update 2017-01-01