Bullets of toctree do not get rendered on RTD

Bug #1664976 reported by Andreas Scheuring
6
This bug affects 1 person
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_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

summary: - Bullets and numbering do not get rendered on RTD
+ Bullets of toctree do not get rendered on RTD
description: updated
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix proposed to oslosphinx (master)

Fix proposed to branch: master
Review: https://review.openstack.org/434292

Changed in oslosphinx:
assignee: nobody → Andreas Scheuring (andreas-scheuring)
status: New → In Progress
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Change abandoned on oslosphinx (master)

Change abandoned by Andreas Scheuring (<email address hidden>) on branch: master
Review: https://review.openstack.org/434292
Reason: will not follow up oslosphinx on RTD for now

Changed in oslosphinx:
status: In Progress → New
Revision history for this message
Doug Hellmann (doug-hellmann) wrote :

Closing all open bugs now that the library is deprecated and no longer supported.

Changed in oslosphinx:
status: New → Won't Fix
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.