[Twisted-Python] lore2sphinx table handling?
kevin.horn at gmail.com
Mon Jan 4 19:08:17 EST 2010
Sphinx uses plain ReST tables, and from what I can tell, ReST has 4 (yes,
4!) ways of marking up tables:
- ASCII-art style tables
- A different style of ASCII-art table, simpler but less powerful than Grid
- data is provided in CSV format in the body of a ReST directive
- data is provided as nested lists in the body of a ReST directive
My question is, what format should the lore2sphinx tool target?
Any of these formats should work fine, but I'm curious as to what people (in
particular the core devs) think as to which should be the preferred method
in the Sphinx documentation.
Keep in mind that there are only 2 tables in all of the Twisted docs, and
one of them is in the documentation for Lore, which (hopefully!) should be
going away once this project is completed. So it's not like it would be a
whole lot of work to change the preferred format later.
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the Twisted-Python