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-->

\starttabulate[|r|l|llB|]

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

\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

\setuppapersize[A5]\starttabulate[|r|l|llB|]

\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\NC cg(.) \NC align on a character \NC\NR

* {{cmd|HL is }} draws a horizontal linerule,* {{cmd|NC is }} marks a new column (or new cell),* {{cmd|NN}} marks a new math column/cell (see below),* {{cmd|NR is }} starts a new row,* {{cmd|NB}} starts a new row as a block (avoids page breaking inside of a block, to keep some lines together),* {{cmd|TB}} (= "Table Blank") adds some vertical space between rows -- see an example below,* {{cmd|VL}} (instead of {{cmd|NC}}) draws a vertical rule -- for more info see below. When using fixed width, you can use values relative to thecurrent page-width. For example: if you want the previous tabletake up all the width and having the second column taking threequarters of the space, change the {{cmd|starttabulate}} to:<texcode>\starttabulate[|rw(.25\textwidth)|lw(.75\textwidth)|]</texcode>(Mistake: This doesn’t account for the width of the column distance!) =Horizontal centering table on the page=

<context source== Headers and Footers ==yes>This is a very long text, longer than the width of the table.It must be long enough to flow to the next line to see the effect.

In \placetable[force,none]{}{% \starttabulate[|r|l|] \HL \NC I want this table \NC aligned in the center.\NC\NR \HL \stoptabulate}</context> This can also be done with the start/stop syntax: <context source=yes>This is a very long text, longer than the width of the table.It must be long tabulations youenough to flow to the next line to see the effect. \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''d like : the difference between setting and unsetting thisargument may not be visible on the first few pages. Rather, itseems to get your headers 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(and perhaps footers1.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 on above at every pagebreak 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.

\setuptabulate[headerssplit=yes,header=repeat] % same for footers 

\HLFL \NC {\bf format char} \NC {\bf meaning } \NC\NRAR \HLLL

 \starttabulate[|lr|l|] \NC c \NC centered \NC\NRAR \NC l \NC left aligned \NC\NRAR \NC r \NC right aligned \NC\NRAR

\setuppapersize[A5] \setuptabulate[headerssplit=yes,header=repeat] % same for footers 

\HLFL \NC {\bf format char} \NC {\bf meaning } \NC\NRAR \HLLL

 \starttabulate[|lr|l|] \NC c \NC centered \NC\NRAR \NC l \NC left aligned \NC\NRAR \NC r \NC right aligned \NC\NRAR

=Individualizing the Tabulate has no support for column spans but you could add this function yourself.Look=

The code to do this depends Hans initially announced support for vertical lines and colors on the tabulate setting and you have to know whatcontent what column setting you needmailing list. [http://archive.contextgarden.net/message/20101117.123950.739657a7.en.html]

=== Single row columns =Rules==

You could prevent these values you could them in a macro and use it withAs already demonstrated above, the <codett>\use{2}HL</codett> statement insertsa hairline after the current line.This particularly useful when demarking header and footer rows or <code>\TWO</code> in separated parts of a table that should not be as closelyassociated as the rows between the tabulate environmentrules.

! width="4555%"|

! width="4535%"|

\defstarttabulate[|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 \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 \tabulateuseHL\stoptabulate</context>|} Context supports different categories of rules that can beconfigured individually in order to discern various applications.Their behaviour accounts for the designated use, e.g.<tt>\ML</tt> (mid rules) are intended to be deployed betweenordinary rows of the table body and will prevent page breaks&ndash; no way you’d end up with a rogue hairline desecratingthe bottom of your page’s text area.{|cellpadding="10" style="border:2px solid #addeff"! style="background:#1%addeff;" | Type !! Description|-|<tt>\HL</tt> || standard horizontal rule;|-|<tt>\FL</tt> || first rule; {|-|<tt>\dorecurse{ML</tt> || mid rule;|-|<tt>\numexpr2*#1LL</tt> || bottom rule;|-1|<tt>\relax}{LL</tt> and <tt>\spanTL</tt> || bottom rule;|-|<tt>\omit}BL</tt> || last rule.|}

\appendtoksAdditionally, there is an option <tt>rulecolor</tt> for \let\use\tabulateuse \defineTABLEshorthands\{{cmd|setuptabulate}} that allows for those rules to \everytabulatebe tinted.

<texcode>\starttextsetuptabulate[rulecolor=red]

\starttabulate[|lr|Br|lc|l|] \FL \NC first row \NC test \NC test \NC\NR \ML \NC a rows in \NC b test \NC c test \NC d \NR \NC 1 between \NC 2 test \NC test \NC\NR \LL \TWO NC last row \NC 4 test \NC test \NC\NR \BL

===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>\stoptextstarttabulate[||||] \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

\appendtoks==Coloring== \let\use\tabulateuse \defineTABLEshorthandsThe following elements can be colorized: rules, cell backgrounds,\to \everytabulateand, obviously, common text. ===Colorizing Rules=== For ''horizontal rules'' see above.

<texcode>\starttabulate[|lr|Br|lc|l|] \VL test \VL[red] red rule \VL test \VL \NR \NC a VL test \NC b VL[green] green rule \NC c VL test \NC d VL \NR \NC 1 VL test \NC 2 VL[blue] blue rule \TWO VL test \NC 4 VL \NR

For spanned columns in ===Colorizing Cell Text===''Normal text'' inside cells with paragraphs you need a different implementationgets its color via the[[Color|standard coloring commands]], or by the shorter variant described above.

{| <! width="45%"|-- ! width="10%"|There does not seem to be an official interface for ! width="45%"|vertical skips. |-Manually placed <code>\blank</code>s are | <texcodecode>\unskipped</code>on purpose.However, as expected there is a token list<code>\def\tabulateuse#1%t_tabl_tabulate_every_after_row</code> that isplaced after a line is finished.So, in order to get a vertical spacing of half a baseline {\dorecurse{\numexpr2*#1-1\relax}{\span\omit}\raggedright\ignorespaces}distance you can use this code:

\letblank[halfline]\to \t_tabl_tabulate_every_after_row\protect</texcode> --> <context mode=mkiv source=yes>\starttabulate \NC one \NC two \NC\NR \NC two \NC three \NC\NR \TB[halfline] \useNC four \NC five \NC\NR \TB[line] \NC four \NC five \NC\NR \tabulateuseTB[1cm] \defineTABLEshorthandsNC eight \NC nine \NC\NR \stoptabulate</context> =Using math mode= If you want to display numerics, you can simply use {{cmd|NN}} for a new column instead of {{cmd|NC}}. This command works similar to the [http://www.pragma-ade.com/general/magazines/mag-0003.pdf digit-module]. Therefore you can also abbreviate: <texcode>\starttabulate[|l|l|]\HL\NN 10e-3 \NN 10e+3 \NR\HL\stoptabulate</texcode> instead of <texcode>\starttabulate[|l|l|]\everytabulateHL\NC $10\cdot 10^{-3}$ \NC $10 \cdot 10^3$ \NR\HL\stoptabulate</texcode> although both variants do work.

<texcode>\starttabulate[|p(2cm)m|p(3cm)|p(4cm)m|]\NC \dorecurse{10}{text } HL\NC \dorecurse{4}{Lorem Ipsum } \NC\dorecurse{18}{text } 10e-3 \NC10e+3 \NR\NC \TWO Short text spanning two tabulate paragraphs. \NC\dorecurse{17}{text } \NC\NRHL

<texcode>\stoptexttabulatesplitlinemode \plustwo\starttabulate[|p|]\NCone \par\blank[penalty:10000]two \par\blank[penalty:10000]three\NC\NR\stoptabulate

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>\startitemize[n]\starttabulate[|||||]\NC p \NC \itemtag \NC q \appendtoksNC r \NC \NR \letNC p \useNC \itemtag \NC q \NC r \NC \NR\NC p \NC \itemtag \NC q \NC r \NC \tabulateuseNR \defineTABLEshorthandsNC p \NC \itemtag \NC q \NC r \NC \NR\to stoptabulate\everytabulatestopitemize</context>

<texcode>\starttextstartitemize[n]\switchtobodyfontstarttabulate[8pt|||||]\NI x \NC y \NC z \NC \NR\NI x \NC y \NC z \NC \NR\NI x \NC y \NC z \NC \NR\NI x \NC y \NC z \NC \NR\stoptabulate\stopitemize

\startitemize[n]\starttabulate[|p(2cm)|p(3cm)|p(4cm)||]\NI b \NC c \dorecurse{10}{text } NC d \NC \dorecurse{4}{Lorem Ipsum } NR\NCa \NI c \dorecurse{18}{text } NC d \NC\NR\NC a \TWO Short text spanning two tabulate paragraphs. NC b \NI d \NC\NR\dorecurse{17}{text } NC a \NCb \NC c \NI \NR

<context mode=mkiv source=yes> \stoptextstarttabulate[|l|r|r|][EQ={=}] \NC DC \EQ 3.20 bbl \EQ 420 ft \NC\NR \NC HWDP \EQ 3.90 bbl \EQ 450 ft \NC\NR \NC DP \EQ 34.63 bbl \EQ 2.037 ft \NC\NR \NC DC \EQ 41.73 bbl \EQ 2.907 ft \NC\NR \stoptabulate

== More Features =See also=

... * More features are constantly added and documented only in the [[source:{{src|tabl-tbl.mkiimkiv|source}}.* {{cmd|starttabulate}}, {{cmd|setuptabulate}}* [[TABLE|Natural Tables]].* {{cmd|starttable}}, <s>{{cmd|setuptable}}</s>