reorganizing index, more closely aligned with Readthedocs format, usi…

…ng caption option, only available in Sphinx 1.3
ox-it · Sep 10, 2015 · 294f346 · 294f346
1 parent 8066fee
commit 294f346
Show file tree

Hide file tree

Showing 5 changed files with 26 additions and 47 deletions.
diff --git a/docs/source/conf.py b/docs/source/conf.py
@@ -34,7 +34,7 @@
     'sphinx.ext.intersphinx',
 ]
 
-intersphinx_mapping = {'widget': ('http://talksox.readthedocs.org/projects/talksox-js-widget/en/latest/', None)} 
+intersphinx_mapping = {'widget': ('http://talksox.readthedocs.org/projects/talksox-js-widget/en/latest/', None)}
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
@@ -104,7 +104,7 @@
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-html_theme = 'default'
+html_theme = 'alabaster'
 
 # 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

diff --git a/docs/source/index.rst b/docs/source/index.rst
@@ -7,36 +7,40 @@
 Oxford Talks
 ############
 
-
-
-**********
-User Guide
-**********
-
-New features arriving in the next few months
-
 .. toctree::
-    :maxdepth: 1
-
-    user/talk-users
+   :maxdepth: 1
+   :caption: User Guide
 
-*******************
-General Information
-*******************
+   user/talk-users/explore-talks
+   user/talk-users/make-a-list
+   user/talk-users/add-to-your-calendar
+   user/talk-users/feed-in-your-calendar
+   user/talk-users/email-reminders
 
 .. toctree::
     :maxdepth: 1
+    :caption: General Information
 
-    user/general
-
-**************
-Editors' Guide
-**************
+    user/general/log-in
+    user/general/terms
+    user/general/organisers
+    user/general/differences
+    user/general/contact
 
 .. toctree::
     :maxdepth: 1
+    :caption: Talks Editor's Guide
+
+    user/talk-editors/sign-up
+    user/talk-editors/create-a-talk
+    user/talk-editors/create-a-series
+    user/talk-editors/editing
+    user/talk-editors/formatting-the-abstract
+    user/talk-editors/publicizing-your-talk
+    user/talk-editors/last-minute-changes
+    user/talk-editors/share-editing
+    user/talk-editors/people-details
 
-    user/talk-editors
 
 
 ****************************

diff --git a/docs/source/user/general.rst b/docs/source/user/general.rst
diff --git a/docs/source/user/talk-editors.rst b/docs/source/user/talk-editors.rst
diff --git a/docs/source/user/talk-users.rst b/docs/source/user/talk-users.rst