2017-02-15 14:00:34 |
Andreas Scheuring |
description |
In our project [1], the oslosphinx theme is used by just importing it as extension. But once Read the docs builds it using sphinx, all bullets of the toctree are not getting rendered. This results in a flat list of headings shown in our table of contents.
The root cause of this is, that RTD extends the existing conf.py file. One thing they do is updating the html_context dictionary with the value {'html_theme': 'sphinx_rtd_theme'}.
But this setting is not getting overriden by the oslosphinx extension. Overriding it helped to solve the problem.
As a circumvention I currently set the html_context in the conf.py manually to Openstack. This can be removed again once this is fixed.
[1] https://github.com/openstack/networking-dpm |
In our project [1], the oslosphinx theme is used by just importing it as extension. But once Read the docs builds it using sphinx, all bullets of the toctree are not getting rendered. This results in a flat list of headings shown in our table of contents.
The root cause of this is, that RTD extends the existing conf.py file. One thing they do is updating the html_context dictionary with the value {'html_theme': 'sphinx_rtd_theme'}.
But this setting is not getting overwritten by the oslosphinx extension. Overriding it helped to solve the problem.
As a circumvention I currently set the html_theme and html_theme_path in the conf.py manually to 'openstack' and the corresponding path. (To be more precise, you could set it to everything != 'default' - as only then RTD sets the html_theme to rtd...)
[1] https://github.com/openstack/networking-dpm |
|