AsciiDoc Presentations for Visual Studio Code

Visual Studio Code extension to create reveal.js slides via AsciiDoc documents.

This is fork of AsciiDoc Slides Plugin.

AsciiDoc Presentations requires base extension AsciiDoc to run.

Quickstart

1. Install extension.
2. Download demo AsciiDoc Presentation and open it in Visual Studio Code.
3. Open command palette (View -> Command Palette or Ctrl/Cmd+Shift+P) and run command AsciiDoc Presentation: Open Presentation in Browser.

Features

Slide Preview Panel

• Shows reveal.js slides of asciidoc document beside it.
• Preview is updated on every save of base document.
• Preview is scrolled to the slide of cursor on every save of base document.

Open in Browser

• Show reveal.js slides of asciidoc document in browser.
• Website in browser is updated on every save of base document.
• Website in browser is scrolled to the slide of cursor on every save of base document.

Export to reveal.js html file

Export your slides into a html file which will work locally on your computer (containing links to all required resources as scripts, styles and images).

Export to inlined (shareable) reveal.js html file

Export your slides into an inlined html file which will work everywhere (containing all required scripts, styles and images).

restraints

Inlining currently breaks the following plugins:

• notes plugin (reader view)

Inlining currently does not work for:

• Background Images
• Background Videos
• Background IFrames
• Probably a lot more, see demo.adoc

Kroki integration

Draws images out of textual description of diagrams. Example:

[graphviz]
....
digraph foo {
  node [style=rounded]
  node1 [shape=box]
  node2 [fillcolor=yellow, style="rounded,filled", shape=diamond]
  node3 [shape=record, label="{ a | b | c }"]

  node1 -> node2 -> node3
}
....

Print Slides / Export as PDF

While slides are shown in browser or exported as html/inlined html to same computer, they can transformed into a printable format via url parameter ?print-pdf. The resulting website is printable (or exportable as pdf) via default print menu of chrome/chromium browser (Ctrl/Cmd + P).