Changes

< [[Tables Overview]] | [[tabulateTabulate]] | [[Tables]] >

This is ConTeXts oldest table module. It uses the same formatting as [[tabulateTabulate]] (see [[Tables Overview]]).

This mode is based on Michael Wichura's TaBlE package for PlainTeX. The official manual for it is commercial (about 40 USD), see [http://www.pctex.com /books.html PCTeX] -- but note that the TaBlE manual only talks about the original syntax, which does not use <{{cmd>|NC</cmd>}}, <{{cmd>|HL</cmd> }} cum suis.

The only ConTeXt docs are in [[manual:ms-cb-en.pdf|ConTeXt - an excursion]]. There is also two introductory articles in tugboat [http://tug.org/TUGboat/Articles/tb28-3/tb90mahajan.pdf ConTeXt basics for users: Table macros] [http://www.tug.org/TUGboat/Articles/tb29-1/tb91mahajan.pdf Table macros II] by Aditya Mahajan (2007 and 2008).

</td></tr></table>

* You get vertical lines (rules), if you use <{{cmd>|VL</cmd> }} instead of <{{cmd>|NC</cmd>}}.* Better use <{{cmd>|SR</cmd>}}, <{{cmd>|FR</cmd>}}, <{{cmd>|MR</cmd>}}, <{{cmd>|LR</cmd> }} instead of <{{cmd>|NR</cmd>}}.* You can also use <{{cmd>|AR</cmd> }} instead of <{{cmd>|SR</cmd>}}, <{{cmd>|FR</cmd>}}, <{{cmd>|MR</cmd> }} and <{{cmd>|LR</cmd> }} (AR for automatic row).* You can leave out the <{{cmd>|NC</cmd> }} before the "row" command, but not if you use <{{cmd>|AR</cmd> }} in a last or single row (see example).* You can influence the table with <{{cmd>|setuptables</cmd>.* There are also <cmd>BL</cmd> and <cmd>CL</cmd> for colored backgrounds, see below}}.

The table is defined by the template enclosed in square brackets after <{{cmd>|starttable</cmd>}}. The template has the form<tt>|keys for the first column|keys for the second column|...|keys for the last column|</tt>. Please note that the each column is surrounded by <tt>|</tt> signs. These are necessary. The formatting keys for each column can be a choice of {| class="wikitable" ! Key ! Meaning |- ! colspan="2" | Primitive Keys |- | <code>a{<em>tokens</em>}</code> | Adds <code><em>tokens</em></code> <em>after</em> the column content |- |- | <code>b{<em>tokens</em>}</code> | Adds <code><em>tokens</em></code> <em>before</em> the column content |- | <code>\{</code> | Enclose the column in braces (grouping) |- | <code>*{<em>n</em>}{<em>keys</em>}</code> | Equivalent to repeating the formatting keys <code><i>keys</i></code> <code><i>n</i></code> times |- ! colspan="2" | Positioning Keys |- | <code>\LeftGlue</code> | Specifies the left glue to be used before the column |- | <code>\RightGlue</code> | Specifies the right glue to be used after the column |- | <code>l</code> | left-aligned column |- | <code>c</code> | centered column |- | <code>r</code> | right-aligned column |- | <code>p(<em>width</em>)</code> | Set each cell as a paragraph |- | <code>s(<em>width</em>)</code> | Specify the inter-column width |- | <code>w</code> | Set minimum column width |- | <code>k</code> | Insert a kern both left and right of the column |- | <code>i</code> | Add a kern to the left of the column |- | <code>j</code> | Add a kern to the right of the column |- ! colspan="2" | Numeric and Math Item Keys |- | <code>n</code> | Numeric item not in math mode |- | <code>N</code> | Numeric item in math mode |- | <code>m</code> | Each cell is in (inline) math mode. Equivalent to <code>b$ a$</code> |- | <code>M</code> | Each cell is in display math mode. Equivalent to <code>\{b{$\displaystyle}a$}</code> |- | <code>\m</code> | Equivalent to 1 <code>l b{{}}m</code> |- | <code>\M</code> | Equivalent to 1 <code>l b{{}}M</code> |- ! colspan="2" | Style Keys |- | <code>f\<em>command</em></code> | Set font according to following <code><em>command</em></code> |- | <code>B</code> | Bold. Equivalent to <code>f\bf</code> |- | <code>I</code> | Italic. Equivalent to <code>f\it</code> |- | <code>S</code> | Slanted. Equivalent to <code>f\sl</code> |- | <code>R</code> | Roman. Equivalent to <code>f\rm</code> |- | <code>T</code> | Teletype. Equivalent to <code>f\tt</code> |- | <code>C</code> | Color. Use it in combination with <code>\{</code> (e.g. <code>\{C{<em>red</em>}</code>) |- ! colspan="2" | Tabskip Keys |- | <code>s</code> | Set the tabskip to the right of this column and of all following columns up to the next <code>s</code> or <code>o</code> key |- | <code>o</code> | Set the tabskip to the right of this column only |- |} === Column definition examples===; <code>|l|</code> : a left aligned column, as wide as necessary; <code>|lw(2cm)|</code> : a left aligned column of at least 2 cm width; <code>|p(2cm)|</code> : a centered(!) paragraph of 2 cm width; <code>|lp(.5\textwidth)|</code> : a left aligned paragraph of specified width; <code>|rp(.5\textwidth)|</code> : a right aligned paragraph of specified width; <code>|cp(.5\textwidth)|</code> : a center aligned paragraph of specified width; <code>|xp(.5\textwidth)|</code> : a justified paragraph of specified width {{todo|add more examples of column definitions}} ==Column Spans== It's possible to create columnspans (i.e. cells that span more than one column) with the command {{cmd|use|{<i>N</i>}}} where ''N'' is the number of columns spanned by the cell. It's often necessary to use {{cmd|ReFormat|[<i>new keys</i>]{}}} to reformat this specific cell according to the ''new keys''.

 <table cols="2"><tr valign="top"><td><contexttexcode>\switchtobodyfontstarttable[8pts(0pt)|ls(10pt)|rs(0pt)|]

\NC \bf Key use{2}\VL \bf Meaning ReFormat[cB]{Spanning head} \SR

\NC \NC Primitive Keys Use{2}[cB]{Spanning head} \SR% slightly shorted

\NC \type{a{tokens}}left text \VL Adds right column text \type{tokens} {\em after} the column contentNC \AR\NC \type{b{tokens}}new row \VL Adds \type{tokens} '''before''' the column content\ARnew row \NC {\tt \backslash\{ } \VL Enclose the column in braces \AR\NC \type{*{n}{keys}}left text \VL Equivalent to repeating the formatting keys \typeReFormat[l]{keysreformatted} \type{n} times\NC\LRAR

\NC \NC Positioning Keysuse{2}Spanning entry \SR

\NC \type{\LeftGlue} \VL Specifies the left glue to be used before the column\ARstoptable\NC \type{\RightGlue} \VL Specifies the right glue to be used after the column\AR</texcode>\NC \type{l} \VL left-aligned column\AR</td><td>\NC \type{c} \VL centered column\AR<context>\NC \type{r} \VL right-aligned column\ARsetuppapersize[A5]\NC \type{p} \VL Set each cell as a paragraph\AR\NC \type{w} \VL Set minimum column width\AR\NC \type{k} \VL Insert a kern both left and right of the column\AR\NC \type{i} \VL Add a kern to the left of the column\AR\NC \type{j} \VL Add a kern to the right of the column\LRstarttable[s(0pt)|ls(10pt)|rs(0pt)|]

\NC \NC Numeric and Math Item Keys use{2}\ReFormat[cB]{Spanning head} \SR

\NC \typeUse{n2} \VL Numeric item not in math mode\AR\NC \type[cB]{N} \VL Numeric item in math mode\AR\NC \type{m} \VL Each cell is in (inline) math mode. Equivalent to \type{b$ a$}\AR\NC \type{M} \VL Each cell is in display math mode. Equivalent to \type{\{b{$\displaystyle}a$}} \AR\NC \type{\m} \VL Equivalent to \type{l b{{}}m}\AR\NC \type{\M} \VL Equivalent to \type{l b{{}}MSpanning head}\LRSR

\NC left text \VL right column text \NC \AR\NC new row \VL new row \NC \AR\NC left text \VL \ReFormat[l]{reformatted} \NC Style Keys \SRAR

\NC \typeuse{f\command} \VL Set font according to following \tex{command}\AR\NC \type{B} \VL Bold. Equivalent to \type{f\bf}\AR\NC \type{I} \VL Italic. Equivalent to \type{f\it}\AR\NC \type{S} \VL Slanted. Equivalent to \type{f\sl}\AR\NC \type{R} \VL Roman. Equivalent to \type{f\rm}\AR\NC \type{T} \VL Teletype. Equivalent to \type{f\tt2}Spanning entry \LRSR

\NC stoptable</context></td></tr></table>  ({{cmd|ReFormat}} can be abbreviated {{cmd|REF}} for brevity.) == Row Spans== It's also possible to create rowspans (i.e. cells that span more than one row) with the command {{cmd|Raise|(<i>dimen</i>){<i>content</i>}}} or {{cmd|Lower|(<i>dimen</i>){</i>content</i>}}} that raise or lower ''content'' by ''dimen''. <table cols="2"><tr valign="top"><td><texcode>\NC Tabskip Keys \SRstarttable[|c|c|]

\NC VL \Lower(.5\typelineheight){sa} \VL Set the tabskip to the right of this column and of all following columns up to the next b \VL \type{s} or AR\DC \type{o} keyDL[1] \ARDR\NC VL \type{o} VL c \VL Set the tabskip to the right of this column only\LRAR\HL\stoptable</texcode></td><td><context>\starttable[|c|c|]

It's possible to create columnspans (i.e. cells that span more than one column) with the command <cmdtable cols="2">use[<itr valign="top"><td><texcode>\starttable[|M|c|]\HL\VL \VL a \VL \AR\DC \DL[1] \DR\VL \smash{\sum_0^N} \VL b \VL \AR\DC \DL[1] \DR\VL \VL c \VL \AR\HL\stoptable</itexcode>]</cmdtd><td><context> where ''\starttable[|M|c|]\HL\VL \VL a \VL \AR\DC \DL[1] \DR\VL \smash{\sum_0^N'' is the number of columns spanned by the cell. It's often necessary to use } \VL b \VL \AR\DC \DL[1] \DR\VL \VL c \VL \AR\HL\stoptable<cmd/context>ReFormat[<i/td>new keys</itr>]</cmdtable> to reformat this specific cell according to the ''new keys''.

\placetable[here][tab:sample]{sample table}{

* If you need information about <{{cmd>|placetable</cmd> }} look after <{{cmd>|placefloat</cmd> }} in the manual or texshow!* If you'd like do not want a caption for your table, to get rid of it altogether you have to add "none" to settings and then leave out the braces empty; if you only leave the braces empty, your table's caption will still be numbered (here: "sample tableTable 1"etc.), you can't simply leave the braces empty but must write . <tttexcode>\placetable[here,none][tab:sample]{}{\starttable ...\stoptable}</tttexcode>!

Note: Adding color to tables using the `\CL` and `\BL` commands appears to be deprecated in MKIV; see: http://wiki.contextgarden.net/Tabulate A very nice application in table are background colors for rows/cells (a feature that doesn't work in [[tabulateTabulate]]): <table cols="2"><tr valign="top"><td>

\BL[21]\SR

\NC \tex{AR} \NC automatic row \NC\SR

The commands work something like this: first, you say what background colour you want for the next rowand then you typeset the row. Observe: the line with the colour-command and the row it is supposedto colour should end in the same command (i.e. both \SR, \LR, \FR, ...). If they don't, the backgroundwon't cover the whole cell. * <cmd>BL</cmdtd> makes a gray background: the optional argument tells BL how many cells it should color* <cmd>CL</cmdtd> makes a colored line

\NC \tex{AR} \NC automatic row \NC\SR

\stoptextstarttable[s0|l|i2l|i2r|] \HL[3] \NC \Use2[c]{Item} \NC \NC \AR \DL[2] \DC \DR \NC Animal \NC Description \NC Price (\$) \NC \AR \HL[2] \NC Gnat \NC per gram \NC 13.65 \NC \AR \NC \NC each \NC 0.01 \NC \AR \NC Gnu \NC stuffed \NC 92.50 \NC \AR \NC Emu \NC stuffed \NC 33.33 \NC \AR \NC Armadillo \NC frozen \NC 8.99 \NC \AR \HL[3]\stoptable