Changes

This {{cmd|starttabulate}} is especially suited if you want to have a versatile table environment.It supports ''paragraphs '' in one cells, ''vertical rules'' (or moreforthose typographically less demanding jobs …) , and''colorization'' of those rules, the tabulate columnsbackground of fields as wellas the text itself.

'''Warning''': When you want to use tables with macros use {{cmd|starttable}} and \stoptable. {{cmd|starttabulate}} and \stoptabulate does not work correctly with macros. =Basic commands= The sample describes control sequence {{cmd|starttabulate|[#1]}} takes a layoutstring as optional argument.As is common with tables in TeX-based typesetting, this string(in its basic variant) consists primarily of the ''bar''character (“<tt>|</tt>”) as delimiter for columns,and of the letters <tt>c</tt>, <tt>l</tt>, as well as <tt>r</tt>,denoting the ''alignment'' within cells of this row. For instance consider a two-column table: if any text in thefirst column should be right aligned (''real''[[Right and left|<tt>flushright</tt>]]) and the second columnleft aligned, the formatting characterscorresponding format string would be<tt>|l|r|</tt>.''NB'':those bars, as stated above, denote cell limits only&ndash; ''not'' vertical lines. <!-- - wtf this listing was full of <tab> chars‽ Was this supposed - to be a bad pun on *tabulate*? - - No, I formatted it readably in my text editor. --HR-->{| ! width="55%"| ! width="10%"| ! width="35%"| |- | <texcode>\starttabulate[|r|l|lB|]\HL\NC {\bf format} \NC {\bf meaning} \NC Mk \NC\NR\HL\NC c \NC centered \NC \NC\NR\NC l \NC left aligned \NC \NC\NR\NC r \NC right aligned \NC \NC\NR\NC w(1cm) \NC one line, fixed width \NC \NC\NR\NC p(2cm) \NC paragraph, lines broken to fixed width \NC \NC\NR\NC cg(.) \NC align on a character \NC IV: cg{.} \NC\NR\NC m \NC math mode \NC IV only \NC\NR\NC b \NC before e.g. b{\star} \NC IV only \NC\NR\NC a \NC after, e.g. a{\percent} \NC IV only \NC\NR\HL\stoptabulate</texcode>||<context>\setuppapersize[A5]\starttabulate[|r|l|lB|]

\NC {\bf format } \NC {\bf meaning }\NC Mk \NC\NR

\NC c \NC centered \NC\NR\NC l \NC left aligned \NC\NR\NC r \NC right aligned \NC\NR\NC w(1cm) \NC one line, fixed width \NC\NR\NC p(2cm) \NC paragraph, lines broken to fixed width \NC\NR% You can leave out the \NC before cg(.) \NC align on a character \NC\NR

\startplacetable[location=force,number=no] \starttabulate[|r|l|] \HL \NC I want this table \NC aligned in the center.\NC\NR \HL \stoptabulate\stopplacetable</context> =Spanning Multiple Pages= Tabulate may extend to adjacient pages if needed.To achieve this the argument <tt>split</tt> must be set to''true''. ''NB'': the difference between setting and unsetting thisargument may not be visible on the first few pages. Rather, itseems to affect the ''end'' of the environment. <context source=yes>\setuppapersize[A10, landscape][A8, landscape]\setuppaper[nx=2,ny=2]\setuparranging[XY] \switchtobodyfont[5pt]\setuppagenumbering[location={header,inright}]\showframe[edge] \setuptabulate [split=yes, header=text, title={\color[red] Fenchurch St. Paul}, frame=on] \starttabulate[|p(1.2cm)|p(1.2cm)|]\dorecurse{6}{ \NC Bells: \NC Tin tan din dan bim bam bom bo \NC\NR \HL \NC Name: \NC Tailor Paul \NC \NR \HL}\stoptabulate</context>  ==Titles== A tabulating environment can have an optional name which will berepeated above at every page break that occurs inside the table.This name needs to be specified as the argument of the<tt>title</tt> key of {{cmd|setuptabulate}}.The <tt>header</tt> key has to be set to <em>text</em> for thisto work. <context source=yes>\setuppapersize[A10, landscape][A8, landscape]\setuppaper[nx=2,ny=2]\setuparranging[XY] \switchtobodyfont[5pt]\setuppagenumbering[location={header,inright}]\showframe[edge] \setuptabulate [split=yes, header=text, title={\color[red] Fenchurch St. Paul}, frame=on] \starttabulate[|p(1.2cm)|p(1.2cm)|]\dorecurse{6}{ \NC Bells: \NC Tin tan din dan bim bam bom bo \NC\NR \HL \NC Name: \NC Tailor Paul \NC \NR \HL}\stoptabulate</context> <!-- - ==Headers and Footers== - As I couldn’t get footers running I just comment this and - leave it to whoever discovers the trick to activate them. - (The <tt>footer=</tt> key seems to be implemented for - “\setuptabulate” but I couldn’t notice any effect.--> ==Headers==Tabulate supports header rows that can be repeated over new tablepages instead of the title.There is a separate environment {{cmd|starttabulatehead}} wherethis header row has to be specified in advance of its use in atabulation. In ConTeXt MkIV the command requires an additional [], thus you needto write {{cmd|starttabulatehead}}[] instead. {| ! width="55%"| ! width="10%"| ! width="35%"| |- | <texcode>\setuptabulate[split=yes,header=repeat] \starttabulatehead \FL \NC {\bf format char} \NC {\bf meaning} \NC \AR \LL\stoptabulatehead \starttabulate[|r|l|] \NC c \NC centered \NC \AR \NC l \NC left aligned \NC \AR \NC r \NC right aligned \NC \AR\stoptabulate</texcode>|| <context>\setuppapersize[A5] \setuptabulate[split=yes,header=repeat] \starttabulatehead \FL \NC {\bf format char} \NC {\bf meaning} \AR \LL\stoptabulatehead \starttabulate[|r|l|] \NC c \NC centered \AR \NC l \NC left aligned \AR \NC r \NC right aligned \AR\stoptabulate</context>|} Note the use of <tt>\FL</tt> and <tt>\LL</tt> in the tabulate header rather than <tt>\HL</tt> which is a standard rule command (see below) that tries to guess automatically its position. =Individualizing the Tabulate Look= Hans initially announced support for vertical lines and colors onthe mailing list. [http://archive.contextgarden.net/message/20101117.123950.739657a7.en.html] ==Rules== ===Horizontal Rules=== As already demonstrated above, the <tt>\HL</tt> statement insertsa hairline after the current line.This particularly useful when demarking header and footer rows orseparated parts of a table that should not be as closelyassociated as the rows between the rules. {| ! width="55%"| ! width="10%"| ! width="35%"| |- | <texcode>\starttabulate[|r|c|l|] \NC test \NC test \NC test \NC\NR \HL\NC test \NC test \NC test \NC\NR \NC test \NC test \NC test \NC\NR \HL\NC test \NC test \NC test \NC\NR \HL\stoptabulate</texcode>| <context>\starttabulate[|r|c|l|]\NC test \NC test \NC test \NC\NR

\NC format test \NC meaning test \NC test \NC\NR \NC test \NC test \NC test \NC\NR

\NC c test \NC centered test \NC\NR\NC l \NC left aligned \NC\NR\NC r \NC right aligned \NC\NR\NC w(1cm) \NC one line, fixed width \NC\NR\NC p(2cm) \NC paragraph, lines broken to fixed width \NC\NR% You can leave out the test \NC before \NR

\starttabulate[|r|c|l|] \FL \NC first row \NC test \NC test \NC\NR \ML \NC rows in \NC test \NC test \NC\NR \NC between \NC test \NC test \NC\NR \LL \NC last row \NC test \NC test \NC\NR \BL\stoptabulate</texcode> Other types can be discovered in the source([[source:tabl-tbl.mkiv|tabl-tbl.mkiv]]). == Column Spans =Vertical Rules=== The {{cmd|VL}} command serves as a replacement for {{cmd|NC}}to mark a cell border wherever a vertical rule may be desired (ifthey are to be desired at all from a typographical point ofview). <texcode>\starttabulate[||||] \NC test \VL test \VL test \VL\NR \VL test \NC test \VL test \VL\NR \VL test \VL test \NC test \VL\NR \VL test \VL test \VL test \NC\NR \stoptabulate</texcode> ==Coloring== The following elements can be colorized: rules, cell backgrounds,and, obviously, common text. ===Colorizing Rules=== For ''horizontal rules'' see above. For ''vertical rules'', {{cmd|VL}} takes a defined color as anoptional argument. <texcode>\starttabulate[|r|c|l|] \VL test \VL[red] red rule \VL test \VL \NR \VL test \VL[green] green rule \VL test \VL \NR \VL test \VL[blue] blue rule \VL test \VL \NR \stoptabulate</texcode>

Tabulate has no support for ===Colorizing Backgrounds & Text===Backgrounds and text can be colorized either on column spans but you could add this function yourselfbasis orindividually by cell.

The code There are five color-specific control sequences:{||{{cmd|CR}} || color is applied to the background of the text and the remaining space on the right.|-|{{cmd|CC}} || color is applied to the background of the text only.|-|{{cmd|CM}} || color is applied to do this depends the background of the text and the remaining space on both sides.|-|{{cmd|CL}} || color is applied to the tabulate setting background of the text and you the remaining space on the left.|-|{{cmd|CT}} || color is applied to the text itself - in other words, the "foreground color."|}These are to complement the normal table layout expression (thefirst argument to {{cmd|starttabulate}.Thus, in order to colorize a four column table with the initiallayout <tt>|c|c|c|c|</tt> it will have to know whatbe modified as follows:<texcode>\starttabulate[|CR{red}c|CC{yellow}c|CM{green}c|CL{blue}c|] \NC test \NC test \NC test \NC test \NC \NR \NC test \NC test \NC test \NC test \NC \NR \NC test \NC test \NC test \NC test \NC \NR content what column setting you need. \NC test \NC test \NC test \NC test \NC \NR \stoptabulate</texcode>

To span columns in cells with <code>l</code>'''caveat emptor'''! The background coloring does apply only tothe ''first'' row of a paragraph cell. Any other cell will comeout colorless. If you need to color an entire multi-line cell, <code>r</code> or <code>c</code>you could use <code>\span\omit\span\omit\span\omit</code> for each cellwill need to switch to another[[Tables Overview|tabulation variant]].

You could prevent these values you could them in a macro and use it with===Colorizing Cell Text===<code>\use{2}</code> ''Normal text'' inside cells gets its color via the[[Color|standard coloring commands]], or <code>\TWO</code> in by the tabulate environmentshorter variant described above.

\defstarttabulate[|r|c|l|] \NC test \NC {\colored[red] test} \NC test \NC\tabulateuse#1%NR \NC test \NC {\dorecursecolored[green] test} \NC test \NC\NR \NC test \NC {\numexpr2*#1-1colored[blue] test} \NC test \NC\NR \NC test \NC {\relaxcolored[cyan] test}{\spanNC test \NC\omit}}NR \stoptabulate</texcode>

\letblank[halfline]\useto \tabulateuset_tabl_tabulate_every_after_row \defineTABLEshorthandsprotect\to \everytabulate</texcode>

<context mode=mkiv source=yes>\starttabulate \NC one \NC two \NC\NR \NC two \NC three \NC\NR \TB[|l|Br|l|l|halfline] \NC a four \NC b five \NC c \NR \TB[line] \NC four \NC five \NC d \NR \TB[1cm] \NC 1 eight \NC 2 \TWO nine \NC 4 \NR

<texcode>\stoptextstarttabulate[|l|l|]\HL\NN 10e-3 \NN 10e+3 \NR\HL\stoptabulate

* You have to set a width for each cell* The format for the spanned column is fixed and If you have to change it always need math in the macroone column, consider math mode columns:

\defstarttabulate[|m|m|]\tabulateuse#1%HL\NC 10e-3 \NC 10e+3 {\dorecurse{NR\numexpr2*#1-1HL\relaxstoptabulate</texcode>  =Itemization or framed objects inside a tabulation= The following issue is related to MkIV: When using an itemization inside a tabulation where one uses also the {{cmd|head}}{command, there occurs a snapping problem. This is related to penalties which force a twoline split whereas the snapping mechanism prevents this. As a result two lines are typeset on top of each other. The solution is to add the following statement to the preamble:<texcode>\spantabulatesplitlinemode \omit}plustwo</texcode> The following code provided by Wolfgang Schuster demonstrates the problem: Compile with and without the line <tt>\raggedrighttabulatesplitlinemode\ignorespaces}plustwo</tt>

<texcode>\tabulatesplitlinemode \plustwo\starttabulate[|p|]\appendtoksNC one \letpar\useblank[penalty:10000]two \tabulateusepar \defineTABLEshorthandsblank[penalty:10000]three\to NC\NR\everytabulatestoptabulate</texcode> The same is true if you use {{cmd|framed}} or something that uses it internally, like [[Widgets]], within Tabulate. =Combining enumerations and tabulations= {{cmd|NI}} (new item) exists since 2017-09-25. {{cmd|itemtag}} is old, but undocumented. Source: http://source.contextgarden.net/tex/context/base/mkiv/strc-itm.mkvi?search=itemtag

<context mode=mkiv source=yes>\starttextstartitemize[n]\starttabulate[|||||]\NC p \NC \itemtag \NC q \NC r \NC \NR\NC p \NC \itemtag \NC q \NC r \NC \NR\NC p \NC \itemtag \NC q \NC r \NC \NR\NC p \NC \itemtag \NC q \NC r \NC \NR\stoptabulate\stopitemize</context>

<texcode>\startitemize[n]\starttabulate[|p(4cm)|p(4cm)|p(6cm)||]\NI x \NC y \dorecurse{10}{text } NC z \NC \dorecurse{8}{text } NR\NI x \NCy \dorecurse{18}{text } NC z \NC\NR\NI x \NC y \TWO Short text spanning two tabulate paragraphs. NC z \NC\NR\dorecurse{22}{text } NI x \NC y \NC z \NC\NR

\stoptextstartitemize[n]\starttabulate[|||||]\NI b \NC c \NC d \NC \NR\NC a \NI c \NC d \NC \NR\NC a \NC b \NI d \NC \NR\NC a \NC b \NC c \NI \NR\stoptabulate\stopitemize