blob: f284258c8a01357e957a2448419c787918f3c81c [file] [log] [blame]
Sean Silva1c6ee672012-12-12 23:02:30 +00001@ECHO OFF
2
3REM Command file for Sphinx documentation
4
5if "%SPHINXBUILD%" == "" (
6 set SPHINXBUILD=sphinx-build
7)
8set BUILDDIR=_build
9set ALLSPHINXOPTS=-d %BUILDDIR%/doctrees %SPHINXOPTS% .
10set I18NSPHINXOPTS=%SPHINXOPTS% .
11if NOT "%PAPER%" == "" (
12 set ALLSPHINXOPTS=-D latex_paper_size=%PAPER% %ALLSPHINXOPTS%
13 set I18NSPHINXOPTS=-D latex_paper_size=%PAPER% %I18NSPHINXOPTS%
14)
15
16if "%1" == "" goto help
17
18if "%1" == "help" (
19 :help
20 echo.Please use `make ^<target^>` where ^<target^> is one of
21 echo. html to make standalone HTML files
22 echo. dirhtml to make HTML files named index.html in directories
23 echo. singlehtml to make a single large HTML file
24 echo. pickle to make pickle files
25 echo. json to make JSON files
26 echo. htmlhelp to make HTML files and a HTML help project
27 echo. qthelp to make HTML files and a qthelp project
28 echo. devhelp to make HTML files and a Devhelp project
29 echo. epub to make an epub
30 echo. latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter
31 echo. text to make text files
32 echo. man to make manual pages
33 echo. texinfo to make Texinfo files
34 echo. gettext to make PO message catalogs
35 echo. changes to make an overview over all changed/added/deprecated items
36 echo. linkcheck to check all external links for integrity
37 echo. doctest to run all doctests embedded in the documentation if enabled
38 goto end
39)
40
41if "%1" == "clean" (
42 for /d %%i in (%BUILDDIR%\*) do rmdir /q /s %%i
43 del /q /s %BUILDDIR%\*
44 goto end
45)
46
47if "%1" == "html" (
48 %SPHINXBUILD% -b html %ALLSPHINXOPTS% %BUILDDIR%/html
49 if errorlevel 1 exit /b 1
50 echo.
51 echo.Build finished. The HTML pages are in %BUILDDIR%/html.
52 goto end
53)
54
55if "%1" == "dirhtml" (
56 %SPHINXBUILD% -b dirhtml %ALLSPHINXOPTS% %BUILDDIR%/dirhtml
57 if errorlevel 1 exit /b 1
58 echo.
59 echo.Build finished. The HTML pages are in %BUILDDIR%/dirhtml.
60 goto end
61)
62
63if "%1" == "singlehtml" (
64 %SPHINXBUILD% -b singlehtml %ALLSPHINXOPTS% %BUILDDIR%/singlehtml
65 if errorlevel 1 exit /b 1
66 echo.
67 echo.Build finished. The HTML pages are in %BUILDDIR%/singlehtml.
68 goto end
69)
70
71if "%1" == "pickle" (
72 %SPHINXBUILD% -b pickle %ALLSPHINXOPTS% %BUILDDIR%/pickle
73 if errorlevel 1 exit /b 1
74 echo.
75 echo.Build finished; now you can process the pickle files.
76 goto end
77)
78
79if "%1" == "json" (
80 %SPHINXBUILD% -b json %ALLSPHINXOPTS% %BUILDDIR%/json
81 if errorlevel 1 exit /b 1
82 echo.
83 echo.Build finished; now you can process the JSON files.
84 goto end
85)
86
87if "%1" == "htmlhelp" (
88 %SPHINXBUILD% -b htmlhelp %ALLSPHINXOPTS% %BUILDDIR%/htmlhelp
89 if errorlevel 1 exit /b 1
90 echo.
91 echo.Build finished; now you can run HTML Help Workshop with the ^
92.hhp project file in %BUILDDIR%/htmlhelp.
93 goto end
94)
95
96if "%1" == "qthelp" (
97 %SPHINXBUILD% -b qthelp %ALLSPHINXOPTS% %BUILDDIR%/qthelp
98 if errorlevel 1 exit /b 1
99 echo.
100 echo.Build finished; now you can run "qcollectiongenerator" with the ^
101.qhcp project file in %BUILDDIR%/qthelp, like this:
102 echo.^> qcollectiongenerator %BUILDDIR%\qthelp\Clang.qhcp
103 echo.To view the help file:
104 echo.^> assistant -collectionFile %BUILDDIR%\qthelp\Clang.ghc
105 goto end
106)
107
108if "%1" == "devhelp" (
109 %SPHINXBUILD% -b devhelp %ALLSPHINXOPTS% %BUILDDIR%/devhelp
110 if errorlevel 1 exit /b 1
111 echo.
112 echo.Build finished.
113 goto end
114)
115
116if "%1" == "epub" (
117 %SPHINXBUILD% -b epub %ALLSPHINXOPTS% %BUILDDIR%/epub
118 if errorlevel 1 exit /b 1
119 echo.
120 echo.Build finished. The epub file is in %BUILDDIR%/epub.
121 goto end
122)
123
124if "%1" == "latex" (
125 %SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
126 if errorlevel 1 exit /b 1
127 echo.
128 echo.Build finished; the LaTeX files are in %BUILDDIR%/latex.
129 goto end
130)
131
132if "%1" == "text" (
133 %SPHINXBUILD% -b text %ALLSPHINXOPTS% %BUILDDIR%/text
134 if errorlevel 1 exit /b 1
135 echo.
136 echo.Build finished. The text files are in %BUILDDIR%/text.
137 goto end
138)
139
140if "%1" == "man" (
141 %SPHINXBUILD% -b man %ALLSPHINXOPTS% %BUILDDIR%/man
142 if errorlevel 1 exit /b 1
143 echo.
144 echo.Build finished. The manual pages are in %BUILDDIR%/man.
145 goto end
146)
147
148if "%1" == "texinfo" (
149 %SPHINXBUILD% -b texinfo %ALLSPHINXOPTS% %BUILDDIR%/texinfo
150 if errorlevel 1 exit /b 1
151 echo.
152 echo.Build finished. The Texinfo files are in %BUILDDIR%/texinfo.
153 goto end
154)
155
156if "%1" == "gettext" (
157 %SPHINXBUILD% -b gettext %I18NSPHINXOPTS% %BUILDDIR%/locale
158 if errorlevel 1 exit /b 1
159 echo.
160 echo.Build finished. The message catalogs are in %BUILDDIR%/locale.
161 goto end
162)
163
164if "%1" == "changes" (
165 %SPHINXBUILD% -b changes %ALLSPHINXOPTS% %BUILDDIR%/changes
166 if errorlevel 1 exit /b 1
167 echo.
168 echo.The overview file is in %BUILDDIR%/changes.
169 goto end
170)
171
172if "%1" == "linkcheck" (
173 %SPHINXBUILD% -b linkcheck %ALLSPHINXOPTS% %BUILDDIR%/linkcheck
174 if errorlevel 1 exit /b 1
175 echo.
176 echo.Link check complete; look for any errors in the above output ^
177or in %BUILDDIR%/linkcheck/output.txt.
178 goto end
179)
180
181if "%1" == "doctest" (
182 %SPHINXBUILD% -b doctest %ALLSPHINXOPTS% %BUILDDIR%/doctest
183 if errorlevel 1 exit /b 1
184 echo.
185 echo.Testing of doctests in the sources finished, look at the ^
186results in %BUILDDIR%/doctest/output.txt.
187 goto end
188)
189
190:end