Opened 10 years ago

Closed 10 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 10 years ago.

Download all attachments as: .zip

Change History (6)

comment:1 Changed 10 years ago by kgrandis

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

Changed 10 years ago by Ramiro Morales

comment:2 Changed 10 years ago by Ramiro Morales

Has patch: set

comment:3 Changed 10 years ago by 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

comment:4 in reply to:  3 Changed 10 years ago by 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?

comment:5 Changed 10 years ago by Alex Gaynor

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