Working with Antora
Right now we are doing our work with the upstream published docker container. Ultimately we will do something different.
docker pull antora/antora
Clone the Antora play book
git clone ssh://email@example.com/forks/bex/fedora-docs/docs-fp-o.git
git checkout antora-playbook
Build the site
docker run -it -v $(pwd):/antora:z antora/antora site.yml+ [NOTE]
You will get a ton of warnings from the draft Packaging Guidelines Docs. You can edit the site.yml if you’d like to skip that doc set. This is remaining included to test errors. (True as of 25 April 2018)
View the site
Read the site.yml file. The specific branches of the specific forks of the docs are listed there.
The test site currently uses the default UI provided by Antora, located at https://gitlab.com/antora/antora-ui-default/ .
The default UI is supplemented with additional code located in the
This replaces/adds files in the default UI.
Long term, we probably want to write a full, single UI in a separate repo, however this is undecided.