switch to the pydata sphinx theme

Author: rmorshea

docs/main.py

@@ -20,7 +20,7 @@
 
 @app.route("/")
 async def forward_to_index(request):
-    return response.redirect("/docs/index.html")
+    return response.redirect("/docs/content/index.html")
 
 
 mount, element = multiview()

docs/source/conf.py

@@ -64,7 +64,7 @@
 source_suffix = ".rst"
 
 # The master toctree document.
-master_doc = "index"
+master_doc = "content/index"
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
@@ -95,7 +95,7 @@
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-html_theme = "sphinx_rtd_theme"
+html_theme = "pydata_sphinx_theme"
 
 # 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
@@ -110,7 +110,11 @@
 
 # These paths are either relative to html_static_path
 # or fully qualified paths (eg. https://...)
-html_css_files = ["css/interactive-widget.css"]
+html_css_files = [
+    "css/interactive-widget.css",
+    "css/custom-max-width.css",
+    "css/fix-code-linenos.css",
+]
 
 # Custom sidebar templates, must be a dictionary that maps document names
 # to template names.

docs/source/core-concepts.rst renamed to docs/source/content/advanced-usage/core-concepts.rst

@@ -0,0 +1,14 @@
+Advanced Usage
+==============
+
+Explains the high level abstractions of IDOM like layouts, distpatchers and servers as
+well as more advanced features that allow you to import existing or custom javascript
+into your IDOM views. If you're just getting started check out the :ref:`User Guide`
+first before you dive in here.
+
+.. toctree::
+    :maxdepth: 1
+
+    core-concepts
+    javascript-modules
+    extra-features

docs/source/extra-features.rst renamed to docs/source/content/advanced-usage/extra-features.rst

@@ -77,12 +77,8 @@ hook in a module of your own making on the fly. As before, we'll be using a
 parameter which is a file-like object. In the following example we'll use Victory again,
 but this time we'll add a callback to it. Unfortunately we can't just pass it in
 :ref:`like we did before <Passing Props To Components>` because Victory's event API
-is a bit more complex so we've implemented a quick wrapper for it in a file ``chart.js``.
-
-.. literalinclude:: examples/custom_chart.js
-    :language: javascript
-
-Which we can read in as a ``source`` to :class:`~idom.widgets.utils.Module`:
+is a bit more complex so we've implemented a quick wrapper for it in a file ``chart.js``
+which we can read in as a ``source`` to :class:`~idom.widgets.utils.Module`:
 
 Click the bars to trigger an event 👇
 

docs/source/content/advanced-usage/index.rst

@@ -0,0 +1,10 @@
+API Reference
+=============
+
+Detailed explanations of classes, functions, and protocols used by IDOM.
+
+.. toctree::
+    :maxdepth: 1
+
+    package-api
+    specifications

docs/source/javascript-modules.rst renamed to docs/source/content/advanced-usage/javascript-modules.rst

@@ -1,5 +1,5 @@
-API
-===
+Package API
+===========
 
 .. contents::
   :local: