ggrossetie/asciidoctor-web-pdf

By ggrossetie

Updated over 2 years ago

A PDF converter for AsciiDoc based on web technologies.

Image

654

Asciidoctor Web PDF

A PDF converter for AsciiDoc based on web technologies. It allows complex layouts to be defined with CSS and JavaScript, while writing the content in AsciiDoc.

Getting Started

Prerequisities

In order to run this container you'll need docker installed.

Usage

convert an AsciiDoc file to PDF using a volume

$ docker run -i --rm \
  --volume=$PWD:"/usr/app" \
  -u $(id -u ${USER}):$(id -g ${USER}) \
  asciidoctor-web-pdf:latest \
  document.adoc

The --volume option will mount your local current directory ($PWD) on the container. Since we are using a non-root user we have to map our user to asciidoctor user in the container.

convert an AsciiDoc file to PDF using stdin/stdout

You can also use stdin and stdout without the need of volumes:

$ cat document.adoc | docker run -i --rm asciidoctor-web-pdf:latest - > document.pdf

Versioning

We use SemVer for versioning.

License

This project is licensed under the MIT License.

Docker Pull Command

docker pull ggrossetie/asciidoctor-web-pdf