Difference between revisions of "Command/setupcombination"

From Wiki
Jump to navigation Jump to search
(Create reference page)
 
(clean up page)
 
(17 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<!-- please remove this and the following line if you have checked this page -->
 
{{Reference_Cleanup}}
 
 
{{Reference
 
{{Reference
|name=setupcombinations
+
|name=setupcombination
 
|attributes=
 
|attributes=
 
}}
 
}}
  
== [[Help:Reference|Syntax]] ==
+
== [[Help:Reference|Syntax]] (autogenerated) ==
 +
<syntax>setupcombination</syntax>
 +
 
 +
== Settings ==
 
<table cellspacing="4" cellpadding="2" class="cmd">
 
<table cellspacing="4" cellpadding="2" class="cmd">
  <tr>
 
    <td colspan="2" class="cmd">\setupcombinations<span class="first" >[...,...=...,...]</span></td>
 
  </tr>
 
 
   <tr valign="top" class="first">
 
   <tr valign="top" class="first">
     <td class="cmd">[[Reference/en/keyword:before|before]]</td>
+
     <td class="cmd">[[Command/keyword:name|name]]</td>
     <td>[[Reference/en/value:command|command]] </td>
+
     <td colspan="2">Named combinations are defined with {{cmd|definecombination}}</td>
 
   </tr>
 
   </tr>
   <tr valign="top" class="first">
+
   <tr valign="top" class="second">
     <td class="cmd">[[Reference/en/keyword:inbetween|inbetween]]</td>
+
     <td class="cmd">[[Command/keyword:before|before]]</td>
     <td>[[Reference/en/value:command|command]] </td>
+
     <td>[[Command/value:command|''command'']]</td>
 +
    <td>to be executed before each item-caption pair</td>
 
   </tr>
 
   </tr>
   <tr valign="top" class="first">
+
   <tr valign="top" class="second">
     <td class="cmd">[[Reference/en/keyword:after|after]]</td>
+
     <td class="cmd">[[Command/keyword:nx|nx]]</td>
     <td>[[Reference/en/value:command|command]] </td>
+
     <td>[[Command/value:nx|''number'']]</td>
 +
    <td>of columns in the combination (default: 2)</td>
 
   </tr>
 
   </tr>
   <tr valign="top" class="first">
+
   <tr valign="top" class="second">
     <td class="cmd">[[Reference/en/keyword:distance|distance]]</td>
+
     <td class="cmd">[[Command/keyword:ny|ny]]</td>
     <td>[[Reference/en/value:dimension|dimension]] </td>
+
     <td>[[Command/value:ny|''number'']]</td>
 +
    <td>of rows in the combination (default: as many as needed)</td>
 
   </tr>
 
   </tr>
   <tr valign="top" class="first">
+
 
     <td class="cmd">[[Reference/en/keyword:height|height]]</td>
+
   <tr valign="top" class="second">
     <td>[[Reference/en/value:dimension|dimension]] [[Reference/en/value:fit|fit]] </td>
+
     <td class="cmd">[[Command/keyword:inbetween|inbetween]]</td>
 +
     <td>[[Command/value:command|''command'']]</td>
 +
    <td>to be executed between each item and its caption</td>
 
   </tr>
 
   </tr>
   <tr valign="top" class="first">
+
   <tr valign="top" class="second">
     <td class="cmd">[[Reference/en/keyword:width|width]]</td>
+
     <td class="cmd">[[Command/keyword:after|after]]</td>
     <td>[[Reference/en/value:dimension|dimension]] [[Reference/en/value:fit|fit]] </td>
+
     <td>[[Command/value:command|''command'']]</td>
 +
    <td>to be executed after each item-caption pair</td>
 
   </tr>
 
   </tr>
   <tr valign="top" class="first">
+
   <tr valign="top" class="second">
     <td class="cmd">[[Reference/en/keyword:location|location]]</td>
+
     <td class="cmd" rowspan="2">[[Command/keyword:alternative|alternative]]</td>
     <td>[[Reference/en/value:top|top]] [[Reference/en/value:middle|middle]] [[Reference/en/value:bottom|bottom]] [[Reference/en/value:left|left]] [[Reference/en/value:right|right]] </td>
+
     <td>text</td>
 +
    <td>interpret every second item in the combination as a caption</td>
 
   </tr>
 
   </tr>
   <tr valign="top" class="first">
+
   <tr valign="top" class="second">
     <td class="cmd">[[Reference/en/keyword:align|align]]</td>
+
     <td>label</td>
     <td>[[Reference/en/value:no|no]] [[Reference/en/value:left|left]] [[Reference/en/value:right|right]] [[Reference/en/value:middle|middle]] [[Reference/en/value:normal|normal]] </td>
+
     <td>interpret every item as a figure; labels are automatically added.</td>
 
   </tr>
 
   </tr>
   <tr valign="top" class="first">
+
   <tr valign="top" class="second">
     <td class="cmd">[[Reference/en/keyword:style|style]]</td>
+
     <td class="cmd" rowspan="2">[[Command/keyword:continue|continue]]</td>
     <td>[[Reference/en/value:normal|normal]] [[Reference/en/value:bold|bold]] [[Reference/en/value:slanted|slanted]] [[Reference/en/value:boldslanted|boldslanted]] [[Reference/en/value:type|type]] [[Reference/en/value:cap|cap]] [[Reference/en/value:small...command|small...command]] </td>
+
     <td>yes</td>
 +
    <td>If alternative=label, label numbers (i.e. subfigure numbers) do not reset at the start of each combination</td>
 
   </tr>
 
   </tr>
   <tr valign="top" class="first">
+
   <tr valign="top" class="second">
     <td class="cmd">[[Reference/en/keyword:color|color]]</td>
+
     <td>no</td>
     <td>[[Reference/en/value:name|name]] </td>
+
     <td>If alternative=label, label numbers reset at the start of each new combination</td>
 
   </tr>
 
   </tr>
 
</table>
 
</table>
Line 55: Line 61:
  
 
== Description ==  
 
== Description ==  
== comment ==
+
Set up the behaviour of {{cmd|startcombination}} or {{cmd|startcombination|[mycombination]}}. These parameters may also be used ad-hoc in the options parameter of {{cmd|startcombination}}.
<pre>
+
 
a dutch location? -PG
+
== Example ==
</pre>
+
<!-- Please fill in an example if you can -->
 +
 
 +
* Suppressing both the horizontal and vertical gap between cells:
 +
<texcode>\setupcombinations[distance=0mm,after=]</texcode>
  
 +
* a 10mm horizontal and vertical gap between cells:
 +
<texcode>\setupcombinations[distance=10mm,after={\blank[10mm]}]</texcode>
  
 +
The distance between the content and its caption entry is set with the 'inbetween' parameter.
 +
 +
({{cmd|setupcombinations}} is an alias of {{cmd|setupcombination}}, but it looks more natural to use that when adjusting anonymous combination settings.)
  
== Example ==
 
<!-- Please fill in an example if you can -->
 
  
 
== See also ==
 
== See also ==
<!-- something like [[cmd:goto|\goto]] -->
+
* {{cmd|definecombination}} for how to create a named instance of a combination
 +
* {{cmd|startcombination}} for an example of {{code|alternative=label}}
 +
* {{cmd|placefloat}} to float a combination
 +
* {{cmd|setuplabel}} to adapt a combination's automatic labels
 +
 
 +
== Help from ConTeXt-Mailinglist/Forum ==
 +
All issues with:
 +
{{Forum|{{SUBPAGENAME}}}}
  
[[Category:Reference/en|setupcombinations]]
+
[[Category:Command/Floating|setupcombination]]

Latest revision as of 08:06, 29 June 2020

\setupcombination

Syntax (autogenerated)

\setupcombination[...,...][...=...,...]
[...,...]name
nxnumber
nynumber
widthfit dimension
heightfit dimension
locationleft middle right top bottom
distancedimension
alternativelabel text
alignsee \setupalign
continueyes no
beforecommand
aftercommand
inbetweencommand
stylestyle command
colorcolor


Settings

name Named combinations are defined with \definecombination
before command to be executed before each item-caption pair
nx number of columns in the combination (default: 2)
ny number of rows in the combination (default: as many as needed)
inbetween command to be executed between each item and its caption
after command to be executed after each item-caption pair
alternative text interpret every second item in the combination as a caption
label interpret every item as a figure; labels are automatically added.
continue yes If alternative=label, label numbers (i.e. subfigure numbers) do not reset at the start of each combination
no If alternative=label, label numbers reset at the start of each new combination


Description

Set up the behaviour of \startcombination or \startcombination[mycombination]. These parameters may also be used ad-hoc in the options parameter of \startcombination.

Example

  • Suppressing both the horizontal and vertical gap between cells:
\setupcombinations[distance=0mm,after=]
  • a 10mm horizontal and vertical gap between cells:
\setupcombinations[distance=10mm,after={\blank[10mm]}]

The distance between the content and its caption entry is set with the 'inbetween' parameter.

(\setupcombinations is an alias of \setupcombination, but it looks more natural to use that when adjusting anonymous combination settings.)


See also

Help from ConTeXt-Mailinglist/Forum

All issues with: