QA » openQA Project

https://app.circleci.com/pipelines/github/os-autoinst/openQA/9418/workflows/65f6e3c3-870e-4271-9f06-0226e83fcb27/jobs/88845

+ /home/squamata/project/.gem/bin/asciidoctor.ruby2.5 -r asciidoctor-pdf -b pdf -o /tmp/openqa-doc-WVtp/output/openqa-documentation-20220421_d2c43c797.pdf index.asciidoc -d book
asciidoctor: WARNING: Installing.asciidoc: line 1039: section title out of sequence: expected level 2, got level 3
asciidoctor: WARNING: Installing.asciidoc: line 1047: section title out of sequence: expected level 2, got level 3
asciidoctor: WARNING: Installing.asciidoc: line 1122: list item index: expected 7, got 5
asciidoctor: WARNING: Installing.asciidoc: line 1131: list item index: expected 8, got 6
asciidoctor: WARNING: Installing.asciidoc: line 1150: list item index: expected 9, got 7
asciidoctor: WARNING: Installing.asciidoc: line 1157: list item index: expected 10, got 8
asciidoctor: WARNING: Installing.asciidoc: line 1168: list item index: expected 11, got 9
asciidoctor: WARNING: Installing.asciidoc: line 1175: list item index: expected 12, got 10
asciidoctor: WARNING: Installing.asciidoc: line 1182: list item index: expected 13, got 11
asciidoctor: WARNING: Contributing.asciidoc: line 418: list item index: expected 3, got 2
asciidoctor: WARNING: Contributing.asciidoc: line 420: list item index: expected 4, got 3
asciidoctor: WARNING: Contributing.asciidoc: line 423: list item index: expected 5, got 4
asciidoctor: WARNING: Contributing.asciidoc: line 424: list item index: expected 6, got 5
asciidoctor: ERROR: could not locate or load the built-in pdf theme `' because of ArgumentError unknown keywords: aliases, filename; reverting to default theme
unknown keywords: aliases, filename
  Use --trace to show backtrace

Seems like asciidoctor just got a little bit stricter.

But also I am not able to call tools/generate-documentation locally:

a1a8237309549fe7033da1cd724ce100f6846f65        refs/heads/gh-pages
asciidoctor: FAILED: 'asciidoctor-pdf' could not be loaded
  Use --trace for backtrace

I think we should have a command that runs a container generating the docs instead of having to install several packages with gem, cpanm and so on.

Alternatively we could simply suggest to call

asciidoctor -o openqa.html docs/index.asciidoc -d book

instead of tools/generate-documentation in .github/checklist.yml.