[DOC] css wrap

docs/conf.py

@@ -28,8 +28,13 @@
 # -- General configuration ------------------------------------------------
 
 # If your documentation needs a minimal Sphinx version, state it here.
-#
-# needs_sphinx = '1.0'
+
+needs_sphinx = '1.2'
+
+# generate autosummary even if no references
+autosummary_generate = True
+autodoc_default_flags = ['members', 'inherited-members']
+add_module_names = False
 
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
@@ -42,23 +47,10 @@
               'sphinx.ext.doctest',
               'sphinx.ext.todo',
               'numpydoc',
+              'sphinx.ext.mathjax',
               'sphinx.ext.ifconfig',
               'sphinx.ext.linkcode']
 
-# pngmath / imgmath compatibility layer for different sphinx versions
-import sphinx
-from distutils.version import LooseVersion
-if LooseVersion(sphinx.__version__) < LooseVersion('1.4'):
-    extensions.append('sphinx.ext.pngmath')
-else:
-    extensions.append('sphinx.ext.imgmath')
-
-# Add any paths that contain templates here, relative to this directory.
-templates_path = ['_templates']
-
-# The suffix(es) of source filenames.
-# You can specify multiple suffix as a list of string:
-#
 # source_suffix = ['.rst', '.md']
 source_suffix = '.rst'
 
@@ -67,17 +59,18 @@
 
 # General information about the project.
 project = 'tedana'
-copyright = '2017-2018, Elizabeth DuPre'
-author = 'Elizabeth DuPre'
+copyright = '2017-2018, tedana developers'
+author = 'tedana developers'
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
 # The short X.Y version.
-version = ''
+import tedana
+version = tedana.__version__
 # The full version, including alpha/beta/rc tags.
-release = ''
+release = tedana.__version__
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
@@ -118,26 +111,11 @@
 # so a file named "default.css" will overwrite the builtin "default.css".
 html_static_path = ['_static']
 
-# html_context = {
-#     'css_files': [
-#         '_static/theme_overrides.css',  # override wide tables in RTD theme
-#         ],
-#     }
 
-# Custom sidebar templates, must be a dictionary that maps document names
-# to template names.
-#
-# This is required for the alabaster theme
-# refs: http://alabaster.readthedocs.io/en/latest/installation.html#sidebars
-html_sidebars = {
-    '**': [
-        'about.html',
-        'navigation.html',
-        'relations.html',  # needs 'show_related': True theme option to display
-        'searchbox.html',
-        'donate.html',
-    ]
-}
+# https://github.com/rtfd/sphinx_rtd_theme/issues/117
+def setup(app):
+    app.add_stylesheet('theme_overrides.css')
+
 
 html_favicon = '_static/tedana_favicon.png'
 
@@ -147,62 +125,6 @@
 # Output file base name for HTML help builder.
 htmlhelp_basename = 'tedanadoc'
 
-
-# -- Options for LaTeX output ---------------------------------------------
-
-latex_elements = {
-    # The paper size ('letterpaper' or 'a4paper').
-    #
-    # 'papersize': 'letterpaper',
-
-    # The font size ('10pt', '11pt' or '12pt').
-    #
-    # 'pointsize': '10pt',
-
-    # Additional stuff for the LaTeX preamble.
-    #
-    # 'preamble': '',
-
-    # Latex figure (float) alignment
-    #
-    # 'figure_align': 'htbp',
-}
-
-# Grouping the document tree into LaTeX files. List of tuples
-# (source start file, target name, title,
-#  author, documentclass [howto, manual, or own class]).
-latex_documents = [
-    (master_doc, 'tedana.tex', 'yedana Documentation',
-     'Elizabeth DuPre, Prantik Kundu', 'manual'),
-]
-
-
-# -- Options for manual page output ---------------------------------------
-
-# One entry per manual page. List of tuples
-# (source start file, name, description, authors, manual section).
-man_pages = [
-    (master_doc, 'tedana', 'tedana Documentation',
-     [author], 1)
-]
-
-
-# -- Options for Texinfo output -------------------------------------------
-
-# Grouping the document tree into Texinfo files. List of tuples
-# (source start file, target name, title, author,
-#  dir menu entry, description, category)
-texinfo_documents = [
-    (master_doc, 'tedana', 'tedana Documentation',
-     author, 'tedana', 'One line description of project.',
-     'Miscellaneous'),
-]
-
-# generate autosummary even if no references
-autosummary_generate = True
-autodoc_default_flags = ['members', 'inherited-members']
-add_module_names = False
-
 # The following is used by sphinx.ext.linkcode to provide links to github
 linkcode_resolve = make_linkcode_resolve('tedana',
                                          u'https://github.com/me-ica/'