From 399dfe06f23b082aa1fdb3b87d7c7e12273f7efd Mon Sep 17 00:00:00 2001 From: Andreas Scheuring Date: Wed, 22 Feb 2017 09:30:14 +0100 Subject: [PATCH] Fix RTD not rendering bullets of toctree RTD is not rendering the bullets of toctree items when the oslosphinx extension containing the 'openstack' theme is used. This patch is a circumvention until the issue has been fixed in oslosphinx [1]. [1] https://bugs.launchpad.net/oslosphinx/+bug/1664976 Change-Id: Id78caa0022c2d1257a651712bdb14f126bf854fc Closes-Bug: #1664863 --- doc/source/conf.py | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/doc/source/conf.py b/doc/source/conf.py index da88c95..b466446 100755 --- a/doc/source/conf.py +++ b/doc/source/conf.py @@ -15,6 +15,7 @@ # under the License. import os +import oslosphinx import sys sys.path.insert(0, os.path.abspath('../..')) @@ -74,6 +75,14 @@ pygments_style = 'sphinx' # Sphinx are currently 'default' and 'sphinxdoc'. # html_theme_path = ["."] # html_theme = '_theme' + +# Bullets of a toctree are not getting rendered when docs are build +# on RTD. The following 2 lines circumvent that. +# For more details see: https://bugs.launchpad.net/oslosphinx/+bug/1664976 +# Once the bug is fixed, those 2 lines can be remove again +html_theme_path = [os.path.join(os.path.dirname(oslosphinx.__file__), 'theme')] +html_theme = 'openstack' + html_static_path = ['_static'] # Output file base name for HTML help builder.