6
6
# All configuration values have a default; values that are commented out
7
7
# serve to show the default.
9
from __future__ import absolute_import
11
# FIXME: better move the content of doc/en/conf.py here and cleanup the result
11
14
# If extensions (or modules to document with autodoc) are in another directory,
12
15
# add these directories to sys.path here. If the directory is relative to the
13
16
# documentation root, use os.path.abspath to make it absolute, like shown here.
14
#sys.path.append(os.path.abspath('.'))
17
# sys.path.append(os.path.abspath('.'))
17
20
# -- General configuration -----------------------------------------------------
19
22
# Add any Sphinx extension module names here, as strings. They can be extensions
20
23
# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
21
extensions = ['sphinx.ext.ifconfig']
25
'sphinx.ext.ifconfig',
27
'sphinx.ext.intersphinx',
29
# 'sphinxcontrib.napoleon', # TODO: for Google docstrings
23
32
# Add any paths that contain templates here, relative to this directory.
24
33
templates_path = ['_templates']
33
42
master_doc = 'index'
35
44
# General information about the project.
37
copyright = u'2009, Canonical Ltd'
46
copyright = u'2009-2011 Canonical Ltd, 2017-2018 Breezy Developers'
39
48
# The version info for the project you're documenting, acts as replacement for
40
49
# |version| and |release|, also used in various other places throughout the
43
52
# The short X.Y version.
45
version = '.'.join(str(p) for p in bzrlib.version_info[:2])
54
version = '.'.join(str(p) for p in breezy.version_info[:2])
46
55
# The full version, including alpha/beta/rc tags.
47
release = bzrlib.version_string
56
release = breezy.version_string
49
58
# The language for content autogenerated by Sphinx. Refer to documentation
50
59
# for a list of supported languages.
89
98
# The theme to use for HTML and HTML Help pages. Major themes that come with
90
99
# Sphinx are currently 'default' and 'sphinxdoc'.
91
html_theme = 'default'
93
102
# Theme options are theme-specific and customize the look and feel of a theme
94
103
# further. For a list of options available for each theme, see the
97
106
# Unfortunately, the right sidebar breaks under IE6 and maybe IE7.
98
107
# So we stick with the default left placement to cater for users stuck
99
108
# on those browsers.
100
#'rightsidebar': True,
109
# 'rightsidebar': True,
102
111
# Non-document areas: header (relbar), footer, sidebar, etc.
103
112
# Some useful colours here:
104
113
# * blue: darkblue, mediumblue, darkslateblue, cornflowerblue, royalblue,
106
115
# * gray: dimgray, slategray, lightslategray
107
'sidebarbgcolor': "cornflowerblue",
108
'sidebarlinkcolor': "midnightblue",
109
'relbarbgcolor': "darkblue",
110
'footerbgcolor': "lightslategray",
116
#'sidebarbgcolor': "cornflowerblue",
117
#'sidebarlinkcolor': "midnightblue",
118
#'relbarbgcolor': "darkblue",
119
#'footerbgcolor': "lightslategray",
112
121
# Text, heading and code colouring
113
'codebgcolor': "lightyellow",
114
'codetextcolor': "firebrick",
115
'linkcolor': "mediumblue",
122
#'codebgcolor': "lightyellow",
123
#'codetextcolor': "firebrick",
124
#'linkcolor': "mediumblue",
118
127
# Add any paths that contain custom themes here, relative to this directory.
132
141
# The name of an image file (within the static path) to use as favicon of the
133
142
# docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32
135
html_favicon = "bzr.ico"
144
# TODO(jelmer): add a brz.ico
145
# html_favicon = "brz.ico"
137
147
# Add any paths that contain custom static files (such as style sheets) here,
138
148
# relative to this directory. They are copied after the builtin static files,
193
203
# The name of an image file (relative to this directory) to place at the top of
194
204
# the title page.
195
latex_logo = '../Bazaar-Logo-For-Manuals.png'
205
# latex_logo = '../Bazaar-Logo-For-Manuals.png'
197
207
# For "manual" documents, if this is true, then toplevel headings are parts,
211
221
# -- Bazaar-specific configuration ---------------------------------------------
213
223
# Authors of the documents
214
bzr_team = u'Bazaar Developers'
224
brz_team = u'Breezy Developers'
226
intersphinx_mapping = {
227
'python': ('https://docs.python.org/3', None),
228
'testtools': ('https://testtools.readthedocs.io/en/latest', None),
229
'configobj': ('https://configobj.readthedocs.io/en/latest', None),
230
'dulwich': ('https://dulwich.readthedocs.io/en/latest', None),