devilbox/docs/Makefile

# Minimal makefile for Sphinx documentation
#

# You can set these variables from the command line.
SPHINXOPTS    =
SPHINXBUILD   = sphinx-build
SPHINXPROJ    = devilbox
SOURCEDIR     = .
BUILDDIR      = _build

# Put it first so that "make" without argument is like "make help".
help:
	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
	@echo
	@echo "Devilbox additional commands:"
	@echo "  build       Build and test documentation"
	@echo "  autobuild   Continuously run and build (http://127.0.0.1:8000)"

.PHONY: help Makefile test build autobuild

# Catch-all target: route all unknown targets to Sphinx using the new
# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
%: Makefile
	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)


#
# Devilbox additions
#
#
# Used Sphinx options:
# --------------------
#
# -a: Always write all output files. The default is to only write output files
#     for new and changed source files.
#
# -E: Don’t use a saved environment (the structure caching all cross-references),
#     but rebuild it completely.
#
# -n: Run in nit-picky mode. Currently, this generates warnings for all
#     missing references. See the config value nitpick_ignore for a way to
#     exclude some references as “known missing”.
#
# -q: Do not output anything on standard output, only write warnings and errors
#     to standard error.
#
# -W: Turn warnings into errors. This means that the build stops at the first
#     warning and sphinx-build exits with exit status 1.


linkcheck2:
ifeq ($(wildcard file1),)
	bash -c 'curl -Ss -o linkcheck https://raw.githubusercontent.com/cytopia/linkcheck/master/linkcheck 2>/dev/null'
else
	bash -c 'curl -Ss -o linkcheck -z linkcheck https://raw.githubusercontent.com/cytopia/linkcheck/master/linkcheck 2>/dev/null'
endif
	chmod +x linkcheck
	./linkcheck -k -r 60 -t 30 -e rst _includes/

build:
	sphinx-build -a -E -n -j auto -q -W . _build/html

autobuild:
	sphinx-autobuild . _build/html