blob: 321a1b92cc4030f9956818f4b6ab9e04415312e5 [file] [log] [blame] [edit]
# ------------------------------------------------------------------------------
# Makefile for documentation build
# SPDX-License-Identifier: Apache-2.0
BUILDDIR ?= _build
DOC_TAG ?= development
SPHINXOPTS ?= -j auto -W --keep-going -T
SPHINXOPTS_EXTRA ?=
LATEXMKOPTS ?= -halt-on-error -no-shell-escape
DT_TURBO_MODE ?= 0
# ------------------------------------------------------------------------------
# Documentation targets
.PHONY: configure clean html html-fast latex pdf doxygen
html-fast:
${MAKE} html DT_TURBO_MODE=1
html latex pdf linkcheck doxygen: configure
cmake --build ${BUILDDIR} --target $@
configure:
cmake \
-GNinja \
-B${BUILDDIR} \
-S. \
-DDOC_TAG=${DOC_TAG} \
-DSPHINXOPTS="${SPHINXOPTS}" \
-DSPHINXOPTS_EXTRA="${SPHINXOPTS_EXTRA}" \
-DLATEXMKOPTS="${LATEXMKOPTS}" \
-DDT_TURBO_MODE=${DT_TURBO_MODE}
clean:
cmake --build ${BUILDDIR} --target clean