freeipa/ipatests/azure/templates/build-docs-fedora.yml

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
Azure: Template docs build The distros may use different sphinx builder paths, for example, by exporting of SPHINXBUILD env var. Signed-off-by: Stanislav Levin <slev@altlinux.org> Reviewed-By: Alexander Bokovoy <abokovoy@redhat.com> 2021-03-10 14:49:59 -06:00			`steps:`
			`- script: \|`
			`set -e`
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-03 05:56:41 -05:00			`echo "Generate virtual environment for building documentation"`
			`make -C doc/ venv`
			`echo "Build documentation"`
Azure: Template docs build The distros may use different sphinx builder paths, for example, by exporting of SPHINXBUILD env var. Signed-off-by: Stanislav Levin <slev@altlinux.org> Reviewed-By: Alexander Bokovoy <abokovoy@redhat.com> 2021-03-10 14:49:59 -06:00			`make -C doc/ html`
			`displayName: Build documentation`