Opened 15 years ago

Closed 15 years ago

#10707 closed (wontfix)

Sphinx & LaTeX: too many nesting section levels for LaTeX

Reported by: kgrandis Owned by: nobody
Component: Documentation Version: 1.0
Severity: Keywords: sphinx docs
Cc: Triage Stage: Unreviewed
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description

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

Attachments (1)

10707-latex-doc-depth-level-workaround.diff (625 bytes ) - added by Ramiro Morales 15 years ago.

Download all attachments as: .zip

Change History (6)

comment:1 by kgrandis, 15 years ago

Summary: Sphinix & LaTeX: too many nesting section levels for LaTeXSphinx & LaTeX: too many nesting section levels for LaTeX

by Ramiro Morales, 15 years ago

comment:2 by Ramiro Morales, 15 years ago

Has patch: set

comment:3 by Ramiro Morales, 15 years ago

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

in reply to:  3 comment:4 by Ramiro Morales, 15 years ago

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?

comment:5 by Alex Gaynor, 15 years ago

Resolution: wontfix
Status: newclosed

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

Note: See TracTickets for help on using tickets.
Back to Top