Mercurial > p > roundup > code

annotate doc/conf.py @ 5041:5251e97b1de0

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Configure the database backend in the config.ini The database backend is currently configured in the 'db/backend_name' file which is just another file that needs to be configured when setting up or migrating a tracker instance. By moving this setting into the config.ini it helps to reduce the number of files that need to be configured and is more logical place for users to find the setting.
author John Kristensen <john@jerrykan.com>
date Mon, 22 Dec 2014 13:30:20 +1100
parents 515ab1749b14
children 487dc55e3c5e
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
1 # -*- coding: utf-8 -*-
4955
2d83625e1c06 Synchronize conf.py between doc/ and website/www/
anatoly techtonik <techtonik@gmail.com>
parents: 4897
diff changeset
2
2d83625e1c06 Synchronize conf.py between doc/ and website/www/
anatoly techtonik <techtonik@gmail.com>
parents: 4897
diff changeset
3 # -- Roundup Notice --
2d83625e1c06 Synchronize conf.py between doc/ and website/www/
anatoly techtonik <techtonik@gmail.com>
parents: 4897
diff changeset
4 # This conf.py is used to generate local documentation. There is also
2d83625e1c06 Synchronize conf.py between doc/ and website/www/
anatoly techtonik <techtonik@gmail.com>
parents: 4897
diff changeset
5 # website/www/conf.py in Roundup repository which uses the same .rst
2d83625e1c06 Synchronize conf.py between doc/ and website/www/
anatoly techtonik <techtonik@gmail.com>
parents: 4897
diff changeset
6 # sources, but different setup to generate site contents.
2d83625e1c06 Synchronize conf.py between doc/ and website/www/
anatoly techtonik <techtonik@gmail.com>
parents: 4897
diff changeset
7 # ---
2d83625e1c06 Synchronize conf.py between doc/ and website/www/
anatoly techtonik <techtonik@gmail.com>
parents: 4897
diff changeset
8
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
9 # Roundup documentation build configuration file, created by
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
10 # sphinx-quickstart on Tue Jan 20 17:33:20 2009.
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
11 #
5029
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
12 # This file is execfile()d with the current directory set to its
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
13 # containing dir.
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
14 #
5029
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
15 # Note that not all possible configuration values are present in this
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
16 # autogenerated file.
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
17 #
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
18 # All configuration values have a default; values that are commented out
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
19 # serve to show the default.
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
20
5029
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
21 import sys
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
22 import os
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
23
4837
bf786562ba7f doc/conf.py: Clear sys.path before importing Roundup __version__
anatoly techtonik <techtonik@gmail.com>
parents: 4832
diff changeset
24
bf786562ba7f doc/conf.py: Clear sys.path before importing Roundup __version__
anatoly techtonik <techtonik@gmail.com>
parents: 4832
diff changeset
25 # Read Roundup version by importing it from parent directory,
bf786562ba7f doc/conf.py: Clear sys.path before importing Roundup __version__
anatoly techtonik <techtonik@gmail.com>
parents: 4832
diff changeset
26 # this ensures that 'unkown version' is inserted even if
bf786562ba7f doc/conf.py: Clear sys.path before importing Roundup __version__
anatoly techtonik <techtonik@gmail.com>
parents: 4832
diff changeset
27 # `roundup` is importable from other location in sys.path
bf786562ba7f doc/conf.py: Clear sys.path before importing Roundup __version__
anatoly techtonik <techtonik@gmail.com>
parents: 4832
diff changeset
28 SYSSAVE = sys.path
bf786562ba7f doc/conf.py: Clear sys.path before importing Roundup __version__
anatoly techtonik <techtonik@gmail.com>
parents: 4832
diff changeset
29 DOCROOT = os.path.abspath(os.path.dirname(__file__))
bf786562ba7f doc/conf.py: Clear sys.path before importing Roundup __version__
anatoly techtonik <techtonik@gmail.com>
parents: 4832
diff changeset
30 sys.path = [os.path.dirname(DOCROOT)]
4832
76460d14be91 Read version and release for generated documentation from roundup/__init__.py
Thomas Arendsen Hein <thomas@intevation.de>
parents: 4357
diff changeset
31 try:
4837
bf786562ba7f doc/conf.py: Clear sys.path before importing Roundup __version__
anatoly techtonik <techtonik@gmail.com>
parents: 4832
diff changeset
32 from roundup import __version__ as VERSION
bf786562ba7f doc/conf.py: Clear sys.path before importing Roundup __version__
anatoly techtonik <techtonik@gmail.com>
parents: 4832
diff changeset
33 SHORTVER = '.'.join(VERSION.split('.', 2)[:2])
4832
76460d14be91 Read version and release for generated documentation from roundup/__init__.py
Thomas Arendsen Hein <thomas@intevation.de>
parents: 4357
diff changeset
34 except ImportError:
4837
bf786562ba7f doc/conf.py: Clear sys.path before importing Roundup __version__
anatoly techtonik <techtonik@gmail.com>
parents: 4832
diff changeset
35 VERSION = SHORTVER = '(unknown version)'
bf786562ba7f doc/conf.py: Clear sys.path before importing Roundup __version__
anatoly techtonik <techtonik@gmail.com>
parents: 4832
diff changeset
36 finally:
bf786562ba7f doc/conf.py: Clear sys.path before importing Roundup __version__
anatoly techtonik <techtonik@gmail.com>
parents: 4832
diff changeset
37 sys.path = SYSSAVE
bf786562ba7f doc/conf.py: Clear sys.path before importing Roundup __version__
anatoly techtonik <techtonik@gmail.com>
parents: 4832
diff changeset
38
4832
76460d14be91 Read version and release for generated documentation from roundup/__init__.py
Thomas Arendsen Hein <thomas@intevation.de>
parents: 4357
diff changeset
39
5029
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
40 # If extensions (or modules to document with autodoc) are in another directory,
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
41 # add these directories to sys.path here. If the directory is relative to the
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
42 # documentation root, use os.path.abspath to make it absolute, like shown here.
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
43 #sys.path.insert(0, os.path.abspath('.'))
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
44
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
45 # -- General configuration ------------------------------------------------
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
46
5029
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
47 # If your documentation needs a minimal Sphinx version, state it here.
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
48 #needs_sphinx = '1.0'
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
49
5029
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
50 # Add any Sphinx extension module names here, as strings. They can be
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
51 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
52 # ones.
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
53 #extensions = ['toctree']
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
54
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
55 # Add any paths that contain templates here, relative to this directory.
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
56 templates_path = ['_templates']
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
57
5029
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
58 # The suffix(es) of source filenames.
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
59 # You can specify multiple suffix as a list of string:
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
60 # source_suffix = ['.rst', '.md']
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
61 source_suffix = '.txt'
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
62
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
63 # The encoding of source files.
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
64 #source_encoding = 'utf-8'
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
65
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
66 # The master toctree document.
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
67 master_doc = 'index'
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
68
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
69 # General information about the project.
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
70 project = u'Roundup'
5028
46b7d1ee4fab Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 4955
diff changeset
71 copyright = u'2009-2016, Richard Jones, Roundup-Team'
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
72
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
73 # The version info for the project you're documenting, acts as replacement for
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
74 # |version| and |release|, also used in various other places throughout the
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
75 # built documents.
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
76 #
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
77 # The short X.Y version.
4837
bf786562ba7f doc/conf.py: Clear sys.path before importing Roundup __version__
anatoly techtonik <techtonik@gmail.com>
parents: 4832
diff changeset
78 version = SHORTVER
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
79 # The full version, including alpha/beta/rc tags.
4837
bf786562ba7f doc/conf.py: Clear sys.path before importing Roundup __version__
anatoly techtonik <techtonik@gmail.com>
parents: 4832
diff changeset
80 release = VERSION
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
81
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
82 # The language for content autogenerated by Sphinx. Refer to documentation
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
83 # for a list of supported languages.
5029
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
84 #
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
85 # This is also used if you do content translation via gettext catalogs.
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
86 # Usually you set "language" from the command line for these cases.
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
87 language = None
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
88
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
89 # There are two options for replacing |today|: either, you set today to some
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
90 # non-false value, then it is used:
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
91 #today = ''
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
92 # Else, today_fmt is used as the format for a strftime call.
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
93 #today_fmt = '%B %d, %Y'
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
94
5029
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
95 # List of patterns, relative to source directory, that match files and
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
96 # directories to ignore when looking for source files.
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
97 exclude_patterns = ['_build']
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
98
5029
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
99 # The reST default role (used for this markup: `text`) to use for all
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
100 # documents.
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
101 #default_role = None
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
102
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
103 # If true, '()' will be appended to :func: etc. cross-reference text.
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
104 #add_function_parentheses = True
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
105
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
106 # If true, the current module name will be prepended to all description
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
107 # unit titles (such as .. function::).
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
108 #add_module_names = True
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
109
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
110 # If true, sectionauthor and moduleauthor directives will be shown in the
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
111 # output. They are ignored by default.
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
112 #show_authors = False
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
113
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
114 # The name of the Pygments (syntax highlighting) style to use.
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
115 pygments_style = 'sphinx'
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
116
5029
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
117 # A list of ignored prefixes for module index sorting.
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
118 #modindex_common_prefix = []
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
119
5029
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
120 # If true, keep warnings as "system message" paragraphs in the built documents.
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
121 #keep_warnings = False
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
122
5029
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
123 # -- Options for HTML output ----------------------------------------------
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
124
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
125 #-- pre Sphinx 1.3
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
126 # The style sheet to use for HTML and HTML Help pages. A file of that name
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
127 # must exist either in Sphinx' static/ path, or in one of the custom paths
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
128 # given in html_static_path.
5030
515ab1749b14 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5029
diff changeset
129 html_style = 'style.css'
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
130
5029
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
131 #-- Sphinx 1.3
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
132 # The theme to use for HTML and HTML Help pages. See the documentation for
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
133 # a list of builtin themes.
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
134 #html_theme = 'alabaster'
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
135
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
136 # Theme options are theme-specific and customize the look and feel of a theme
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
137 # further. For a list of options available for each theme, see the
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
138 # documentation.
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
139 #html_theme_options = {}
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
140
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
141 # Add any paths that contain custom themes here, relative to this directory.
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
142 #html_theme_path = []
4897
b26176334c88 Fix broken links to static html doc files (issue2550840)
John Kristensen <john@jerrykan.com>
parents: 4837
diff changeset
143
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
144 # The name for this set of Sphinx documents. If None, it defaults to
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
145 # "<project> v<release> documentation".
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
146 #html_title = None
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
147
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
148 # A shorter title for the navigation bar. Default is the same as html_title.
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
149 #html_short_title = None
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
150
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
151 # The name of an image file (relative to this directory) to place at the top
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
152 # of the sidebar.
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
153 #html_logo = None
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
154
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
155 # The name of an image file (within the static path) to use as favicon of the
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
156 # docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
157 # pixels large.
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
158 #html_favicon = None
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
159
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
160 # Add any paths that contain custom static files (such as style sheets) here,
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
161 # relative to this directory. They are copied after the builtin static files,
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
162 # so a file named "default.css" will overwrite the builtin "default.css".
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
163 html_static_path = ['_static']
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
164
5029
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
165 # Add any extra paths that contain custom files (such as robots.txt or
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
166 # .htaccess) here, relative to this directory. These files are copied
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
167 # directly to the root of the documentation.
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
168 html_extra_path = ['html_extra']
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
169
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
170 # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
171 # using the given strftime format.
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
172 html_last_updated_fmt = '%b %d, %Y'
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
173
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
174 # If true, SmartyPants will be used to convert quotes and dashes to
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
175 # typographically correct entities.
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
176 #html_use_smartypants = True
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
177
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
178 # Custom sidebar templates, maps document names to template names.
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
179 #html_sidebars = {}
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
180
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
181 # Additional templates that should be rendered to pages, maps page names to
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
182 # template names.
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
183 #html_additional_pages = {}
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
184
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
185 # If false, no module index is generated.
5029
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
186 #html_domain_indices = True
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
187
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
188 # If false, no index is generated.
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
189 #html_use_index = True
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
190
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
191 # If true, the index is split into individual pages for each letter.
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
192 #html_split_index = False
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
193
5029
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
194 # If true, links to the reST sources are added to the pages.
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
195 #html_show_sourcelink = True
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
196
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
197 # If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
198 #html_show_sphinx = True
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
199
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
200 # If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
201 #html_show_copyright = True
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
202
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
203 # If true, an OpenSearch description file will be output, and all pages will
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
204 # contain a <link> tag referring to it. The value of this option must be the
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
205 # base URL from which the finished HTML is served.
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
206 #html_use_opensearch = ''
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
207
5029
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
208 # This is the file name suffix for HTML files (e.g. ".xhtml").
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
209 #html_file_suffix = None
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
210
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
211 # Language to be used for generating the HTML full-text search index.
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
212 # Sphinx supports the following languages:
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
213 # 'da', 'de', 'en', 'es', 'fi', 'fr', 'hu', 'it', 'ja'
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
214 # 'nl', 'no', 'pt', 'ro', 'ru', 'sv', 'tr'
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
215 #html_search_language = 'en'
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
216
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
217 # A dictionary with options for the search language support, empty by default.
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
218 # Now only 'ja' uses this config value
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
219 #html_search_options = {'type': 'default'}
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
220
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
221 # The name of a javascript file (relative to the configuration directory) that
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
222 # implements a search results scorer. If empty, the default will be used.
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
223 #html_search_scorer = 'scorer.js'
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
224
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
225 # Output file base name for HTML help builder.
5029
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
226 htmlhelp_basename = 'roundupdoc'
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
227
5029
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
228 # -- Options for LaTeX output ---------------------------------------------
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
229
5029
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
230 latex_elements = {
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
231 # The paper size ('letterpaper' or 'a4paper').
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
232 #'papersize': 'letterpaper',
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
233
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
234 # The font size ('10pt', '11pt' or '12pt').
5029
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
235 #'pointsize': '10pt',
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
236
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
237 # Additional stuff for the LaTeX preamble.
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
238 #'preamble': '',
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
239
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
240 # Latex figure (float) alignment
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
241 #'figure_align': 'htbp',
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
242 }
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
243
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
244 # Grouping the document tree into LaTeX files. List of tuples
5029
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
245 # (source start file, target name, title,
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
246 # author, documentclass [howto, manual, or own class]).
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
247 latex_documents = [
4357
13b3155869e0 Beginnings of a big code cleanup / modernisation to make 2to3 happy
Richard Jones <richard@users.sourceforge.net>
parents: 4033
diff changeset
248 ('docs/index', 'Roundup.tex', u'Roundup Documentation',
13b3155869e0 Beginnings of a big code cleanup / modernisation to make 2to3 happy
Richard Jones <richard@users.sourceforge.net>
parents: 4033
diff changeset
249 u'Richard Jones', 'manual'),
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
250 ]
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
251
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
252 # The name of an image file (relative to this directory) to place at the top of
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
253 # the title page.
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
254 #latex_logo = None
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
255
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
256 # For "manual" documents, if this is true, then toplevel headings are parts,
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
257 # not chapters.
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
258 #latex_use_parts = False
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
259
5029
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
260 # If true, show page references after internal links.
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
261 #latex_show_pagerefs = False
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
262
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
263 # If true, show URL addresses after external links.
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
264 #latex_show_urls = False
4033
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
265
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
266 # Documents to append as an appendix to all manuals.
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
267 #latex_appendices = []
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
268
bca7c59ac400 Enhance documentation generation.
Stefan Seefeld <stefan@seefeld.name>
parents:
diff changeset
269 # If false, no module index is generated.
5029
333b01621772 Preparing 1.5.1 steps 7/16
anatoly techtonik <techtonik@gmail.com>
parents: 5028
diff changeset
270 #latex_domain_indices = True
Roundup Issue Tracker: http://roundup-tracker.org/