[Docs] Add a custom sidebar to doc pages
authorDeForest Richards <d4m1887@gmail.com>
Fri, 20 Sep 2019 22:16:39 +0000 (22:16 +0000)
committerDeForest Richards <d4m1887@gmail.com>
Fri, 20 Sep 2019 22:16:39 +0000 (22:16 +0000)
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

llvm/docs/_templates/indexsidebar.html
llvm/docs/conf.py

index 4161742..dbd85f0 100644 (file)
@@ -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>
\ No newline at end of file
index a0357cf..c92ede3 100644 (file)
@@ -99,7 +99,7 @@ html_theme = 'llvm-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
 # 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_last_updated_fmt = '%Y-%m-%d'
 #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.