2014-03-24 18:23:54 +00:00
|
|
|
import sys
|
|
|
|
import os
|
|
|
|
|
2013-03-08 23:46:34 +00:00
|
|
|
project = u'Ceph'
|
2014-01-12 16:46:18 +00:00
|
|
|
copyright = u'2010-2014, Inktank Storage, Inc. and contributors. Licensed under Creative Commons BY-SA'
|
2011-08-19 23:43:21 +00:00
|
|
|
version = 'dev'
|
|
|
|
release = 'dev'
|
|
|
|
|
|
|
|
templates_path = ['_templates']
|
|
|
|
source_suffix = '.rst'
|
|
|
|
master_doc = 'index'
|
2014-05-08 01:01:52 +00:00
|
|
|
exclude_patterns = ['**/.#*', '**/*~', 'start/quick-common.rst']
|
2011-08-19 23:43:21 +00:00
|
|
|
pygments_style = 'sphinx'
|
|
|
|
|
2012-05-03 18:02:51 +00:00
|
|
|
html_theme = 'ceph'
|
|
|
|
html_theme_path = ['_themes']
|
2013-03-04 19:48:14 +00:00
|
|
|
html_title = "Ceph Documentation"
|
2012-05-03 18:02:51 +00:00
|
|
|
html_logo = 'logo.png'
|
2011-08-19 23:43:21 +00:00
|
|
|
html_favicon = 'favicon.ico'
|
|
|
|
html_use_smartypants = True
|
|
|
|
html_show_sphinx = False
|
2011-08-30 18:26:56 +00:00
|
|
|
html_sidebars = {
|
|
|
|
'**': ['smarttoc.html', 'searchbox.html'],
|
|
|
|
}
|
2011-08-19 23:43:21 +00:00
|
|
|
|
2011-08-29 22:43:41 +00:00
|
|
|
extensions = [
|
2011-09-30 18:30:28 +00:00
|
|
|
'sphinx.ext.autodoc',
|
2011-09-01 19:42:56 +00:00
|
|
|
'sphinx.ext.graphviz',
|
2011-08-29 22:43:41 +00:00
|
|
|
'sphinx.ext.todo',
|
2011-12-06 20:04:03 +00:00
|
|
|
'sphinx_ditaa',
|
2011-12-23 01:17:20 +00:00
|
|
|
'asphyxiate',
|
2011-08-29 22:43:41 +00:00
|
|
|
]
|
2011-08-19 23:43:21 +00:00
|
|
|
todo_include_todos = True
|
|
|
|
|
|
|
|
def _get_manpages():
|
|
|
|
import os
|
|
|
|
man_dir = os.path.join(
|
|
|
|
os.path.dirname(__file__),
|
|
|
|
'man',
|
|
|
|
)
|
|
|
|
sections = os.listdir(man_dir)
|
|
|
|
for section in sections:
|
|
|
|
section_dir = os.path.join(man_dir, section)
|
|
|
|
if not os.path.isdir(section_dir):
|
|
|
|
continue
|
|
|
|
for filename in os.listdir(section_dir):
|
|
|
|
base, ext = os.path.splitext(filename)
|
|
|
|
if ext != '.rst':
|
|
|
|
continue
|
|
|
|
if base == 'index':
|
|
|
|
continue
|
|
|
|
with file(os.path.join(section_dir, filename)) as f:
|
|
|
|
one = f.readline()
|
|
|
|
two = f.readline()
|
|
|
|
three = f.readline()
|
|
|
|
assert one == three
|
|
|
|
assert all(c=='=' for c in one.rstrip('\n'))
|
|
|
|
two = two.strip()
|
|
|
|
name, rest = two.split('--', 1)
|
|
|
|
assert name.strip() == base
|
|
|
|
description = rest.strip()
|
|
|
|
yield (
|
|
|
|
os.path.join('man', section, base),
|
|
|
|
base,
|
|
|
|
description,
|
|
|
|
'',
|
|
|
|
section,
|
|
|
|
)
|
|
|
|
|
|
|
|
man_pages = list(_get_manpages())
|
2011-08-29 22:43:41 +00:00
|
|
|
|
2011-12-23 01:17:20 +00:00
|
|
|
asphyxiate_doxygen_xml = 'doxygen'
|
2014-03-24 18:23:54 +00:00
|
|
|
|
|
|
|
top_level = os.path.dirname(
|
|
|
|
os.path.dirname(
|
|
|
|
os.path.abspath(__file__)
|
|
|
|
)
|
|
|
|
)
|
|
|
|
|
|
|
|
pybind = os.path.join(top_level, 'src/pybind')
|
|
|
|
if pybind not in sys.path:
|
|
|
|
sys.path.insert(0, pybind)
|