Re: [Docutils-users] Heading in table

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

Felix Wiemann wrote:
 > What is the reason for headings not being allowed in tables?
 > Sometimes it would just be handy.

Headings are indicators of section structure.  The document model that
Docutils uses doesn't allow sections inside tables or inside any other
body elements.  That's because documents may contain sections, and
sections may contain further sections, but once you get into body
elements (non-structural elements), further sections don't make sense.

The HTML document model does allow such combinations, but I claim
that's because HTML's document model is insane.

If you need the odd non-structural heading in a table or anywhere
else, you can use the "rubric" directive.

Here's the table you gave as an example:

 > +--------------------+--------------------+
 > | this is a          | Heading            |
 > | navigation         | =======            |
 > | bar or             |                    |
 > | something          | This is the        |
 > | similar            | document's body.   |
 > +--------------------+--------------------+

It looks to me like you're trying to describe a web page.  Docutils
only does simple, linear documents.  To do something like what you
want, you need to wrap Docutils with something else, like ht2html.

-- David Goodger