https://jira.opendaylight.org This file is an XML representation of an issue en-us 8.20.10 820010 22-06-2022 https://jira.opendaylight.org/browse/DOCS-117 docs <p>Per <a href="https://pypi.org/project/sphinx-bootstrap-theme/0.4.8/" class="external-link" target="_blank" rel="nofollow noopener">https://pypi.org/project/sphinx-bootstrap-theme/0.4.8/</a></p> <p>sphinx-bootstrap assumes a default of 'navbar_fixed_top': "true" if it is not set in html_theme_options of conf.py</p> <p> </p> <p>I have confirmed that conf.py of the current github mirror of the docs project contains no html_theme_options and would inherit all defaults described at the URL given</p> <p> </p> <p>This causes the sidebar to hover and it can not be scrolled until the content pane of the page is scrolled completely to the bottom.</p> <p> </p> <p>For many documentation URLs this results in navigation requiring one to scroll through dozens of pages of content then multiple pages of navbar for the desired section to be visible to click and is almost but not quite entirely unusable in this form.</p> <p> </p> <p>See e.g. <a href="https://docs.opendaylight.org/projects/aaa/en/stable-fluorine/dev-guide.html" class="external-link" target="_blank" rel="nofollow noopener">https://docs.opendaylight.org/projects/aaa/en/stable-fluorine/dev-guide.html</a></p> <p> </p> <p>The behavior is browser independent</p> <p> </p> <p>Please set navbar_fixed_top to false in html_theme_options of conf.py</p> DOCS-117

sphinx-bootstrap default navbar_fixed_top breaks side navbar scrolling

Bug High Resolved Cannot Reproduce David Baugher Joshua McBeth Thu, 21 Mar 2019 01:06:59 +0000 Fri, 13 Sep 2019 17:36:56 +0000 Tue, 13 Aug 2019 21:39:33 +0000 0 1 <p>I cannot find the "navbar_fixed_top" parameter in the conf.py file.</p> <p>David,</p> <p> </p> <p>Thank you for looking into this.  The issue, as you've observed, is that the html_theme_options are not present.  This results in the use of the default parameter, which recently changed in the theme to select the undesired navigation behavior described.</p> <p> </p> <p>The html_theme_options dict needs to be added to conf.py if not present, and the key navbar_fixed_top needs to be added to the html_theme_options dict with the value false to disable this behavior.</p> Development Rank 0|i03n7b: