Sphinx & LaTeX: too many nesting section levels for LaTeX

[kgrandis]

Using Sphinx v0.6.1,

make latex

results in the following error:

...
Markup is unsupported in LaTeX:
ref/contrib/admin/actions:: too many nesting section levels for LaTeX, at heading: Writing action functions
make: *** [latex] Error 1

affected file: docs/ref/contrib/admin/actions.txt : "Writing action functions"

Sphinx issue: ​http://bitbucket.org/birkenfeld/sphinx/issue/125/latex-cannot-cope-with-3-nested-section
this was flagged as wontfix since it is due to LaTeX only allowing up to \subsubsection

[Ramiro Morales]

Seems like ​this change in Sphinx would also solve this by automatically converting the levels with a depth over the LaTeX limitation to the "subparagraph" style instead of raising an exception. It will be included in Sphinx >= 0.6.2

[Ramiro Morales]

Replying to ramiro:

Seems like ​this change in Sphinx would also solve this by automatically converting the levels with a depth over the LaTeX limitation to the "subparagraph" style instead of raising an exception. It will be included in Sphinx >= 0.6.2

A follow-up: After r11162 (and r11165 for 1.0.x) this problem can be worked around by using Sphinx 0.6.2 (current stable release) without having to modify our docs at all. Just tested and verified this here.

A while back Jacob expressed on IRC he would be OK with making Sphinx 0.5 a requirement for building the Django docs. Perhaps we can raise that to 0.6.2 at some point?

[Alex Gaynor]

Since ramiro has said it's fixed in Sphinx 0.6.2 closing as it's not our problem.