Re: table notes

David Goodger <[email protected]> Thu, 16 May 2019 21:09:54 -0500
Newsgroups gmane.text.docutils.user
Message-ID <CABiJP=Lh-yTeJTmTLQM8LqV=iuyKjtNLH=uFTvAY9VeFRtVKqQ@mail.gmail.com>
The table directive as implemented doesn't allow for a legend, just a
title. I can't think of why a table would need a legend, and I've
never seen one in the wild.

Note: figures have captions (below), tables have titles (above).
They're not the same thing, and shouldn't be conflated.

David Goodger
<https://david.goodger.org>

On Thu, 16 May 2019 at 16:59, Alan Isaac <[email protected]> wrote:
>
> I'm looking at the documentation at
> http://docutils.sourceforge.net/docs/ref/rst/directives.html#table
> On my reading, it does not allow for the equivalent of the "legend"
> content in a figure.  What am I overlooking?
>
> Thanks, Alan Isaac
>
>
> On 5/16/2019 4:37 PM, David Goodger wrote:
> > That's what the "table" directive is for:
> > http://docutils.sourceforge.net/docs/ref/rst/directives.html#table
> >
> > David Goodger
> > <https://david.goodger.org>
> >
> > On Thu, 16 May 2019 at 15:03, Alan Isaac <[email protected]> wrote:
> >>
> >> In published work, tables and figures often require
> >> explanatory notes.
> >>
> >> In rst there appears to be an odd difference in structure between
> >> tables and figures.  A figure is understood to have three possible
> >> types of content, and image, a caption, and what is called a "legend"
> >> (which can hold explanatory notes).
> >>
> >> A table does not do this, but it could.
> >> Might this be considered as a possible enhancement?
> >>
> >> Thanks, Alan Isaac
> >>
> >>
> >> _______________________________________________
> >> Docutils-users mailing list
> >> [email protected]
> >> https://lists.sourceforge.net/lists/listinfo/docutils-users
> >>
> >> Please use "Reply All" to reply to the list.
>
>
>
> _______________________________________________
> Docutils-users mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/docutils-users
>
> Please use "Reply All" to reply to the list.