5
5
SPHINXOPTS =
6
6
SPHINXBUILD = sphinx-build
7
7
PAPER =
8
+ BUILD_DIR = build
8
9
9
10
# Internal variables.
10
11
PAPEROPT_a4 = -D latex_paper_size=a4
11
12
PAPEROPT_letter = -D latex_paper_size=letter
12
- ALLSPHINXOPTS = -d .build /doctrees $(PAPEROPT_$(PAPER ) ) $(SPHINXOPTS ) .
13
+ ALLSPHINXOPTS = -d $( BUILD_DIR ) /doctrees $(PAPEROPT_$(PAPER ) ) $(SPHINXOPTS ) src
13
14
14
15
.PHONY : help clean html web htmlhelp latex changes linkcheck
15
16
@@ -23,46 +24,46 @@ help:
23
24
@echo " linkcheck to check all external links for integrity"
24
25
25
26
clean :
26
- -rm -rf .build/ *
27
+ -rm -rf $( BUILD_DIR )
27
28
28
29
html :
29
- mkdir -p .build /doctrees
30
- $(SPHINXBUILD ) -b html $(ALLSPHINXOPTS ) .build /html
30
+ mkdir -p $( BUILD_DIR ) /doctrees
31
+ $(SPHINXBUILD ) -b html $(ALLSPHINXOPTS ) $( BUILD_DIR ) /html
31
32
@echo
32
- @echo " Build finished. The HTML pages are in .build /html"
33
+ @echo " Build finished. The HTML pages are in $( BUILD_DIR ) /html"
33
34
34
35
web :
35
- mkdir -p .build /web .build /doctrees
36
- $(SPHINXBUILD ) -b web $(ALLSPHINXOPTS ) .build /web
36
+ mkdir -p $( BUILD_DIR ) /web $( BUILD_DIR ) /doctrees
37
+ $(SPHINXBUILD ) -b web $(ALLSPHINXOPTS ) $( BUILD_DIR ) /web
37
38
@echo
38
39
@echo " Build finished; now you can run"
39
- @echo " python -m sphinx.web .build /web"
40
+ @echo " python -m sphinx.web $( BUILD_DIR ) /web"
40
41
@echo " to start the server."
41
42
42
43
htmlhelp :
43
- mkdir -p .build /htmlhelp .build /doctrees
44
- $(SPHINXBUILD ) -b htmlhelp $(ALLSPHINXOPTS ) .build /htmlhelp
44
+ mkdir -p $( BUILD_DIR ) /htmlhelp $( BUILD_DIR ) /doctrees
45
+ $(SPHINXBUILD ) -b htmlhelp $(ALLSPHINXOPTS ) $( BUILD_DIR ) /htmlhelp
45
46
@echo
46
47
@echo " Build finished; now you can run HTML Help Workshop with the" \
47
- " .hhp project file in .build /htmlhelp."
48
+ " .hhp project file in $( BUILD_DIR ) /htmlhelp."
48
49
49
50
latex :
50
- mkdir -p .build /latex .build /doctrees
51
- $(SPHINXBUILD ) -b latex $(ALLSPHINXOPTS ) .build /latex
51
+ mkdir -p $( BUILD_DIR ) /latex $( BUILD_DIR ) /doctrees
52
+ $(SPHINXBUILD ) -b latex $(ALLSPHINXOPTS ) $( BUILD_DIR ) /latex
52
53
@echo
53
- @echo " Build finished; the LaTeX files are in .build /latex."
54
+ @echo " Build finished; the LaTeX files are in $( BUILD_DIR ) /latex."
54
55
@echo " Run \` make all-pdf' or \` make all-ps' in that directory to" \
55
56
" run these through (pdf)latex."
56
57
57
58
changes :
58
- mkdir -p .build /changes .build /doctrees
59
- $(SPHINXBUILD ) -b changes $(ALLSPHINXOPTS ) .build /changes
59
+ mkdir -p $( BUILD_DIR ) /changes $( BUILD_DIR ) /doctrees
60
+ $(SPHINXBUILD ) -b changes $(ALLSPHINXOPTS ) $( BUILD_DIR ) /changes
60
61
@echo
61
- @echo " The overview file is in .build /changes."
62
+ @echo " The overview file is in $( BUILD_DIR ) /changes."
62
63
63
64
linkcheck :
64
- mkdir -p .build /linkcheck .build /doctrees
65
- $(SPHINXBUILD ) -b linkcheck $(ALLSPHINXOPTS ) .build /linkcheck
65
+ mkdir -p $( BUILD_DIR ) /linkcheck $( BUILD_DIR ) /doctrees
66
+ $(SPHINXBUILD ) -b linkcheck $(ALLSPHINXOPTS ) $( BUILD_DIR ) /linkcheck
66
67
@echo
67
68
@echo " Link check complete; look for any errors in the above output " \
68
- " or in .build /linkcheck/output.txt."
69
+ " or in $( BUILD_DIR ) /linkcheck/output.txt."
0 commit comments