Difference between revisions of "Command/setupcombinations"

From ConTeXt wiki
Jump to navigationJump to search
m (cleanup)
 
(14 intermediate revisions by 5 users not shown)
Line 4: Line 4:
 
}}
 
}}
  
 +
== [[Help:Reference|Syntax]] (autogenerated) ==
 +
<syntax>setupcombinations</syntax>
 
== [[Help:Reference|Syntax]] ==
 
== [[Help:Reference|Syntax]] ==
 
<table cellspacing="4" cellpadding="2" class="cmd">
 
<table cellspacing="4" cellpadding="2" class="cmd">
 
   <tr>
 
   <tr>
 
     <td colspan="2" class="cmd">\setupcombinations<span class="first" >[...,...=...,...]</span></td>
 
     <td colspan="2" class="cmd">\setupcombinations<span class="first" >[...,...=...,...]</span></td>
 +
  </tr>
 +
  <tr>
 +
    <td colspan="2" class="cmd">\setupcombination<span class="second">[''name defined with {{cmd|definecombination}}'']</span><span class="first" >[...,...=...,...]</span></td>
 
   </tr>
 
   </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:before|before]]</td>
     <td>[[Reference/en/value:command|command]] </td>
+
     <td>[[Command/value:command|''command'']] to be executed before each item-caption pair</td>
 
   </tr>
 
   </tr>
 
   <tr valign="top" class="first">
 
   <tr valign="top" class="first">
     <td class="cmd">[[Reference/en/keyword:inbetween|inbetween]]</td>
+
     <td class="cmd">[[Command/keyword:nx|nx]]</td>
     <td>[[Reference/en/value:command|command]] </td>
+
     <td>[[Command/value:nx|''number'']] of columns in the combination (default: 2)</td>
 
   </tr>
 
   </tr>
 
   <tr valign="top" class="first">
 
   <tr valign="top" class="first">
     <td class="cmd">[[Reference/en/keyword:after|after]]</td>
+
     <td class="cmd">[[Command/keyword:ny|ny]]</td>
     <td>[[Reference/en/value:command|command]] </td>
+
     <td>[[Command/value:ny|''number'']] of rows in the combination (default: as many as needed)</td>
 
   </tr>
 
   </tr>
 +
 
   <tr valign="top" class="first">
 
   <tr valign="top" class="first">
     <td class="cmd">[[Reference/en/keyword:distance|distance]]</td>
+
     <td class="cmd">[[Command/keyword:inbetween|inbetween]]</td>
     <td>[[Reference/en/value:dimension|dimension]] </td>
+
     <td>[[Command/value:command|''command'']] to be executed between each item and its caption</td>
 
   </tr>
 
   </tr>
 
   <tr valign="top" class="first">
 
   <tr valign="top" class="first">
     <td class="cmd">[[Reference/en/keyword:height|height]]</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'']] to be executed after each item-caption pair</td>
 
   </tr>
 
   </tr>
 
   <tr valign="top" class="first">
 
   <tr valign="top" class="first">
     <td class="cmd">[[Reference/en/keyword:width|width]]</td>
+
     <td class="cmd">[[Command/keyword:distance|distance]]</td>
     <td>[[Reference/en/value:dimension|dimension]] [[Reference/en/value:fit|fit]] </td>
+
     <td>[[Command/value:dimension|dimension]] </td>
 
   </tr>
 
   </tr>
 
   <tr valign="top" class="first">
 
   <tr valign="top" class="first">
     <td class="cmd">[[Reference/en/keyword:location|location]]</td>
+
     <td class="cmd">[[Command/keyword:height|height]]</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>[[Command/value:dimension|dimension]] [[Command/value:fit|fit]] </td>
 
   </tr>
 
   </tr>
 
   <tr valign="top" class="first">
 
   <tr valign="top" class="first">
     <td class="cmd">[[Reference/en/keyword:align|align]]</td>
+
     <td class="cmd">[[Command/keyword:width|width]]</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>[[Command/value:dimension|dimension]] [[Command/value:fit|fit]] </td>
 
   </tr>
 
   </tr>
 
   <tr valign="top" class="first">
 
   <tr valign="top" class="first">
     <td class="cmd">[[Reference/en/keyword:style|style]]</td>
+
     <td class="cmd">[[Command/keyword:location|location]]</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... |small]] [[Reference/en/value:command|command]] </td>
+
     <td>[[Command/value:top|top]] [[Command/value:middle|middle]] [[Command/value:bottom|bottom]] [[Command/value:left|left]] [[Command/value:right|right]] </td>
 
   </tr>
 
   </tr>
 
   <tr valign="top" class="first">
 
   <tr valign="top" class="first">
     <td class="cmd">[[Reference/en/keyword:color|color]]</td>
+
     <td class="cmd">[[Command/keyword:align|align]]</td>
     <td>[[Reference/en/value:name|name]] </td>
+
    <td>[[Command/value:no|no]] [[Command/value:left|left]] [[Command/value:right|right]] [[Command/value:middle|middle]] [[Command/value:normal|normal]] </td>
 +
  </tr>
 +
  <tr valign="top" class="first">
 +
    <td class="cmd">[[Command/keyword:style|style]]</td>
 +
    <td>[[Command/value:normal|normal]] [[Command/value:bold|bold]] [[Command/value:slanted|slanted]] [[Command/value:boldslanted|boldslanted]] [[Command/value:type|type]] [[Command/value:cap|cap]] [[Command/value:small... |small]] [[Command/value:command|command]] </td>
 +
  </tr>
 +
  <tr valign="top" class="first">
 +
    <td class="cmd">[[Command/keyword:color|color]]</td>
 +
     <td>[[Command/value:name|name]] </td>
 +
  </tr>
 +
  <tr valign="top" class="first">
 +
    <td class="cmd">[[Command/keyword:alternative|alternative]]</td>
 +
    <td>
 +
{| class="wikitable"
 +
|-
 +
| text || interpret every second item in the combination as a caption
 +
|-
 +
| label || interpret every item as a figure; labels are automatically added.
 +
|}</td>
 +
  </tr>
 +
  <tr valign="top" class="first">
 +
    <td class="cmd">[[Command/keyword:continue|continue]]</td>
 +
    <td>
 +
{| class="wikitable"
 +
|-
 +
| 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
 +
|}</td>
 
   </tr>
 
   </tr>
 
</table>
 
</table>
Line 53: Line 87:
  
 
== Description ==  
 
== Description ==  
 +
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}}.
 +
 +
== Example ==
 +
<!-- 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>
  
== Example ==
+
The distance between the content and its caption entry is set with the 'inbetween' parameter.
<!-- Please fill in an example if you can -->
 
  
 
== See also ==
 
== See also ==
<!-- something like [[cmd:goto|\goto]] -->
+
* {{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|setupcombinations]]

Latest revision as of 14:53, 15 October 2019

\setupcombinations

Syntax (autogenerated)

Syntax

\setupcombinations[...,...=...,...]
\setupcombination[name 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
distance dimension
height dimension fit
width dimension fit
location top middle bottom left right
align no left right middle normal
style normal bold slanted boldslanted type cap small command
color name
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.

See also

Help from ConTeXt-Mailinglist/Forum

All issues with: