From: Andrey V S. <cro...@cr...> - 2007-04-12 09:34:25
|
Hi folks, I've got another (unexpected) problem. The rst2latex.py program handles deep sectioning in a way I think is weird. In case the sectioning depth of the document is more that 3 for the article class, or 4 for the report class, all the headers deeper than that (the subsubsection level in either case) just silently made subsubsections. I even didn't notice this for a long period. The funny thing is that there's no such problem with rst2html.py. Is there a way to fix this somehow? In LaTeX, there are also 'paragraph' and 'subparagraph' headers, and if the depth doesn't fit even them, I believe there must be at least a warning, and the header definitely shouldn't become the one of the previous level, as it ruins the logical structure of the document (hmmm... may be it should just become a part of text). -- Cheers, Andrey "Croco" Stolyarov |
From: G. M. <mi...@us...> - 2007-04-13 09:23:08
|
On 12.04.07, Andrey V Stolyarov wrote: > I've got another (unexpected) problem. The rst2latex.py program > handles deep sectioning in a way I think is weird. In case the > sectioning depth of the document is more that 3 for the article > class, or 4 for the report class, all the headers deeper than > that (the subsubsection level in either case) just silently made > subsubsections. I even didn't notice this for a long period. The problem is that rst syntax support 33 section levels but the output format typically supports less than that. I remember that this restriction is mentioned somewhere in the documentation (however, not in http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#sections) > The funny thing is that there's no such problem with rst2html.py. It is somewhat similar but occures later as HTML provides 6 levels (<h1> ... <h6>). Actually, the html writer produces <h7>, <h8>, ... headers which * preserve the structure information in the html document * are (as invalid elements) typically rendered as normal text. (I wonder if they could be styled by a stylesheet.) ... > and if the depth doesn't fit even them, I believe there must be at > least a warning Seconded. Guenter |
From: Andrey V S. <cro...@cr...> - 2007-04-13 15:38:16
|
On Fri, 13 Apr 2007, G. Milde wrote: > On 12.04.07, Andrey V Stolyarov wrote: > > > I've got another (unexpected) problem. The rst2latex.py program > > handles deep sectioning in a way I think is weird. In case the > > sectioning depth of the document is more that 3 for the article > > class, or 4 for the report class, all the headers deeper than > > that (the subsubsection level in either case) just silently made > > subsubsections. I even didn't notice this for a long period. > > The problem is that rst syntax support 33 section levels but the output > format typically supports less than that. I remember that this > restriction is mentioned somewhere in the documentation (however, not in > http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#sections) Well this sounds reasonable, but LaTeX provides, depending on the document class, 5 to 6 levels (not counting the "Part" level which is optional and not always applicable): there are always "section", "subsection", "subsubsection", "paragraph" and "subparagraph", and in case of "book" or "report" classes there's also "chapter". It seems that rst2latex.py just doesn't know that there are these "paragraph" and "subparagraph". > Guenter Thank you! -- Croco |
From: <gr...@us...> - 2007-04-13 21:35:59
|
On Fri, 13 Apr 2007, Andrey V Stolyarov wrote: > > On Fri, 13 Apr 2007, G. Milde wrote: > >> On 12.04.07, Andrey V Stolyarov wrote: >> >>> I've got another (unexpected) problem. The rst2latex.py program >>> handles deep sectioning in a way I think is weird. In case the >>> sectioning depth of the document is more that 3 for the article >>> class, or 4 for the report class, all the headers deeper than >>> that (the subsubsection level in either case) just silently made >>> subsubsections. I even didn't notice this for a long period. >> >> The problem is that rst syntax support 33 section levels but the output >> format typically supports less than that. I remember that this >> restriction is mentioned somewhere in the documentation (however, not in >> http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#sections) > > Well this sounds reasonable, but LaTeX provides, depending on the > document class, 5 to 6 levels (not counting the "Part" level > which is optional and not always applicable): there are always > "section", "subsection", "subsubsection", "paragraph" and > "subparagraph", and in case of "book" or "report" classes there's > also "chapter". It seems that rst2latex.py just doesn't know > that there are these "paragraph" and "subparagraph". subparagraph just does not sound reasonable for a section heading, but maybe i got something wrong here. (33 levels ?!) -- |
From: Andrey V S. <cro...@cr...> - 2007-04-14 03:02:11
|
On Fri, 13 Apr 2007 gr...@us... wrote: > On Fri, 13 Apr 2007, Andrey V Stolyarov wrote: > > > Well this sounds reasonable, but LaTeX provides, depending on the > > document class, 5 to 6 levels (not counting the "Part" level > > which is optional and not always applicable): there are always > > "section", "subsection", "subsubsection", "paragraph" and > > "subparagraph", and in case of "book" or "report" classes there's > > also "chapter". It seems that rst2latex.py just doesn't know > > that there are these "paragraph" and "subparagraph". > > subparagraph just does not sound reasonable for a section heading, > but maybe i got something wrong here. (33 levels ?!) Oh, this is not about section heading, this is about inadequate terminology (thanks Leslie Lamport, yeah :) Anyway, this might sound reasonable or not, but LaTeX _does_ support these levels, and they look reasonably ("paragraph" looks like any other section heading, and "subparagraph" is placed as a bolded text in the beginning of a plain paragraph). They both can be numbered (if we do ``\setcounter{secnumdepth}{5}``) and/or reflected in the table of contents (``\setcounter{tocdepth}{5}``). Some documents, such as texts of official standards, even do need such (numbered) sectioning. -- Croco |
From: <gr...@us...> - 2007-04-14 17:20:37
|
On Sat, 14 Apr 2007, Andrey V Stolyarov wrote: > > On Fri, 13 Apr 2007 gr...@us... wrote: > >> On Fri, 13 Apr 2007, Andrey V Stolyarov wrote: >> >>> Well this sounds reasonable, but LaTeX provides, depending on the >>> document class, 5 to 6 levels (not counting the "Part" level >>> which is optional and not always applicable): there are always >>> "section", "subsection", "subsubsection", "paragraph" and >>> "subparagraph", and in case of "book" or "report" classes there's >>> also "chapter". It seems that rst2latex.py just doesn't know >>> that there are these "paragraph" and "subparagraph". >> >> subparagraph just does not sound reasonable for a section heading, >> but maybe i got something wrong here. (33 levels ?!) > > Oh, this is not about section heading, this is about inadequate > terminology (thanks Leslie Lamport, yeah :) Anyway, this might > sound reasonable or not, but LaTeX _does_ support these levels, > and they look reasonably ("paragraph" looks like any other > section heading, and "subparagraph" is placed as a bolded text in > the beginning of a plain paragraph). They both can be numbered > (if we do ``\setcounter{secnumdepth}{5}``) and/or reflected in > the table of contents (``\setcounter{tocdepth}{5}``). Some > documents, such as texts of official standards, even do need such > (numbered) sectioning. svn version should be down to subpargraph. cheers -- |
From: G. M. <mi...@us...> - 2007-04-17 06:55:46
|
On 14.04.07, gr...@us... wrote: > On Sat, 14 Apr 2007, Andrey V Stolyarov wrote: > > On Fri, 13 Apr 2007 gr...@us... wrote: > >>> ... It seems that rst2latex.py just doesn't know that there are > >>> these "paragraph" and "subparagraph". > >> > >> subparagraph just does not sound reasonable for a section heading, > >> but maybe i got something wrong here. (33 levels ?!) The reStructuredText Markup Specification http://docutils.sf.net/docs/ref/rst/restructuredtext.html#sections says: Sections are identified through their titles, which are marked up with adornment: "underlines" [...] The following are all valid section title adornment characters: ! " # $ % & ' ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _ ` { | } ~ I counted them wrong, its "only" 32 characters. However, the doc says also Underline-only adornment styles are distinct from overline-and-underline styles that use the same character. so you can write an rst document with up to *64* section levels. There may be any number of levels of section titles, although some output formats may have limits (HTML has 6 levels). The question is what a docutils writer should do if it encounters this limit of the output format: * output some suitable format (IMO html should use <div> and a class instead of <h7> ... <h64>) (LaTeX could possibly define \newcommand-s if required or convert non-supported section titles to text) * issue a message | warning | error? > svn version should be down to subpargraph. This is good news, thanks. Guenter |