Difference between revisions of "Command/setupinterlinespace"

From Wiki
Jump to navigation Jump to search
m (Text replace - "[[Category:Commands|" to "== ConTeXt-Forum == {{Forum|{{SUBPAGENAME}}}} [[Category:Commands|")
(14 intermediate revisions by 6 users not shown)
Line 3: Line 3:
 
|attributes=
 
|attributes=
 
}}
 
}}
 +
 +
== [[Help:Reference|Syntax]] (autogenerated) ==
 +
<syntax>setupinterlinespace</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">\setupinterlinespace<span class="first" style="color:red;">[...]</span><span class="second" >|</span><span class="third" >[...,...=...,...]</span><span class="first" >|</span></td>
+
     <td colspan="2" class="cmd">\setupinterlinespace</td>
 +
  </tr>
 +
  <tr>
 +
    <td colspan="2" class="cmd">\setupinterlinespace<span class="first">[...]</span></td>
 +
  </tr>
 +
  <tr>
 +
    <td colspan="2" class="cmd">\setupinterlinespace<span class="third">[...,...=...,...]</span></td>
 
   </tr>
 
   </tr>
 
   <tr valign="top" class="first">
 
   <tr valign="top" class="first">
Line 15: Line 24:
 
   <tr valign="top" class="third">
 
   <tr valign="top" class="third">
 
     <td class="cmd">[[Command/keyword:height|height]]</td>
 
     <td class="cmd">[[Command/keyword:height|height]]</td>
     <td>[[Command/value:number|number]] </td>
+
     <td>[[Command/value:number|number]]</td>
 
   </tr>
 
   </tr>
 
   <tr valign="top" class="third">
 
   <tr valign="top" class="third">
Line 35: Line 44:
 
</table>
 
</table>
  
 +
== Description ==
 +
 +
{{cmd|setupinterlinespace}} sets up the distance between lines. can be used in three variants:
 +
 +
* Without any keywords:<texcode>\setupinterlinespace</texcode> The command sets the baselineskip to <code>2.8ex</code>.
 +
 +
* With a keyword: <texcode>\setupinterlinespace[...]</texcode> The following keywords are available:
 +
**  reset
 +
**  small
 +
**  medium
 +
**  big
 +
**  on
 +
**  off
 +
 +
* Setting all the parameters involved in line positioning:\setupinterlinespace[...,...=...,...]
 +
**  <code>line</code>:  base interline spacing (baselineskip) (e.g. 3ex or 12pt)
 +
**  <code>height</code>: size of strut as multiple of <code>line</code> (e.g. 0.72)
 +
**  <code>depth</code>:  size of strut as multiple of <code>line</code> (e.g. 0.28)
 +
**  <code>top</code>:    topskip (as multiple of line height)
 +
**  <code>bottom</code>: maxdepth (as multiple of line height)
 +
**  <code>stretch</code>: (glue) line stretching
 +
 +
When setting up the interlinespace, it matters which unit one chooses:
  
== Description ==
+
<texcode>
<pre>
+
% interline space adapts itself to body font size
can be used in 3 variants:
+
\setupinterlinespace[line=2.8ex]
  
1. \setupinterlinespace
+
% set interlinespace to 12pt for every font size --- don't do this!
  (without any param) set line=2.8ex
+
\setupinterlinespace[line=12pt]
  
2. \setupinterlinespace[...]
+
% set interlinespace for a particular body font size
  reset
+
% Useful if you think in terms of "nine-point type on eleven-point leading"
  small
+
\definebodyfontenvironment[9pt][interlinespace=11pt]
  medium
+
</texcode>
  big
 
  on
 
  off
 
  
3. \setupinterlinespace[...,...=...,...]
+
A final note: it seems that <tt>\setupinterlinespace[line=XX\baselineskip]</tt> interacts badly with <tt>\setuplayout</tt> while <tt>\setupinterlinespace[big]</tt> works fine.
  line:  base interline spacing (baselineskip) (e.g. 3ex or 12pt)
 
  
  height: size of strut as multiple of line height (e.g. 0.72)
+
== Example ==
  depth:  size of strut as multiple of line height (e.g. 0.28)
+
<context source=yes mode=mkiv>
 +
\setuppapersize[A5][A5]
 +
\setupwhitespace[big]
  
  top:    topskip (as multiple of line height)
+
\starttext
  bottom: maxdepth (as multiple of line height)
 
  
  stretch: (glue) line stretching
+
\the\baselineskip
</pre>
 
  
== Comment ==
+
% The interlinespace does not change automatically when the font changes
 +
{  \definedfont[Serif at 32pt]
 +
    This is the long long title of my book\crlf
 +
    baselineskip=\the\baselineskip
 +
}
  
It seems, that <tt>\setupinterlinespace[line=XX\baselineskip]</tt> interacts badly with <tt>\setuplayout</tt> while <tt>\setupinterlinespace[big]</tt> works fine.
+
% Invoking \setupinterlinespace sets baselineskip to 2.8ex of current font
 +
{  \definedfont[Serif at 32pt]
 +
    \setupinterlinespace
 +
    This is the long long title of my book\crlf
 +
    baselineskip=\the\baselineskip
 +
}
  
 +
\stoptext
  
 +
</context>
 +
 +
== Example within {{cmd|startnarrower}}...{{cmd|stopnarrower}} ==
 +
<context source=yes mode=mkiv>
 +
\setuppapersize[A5][A5]
 +
\setupinterlinespace[5] % this has no effect before \starttext
  
== Example ==
 
<context source="yes">
 
 
\starttext
 
\starttext
{\definedfont[Serif at 32pt]This is the long long long title of my book.\par}
+
\input tufte % this is default, not 5
 +
\setupinterlinespace[big]
 +
\input tufte % this is big
  
{\definedfont[Serif at 32pt]\setupinterlinespace This is the long long long title of my book.\par}
+
\startnarrower[left]
 +
\setupinterlinespace[small]
 +
\input tufte % this is small
 +
\stopnarrower
 +
 
 +
\input tufte % this is big again
 
\stoptext
 
\stoptext
 +
 
</context>
 
</context>
 +
  
 
== See also ==
 
== See also ==
<!-- something like [[cmd:goto|\goto]] -->
+
* {{cmd|setupwhitespace}} to set up inter-paragraph spacing.
 +
* {{cmd|setuplayout}} to set sizes of text areas.
 +
* {{cmd|setuplocalinterlinespace}} to set interline spacing locally.
 +
* {{cmd|definebodyfontenvironment}} with keyword [[Command/keyword:interlinespace|interlinespace]] to set interline spacing globally (i.e. before {{cmd|starttext}}).
  
== ConTeXt-Forum ==
+
== Help from ConTeXt-Mailinglist/Forum ==
 +
All issues with:
 
{{Forum|{{SUBPAGENAME}}}}
 
{{Forum|{{SUBPAGENAME}}}}
  
[[Category:Commands|setupinterlinespace]]
+
[[Category:Command/Paragraphs|setupinterlinespace]]
 +
[[Category:Command/Layout|setupinterlinespace]]

Revision as of 16:08, 12 November 2019

\setupinterlinespace

Syntax (autogenerated)

\setupinterlinespace[...,...][...=...,...]
[...,...]name
linedimension
heightnumber
depthnumber
minheightnumber
mindepthnumber
distancedimension
topnumber height
bottomnumber
stretchnumber
shrinknumber


\setupinterlinespace[...,...]
[...,...]on off reset auto small medium big number dimension


\setupinterlinespace[...]
[...]name


Syntax

\setupinterlinespace
\setupinterlinespace[...]
\setupinterlinespace[...,...=...,...]
[...] reset small medium auto big on off
height number
depth number
line dimension
top number
bottom number

Description

\setupinterlinespace sets up the distance between lines. can be used in three variants:

  • Without any keywords:
    \setupinterlinespace
    The command sets the baselineskip to 2.8ex.
  • With a keyword:
    \setupinterlinespace[...]
    The following keywords are available:
    • reset
    • small
    • medium
    • big
    • on
    • off
  • Setting all the parameters involved in line positioning:\setupinterlinespace[...,...=...,...]
    • line: base interline spacing (baselineskip) (e.g. 3ex or 12pt)
    • height: size of strut as multiple of line (e.g. 0.72)
    • depth: size of strut as multiple of line (e.g. 0.28)
    • top: topskip (as multiple of line height)
    • bottom: maxdepth (as multiple of line height)
    • stretch: (glue) line stretching

When setting up the interlinespace, it matters which unit one chooses:

% interline space adapts itself to body font size
\setupinterlinespace[line=2.8ex]

% set interlinespace to 12pt for every font size --- don't do this!
\setupinterlinespace[line=12pt]

% set interlinespace for a particular body font size
% Useful if you think in terms of "nine-point type on eleven-point leading"
\definebodyfontenvironment[9pt][interlinespace=11pt]

A final note: it seems that \setupinterlinespace[line=XX\baselineskip] interacts badly with \setuplayout while \setupinterlinespace[big] works fine.

Example

\setuppapersize[A5][A5]
\setupwhitespace[big]

\starttext

\the\baselineskip

% The interlinespace does not change automatically when the font changes
{   \definedfont[Serif at 32pt]
    This is the long long title of my book\crlf
    baselineskip=\the\baselineskip
}

% Invoking \setupinterlinespace sets baselineskip to 2.8ex of current font
{   \definedfont[Serif at 32pt]
    \setupinterlinespace 
    This is the long long title of my book\crlf
    baselineskip=\the\baselineskip
}

\stoptext

Example within \startnarrower...\stopnarrower

\setuppapersize[A5][A5]
\setupinterlinespace[5] % this has no effect before \starttext

\starttext
\input tufte % this is default, not 5
\setupinterlinespace[big]
\input tufte % this is big

\startnarrower[left]
\setupinterlinespace[small]
\input tufte % this is small
\stopnarrower

\input tufte % this is big again
\stoptext


See also

Help from ConTeXt-Mailinglist/Forum

All issues with: