mirror of
https://github.com/cytopia/devilbox.git
synced 2024-12-30 17:46:56 +00:00
65 lines
2.0 KiB
Makefile
65 lines
2.0 KiB
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
|