Re: [Docutils-develop] Re: r3188 - trunk/docutils/docs/dev/todo.txt

[Aahz <aa...@py...>]

On Fri, Apr 08, 2005, Felix Wiemann wrote:
>
> When, one year ago, I asked why I couldn't put a section into a table,
> you correctly guessed that I was trying to create a web page and you
> wrote that "Docutils only does simple, linear documents," and that I
> should use something like ht2html.
> 
> At that time I wondered what's the point in prohibiting sections inside
> tables, but later I realized that it's indeed a good idea to have only
> things inside a document tree which make sense for *documents*.  A
> navigation bar is not part of a document but of a web page, so it's not
> Docutils' job to support it.  I.e., neither the document model nor the
> reST parser should have a concept of a "navigation bar".

There's a gray area here: what about PDF documents?  I think that to the
extent that navigation is part of documents (e.g. ToC, index, references
to code/images) or even sets of documents (consider a separate User Guide
and Reference), Docutils should potentially support it.
-- 
Aahz (aa...@py...)           <*>         http://www.pythoncraft.com/

"The joy of coding Python should be in seeing short, concise, readable
classes that express a lot of action in a small amount of clear code -- 
not in reams of trivial code that bores the reader to death."  --GvR