Merge pull request #463 from berkeley-cocosci/alabaster

Use Alabaster theme for docs

dev-requirements.txt

@@ -1,7 +1,7 @@
+alabaster==0.7.9
 coverage==3.7.1
 coveralls==0.4.2
 nose==1.3.4
-sphinx-rtd-theme==0.1.9
 Sphinx==1.4.5
 sphinxcontrib-spelling==2.2.0
 -r requirements.txt

docs/source/_static/style.css

@@ -1,11 +1,15 @@
 body {
-    font-size: 20px;
+    font-size: 22px;
 }
 
 code {
     font-size: 14px;
 }
 
+.highlight {
+    font-size: 18px;
+}
+
 tt, code {
     padding: 4px 5px 1px 5px;
 }
@@ -15,3 +19,16 @@ tt, code {
         background: #3e4349;
     }
 }
+
+h2 {
+    font-size: 75%;
+}
+
+tt.xref, code.xref, a tt {
+    background-color: #ecf0f3;
+    padding: 4px 5px 1px 5px;
+}
+
+pre {
+    background: #ecf0f3;
+}

docs/source/conf.py

@@ -134,15 +134,27 @@
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-import sphinx_rtd_theme
-html_theme = "sphinx_rtd_theme"
-html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
+import alabaster
+html_theme_path = [alabaster.get_path()]
+extensions += ['alabaster']
+html_theme = 'alabaster'
+html_context = {
+    'css_files': ['_static/style.css'],
+}
 
 # 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 = {}
+html_theme_options = {
+    'logo_name': True,
+    'github_user': 'berkeley-cocosci',
+    'github_repo': 'Wallace',
+    'github_type': 'star',
+    'github_button': True,
+    'description': 'A platform for experimental cultural evolution.',
+    'show_powered_by': False,
+}
 
 # Add any paths that contain custom themes here, relative to this directory.
 # html_theme_path = []
@@ -191,7 +203,15 @@
 
 # Custom sidebar templates, maps document names to template names.
 #
-# html_sidebars = {}
+html_sidebars = {
+    '**': [
+        'about.html',
+        'navigation.html',
+        'relations.html',
+        'searchbox.html',
+        'donate.html',
+    ]
+}
 
 # Additional templates that should be rendered to pages, maps page names to
 # template names.

docs/source/developing_wallace_setup_guide.rst

@@ -121,7 +121,7 @@ will run the command that follows, which in this case locates the
 ``virtualenvwrapper.sh`` shell script, the contents of which are beyond
 the scope of this setup tutorial. If you want to know what it does, a
 more in depth description can be found at `this page on
-``virtualenvwrapper.sh`` <http://virtualenvwrapper.readthedocs.org/en/latest/install.html#python-interpreter-virtualenv-and-path>`__.
+``virtualenvwrapper.sh`` <http://virtualenvwrapper.readthedocs.io/en/latest/install.html#python-interpreter-virtualenv-and-path>`__.
 Finally, the ``mkvirtualenv`` makes your first virtual environment which
 you've named ``wallace``. We have explicitly passed it the location of
 ``python2.7`` so that even if your ``python`` command has been remapped

docs/source/wallace_the_scientist.rst

@@ -30,6 +30,6 @@ of bad investments Wallace again faced an uncertain future, which
 stabilized after Darwin lobbied successfully for him to receive a
 government pension for lifetime contributions to science. Today,
 Wallace's legacy can be seen in the `Wallace
-Line <http://en.wikipedia.org/wiki/Wallace_Line>`__, the `Wallace
-Effect <http://en.wikipedia.org/wiki/Wallace_effect>`__ and Wallace, a
+Line <https://en.wikipedia.org/wiki/Wallace_Line>`__, the `Wallace
+Effect <https://en.wikipedia.org/wiki/Wallace_effect>`__ and Wallace, a
 platform for conducting research on experimental cultural evolution.