[Docs] Add a custom sidebar to doc pages

Adds a custom sidebar to LLVM docs. Sidebar includes links to How to submit a bug and FAQ topics, as well as a Show Source link and search box.

llvm-svn: 372432

Author: drichards-87

llvm/docs/_templates/indexsidebar.html

@@ -3,5 +3,10 @@
 
 <h3>Bugs</h3>
 
-<p>LLVM bugs should be reported to
-  <a href="http://llvm.org/bugs">Bugzilla</a>.</p>
+<p>Information on submitting bugs can be found
+  <a href="https://llvm.org/docs/HowToSubmitABug.html">here</a>.</p>
+
+<h3>FAQ</h3>
+
+<p> A list of
+  <a href="https://llvm.org/docs/FAQ.html">frequently asked questions</a> about LLVM.</p>

llvm/docs/conf.py

@@ -99,7 +99,7 @@
 # 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 = { "nosidebar": True }
+html_theme_options = { "nosidebar": False }
 
 # Add any paths that contain custom themes here, relative to this directory.
 html_theme_path = ["_themes"]
@@ -134,7 +134,14 @@
 #html_use_smartypants = True
 
 # Custom sidebar templates, maps document names to template names.
-html_sidebars = {'index': 'indexsidebar.html'}
+
+html_sidebars = {
+    '**': [
+        'indexsidebar.html',
+        'sourcelink.html',
+        'searchbox.html',
+    ]
+}
 
 # Additional templates that should be rendered to pages, maps page names to
 # template names.