On 2011-02-06, cognacc wrote:
> Hi when i change to using parts in latex
> latex_use_parts = True;
> Then headlines are treated differently.
> when using parts the headline.
>===============
> A Headline
>===============
> is seen as the same level as
> Another Headline
>================
This is a bug.
With latex_use_parts, the hierarchy of headings should not be changed or
merged, only ``\part`` added "at the top".
As ``\chapter`` is not available in "article" like document classes, the
order is as such:
===== ============= ============= ============= =============
Level article report/book article report/book
use-part==True use-part==False
----- --------------------------- ---------------------------
h1 part part section chapter
h2 section chapter subsection section
h3 subsection section subsubsection subsection
h4 subsubsection subsection paragraph subsubsection
h5 paragraph subsubsection subparagraph paragraph
h6 subparagraph paragraph subparagraph subparagraph
≧h7 subparagraph subparagraph subparagraph subparagraph
===== ============= ============= ============= =============
Docutils implements this this way::
def __init__(self, document_class, with_part=False):
self.document_class = document_class
self._with_part = with_part
self.sections = ['section', 'subsection', 'subsubsection',
'paragraph', 'subparagraph']
if self.document_class in ('book', 'memoir', 'report',
'scrbook', 'scrreprt'):
self.sections.insert(0, 'chapter')
if self._with_part:
self.sections.insert(0, 'part')
> Both headlines is seen as parts, meaning i have like 20+ parts
> when i change from using chapters to using parts.
Please report this as a bug in the tracker.
...
> If the behaviour was changed to differ between
>==========
> head
>==========
> and
> subhead
>=======
> There would be much more consistency, also when reading the source.
> As
>============
> Part
>============
> Sticks out from the rest of the chapter / section underlines.
> Just like a **Part** does in the final output from the chapters.
> A suggestion!
You are open to use this as a convention, however the processing of the
section title adornments in reStructuredText is specified in
http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#sections
which states:
Underline-only adornment styles are distinct from
overline-and-underline styles that use the same character.
i.e. the distinction between underlined and over-and-underlined counts
like using a different character and can occure at every section level.
Sphinx should stick to this specification.
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.
