← Back to branch summary

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

« back to all changes in this revision

Viewing changes to doc/Makefile

  • Committer: Matt Giuca
  • Date: 2009-12-01 04:27:58 UTC
  • mfrom: (1164.2.46 sphinx-docs)
  • Revision ID: matt.giuca@gmail.com-20091201042758-wuxd9bdec00c283i
Merged sphinx-docs branch. This adds Sphinx documentation for the entire IVLE system (for system administrators and developers), and removes all of our random old document files (all either irrelevant, or moved into the Sphinx docs nicely). Currently incomplete, but ready to merge.

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."