← Back to branch summary

~azzar1/unity/add-show-desktop-key

« back to all changes in this revision

Viewing changes to doc/Makefile

Cache worksheet and exercise rST-generated XHTML in the DB, accelerating rendering by up to 2000%.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/Makefile
 
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."