From: David G. <go...@py...> - 2002-12-19 02:44:48
|
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/ |