Skip to content

install asciidoctor and pdf

Joseph Cayouette edited this page Apr 12, 2022 · 9 revisions

Install Asciidoctor and Asciidoctor PDF Gems

This guide will help you install the gems required to build documents from adoc sources in a local environment via asciidoctor or to build PDF documents from local sources via the asciidoctor-pdf gem.

Now that you have Ruby and rbev installed you can proceed with installation of asciidoctor and asciidoctor-pdf. We have also included support packages for various syntax highlighting options:

Install Asciidoctor:

gem install asciidoctor

Install Asciidoctor PDF:

gem install asciidoctor-pdf --pre

Install support packages:

gem install rouge coderay rb-pygments concurrent-ruby asciidoctor-diagram

Install the image support package:

If you need support for additional image formats, such as GIF, TIFF, or interlaced PNG—​and you don’t want to convert those images to a supported format—​you must install the prawn-gmagick (>= 0.0.9)

To use the prawn-gmagick gem you need GraphicsMagick on your system:

sudo zypper install GraphicsMagick
sudo zypper install GraphicsMagick-devel
gem install prawn-gmagick -v 0.0.9

Install our translation toolchain (Without po4a you cannot build languages other than English) Install Translation Tools (Po4a)

Clone this wiki locally