@@ -15,141 +15,20 @@ ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
15
15
# the i18n builder cannot share the environment and doctrees with the others
16
16
I18NSPHINXOPTS = $(PAPEROPT_$(PAPER ) ) $(SPHINXOPTS ) .
17
17
18
- .PHONY : help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
18
+ .PHONY : help clean html
19
19
20
20
help :
21
21
@echo " Please use \` make <target>' where <target> is one of"
22
22
@echo " html to make standalone HTML files"
23
- @echo " dirhtml to make HTML files named index.html in directories"
24
- @echo " singlehtml to make a single large HTML file"
25
- @echo " pickle to make pickle files"
26
- @echo " json to make JSON files"
27
- @echo " htmlhelp to make HTML files and a HTML help project"
28
- @echo " qthelp to make HTML files and a qthelp project"
29
- @echo " devhelp to make HTML files and a Devhelp project"
30
- @echo " epub to make an epub"
31
- @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
32
- @echo " latexpdf to make LaTeX files and run them through pdflatex"
33
- @echo " text to make text files"
34
- @echo " man to make manual pages"
35
- @echo " texinfo to make Texinfo files"
36
- @echo " info to make Texinfo files and run them through makeinfo"
37
- @echo " gettext to make PO message catalogs"
38
- @echo " changes to make an overview of all changed/added/deprecated items"
39
- @echo " linkcheck to check all external links for integrity"
40
- @echo " doctest to run all doctests embedded in the documentation (if enabled)"
23
+
41
24
42
25
clean :
43
26
-rm -rf $(BUILDDIR ) /*
44
27
28
+
45
29
html :
46
30
$(SPHINXBUILD ) -b html $(ALLSPHINXOPTS ) $(BUILDDIR ) /html
47
31
48
32
@echo
49
33
@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
50
34
51
- dirhtml :
52
- $(SPHINXBUILD ) -b dirhtml $(ALLSPHINXOPTS ) $(BUILDDIR ) /dirhtml
53
- @echo
54
- @echo " Build finished. The HTML pages are in $( BUILDDIR) /dirhtml."
55
-
56
- singlehtml :
57
- $(SPHINXBUILD ) -b singlehtml $(ALLSPHINXOPTS ) $(BUILDDIR ) /singlehtml
58
- @echo
59
- @echo " Build finished. The HTML page is in $( BUILDDIR) /singlehtml."
60
-
61
- pickle :
62
- $(SPHINXBUILD ) -b pickle $(ALLSPHINXOPTS ) $(BUILDDIR ) /pickle
63
- @echo
64
- @echo " Build finished; now you can process the pickle files."
65
-
66
- json :
67
- $(SPHINXBUILD ) -b json $(ALLSPHINXOPTS ) $(BUILDDIR ) /json
68
- @echo
69
- @echo " Build finished; now you can process the JSON files."
70
-
71
- htmlhelp :
72
- $(SPHINXBUILD ) -b htmlhelp $(ALLSPHINXOPTS ) $(BUILDDIR ) /htmlhelp
73
- @echo
74
- @echo " Build finished; now you can run HTML Help Workshop with the" \
75
- " .hhp project file in $( BUILDDIR) /htmlhelp."
76
-
77
- qthelp :
78
- $(SPHINXBUILD ) -b qthelp $(ALLSPHINXOPTS ) $(BUILDDIR ) /qthelp
79
- @echo
80
- @echo " Build finished; now you can run " qcollectiongenerator" with the" \
81
- " .qhcp project file in $( BUILDDIR) /qthelp, like this:"
82
- @echo " # qcollectiongenerator $( BUILDDIR) /qthelp/PythonUtils.qhcp"
83
- @echo " To view the help file:"
84
- @echo " # assistant -collectionFile $( BUILDDIR) /qthelp/PythonUtils.qhc"
85
-
86
- devhelp :
87
- $(SPHINXBUILD ) -b devhelp $(ALLSPHINXOPTS ) $(BUILDDIR ) /devhelp
88
- @echo
89
- @echo " Build finished."
90
- @echo " To view the help file:"
91
- @echo " # mkdir -p $$ HOME/.local/share/devhelp/PythonUtils"
92
- @echo " # ln -s $( BUILDDIR) /devhelp $$ HOME/.local/share/devhelp/PythonUtils"
93
- @echo " # devhelp"
94
-
95
- epub :
96
- $(SPHINXBUILD ) -b epub $(ALLSPHINXOPTS ) $(BUILDDIR ) /epub
97
- @echo
98
- @echo " Build finished. The epub file is in $( BUILDDIR) /epub."
99
-
100
- latex :
101
- $(SPHINXBUILD ) -b latex $(ALLSPHINXOPTS ) $(BUILDDIR ) /latex
102
- @echo
103
- @echo " Build finished; the LaTeX files are in $( BUILDDIR) /latex."
104
- @echo " Run \` make' in that directory to run these through (pdf)latex" \
105
- " (use \` make latexpdf' here to do that automatically)."
106
-
107
- latexpdf :
108
- $(SPHINXBUILD ) -b latex $(ALLSPHINXOPTS ) $(BUILDDIR ) /latex
109
- @echo " Running LaTeX files through pdflatex..."
110
- $(MAKE ) -C $(BUILDDIR ) /latex all-pdf
111
- @echo " pdflatex finished; the PDF files are in $( BUILDDIR) /latex."
112
-
113
- text :
114
- $(SPHINXBUILD ) -b text $(ALLSPHINXOPTS ) $(BUILDDIR ) /text
115
- @echo
116
- @echo " Build finished. The text files are in $( BUILDDIR) /text."
117
-
118
- man :
119
- $(SPHINXBUILD ) -b man $(ALLSPHINXOPTS ) $(BUILDDIR ) /man
120
- @echo
121
- @echo " Build finished. The manual pages are in $( BUILDDIR) /man."
122
-
123
- texinfo :
124
- $(SPHINXBUILD ) -b texinfo $(ALLSPHINXOPTS ) $(BUILDDIR ) /texinfo
125
- @echo
126
- @echo " Build finished. The Texinfo files are in $( BUILDDIR) /texinfo."
127
- @echo " Run \` make' in that directory to run these through makeinfo" \
128
- " (use \` make info' here to do that automatically)."
129
-
130
- info :
131
- $(SPHINXBUILD ) -b texinfo $(ALLSPHINXOPTS ) $(BUILDDIR ) /texinfo
132
- @echo " Running Texinfo files through makeinfo..."
133
- make -C $(BUILDDIR ) /texinfo info
134
- @echo " makeinfo finished; the Info files are in $( BUILDDIR) /texinfo."
135
-
136
- gettext :
137
- $(SPHINXBUILD ) -b gettext $(I18NSPHINXOPTS ) $(BUILDDIR ) /locale
138
- @echo
139
- @echo " Build finished. The message catalogs are in $( BUILDDIR) /locale."
140
-
141
- changes :
142
- $(SPHINXBUILD ) -b changes $(ALLSPHINXOPTS ) $(BUILDDIR ) /changes
143
- @echo
144
- @echo " The overview file is in $( BUILDDIR) /changes."
145
-
146
- linkcheck :
147
- $(SPHINXBUILD ) -b linkcheck $(ALLSPHINXOPTS ) $(BUILDDIR )/linkcheck
148
- @echo
149
- @echo " Link check complete; look for any errors in the above output " \
150
- " or in $( BUILDDIR) /linkcheck/output.txt."
151
-
152
- doctest :
153
- $(SPHINXBUILD ) -b doctest $(ALLSPHINXOPTS ) $(BUILDDIR ) /doctest
154
- @echo " Testing of doctests in the sources finished, look at the " \
155
- " results in $( BUILDDIR) /doctest/output.txt."
0 commit comments