mirror of
https://github.com/ansible/ansible-documentation.git
synced 2026-03-27 13:28:51 +07:00
15394d182d
Previously, these files needed pre-processing and be symlinked. But they all are almost identical. So now, the differing sections in the config are governed by the tags passed to `sphinx-build`. This allows to reduce duplication and errors related to forgetting to update some of the configs but not the others. It removes the need to do pre-processing, meaning less mandatory disk operations before invoking the build process.
28 lines
856 B
Makefile
28 lines
856 B
Makefile
# Minimal makefile for Sphinx documentation
|
|
#
|
|
|
|
# You can set these variables from the command line.
|
|
DOCS_VARIANTS ?=
|
|
SPHINXCONFDIR = rst
|
|
LANGOPTS ?=
|
|
SPHINXOPTS ?= -j $(CPUS) -n -w rst_warnings -c "$(SPHINXCONFDIR)" $(DOCS_VARIANTS) $(LANGOPTS)
|
|
SPHINXBUILD = sphinx-build
|
|
SPHINXPROJ = sdfsdf
|
|
SOURCEDIR = rst
|
|
|
|
# Sets the build output directory if it's not specified on the command line
|
|
ifndef BUILDDIR
|
|
BUILDDIR = _build
|
|
endif
|
|
|
|
# Put it first so that "make" without argument is like "make help".
|
|
help:
|
|
$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
|
|
|
|
.PHONY: help Makefile.sphinx
|
|
|
|
# Catch-all target: route all unknown targets to Sphinx using the new
|
|
# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
|
|
%: Makefile.sphinx
|
|
$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
|