Menu ▾ ▴

#417 Bullets broken in rST on 0.17 with Sphinx (extensions)

None
closed-invalid
nobody
None
2021-06-11
2021-04-07
Robert R
No

When building projects locally or on readthedocs with docutils==0.17 that contain rST with bullets (e.g. *), the bullets are not appearing. They do appear with docutils==0.16.

Discussion

  • Günter Milde

    Günter Milde - 2021-04-07
    • summary: Bullets broken in rST on 0.17 --> Bullets broken in rST on 0.17 with Sphinx (extensions)
    • status: open --> pending-remind
     
  • Günter Milde

    Günter Milde - 2021-04-07

    Thank you for reporting a problem with the new Docutils version.
    Unfortunately, we cannot help without further information.

    Please tell us,

    • whether this is a problem with literal bullet characters or "bullet lists" (ordinary bullet lists or just some special cases?)
    • whether this problem affects all writers or a specific output format (HTML4, HTML5, LaTex, OpenOffice, man pages, XML).
    • whether it is presentational (e.g. <ul> in HTML but no bullets in the browser.²
    • whether it is present in any Sphinx-processed rst or only under special conditions.

    • Bullet-lists¹ work as expected with stock Docutils (rst2html4.py, rst2html5.py, rst2latex.py, ...).

    • Asterisk characters, hyphens and other bullet characters work as expected in any place in the source with stock Docutils.

    ¹ https://docutils.sourceforge.io/docs/user/rst/quickref.html#bullet-lists

    ² There are some changes in the HTML5 stylesheets which might interfere with custom styles or CSS or templating frameworks.

     
  • Robert R

    Robert R - 2021-04-08

    Thank you. Digging deeper, the HTML is fine and it turns out there is a styling issue for us where the following style now has a higher priority:

    li {
        list-style: none
    }
    

    Since we are using outdated theme code, I am going to assume this is our own issue for now.

    Thank you again for pointing me in the right direction. I think you can close this ticket.

     
  • Günter Milde

    Günter Milde - 2021-04-08
    • status: pending-remind --> closed-invalid
     
  • Ned Batchelder

    Ned Batchelder - 2021-06-11

    I think this is due to <div class="section"> changing to <section>. Our theme used ".section".

     

    Last edit: Ned Batchelder 2021-06-11

Log in to post a comment.