Table

From Wiki
Revision as of 23:06, 30 January 2005 by 84.58.97.41 (talk)
Jump to navigation Jump to search

< Tables Overview

This is ConTeXts oldest table module. It uses the same formatting as tabulate. (See Tables Overview for an overview.)

\placetable[here][tab:sample]{sample table}
\starttable[|l|l|]
\HL
\NC Command	\NC Meaning	\NC\SR
\HL
\NC \tex{NC}	\NC next column	\NC\FR
\NC \tex{HL}	\NC horizontal line	\NC\MR
\NC \tex{VL}	\NC vertical line	\NC\MR
\NC \tex{NR}	\NC next row	\NC\LR
\HL
\NC \tex{SR}	\NC single row	\NC\FR
\NC \tex{FR}	\NC first row	\NC\MR
\NC \tex{MR}	\NC middle row	\NC\MR
\NC \tex{LR}	\NC last row \NC\LR
\HL
\NC \tex{AR}	\NC automatic row	\NC\SR
\HL
\stoptable

The different "row end" commands make a better spacing. Better use \SR, \FR, \MR, \LR instead of \NR. You can also use \AR instead of \SR, \FR, \MR and \LR (AR for automatic row).

If you need information about \placetable look after \placefloat in the manual! If you'd like to leave out the table's caption, you can't simply leave the braces empty but must write none!

This mode is based on Michael Wichura's TaBlE package for PlainTeX. The official manual for it is commercial (about 40 USD), see PCTeX -- but note that the TaBlE manual only talks about the original syntax, which does not use \NC, \HL cum suis.

The only ConTeXt docs about it are in ms-cb-en.pdf.


The sample looks like this:

A very nice application in table are background colors for rows/cells (a feature that doesn't work in tabulate):

\setupcolors[state=start]
\placetable[here][tab:sample]{sample table}
\starttable[|l|l|]
\HL
\BL[2]\SR
\NC Command	\NC Meaning	\NC\SR
\HL
\NC \tex{NC}	\NC next column	\NC\FR
\NC \tex{HL}	\NC horizontal line	\NC\MR
\NC \tex{VL}	\NC vertical line	\NC\MR
\NC \tex{NR}	\NC next row	\NC\LR
\HL
\CL[green]\SR
\NC \tex{AR}	\NC automatic row	\NC\SR
\HL
\stoptable

The commands work something like this: first, you say what background colour you want for the next row and then you typeset the row. Observe: the line with the colour-command and the row it is supposed to colour should end in the same command (i.e. both \SR, \LR, \FR, ...). If they don't, the background won't cover the whole cell.

  • \BL makes a gray background: the optional argument tells BL how many cells it should color
  • \CL makes a colored line