]> git.donarmstrong.com Git - neurodebian.git/blobdiff - sphinx/conf.py
Also for stats report which repo and which job number use our setup
[neurodebian.git] / sphinx / conf.py
index 2597bbdc66a2577aca2d00bc96cd107b0d64c06c..aefd155932202c732107e9097312204cd73c5542 100644 (file)
@@ -41,7 +41,14 @@ def artworkdir():
 
 # 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']
@@ -57,7 +64,7 @@ master_doc = 'index'
 
 # General information about the project.
 project = u'Debian Neuroscience Package Repository'
-copyright = u'2009, Michael Hanke'
+copyright = u'2009-2014, NeuroDebian Team <team@neuro.debian.net>'
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
@@ -68,9 +75,23 @@ version = ''
 # The full version, including alpha/beta/rc tags.
 release = ''
 
+# Monkey patch "English" language regular expression so we could
+# search for package names as well
+import re
+word_re = re.compile(r'[-.\w]+(?u)')
+
+import sphinx.search
+# older versions (before 1.1.3, 1.0.7 for sure) had no language
+# customizations
+if hasattr(sphinx.search, 'word_re'):
+    sphinx.search.word_re = word_re
+else:
+    from sphinx.search.en import SearchEnglish
+    SearchEnglish._word_re = word_re
+
 # 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:
@@ -111,6 +132,15 @@ pygments_style = 'sphinx'
 # given in html_static_path.
 html_style = 'neurodebian.css'
 
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = 'default'
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+html_theme_options = {'nosidebar': True}
+
 # The name for this set of Sphinx documents.  If None, it defaults to
 # "<project> v<release> documentation".
 html_title = project
@@ -203,3 +233,16 @@ latex_documents = [
 
 # 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'