Hi Stefano, Thanks for the hint. I will take a look into this :)
One thing I noticed is that we use ~~~~~ for defining the headings in some manually written docs which is allowed by rST <https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#sections>but isn't mentioned by Sphinx <https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#sections>. This worked in older version of Sphinx not sure if newer versions break this. Will try and replace these with another symbol. Thanks, Anurag On Friday, 27 August 2021 at 03:57:41 UTC-5 Stefano David wrote: > On Thursday, 26 August 2021 at 16:52:36 UTC+2 anurag garg wrote: > >> Hi Sandra, Stefano >> >> Thanks for info. I tried the rstcheck but it had mostly Info and >> Warnings, so I think it should be fine for Sphinx. >> >> So for the error, generally Sphinx has following warnings/info:- >> File-name.rst:2: WARNING: duplicate label rulesummary, other instance in >> File-name.rst >> > You probaly have included a file (fileA.rst) in another one (fileB.rst). > you need to add fileA.rst to the exclude_patterns configuration option of > conf.py > > >> But the case where our docs fails is :- >> >> reST markup error: >> :16: (SEVERE/4) Unexpected section title. >> > You need to make sure that the headings always follow the same pattern, > you can not have for example a third level of heading follow a first level. > > HTH, > Stefano > > -- You received this message because you are subscribed to the Google Groups "sphinx-users" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/sphinx-users/2af3fc84-2590-47eb-bbb1-bebcb47a8577n%40googlegroups.com.
