tabo / numconv

Python library to convert strings to numbers and numbers to strings. Docs: http://docs.tabo.pe/numconv/tip/

Clone this repository (size: 158.5 KB): HTTPS / SSH
$ hg clone http://code.tabo.pe/numconv

Changed (Δ939 bytes):

raw changeset »

docs/Makefile (52 lines added, 28 lines removed)

Up to file-list docs/Makefile:

5
5
SPHINXOPTS    =
6
6
SPHINXBUILD   = sphinx-build
7
7
PAPER         =
8
HTMLDIR       = html
8
BUILDDIR      = _build
9
9
10
10
# Internal variables.
11
11
PAPEROPT_a4     = -D latex_paper_size=a4
12
12
PAPEROPT_letter = -D latex_paper_size=letter
13
ALLSPHINXOPTS   = -d _build/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
13
ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
14
14
15
.PHONY: help clean html web pickle htmlhelp latex changes linkcheck
15
.PHONY: help clean html dirhtml pickle json htmlhelp qthelp latex changes linkcheck doctest
16
16
17
17
help:
18
18
	@echo "Please use \`make <target>' where <target> is one of"
19
19
	@echo "  html      to make standalone HTML files"
20
	@echo "  pickle    to make pickle files (usable by e.g. sphinx-web)"
20
	@echo "  dirhtml   to make HTML files named index.html in directories"
21
	@echo "  pickle    to make pickle files"
22
	@echo "  json      to make JSON files"
21
23
	@echo "  htmlhelp  to make HTML files and a HTML help project"
24
	@echo "  qthelp    to make HTML files and a qthelp project"
22
25
	@echo "  latex     to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
23
	@echo "  changes   to make an overview over all changed/added/deprecated items"
26
	@echo "  changes   to make an overview of all changed/added/deprecated items"
24
27
	@echo "  linkcheck to check all external links for integrity"
28
	@echo "  doctest   to run all doctests embedded in the documentation (if enabled)"
29
	@echo "  coverage   Coverage"
25
30
26
31
clean:
27
#	-rm -rf _build $(HTMLDIR)/*
28
	-rm -rf _build _sources _static *.html *.js .buildinfo *.inv *.orig
32
	-rm -rf $(BUILDDIR)/*
29
33
30
34
html:
31
	mkdir -p $(HTMLDIR) _build/doctrees _static
32
	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(HTMLDIR)
35
	mkdir -p _static
36
	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
33
37
	@echo
34
	@echo "Build finished. The HTML pages are in $(HTMLDIR)"
38
	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
39
40
dirhtml:
41
	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
42
	@echo
43
	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
35
44
36
45
pickle:
37
	mkdir -p _build/pickle _build/doctrees
38
	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) _build/pickle
46
	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
39
47
	@echo
40
	@echo "Build finished; now you can process the pickle files or run"
41
	@echo "  sphinx-web _build/pickle"
42
	@echo "to start the sphinx-web server."
48
	@echo "Build finished; now you can process the pickle files."
43
49
44
web: pickle
50
json:
51
	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
52
	@echo
53
	@echo "Build finished; now you can process the JSON files."
45
54
46
55
htmlhelp:
47
	mkdir -p _build/htmlhelp _build/doctrees
48
	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) _build/htmlhelp
56
	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
49
57
	@echo
50
58
	@echo "Build finished; now you can run HTML Help Workshop with the" \
51
	      ".hhp project file in _build/htmlhelp."
59
	      ".hhp project file in $(BUILDDIR)/htmlhelp."
60
61
qthelp:
62
	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
63
	@echo
64
	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
65
	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
66
	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/numconv.qhcp"
67
	@echo "To view the help file:"
68
	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/numconv.qhc"
52
69
53
70
latex:
54
	mkdir -p _build/latex _build/doctrees
55
	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) _build/latex
71
	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
56
72
	@echo
57
	@echo "Build finished; the LaTeX files are in _build/latex."
73
	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
58
74
	@echo "Run \`make all-pdf' or \`make all-ps' in that directory to" \
59
75
	      "run these through (pdf)latex."
60
76
61
77
changes:
62
	mkdir -p _build/changes _build/doctrees
63
	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) _build/changes
78
	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
64
79
	@echo
65
	@echo "The overview file is in _build/changes."
80
	@echo "The overview file is in $(BUILDDIR)/changes."
66
81
67
82
linkcheck:
68
	mkdir -p _build/linkcheck _build/doctrees
69
	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) _build/linkcheck
83
	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
70
84
	@echo
71
85
	@echo "Link check complete; look for any errors in the above output " \
72
	      "or in _build/linkcheck/output.txt."
86
	      "or in $(BUILDDIR)/linkcheck/output.txt."
87
88
doctest:
89
	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
90
	@echo "Testing of doctests in the sources finished, look at the " \
91
	      "results in $(BUILDDIR)/doctest/output.txt."
92
93
coverage:
94
	$(SPHINXBUILD) -b coverage $(ALLSPHINXOPTS) $(BUILDDIR)/coverage
95
	@echo "Coverage, " \
96
	      "results in $(BUILDDIR)/coverage"