mirror of
https://github.com/sphinx-doc/sphinx.git
synced 2026-09-03 20:52:55 -05:00
Fix #777: (part II) LaTeX output "too deeply nested"
The standard classes have a severe cap on maximal nesting of list-like environments (a total of six levels, and four for each of enumerate and itemize). This commit defines a new key ``'maxlistdepth'``. _Only_ if it is set (i.e. non-empty) will sphinx.sty do some hack to lift the LaTeX limitations and extend the maximal list depth to the desired value.
This commit is contained in:
@@ -1742,6 +1742,24 @@ These options influence LaTeX output. See further :doc:`latex`.
|
||||
|
||||
* Keys that don't need be overridden unless in special cases are:
|
||||
|
||||
``'maxlistdepth'``
|
||||
For example, setting it to ``'10'`` (as a string) will allow up to 10
|
||||
nested levels of list or quote environments, either numbered or not.
|
||||
The default is to leave this key empty. LaTeX then allows only a
|
||||
maximum of 6 nested levels, and among them at most 4 for numbered and
|
||||
4 for itemized lists.
|
||||
|
||||
.. attention::
|
||||
|
||||
- This setting may likely be incompatible with LaTeX packages
|
||||
modifying lists, or special document classes.
|
||||
|
||||
- The LaTeX package "enumitem" provides its own commands for
|
||||
extending the maximal list depth. If this package is added to the
|
||||
preamble, its commands should be used and ``'maxlistdepth'``
|
||||
left to an empty string.
|
||||
|
||||
.. versionadded:: 1.5
|
||||
``'inputenc'``
|
||||
"inputenc" package inclusion, defaults to
|
||||
``'\\usepackage[utf8]{inputenc}'`` when using pdflatex.
|
||||
|
||||
Reference in New Issue
Block a user