3,897
edits
Changes
Jump to navigation
Jump to search
Created page with "Documentation for \starttable ... \stoptable"
<cd:commandgroup name="table" type="environment" xmlns:cd="http://wiki.contextgarden.net/commanddoc/20200807">
<cd:shortdesc><!-- a short command summary goes here -->
The environment <tt>\starttable ... \stoptable</tt> is and old and nearly obsolete way to handle tabular material
</cd:shortdesc>
<cd:variants>
<cd:command category="tables" file="tabl-tab.mkiv" interfacedate="2020-06-19T13:41" interfacefile="i-table.xml" level="document" name="table" type="environment" variantnumber="1">
<cd:arguments>
<cd:template ordinal="1"></cd:template>
<cd:assignments list="yes" optional="yes" ordinal="2">
<cd:assignmentsdoc></cd:assignmentsdoc>
<cd:inherit name="setuptables"></cd:inherit>
</cd:assignments>
</cd:arguments>
</cd:command>
<cd:command category="tables" file="tabl-tab.mkiv" interfacedate="2020-06-19T13:41" interfacefile="i-table.xml" level="document" name="table" type="environment" variant="name" variantnumber="2">
<cd:arguments>
<cd:keywords ordinal="1">
<cd:keywordsdoc></cd:keywordsdoc>
<cd:constant type="cd:name"></cd:constant>
</cd:keywords>
<cd:assignments list="yes" optional="yes" ordinal="2">
<cd:assignmentsdoc></cd:assignmentsdoc>
<cd:inherit name="setuptables"></cd:inherit>
</cd:assignments>
</cd:arguments>
</cd:command>
</cd:variants>
<cd:description>The table entries are placed between the <code>\starttable</code> ... <code>\stoptable</code> pair. Between the bracket pair your can specify the table format template using column separators <code>|</code> and format keys, or using the name of a defined table template (see {{cmd|definetabletemplate}}).
There is a long wiki page about [[Table]] macros, and the macros have been superseded by different macros sets, so this page is intentionally kept short. The [[Tables Overview]] page contains a quick overview of all the tabular macro environments and their pros and cons.</cd:description>
<cd:examples><cd:example title="">The command {{cmd|placetable}} on the first line has the same function as {{cmd|placefigure}}. It takes care of spacing before and after the table and numbering. Furthermore the floating mechanism is initialised so the table will be placed at the most optimal location of the page.
<context source='yes' text='yields'>
\placetable[here][tab:ships]{Ships that moored at Hasselt.}
\starttable[|c|c|]
\HL
\NC \bf Year \NC \bf Number of ships \NC\SR
\HL
\NC 1645 \NC 450 \NC\FR
\NC 1671 \NC 480 \NC\MR
\NC 1676 \NC 500 \NC\MR
\NC 1695 \NC 930 \NC\LR
\HL
\stoptable
...
See \in{Table}[tab:ships].
</context></cd:example></cd:examples>
<cd:notes></cd:notes>
<cd:seealso>
<cd:commandref name="setuptables" originator="system"></cd:commandref>
<cd:source file="tabl-tab.mkiv" originator="system"></cd:source>
<cd:wikipage originator="system" page="Category:Tables"></cd:wikipage>
<cd:wikipage page="Table">wiki manual page for tables using this macro set</cd:wikipage>
<cd:wikipage page="Tables_Overview">for a global intro to the various table macro sets in ConTeXt</cd:wikipage>
<cd:commandref name="definetabletemplate"></cd:commandref></cd:seealso>
</cd:commandgroup>
<cd:shortdesc><!-- a short command summary goes here -->
The environment <tt>\starttable ... \stoptable</tt> is and old and nearly obsolete way to handle tabular material
</cd:shortdesc>
<cd:variants>
<cd:command category="tables" file="tabl-tab.mkiv" interfacedate="2020-06-19T13:41" interfacefile="i-table.xml" level="document" name="table" type="environment" variantnumber="1">
<cd:arguments>
<cd:template ordinal="1"></cd:template>
<cd:assignments list="yes" optional="yes" ordinal="2">
<cd:assignmentsdoc></cd:assignmentsdoc>
<cd:inherit name="setuptables"></cd:inherit>
</cd:assignments>
</cd:arguments>
</cd:command>
<cd:command category="tables" file="tabl-tab.mkiv" interfacedate="2020-06-19T13:41" interfacefile="i-table.xml" level="document" name="table" type="environment" variant="name" variantnumber="2">
<cd:arguments>
<cd:keywords ordinal="1">
<cd:keywordsdoc></cd:keywordsdoc>
<cd:constant type="cd:name"></cd:constant>
</cd:keywords>
<cd:assignments list="yes" optional="yes" ordinal="2">
<cd:assignmentsdoc></cd:assignmentsdoc>
<cd:inherit name="setuptables"></cd:inherit>
</cd:assignments>
</cd:arguments>
</cd:command>
</cd:variants>
<cd:description>The table entries are placed between the <code>\starttable</code> ... <code>\stoptable</code> pair. Between the bracket pair your can specify the table format template using column separators <code>|</code> and format keys, or using the name of a defined table template (see {{cmd|definetabletemplate}}).
There is a long wiki page about [[Table]] macros, and the macros have been superseded by different macros sets, so this page is intentionally kept short. The [[Tables Overview]] page contains a quick overview of all the tabular macro environments and their pros and cons.</cd:description>
<cd:examples><cd:example title="">The command {{cmd|placetable}} on the first line has the same function as {{cmd|placefigure}}. It takes care of spacing before and after the table and numbering. Furthermore the floating mechanism is initialised so the table will be placed at the most optimal location of the page.
<context source='yes' text='yields'>
\placetable[here][tab:ships]{Ships that moored at Hasselt.}
\starttable[|c|c|]
\HL
\NC \bf Year \NC \bf Number of ships \NC\SR
\HL
\NC 1645 \NC 450 \NC\FR
\NC 1671 \NC 480 \NC\MR
\NC 1676 \NC 500 \NC\MR
\NC 1695 \NC 930 \NC\LR
\HL
\stoptable
...
See \in{Table}[tab:ships].
</context></cd:example></cd:examples>
<cd:notes></cd:notes>
<cd:seealso>
<cd:commandref name="setuptables" originator="system"></cd:commandref>
<cd:source file="tabl-tab.mkiv" originator="system"></cd:source>
<cd:wikipage originator="system" page="Category:Tables"></cd:wikipage>
<cd:wikipage page="Table">wiki manual page for tables using this macro set</cd:wikipage>
<cd:wikipage page="Tables_Overview">for a global intro to the various table macro sets in ConTeXt</cd:wikipage>
<cd:commandref name="definetabletemplate"></cd:commandref></cd:seealso>
</cd:commandgroup>
