Re: [Docutils-develop] .. table:: directive

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

David Priest wrote:
 > Er, it looks like there is a .. table:: directive (see line 124 of
 > parsers/rst/body.py).
 >
 > What does it do?

That one wasn't documented!  It is now:
<http://docutils.sf.net/spec/rst/directives.html#table>.

 > I'm able to retrieve a list of rows and/or individual cells from the
 > CSV table.  The .. csvtable:: directive will need to return a list
 > of nodes to insert in the tree.  My question is whether I can
 > populate a list of rows/cells and let the existing table-handling
 > code generate the appropriate node structure.  I think I'd make a
 > call to states.py/buildtable() to do that.

Yes, that should work.  See the class docstring of
docutils.parsers.rst.tableparser.GridTableParser for a description of
the data structure that states.Body.build_table() requires.  Your
directive will have to convert the CSV data to that data structure.

 > I'm open to all advice, 'cause I frankly don't understand DocUtils'
 > code at all...

Lucky you!  ;-)

-- 
David Goodger <http://python.net/~goodger>