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
9
# FIXME: better move the content of doc/en/conf.py here and cleanup the result
14
12
# If extensions (or modules to document with autodoc) are in another directory,
15
13
# add these directories to sys.path here. If the directory is relative to the
16
14
# documentation root, use os.path.abspath to make it absolute, like shown here.
17
#sys.path.append(os.path.abspath('.'))
15
# sys.path.append(os.path.abspath('.'))
20
18
# -- General configuration -----------------------------------------------------
22
20
# Add any Sphinx extension module names here, as strings. They can be extensions
23
21
# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
24
extensions = ['sphinx.ext.ifconfig',]
23
'sphinx.ext.ifconfig',
25
'sphinx.ext.intersphinx',
27
# 'sphinxcontrib.napoleon', # TODO: for Google docstrings
26
30
# Add any paths that contain templates here, relative to this directory.
27
31
templates_path = ['_templates']
38
42
# General information about the project.
39
43
project = u'Breezy'
40
copyright = u'2009-2011 Canonical Ltd'
44
copyright = u'2009-2011 Canonical Ltd, 2017-2018 Breezy Developers'
42
46
# The version info for the project you're documenting, acts as replacement for
43
47
# |version| and |release|, also used in various other places throughout the
92
96
# The theme to use for HTML and HTML Help pages. Major themes that come with
93
97
# Sphinx are currently 'default' and 'sphinxdoc'.
94
html_theme = 'default'
96
100
# Theme options are theme-specific and customize the look and feel of a theme
97
101
# further. For a list of options available for each theme, see the
100
104
# Unfortunately, the right sidebar breaks under IE6 and maybe IE7.
101
105
# So we stick with the default left placement to cater for users stuck
102
106
# on those browsers.
103
#'rightsidebar': True,
107
# 'rightsidebar': True,
105
109
# Non-document areas: header (relbar), footer, sidebar, etc.
106
110
# Some useful colours here:
107
111
# * blue: darkblue, mediumblue, darkslateblue, cornflowerblue, royalblue,
109
113
# * gray: dimgray, slategray, lightslategray
110
'sidebarbgcolor': "cornflowerblue",
111
'sidebarlinkcolor': "midnightblue",
112
'relbarbgcolor': "darkblue",
113
'footerbgcolor': "lightslategray",
114
#'sidebarbgcolor': "cornflowerblue",
115
#'sidebarlinkcolor': "midnightblue",
116
#'relbarbgcolor': "darkblue",
117
#'footerbgcolor': "lightslategray",
115
119
# Text, heading and code colouring
116
'codebgcolor': "lightyellow",
117
'codetextcolor': "firebrick",
118
'linkcolor': "mediumblue",
120
#'codebgcolor': "lightyellow",
121
#'codetextcolor': "firebrick",
122
#'linkcolor': "mediumblue",
121
125
# Add any paths that contain custom themes here, relative to this directory.
217
221
# Authors of the documents
218
222
brz_team = u'Breezy Developers'
224
intersphinx_mapping = {
225
'python': ('https://docs.python.org/3', None),
226
'testtools': ('https://testtools.readthedocs.io/en/latest', None),
227
'configobj': ('https://configobj.readthedocs.io/en/latest', None),
228
'dulwich': ('https://dulwich.readthedocs.io/en/latest', None),