Sphinx uses plain ReST tables, and from what I can tell, ReST has 4 (yes, 4!) ways of marking up tables:<br><br>Grid tables<br><a href="http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#grid-tables">http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#grid-tables</a><br>
- ASCII-art style tables<br><br>Simple Tables<br><a href="http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#simple-tables">http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#simple-tables</a><br>
- A different style of ASCII-art table, simpler but less powerful than Grid Tables<br><br>CSV Tables<br><a href="http://docutils.sourceforge.net/docs/ref/rst/directives.html#csv-table">http://docutils.sourceforge.net/docs/ref/rst/directives.html#csv-table</a><br>
- data is provided in CSV format in the body of a ReST directive<br><br>List Tables<br><a href="http://docutils.sourceforge.net/docs/ref/rst/directives.html#list-table">http://docutils.sourceforge.net/docs/ref/rst/directives.html#list-table</a><br>
- data is provided as nested lists in the body of a ReST directive<br><br>My question is, what format should the lore2sphinx tool target?<br><br>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.<br>
<br>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.<br>
<br>Kevin Horn<br>