Re: [Docutils-users] Subtitle issue

[David G. <go...@py...>]

Patrick K. O'Brien wrote:
>>> I noticed that including a subtitle changes how the TOC is determined
>>> using the html writer.
...
> It turned out that the sample did work fine, so I sent David the full file.

I tried the full file just now, and I see the problem.  It's very simple.
The table of contents gives a clue (note the nesting):

    * Using Python As An Authoring Tool

      * Introduction
      * reStructuredText

    * Creating a custom writer for dW tutorials

Here's the document subtitle::

    Using Python As An Authoring Tool
    ---------------------------------

And here's the last section title::

    Creating a custom writer for dW tutorials
    -----------------------------------------

They both use the same title adornment style -- dash underlines.  Therefore
the parser places them at the same section level, as evidenced by the TOC
above.  The solution is to use a different -- and unique -- adornment style
for the document subtitle.  You could add a dash overline::

    -----------------------------------
     Using Python As An Authoring Tool
    -----------------------------------

One nit: it's spelled "Docutils", not "DocUtils" (no StudlyCaps).

BTW, the first two sections, "Introduction" and "reStructuredText", are an
excellent introduction to the markup.  It's good to see a fresh approach --
I'm too close to the project to write objectively.  I take it that this is
the article you mentioned last month.  Is it intended for publication
somewhere?  Either way, can we use it in the Docutils project once you're
done?  It would make a great "techie summary" if not an "executive summary".

-- David Goodger    http://starship.python.net/~goodger

Programmer/sysadmin for hire: http://starship.python.net/~goodger/cv