Re: [Docutils-users] Plans for #.#.# list type?

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

Stephan R.A. Deibel wrote:
> Are there any plans that anyone here knows of to recognize lists
> in the following form in reST?
> 
> 1 Top level
>   1.1 Next level
>   1.2 Another item

That's the first entry in the "... Or Not To Do?" list (with a
trailing "."): <http://docutils.sf.net/spec/rst/alternatives.html>::

    Allow for compound enumerators, such as "1.1." or "1.a." or
    "1(a)", to allow for nested enumerated lists without indentation?

It hasn't found a champion or much interest.

> Also, would this be in contradiction with the accepted spec for
> what reST is?

I wouldn't be averse to including it, were a well-implemented patch to
appear.  I'm not interested enough to write it though.

> (BTW, what I'm doing is creating a table of contents on my own
> because I'm dynamically assembling it to span many reST docs and
> possibly other resources that get presented to the user as if they
> were one doc).

Perhaps what you want is the "include" directive, and a master
document::

    =======================
     Master Document Title
    =======================

    .. contents::

    .. include:: part1.txt
    .. include:: part2.txt
    .. include:: part3.txt

This will merge several source files and process them as one.  The
table of contents can now be automatically generated.  Eventually
there will be a mechanism to split up that one large document into
several smaller ones, with navigation in-between (see
<http://docutils.sf.net/spec/notes.html#document-splitting>), but it
hasn't been implemented yet.

-- 
David Goodger  <go...@py...>  Open-source projects:
  - Python Docutils: http://docutils.sourceforge.net/
    (includes reStructuredText: http://docutils.sf.net/rst.html)
  - The Go Tools Project: http://gotools.sourceforge.net/