1 # Makefile for Sphinx documentation 2 # 3 4 # You can set these variables from the command line. 5 SPHINXOPTS = 6 SPHINXBUILD = sphinx-build 7 PAPER = 8 9 # Internal variables. 10 PAPEROPT_a4 = -D latex_paper_size=a4 11 PAPEROPT_letter = -D latex_paper_size=letter 12 ALLSPHINXOPTS = -d _build/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . 13 14 .PHONY: help clean html web pickle htmlhelp latex changes linkcheck 15 16 help: 17 @echo "Please use \`make <target>' where <target> is one of" 18 @echo " html to make standalone HTML files" 19 @echo " pickle to make pickle files (usable by e.g. sphinx-web)" 20 @echo " htmlhelp to make HTML files and a HTML help project" 21 @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter" 22 @echo " changes to make an overview over all changed/added/deprecated items" 23 @echo " linkcheck to check all external links for integrity" 24 25 clean: 26 -rm -rf _build/* 27 28 html: 29 mkdir -p _build/html _build/doctrees 30 $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) _build/html 31 @echo 32 @echo "Build finished. The HTML pages are in _build/html." 33 34 pickle: 35 mkdir -p _build/pickle _build/doctrees 36 $(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) _build/pickle 37 @echo 38 @echo "Build finished; now you can process the pickle files or run" 39 @echo " sphinx-web _build/pickle" 40 @echo "to start the sphinx-web server." 41 42 web: pickle 43 44 htmlhelp: 45 mkdir -p _build/htmlhelp _build/doctrees 46 $(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) _build/htmlhelp 47 @echo 48 @echo "Build finished; now you can run HTML Help Workshop with the" \ 49 ".hhp project file in _build/htmlhelp." 50 51 latex: 52 mkdir -p _build/latex _build/doctrees 53 $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) _build/latex 54 @echo 55 @echo "Build finished; the LaTeX files are in _build/latex." 56 @echo "Run \`make all-pdf' or \`make all-ps' in that directory to" \ 57 "run these through (pdf)latex." 58 59 changes: 60 mkdir -p _build/changes _build/doctrees 61 $(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) _build/changes 62 @echo 63 @echo "The overview file is in _build/changes." 64 65 linkcheck: 66 mkdir -p _build/linkcheck _build/doctrees 67 $(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) _build/linkcheck 68 @echo 69 @echo "Link check complete; look for any errors in the above output " \ 70 "or in _build/linkcheck/output.txt." 71