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:
jfbu
2016-10-26 10:30:52 +02:00
parent a2672ce11b
commit 3af9353b38
4 changed files with 105 additions and 8 deletions
+18
View File
@@ -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.