zuul-jobs/roles/fetch-sphinx-output/README.rst
Andreas Jaeger 56b9c68ba2 Remove sphinx_output_dir
this is a partial revert of Ifd270cbc2d4bd42418b89a3b3061748ce537ae42,
we do not need sphinx_output_dir anymore, the single use that needed it
has been changed.

Change-Id: I95543b1a56c04dbfb8591612e4c48be0d8631633
2019-08-16 15:39:59 +02:00

37 lines
1.0 KiB
ReStructuredText

Collect output from a sphinx build
By default, this copies the output from the sphinx build on the worker
to the log root of the executor.
**Role Variables**
.. zuul:rolevar:: zuul_executor_dest
:default: {{ zuul.executor.log_root }}
The destination directory on the executor. By default, the log
root.
.. zuul:rolevar:: sphinx_build_dir
:default: doc/build
Directory relative to zuul_work_dir where build output will be put.
.. zuul:rolevar:: sphinx_output_suffix
:default: ''
Suffix to use for constructing the path. This is normally an
empty string. If set to '/' then, rsync will remove the last part
from the original path.
.. zuul:rolevar:: sphinx_output_src
:default: {{ zuul_work_dir }}/{{ sphinx_build_dir }}/html{{ sphinx_output_suffix }}
The location on the worker from which to fetch the generated sphinx
content. By default, the HTML doc build dir of the current
project.
.. zuul:rolevar:: zuul_work_dir
:default: {{ zuul.project.src_dir }}
The location of the main working directory of the job.