Makefile (1510B)
1 # Minimal makefile for Sphinx documentation 2 # 3 4 # You can set these variables from the command line, and also 5 # from the environment for the first two. 6 SPHINXOPTS ?= 7 SPHINXBUILD ?= sphinx-build 8 SOURCEDIR = . 9 BUILDDIR = _build 10 11 # Put it first so that "make" without argument is like "make help". 12 help: 13 @$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) 14 15 .PHONY: help Makefile 16 17 # Catch-all target: route all unknown targets to Sphinx using the new 18 # "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS). 19 %: Makefile 20 @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) 21 22 23 REGENDOC_ARGS := \ 24 --normalize "/[ \t]+\n/\n/" \ 25 --normalize "~\$$REGENDOC_TMPDIR~/home/sweet/project~" \ 26 --normalize "~/path/to/example~/home/sweet/project~" \ 27 --normalize "/in \d.\d\ds/in 0.12s/" \ 28 --normalize "@/tmp/pytest-of-.*/pytest-\d+@PYTEST_TMPDIR@" \ 29 --normalize "@pytest-(\d+)\\.[^ ,]+@pytest-\1.x.y@" \ 30 --normalize "@py-(\d+)\\.[^ ,]+@py-\1.x.y@" \ 31 --normalize "@pluggy-(\d+)\\.[.\d,]+@pluggy-\1.x.y@" \ 32 --normalize "@hypothesis-(\d+)\\.[.\d,]+@hypothesis-\1.x.y@" \ 33 --normalize "@Python (\d+)\\.[^ ,]+@Python \1.x.y@" 34 35 regen: REGENDOC_FILES:=*.rst */*.rst 36 regen: 37 # need to reset cachedir to the non-tox default 38 PYTHONDONTWRITEBYTECODE=1 \ 39 PYTEST_ADDOPTS="-pno:hypothesis -p no:hypothesispytest -Wignore::pytest.PytestUnknownMarkWarning -o cache_dir=.pytest_cache" \ 40 COLUMNS=76 \ 41 regendoc --update ${REGENDOC_FILES} ${REGENDOC_ARGS} 42 43 .PHONY: regen