mraible / infoq-mini-book-presentation

Writing an InfoQ Mini-Book with Asciidoctor

Writing an InfoQ Mini-Book with Asciidoctor

An Asciidoctor-powered presentation that shows you how to write an InfoQ Mini-Book with Asciidoctor.

Slides | Presentation on YouTube

If you’d like to create a similar presentation, clone Bespoke.js Emulating Shower.

Building the presentation

Prerequisites

Ensure you have the following installed on your machine:

1. Ruby 2.x ^[1]

2. Bundler

   $ gem install bundler

3. Node.js ^[2]

4. Gulp

   $ npm install -g gulp

Setup

Then, install the required dependencies:

$ bundle && npm install

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 dist directory. You can then view the slides by navigating to dist/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.

Deploy static version

You can publish to GitHub pages by running the following command:

$ gulp deploy

Tips and Tricks

A few tips from Dan Allen:

1. If you don’t want it the presentation to start in overview, drop the autostart: true option from the overview() plugin call in src/scripts/main.js.

2. If you want builds to work each time you visit the slide, remove this function.

3. You can export the presentation to PDF using DeckTape.

---

1. We strongly recommend using RVM to manage Ruby.

2. We strongly recommend using nvm to manage Node.