DOC: add a page with a different sidebar

doc/conf.py

@@ -62,7 +62,11 @@
        'separator.html',
        'indices.html',
    ],
-   'showcase/no-sidebar': [],  # To demonstrate a page without a sidebar
+   'showcase/different-sidebar': [
+       'localtoc.html',
+       'searchbox.html',
+   ],
+   'showcase/no-sidebar': [],
 }
 
 html_static_path = ['_static']

doc/index.rst

@@ -33,6 +33,7 @@
     showcase/math
     showcase/api-doc
     showcase/sections
+    showcase/different-sidebar
     showcase/no-sidebar
 
 ----

doc/showcase/different-sidebar.rst

@@ -0,0 +1,31 @@
+Page With Different Sidebar
+===========================
+
+This page has different content in the sidebar,
+see :confval:`html_sidebars` in :download:`conf.py <../conf.py>`:
+
+.. literalinclude:: ../conf.py
+    :caption: conf.py
+    :language: python
+    :linenos:
+    :lineno-match:
+    :start-at: html_sidebars
+    :end-at: }
+
+
+Local Table of Contents
+-----------------------
+
+Instead of displaying the whole TOC in the sidebar
+with ``globaltoc.html``,
+a local TOC can be shown with ``localtoc.html``.
+
+
+Search Box
+----------
+
+If you don't like the search button in the topbar,
+you can also put a search field into the sidebar
+by selecting the template ``searchbox.html``.
+
+Like the search button, this is only available when JavaScript is enabled.