Changes

ConTeXt has a whole bunch of possibilities to typeset tables. Not each provides everything [[#Features|Features]] you may need, and the older ones are deprecated.

* [[tabulateFloating_Objects|Floating objects]] (tabulation)* [[table]] (TaBlE)* [[tables]] (multipage TaBlE)* [[TABLE]] (natural enable to place and number tables, HTML tables)* [[linetable]] (new multipage tables)like graphics.

Features:{{TwoColumnsUnderLevel1|== Recommended ==* [[Tabulate]] (tabulation, '''recommended for simple requirements''')* [[TABLE]] (natural tables, HTML tables, '''recommended''')* [[xtables]] (extreme tables – mostly compatible to natural tables, better for page breaking)* framed tables (for simple tables that span hundreds of pages)|== Deprecated ==* [[Table]] (TaBlE, '''deprecated''')* [[Tables]] (multipage TaBlE, '''deprecated''') == Experimental ==* [[Linetable]] ("new" multipage tables, '''experimental''' and probably obsolete)}}  Note that you can use natural and extreme tables with the old Table/Tabulate syntax. (To make this even more confusing...)<table><tr>If you have simple tables with lots of contents, and you're tired of typing <thcode>Feature\bTR\bTD</thcode>s or <thcode>tabulate\NC\NR</thcode>s, you can also have a look at:* [[M-database|database]] module and its [http://dl.contextgarden.net/myway/csv.pdf manual].* [[Wikitable]], a TABLE wrapper that uses MediaWiki syntax* [http://tug.org/TUGboat/Articles/tb28-3/tb90mahajan.pdf ConTeXt basics for users: Table macros] and [http://www.tug.org/TUGboat/Articles/tb29-1/tb91mahajan.pdf Table macros II] by Aditya Mahajan (2007 and 2008). = Features =<thtable style="border:1px solid #DDDDDD; width:100%" align="left" valign="top">table</thtr style="background-color:#DDDDDD" align="left" valign="top"><th>tablesFeature</th><th>TABLE[[Tabulate]]</th><th>linetable[[Table]]/[[Tables]]</th></trth><tr><td>horizonal lines[[TABLE]]</tdth><tdth>[[xtables]]</tdth><tdth>[[Linetable]]</tdth><tdth>[[framedtable]]</td><td></td><td></tdth></tr> <tralign="left" valign="top"><tdth style="background-color:#DDDDDD">vertical horizonal lines</tdth><td>{{cmd|HL}}</td><td>{{cmd|HL}}</td><td></td><tdtexcode>\setupTABLE[topframe=on]or\setupTABLE[bottomframe=on]</td><tdtexcode></td></tr><tr><td>multipage</td><tdtexcode>\setupxtable[...]</td><tdtexcode></td><td>yes</td><td>split=yesunknown</td><td>yes</td></tr> <tralign="left" valign="top" style="background-color:#EEEEEE;"><tdth style="background-color:#DDDDDD">header for each pagevertical lines</tdth><td>{{cmd|VL}}</td><td>{{cmd|VL}}</td><td></td><tdtexcode>\setupTABLE[leftframe=on]or\setupTABLE[rightframe=on]</td><tdtexcode></td></tr><tr><td>footer for each page</td><tdtexcode>\setupxtable[...]</td><td></td><tdtexcode></td><td>unknown</td><td>yes</td></tr> <tralign="left" valign="top"><tdth style="background-color:#DDDDDD">multipage</tdth><td>yes</td><td><no /td><td>yes (tables)</td><td>yes, with </td><tdtt>split=yes</tdtt>or </tr><tr><tdtt>split=repeat</td><td></td><tdtt></td><td>vertically yes, horizontally not but planned</td><td>yes, even horizontally</td><td>yes</td></tr> <tralign="left" valign="top" style="background-color:#EEEEEE;"><tdth style="background-color:#DDDDDD">repeated header</tdth><td></td><tdtexcode>\setuptabulate[header=repeat]\starttabulatehead...\stoptabulatehead</td><tdtexcode>only one line</td><td>table</td><tdb>s</tdb>only:</tr><trtexcode><td>\setuptables [split=repeat] \starttablehead...\stoptablehead</td><tdtexcode></td><td></td><td></td><td></td><td></tdtexcode></tr><tr>\bTABLE[split=repeat]\bTABLEhead...\eTABLEhead<td></td><td></td><tdtexcode></td><td>yes</td><td>yes</td><td>yes</td></tr> <tralign="left" valign="top"><tdth style="background-color:#DDDDDD">repeated footer</tdth><td>no</td><td>table</td><tdb>s</tdb>only:<td></td><td></tdtexcode></tr><tr>\setuptables [split=repeat] \starttabletail...\stoptabletail<td></td><tdtexcode></td><td>no?</td><td>yes</td><td>no</td><td>unknown</td></tr> <tralign="left" valign="top" style="background-color:#EEEEEE;"><tdth style="background-color:#DDDDDD">automatic fitting to given table width</tdth><td>no</td><td>{{cmd|SetTableToWidth}}</td><td></td><td></td><td></tdtexcode></tr><tr>\setupTABLE[option=stretch, textwidth=10cm]<td></td><td></td><tdtexcode></td><td>yes</td><td>default</td><td>unknown</td></tr> <tralign="left" valign="top"><tdth style="background-color:#DDDDDD">problems</tdth><td>very limited</td><td>some limitations, problems with spacing</td><td></td><td></td><td></tdtexcode></tr><tr>\starttext\starttablehead \HL\stoptablehead\starttables[|l|l|]\dorecurse{50}{% \VL SomeText \VL SomeText \VL \AR}\stoptablesProblem: top margin onfirst page is bigger.\stoptext<td></td><tdtexcode></td><td>there may be problems in width and height calculation and perhaps the multipage features</td><td>very verbose</td><td>lack of documentation, just experimental</td><td>limitations, lack of documentation</td></tr> <tr!-- Tabulate Table(s) TABLE xtable linetable framedtable --><tdtr align="left" valign="top" style="background-color:#EEEEEE;"></td><tdth style="background-color:#DDDDDD">documentation (except wiki)</tdth><td><[http:/td><td></td><td><pmrb.free.fr/td><td><contextref.pdf contextref.pdf], [[source:tabl-tbl.mkii|tabl-tbl.mkii]], [http:/td></tr><tr><td><www.ntg.nl/td><td><maps/td><td><pdf/td><td>22_28.pdf MAPS article]</td><td>[[manual:mp-cb-en.pdf|ms-cb-en.pdf]], [[source:tabl-tab.mkii|tabl-tab.mkii]]</td><td><[[manual:enattab.pdf|enattab.pdf]], [http:/td></tr><tr><td><dl.contextgarden.net/td><td><myway/td><td><NaturalTables.pdf NaturalTables.pdf], [[source:tabl-ntb.mkii|tabl-ntb.mkii]] /td><td>[[source:tabl-ntb.mkiv|tabl-ntb.mkiv]]</td><td><[http:/td><td></td><www.pragma-ade.nl/tr><tr><td><general/td><td><manuals/td><td>xtables-mkiv.pdf xtables-mkiv.pdf], [[source:tabl-xtb.lua|tabl-xtb.lua]]</td><td><[[source:tabl-ltb.mkii|tabl-ltb.mkii]] /td><td>[[source:tabl-ltb.mkiv|tabl-ltb.mkiv]]</td><td>?</td></tr></table>  [[Category:Tables]]