Skip to content

Docker image used to generate EPUB3 documents with VSHN style

Notifications You must be signed in to change notification settings

vshn/asciidoctor-epub3

Repository files navigation

VSHN EPUB3 Generator based on Asciidoctor

This project generates a container image to be used to generate EPUB3 books with a standard VSHN style and fonts.

Build

Run the make command to build the image.

Usage

Run the following command to build an EPUB3 using an Asciidoc file as a basis:

podman run --rm --volume "${PWD}":/documents ghcr.io/vshn/asciidoctor-epub3:1.14.1 file.adoc

Any parameters passed after the command line will be fed directly to Asciidoctor, for example

podman run --rm --volume "${PWD}":/documents ghcr.io/vshn/asciidoctor-epub3:1.14.1 file.adoc --destination-dir=./_archive

Default Attributes

This project sets the following default attributes for the generation of the EPUB3 file:

  • doctype=book

  • epub3-stylesdir=/theme

  • ebook-validate

  • mathematical-format=svg

  • mathematical-inline=true

  • stem=latexmath

  • hide-uri-scheme

  • experimental

  • source-highlighter=rouge

  • pygments-style=bw

  • icons=font

  • icon-set=fi

  • numbered

  • toc

  • toclevels=2

  • sectnumlevels=2

These attributes can be overridden on the command line passing the corresponding --attribute or -a parameter.