GitLab Pages CI hugo with asciidoctor (low maintenance)

Question

What is the best low maintenance / future proof way to use GitLab Pages to build a hugo site with asciidoc pages (using asciidoctor).

There are some images on DockerHub, but they don't have reliable maintenance.

Ideally, I think it would be best to use the GitLab Pages image for hugo (extended) and install the asciidoctor gem.

Answer 1

Ok, the steps are:

1. install ruby
2. gem install asciidoctor
3. whitelist asciidoctor

The first two are performed in gitlab-ci.yml and the final step in config.toml.

Demo: https://gitlab.com/bquast1/bquast1.gitlab.io

The security policy change to whitelist asciidoctor is at the end of the config.toml file.