Skip to content

gbif/gbif-asciidoctor-toolkit

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GBIF Asciidoctor Toolkit

The toolkit

This is a Docker container derived from docker-asciidoctor, but with the addition of:

The Asciidoctor Docker container provides:

  • Asciidoctor

  • Asciidoctor BibTeX

  • Asciidoctor Diagram with Graphviz integration (supports plantuml and graphiz diagrams)

  • Asciidoctor PDF

  • Asciidoctor EPUB3

  • Asciidoctor Mathematical

  • AsciiMath

  • Source highlighting using Pygments, CodeRay or Rouge

  • Asciidoctor Confluence

How to use it

From the top-level directory containing the GBIF document named index.en.adoc (where en is normally a two-letter language code), run:

docker run --rm -it --user $(id -u):$(id -g) -v $PWD:/documents/ docker.gbif.org/asciidoctor-toolkit

Your documents will be processed, and output in the directory en (etc).

To have the HTML document build automatically as changes to the source files are saved, use

docker run --rm -it --user $(id -u):$(id -g) -v $PWD:/documents/ docker.gbif.org/asciidoctor-toolkit continuous

Component details

glossary extension

This adds a role (style) to [crossreference] links to the glossary, to avoid a "link soup" appearance where there are many such links.

term extension macros

The term extension macro converts e.g. term:dwc[basisOfRecord] into a styled link to the property URI.

GbifHtmlConverter.rb

This overrides particular methods of the Ruby converter.

  • Handling short crossreferences with the § symbol without a following space, e.g. "§1.3"

  • Inline syntax highlighting using the syntax [source,javascript`var x = [];]`

  • "This document is also available in PDF format and in other languages: español, français, 中文." with the languageLinks[] macro.

Limitations

  • PDF output does not support inline syntax highlighting, all fonts, or the custom admonitions used in the training courses.

About

🍃 A Docker image containing the GBIF Asciidoctor toolchain

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Ruby 63.6%
  • Shell 15.0%
  • JavaScript 7.8%
  • Dockerfile 4.9%
  • CSS 4.6%
  • TeX 1.8%
  • Other 2.3%