Bullets of toctree do not get rendered on RTD
Affects | Status | Importance | Assigned to | Milestone | |
---|---|---|---|---|---|
oslosphinx |
Won't Fix
|
Undecided
|
Andreas Scheuring |
Bug 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_
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...)
summary: |
- Bullets and numbering do not get rendered on RTD + Bullets of toctree do not get rendered on RTD |
description: | updated |
Changed in oslosphinx: | |
status: | In Progress → New |
Fix proposed to branch: master /review. openstack. org/434292
Review: https:/