3
REM Command file for Sphinx documentation
5
set SPHINXBUILD=sphinx-build
7
set ALLSPHINXOPTS=-d %BUILDDIR%/doctrees %SPHINXOPTS% .
8
if NOT "%PAPER%" == "" (
9
set ALLSPHINXOPTS=-D latex_paper_size=%PAPER% %ALLSPHINXOPTS%
12
if "%1" == "" goto help
16
echo.Please use `make ^<target^>` where ^<target^> is one of
17
echo. html to make standalone HTML files
18
echo. pdf to make PDF document
19
echo. dirhtml to make HTML files named index.html in directories
20
echo. pickle to make pickle files
21
echo. json to make JSON files
22
echo. htmlhelp to make HTML files and a HTML help project
23
echo. qthelp to make HTML files and a qthelp project
24
echo. latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter
25
echo. changes to make an overview over all changed/added/deprecated items
26
echo. linkcheck to check all external links for integrity
27
echo. doctest to run all doctests embedded in the documentation if enabled
32
for /d %%i in (%BUILDDIR%\*) do rmdir /q /s %%i
33
del /q /s %BUILDDIR%\*
38
%SPHINXBUILD% -b html %ALLSPHINXOPTS% %BUILDDIR%/html
40
echo.Build finished. The HTML pages are in %BUILDDIR%/html.
44
if "%1" == "dirhtml" (
45
%SPHINXBUILD% -b dirhtml %ALLSPHINXOPTS% %BUILDDIR%/dirhtml
47
echo.Build finished. The HTML pages are in %BUILDDIR%/dirhtml.
52
%SPHINXBUILD% -b pickle %ALLSPHINXOPTS% %BUILDDIR%/pickle
54
echo.Build finished; now you can process the pickle files.
59
%SPHINXBUILD% -b json %ALLSPHINXOPTS% %BUILDDIR%/json
61
echo.Build finished; now you can process the JSON files.
65
if "%1" == "htmlhelp" (
66
%SPHINXBUILD% -b htmlhelp %ALLSPHINXOPTS% %BUILDDIR%/htmlhelp
68
echo.Build finished; now you can run HTML Help Workshop with the ^
69
.hhp project file in %BUILDDIR%/htmlhelp.
74
%SPHINXBUILD% -b qthelp %ALLSPHINXOPTS% %BUILDDIR%/qthelp
76
echo.Build finished; now you can run "qcollectiongenerator" with the ^
77
.qhcp project file in %BUILDDIR%/qthelp, like this:
78
echo.^> qcollectiongenerator %BUILDDIR%\qthelp\dulwich.qhcp
79
echo.To view the help file:
80
echo.^> assistant -collectionFile %BUILDDIR%\qthelp\dulwich.ghc
85
%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
87
echo.Build finished; the LaTeX files are in %BUILDDIR%/latex.
91
if "%1" == "changes" (
92
%SPHINXBUILD% -b changes %ALLSPHINXOPTS% %BUILDDIR%/changes
94
echo.The overview file is in %BUILDDIR%/changes.
98
if "%1" == "linkcheck" (
99
%SPHINXBUILD% -b linkcheck %ALLSPHINXOPTS% %BUILDDIR%/linkcheck
101
echo.Link check complete; look for any errors in the above output ^
102
or in %BUILDDIR%/linkcheck/output.txt.
106
if "%1" == "doctest" (
107
%SPHINXBUILD% -b doctest %ALLSPHINXOPTS% %BUILDDIR%/doctest
109
echo.Testing of doctests in the sources finished, look at the ^
110
results in %BUILDDIR%/doctest/output.txt.
115
%SPHINXBUILD% -b pdf %ALLSPHINXOPTS% %BUILDDIR%/pdf
117
echo.Build finished. The PDF files are in %BUILDDIR%/pdf.