gardener, Interface administrators, Administrators
1,542
edits
Changes
Jump to navigation
Jump to search
<!--(Solution from the mailing list)-->
<!--(added by Willi Egger 04-08-2011, edited by Hraban 2015-10-06)-->
add line and dash factors
denoting the ''alignment'' within cells of this row.
For instance consider a two-column table: if any text in the
first column should be right aligned (''real''
[[Right and left|<tt>flushright</tt>]]) and the second column
|}
* <{{cmd>|HL}} draws a horizontal rule,* <{{cmd>|NC}} marks a new column (or new cell),* <{{cmd>|NS}} marka a new cell that spans more than one column (LMTX only),* {{cmd|NN}} marks a new math column/cell (see below),* <{{cmd>|NR}} 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<!--; available since beta of 2011-12-21-->);,* <{{cmd>|TB}} (= "Table Blank") adds some vertical space between rows -- see an example bellowbelow,* <{{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 the
current page-width. For example: if you want the previous table
to take up all the width and having the second column taking three
quarters of the space, change the {{cmd|starttabulate}} to:
<texcode>
=Horizontal centering table on the page=
<context source=yes>
}</context>
This can also be done with the start/stop syntax (showing only source here, since it does not compile on the wiki):
<context source=yes>
\stopplacetable
</context>
=Spanning columns=
Only LMTX since September 2021 supports wide cells:
<context source=yes>
\starttabulate[|r|l|c|]
\HL
\NC 123 \NC foo \NC bar \NC\NR
\NS[2][c] LMTX \NC\NR
\NC 123 \NC baz \NC bla \NC\NR
\HL
\stoptabulate
</context>
The two parameters of {{cmd|NS}} are the number of additional columns (i.e. 1 of you want to span 2 columns), and the formatting for it.
This works only with single-line cells, i.e. not with āpā columns.
=Spanning Multiple Pages=
[split=yes,
header=text,
title={\color[red] {Fenchurch St. Paul}\strut},
frame=on]
\starttext
\starttabulate[|p(1.2cm)|p(1.2cm)|]
\dorecurse{6}{
}
\stoptabulate
\stoptext
</context>
\stoptabulate
</texcode>
In LMTX, the line commands understand one or two numerical parameters: the line factor and the dash factor. (The second is new as of 2024-02-22.)
<context source="yes">
\starttabulate
\FL[1,2] % linefactor (old) dashfactor (new)
\NC test \NC test and test and test and done \NC \NR
\ML[1,1]
\NC test \NC test and test and test and done \NC \NR
\NC test \NC test and test and test and done \NC \NR
\NC test \NC test and test and test and done \NC \NR
\LL[1,10]
\stoptabulate
</context>
Other types can be discovered in the source
===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 (if
they are to be desired at all from a typographical point of
For ''horizontal rules'' see above.
For ''vertical rules'', <{{cmd>|VL}} takes a defined color as an
optional argument.
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 the background of the text and the remaining space on both sides.
|-
|<{{cmd>|CL}} || color is applied to the background of the text and 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 (the
Those control sequences, if applied within the table body, can
replace the ordinary <{{cmd>|NC}}, allowing individual cells to
be colorized.
<texcode>
=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.comnl/general/magazines/mag-0003.pdf digit-module]. Therefore you can also abbreviate:
<texcode>\starttabulate[|l|l|]
=Itemization or framed objects inside a tabulation=
The following issue is related to MkIV:
* More features are constantly added and documented in the {{src|tabl-tbl.mkiv|source}}.
* {{cmd|starttabulate}}, {{cmd|setuptabulate}}, {{cmd|definetabulate}}
* [[TABLE|Natural Tables]]
* {{cmd|starttable}}, <s>{{cmd|setuptable}}</s>
[[Category:Tables]]
