On 2009-06-15, Georg Brandl wrote:
> Timmie schrieb:

>> when running make all-pdf in the build/latex direcory I get an error
>> saying:

>> too deeply nested.

>> I do not understand this as latext supports nesting down to the
>> paragraph level.

>> Where can I improve?

Add levels on top: 

* Use a document class that supports chapters.

* Make sure there is a title (and subtitle) transform in sphinx, so that
  with::

    Title
    =====

    Subtitle
    ********
    
    Top section
    -----------
    
    Next top section
    ----------------

  you get something like this excerpt from the translation with the
  newest version of Docutils latex2e writer::
  
    ...
    
    %%% Title metadata
    \title{Title%
      \phantomsection%
      \label{title}}
      \\ % subtitle%
      \large{Subtitle}%
      \label{subtitle}
    }
    \author{}
    \date{}
    
    %%% Body
    \begin{document}
    \maketitle

    \chapter{Top section%
      \label{top-section}%
    }
    
    ...    


* Use \part for one more top level.

 (Docutils supports this with

    --use-part-section      Add parts on top of the section hierarchy.
  Ask for the Sphinx counterpart.)

> Keep in mind that section numbers are not assigned per source file,
> but once for the whole latex file that is generated by Sphinx.  So if
> you have further headings in the files that include that one by toctree,
> it will count as well.

> That said, the trunk version won't run out of sectionlevels anymore,
> but simply reuse the lowest one.

Keep in mind that if you dont set "use-latex-toc", the toc is translated
into a nested bullet list - LaTeX only supports n levels::

   Too deeply nested lists fail. TODO: generate an error or provide a
   workaround.
   
   * * * * * * * * Deeply nested list.
   
   1. 2. 3. 4. 5. 6. 7. 8. Deeply nested list.


TODO: determine the value of n.

Günter


--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"sphinx-dev" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to 
[email protected]
For more options, visit this group at 
http://groups.google.com/group/sphinx-dev?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to