Re: table notes

Alan Isaac <[email protected]> Mon, 20 May 2019 08:55:21 -0400
Newsgroups gmane.text.docutils.user
Message-ID <[email protected]>
Thinking this through a bit more, I realize I have a more fundamental
design question.  As I struggle with the `table` directive, it seems
that it behaves quite a bit differently than I would like, and that
would I would find more useful would be something like the following:
a table directive that is basically a container with a class, except
that it accepts a title as an argument.

With this perspective, I would then like to be able to
add arbitrary content in the container.  One type of
content would be a normal reST table.  Another type
of content would be a `note` directive.  Etc.  This
gets closer to the idea that a "table" environment is
just a (usually numbered) environment that contains content
that should be kept together (e.g., tabular content,
source notes, other notes, etc).  This notion of a table
environment would be close to the LaTeX approach.

Additionally, from this perpsective, the `csv-table` directive
has conflated two things: the desire for a "table environment",
and the desire to input tabular data in a certain format.

Cheers, Alan