Bespoke.js Starter Presentation

A starter presentation for Bespoke.js that integrates asciidoctor-bespoke for generating the HTML from AsciiDoc.

Building the presentation

Prerequisites

In order to use this project, you must first satisify the prerequisites of Bespoke.js and Asciidoctor.

For Bespoke.js

1. Node.js >= 0.12 ^[1]

2. Gulp (command line interface only)

   $ npm install -g gulp-cli

For Asciidoctor

1. Ruby >= 2 ^[2]

2. Bundler

   $ rvm use 2.3.0 --install # (optional)
   $ gem install bundler

Setup

Next, clone the repository and switch to the project directory:

$ git clone -b asciidoc https://github.com/opendevise/presentation-bespoke-starter.git
  cd presentation-bespoke-starter

Then, install the required dependencies:

$ bundle && npm i

Note	The bundle command is configured to install gems within this project, under the rubygems/ directory. As normal, the npm i command installs Node.js modules into the node_modules/ directory.

Now you’re all set to build the presentation!

Building the static version

You can build a static version of the slides using the following command:

$ gulp

The files are built into the public directory. You can view the slides by navigating to public/index.html in your browser.

Launching the preview server

The preview server will monitor files for changes and automatically update the presentation. You can launch the preview server using:

$ gulp serve

Once the server is running, you can view the slides by navigating to http://localhost:8000 in your browser.

---

1. We strongly recommend using nvm to manage Node.

2. We strongly recommend using RVM to manage Ruby.