Difference between revisions of "Command/setuptab"

From Wiki
Jump to navigation Jump to search
m (Text replace - "== Help from ConTeXt-Forum ==" to "== Help from ConTeXt-Mailinglist/Forum ==")
 
(7 intermediate revisions by 4 users not shown)
Line 3: Line 3:
 
|attributes=
 
|attributes=
 
}}
 
}}
 +
 +
== [[Help:Reference|Syntax]] (autogenerated) ==
 +
<syntax>setuptab</syntax>
  
 
== [[Help:Reference|Syntax]] ==
 
== [[Help:Reference|Syntax]] ==
Line 8: Line 11:
 
   <tr>
 
   <tr>
 
     <td colspan="2" class="cmd">\setuptab<span class="first" >[...,...=...,...]</span></td>
 
     <td colspan="2" class="cmd">\setuptab<span class="first" >[...,...=...,...]</span></td>
 +
  </tr>
 +
  <tr valign="top" class="first">
 +
    <td class="cmd">[[Command/keyword:headstyle|headstyle]]</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: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>
 
   <tr valign="top" class="first">
 
   <tr valign="top" class="first">
Line 15: Line 26:
 
   <tr valign="top" class="first">
 
   <tr valign="top" class="first">
 
     <td class="cmd">[[Command/keyword:width|width]]</td>
 
     <td class="cmd">[[Command/keyword:width|width]]</td>
     <td>[[Command/value:dimension|dimension]] </td>
+
     <td>[[Command/value:dimension|dimension]] default: '''broad'''</td>
 +
  </tr>
 +
  <tr valign="top" class="first">
 +
    <td class="cmd">[[Command/keyword:sample|sample]]</td>
 +
    <td>[[Command/value:dimension|dimension]] default: '''\hskip4em'''</td>
 
   </tr>
 
   </tr>
 
   <tr valign="top" class="first">
 
   <tr valign="top" class="first">
     <td class="cmd">[[Command/keyword:headstyle|headstyle]]</td>
+
     <td class="cmd">MkII: [[Command/keyword:location|location]]<br />
    <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>
+
      MkIV: [[Command/keyword:alternative|alternative]]</td>
 +
    <td>'''left'''</td>
 
   </tr>
 
   </tr>
 
   <tr valign="top" class="first">
 
   <tr valign="top" class="first">
     <td class="cmd">[[Command/keyword:location|location]]</td>
+
     <td class="cmd">...=...</td>
     <td>[[Command/value:left|left]] [[Command/value:right|right]] </td>
+
     <td>''see'' {{cmd|setupdescriptions}}</td>
 
   </tr>
 
   </tr>
 
</table>
 
</table>
  
 +
== Description ==
 +
<code>\tab</code> (a <code>description</code> created with <code>{{cmd|definedescription}}[tab]</code>) starts an indented paragraph with a word or two (the 'key') in front of it. <code>\setuptab</code> configures styles and dimensions for <code>\tab</code>. By default, it leaves 4em for the key and 2em of space between the key area and the paragraph, the latter thanks to <code>width=broad</code>. <code>width=fit</code> leaves no space in between. In mkiv, <code>width=fit</code> leaves 1em of space between the key space and the paragraph; this is probably a bug.
  
== Description ==  
+
== Example ==
 +
<context source=yes>
 +
\def\ruler{%
 +
    \dorecurse{8}{%
 +
        \dontleavehmode%
 +
        \blackrule[width={\dimexpr1em-0.5pt}, height=0.5pt]%
 +
        \dontleavehmode%
 +
        \blackrule[width=0.5pt, height=1ex]%
 +
    }
 +
}
 +
 
 +
\def\testpara{%
 +
    They might have called Sunday the super-man. If any such creature
 +
    be conceivable, he looked, indeed, somewhat like it, with his
 +
    earth-shaking abstraction, as of a stone statue walking.
 +
}
 +
 
 +
(The ruler is marked in ems.
 +
The quotation is from G.K. Chesterton's {\em The Man who was Thursday}.)
 +
 
 +
\ruler \par
 +
\setuptab[width=broad, sample={\blackrule[width=2em]}, headstyle=slanted]
 +
\tab{\blackrule[width=2em]} (Sample of 2em wide, broad width.) \testpara \par
 +
 
 +
\ruler \par
 +
\setuptab[width=broad, sample={\blackrule[width=4em]}, headstyle=slanted]
 +
\tab{\blackrule[width=4em]} (Sample of 4em wide, broad width.) \testpara \par
  
 +
\ruler \par
 +
\setuptab[width=fit, sample={\blackrule[width=2em]}, headstyle=slanted]
 +
\tab{\blackrule[width=2em]} (Sample of 2em wide, fit width.) \testpara \par
  
 +
\ruler \par
 +
\setuptab[width=3em, sample={thisisaverylongsample}, headstyle=slanted]
 +
\tab{\blackrule[width=3em]} (Exact width of 3em overrides long sample.) \testpara \par
  
== Example ==
+
</context>
<!-- Please fill in an example if you can -->
 
  
 
== See also ==
 
== See also ==
<!-- something like [[cmd:goto|\goto]] -->
+
* {{cmd|tab}}
 +
* {{cmd|setupdescriptions}}
 +
* [[source:core-mis.mkii|core-mis.mkii]], [[source:core:mis.mkiv|core-mis.mkiv]]
  
 
== Help from ConTeXt-Mailinglist/Forum ==
 
== Help from ConTeXt-Mailinglist/Forum ==
Line 42: Line 93:
 
{{Forum|{{SUBPAGENAME}}}}
 
{{Forum|{{SUBPAGENAME}}}}
  
[[Category:Commands|setuptab]]
+
[[Category:Command/Paragraphs|setuptab]]
 +
[[Category:Command/Descriptions|setuptab]]

Latest revision as of 12:11, 19 November 2019

\setuptab

Syntax (autogenerated)


Syntax

\setuptab[...,...=...,...]
headstyle normal bold slanted boldslanted type cap small... command
style normal bold slanted boldslanted type cap small... command
sample text
width dimension default: broad
sample dimension default: \hskip4em
MkII: location
MkIV: alternative
left
...=... see \setupdescriptions

Description

\tab (a description created with \definedescription[tab]) starts an indented paragraph with a word or two (the 'key') in front of it. \setuptab configures styles and dimensions for \tab. By default, it leaves 4em for the key and 2em of space between the key area and the paragraph, the latter thanks to width=broad. width=fit leaves no space in between. In mkiv, width=fit leaves 1em of space between the key space and the paragraph; this is probably a bug.

Example

\def\ruler{%
    \dorecurse{8}{%
        \dontleavehmode%
        \blackrule[width={\dimexpr1em-0.5pt}, height=0.5pt]%
        \dontleavehmode%
        \blackrule[width=0.5pt, height=1ex]%
    }
}

\def\testpara{%
     They might have called Sunday the super-man. If any such creature
     be conceivable, he looked, indeed, somewhat like it, with his
     earth-shaking abstraction, as of a stone statue walking.
}

(The ruler is marked in ems. 
The quotation is from G.K. Chesterton's {\em The Man who was Thursday}.)

\ruler \par
\setuptab[width=broad, sample={\blackrule[width=2em]}, headstyle=slanted]
\tab{\blackrule[width=2em]} (Sample of 2em wide, broad width.) \testpara \par

\ruler \par
\setuptab[width=broad, sample={\blackrule[width=4em]}, headstyle=slanted]
\tab{\blackrule[width=4em]} (Sample of 4em wide, broad width.) \testpara \par

\ruler \par
\setuptab[width=fit, sample={\blackrule[width=2em]}, headstyle=slanted]
\tab{\blackrule[width=2em]} (Sample of 2em wide, fit width.) \testpara \par

\ruler \par
\setuptab[width=3em, sample={thisisaverylongsample}, headstyle=slanted]
\tab{\blackrule[width=3em]} (Exact width of 3em overrides long sample.) \testpara \par

See also

Help from ConTeXt-Mailinglist/Forum

All issues with: