Asciidoctor-vagrant

Intro

Asciidoc(tor) (http://www.asciidoctor.org) is a great markup language for documentation. Installing the complete toolchain can seem daunting at first because of a long list of prerequisites (packages! operating system!, ..), but this Vagrantfile makes installation a breeze…​

This vagrant machine is a clean Fedora 22 cloud image, provisioned at runtime. Changing or updating is just a matter of altering the Vagrantfile.

Just put the Vagrantfile in your documentation directory and type in your terminal/cmd prompt:

 vagrant up

Once provisioned, use

vagrant ssh

to get in the virtual machine. The /vagrant directory of the vm is mapped to the folder containing the Vagrantfile. Now you should have all the asciidoctor-tools at your fingertips…​

example

#create a default html5 output from test.adoc
asciidoctor test.adoc

#create a pdf file from the same test.adoc
asciidoctor-pdf -r asciidoctor-mathematical test.adoc -a pdf-stylesdir=. -a pdf-style=pdf-theme.yml -a pdf-fontsdir=pdffonts/

Requirements

• Vagrant (http://www.vagrantup.com)

• Virtualbox (http://www.virtualbox.org)

Included

• ✓ Asciidoctor (latest stable)

• ✓ Asciidoctor-pdf (latest alpha)

• ✓ Asciidoctor-mathematical

  • version: build from source

  • https://github.com/ProgramFan/asciidoctor-mathematical.git

• ✓ Blockdiag, seqdiag,actdiag,nwdiag

• ✓ Asciidoctor-confluence

• ✓ Asciidoctor-epub (latest alpha)