freeipa/ipatests/azure/templates/build-docs-fedora.yml
Alexander Bokovoy 4a7cc3467c docs: add plantuml and use virtual environment to generate docs
Documentation generator can be run inside Python virtual environment.
This allows to isolate from the system-wide changes and add Sphinx
extensions that aren't packaged in a distribution.

The only exception right now is plantuml package. We rely on plantuml to
generate diagrams and since it is written in Java, it cannot be
installed directly into the Python venv through 'pip' tool.

Fixes: https://pagure.io/freeipa/issue/9148

Signed-off-by: Alexander Bokovoy <abokovoy@redhat.com>
Reviewed-By: Francisco Trivino <ftrivino@redhat.com>
2022-05-04 09:36:40 +03:00

9 lines
207 B
YAML

steps:
- script: |
set -e
echo "Generate virtual environment for building documentation"
make -C doc/ venv
echo "Build documentation"
make -C doc/ html
displayName: Build documentation