sphinx-click icon indicating copy to clipboard operation
sphinx-click copied to clipboard

CRITICAL: Unexpected section title or transition.

Open Koen1999 opened this issue 4 months ago • 0 comments

I encounter an issue with this extension, that has been very helpful so far. It throws a critical error when generating the docs. I am using the most recent versions of both Sphinx, and the plugin.

C:\Users\user\suricata-check\docs\cli.rst:27: CRITICAL: Unexpected section title or transition.

```` [docutils]
C:\Users\user\suricata-check\docs\cli.rst:33: CRITICAL: Unexpected section title or transition.

```` [docutils]

The cli.rst file processed by Sphinx looks as follows:

`suricata-check` (CLI)
======================

.. click:: suricata_check:main
   :prog: suricata-check

The referenced Click entrypoint can be found here: https://github.com/Koen1999/suricata-check/blob/455327713f8f8cd4127d771a7d89e17bdbd5a7f8/suricata_check/suricata_check.py#L208-L217

Despite the error, the documentation seems to be rendered (sufficiently to my eye) correct: https://suricata-check.teuwen.net/cli.html

Koen1999 avatar Nov 13 '25 10:11 Koen1999