# absolute, like shown here.
#sys.path.append(os.path.abspath('.'))
+def artworkdir():
+ """Look into every parent dir for 'artwork' and return its relative path."""
+ level = 0
+ while True:
+ target = os.path.join(*([os.path.pardir] * level + ['artwork']))
+ if os.path.isdir(target):
+ return target
+ else:
+ level += 1
+ # if there is no way up
+ if os.path.abspath(os.path.join(*([os.path.pardir] * level))) == \
+ os.path.abspath(os.path.join(*([os.path.pardir] * (level + 1)))):
+ raise(ValueError, "Cannot find 'artwork'.")
+
+
# General configuration
# ---------------------
# Add any Sphinx extension module names here, as strings. They can be extensions
# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = []
+#extensions = []
+sys.path.append(os.path.abspath('.'))
+extensions = ['sphinxext.quote',
+ 'sphinxext.feed',
+ 'sphinx.ext.todo']
+
+# show todo items
+todo_include_todos = True
# Add any paths that contain templates here, relative to this directory.
templates_path = ['_templates']
# General information about the project.
project = u'Debian Neuroscience Package Repository'
-copyright = u'2009, Michael Hanke'
+copyright = u'2009-2011, NeuroDebian Team'
# The version info for the project you're documenting, acts as replacement for
# |version| and |release|, also used in various other places throughout the
# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.
-#language = None
+language = 'en'
# There are two options for replacing |today|: either, you set today to some
# non-false value, then it is used:
# The name of an image file (relative to this directory) to place at the top
# of the sidebar.
-html_logo = 'pics/neurodebian.png'
+html_logo = os.path.join(artworkdir(), 'logo_tuned/fmri_w200.png')
# The name of an image file (within the static path) to use as favicon of the
# docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32
# pixels large.
-#html_favicon = None
+html_favicon = 'favicon.ico'
# Add any paths that contain custom static files (such as style sheets) here,
# relative to this directory. They are copied after the builtin static files,
# so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static', 'static']
+html_static_path = ['_static']
# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
# using the given strftime format.
html_use_modindex = False
# If false, no index is generated.
-#html_use_index = True
+html_use_index = False
# If true, the index is split into individual pages for each letter.
#html_split_index = False
# If false, no module index is generated.
#latex_use_modindex = True
+
+# RSS feed
+# --------
+feed_base_url = 'http://neuro.debian.net'
+feed_title = "NeuroDebian Insider"
+feed_subtitle = "This solves all your problems"
+feed_description = "A blog about using the ultimate operating system in neuroscience research"
+feed_variants = {'planetdebian': {'filename': 'feeds/for-debian-planet.xml',
+ 'tag': 'debian'},
+ 'all': {'filename': 'feeds/blog.xml', 'tag': None}}
+feed_categories = ['debian', 'neuroscience']
+feed_author_name = 'NeuroDebian team'
+feed_author_email = 'team@neuro.debian.net'