Difference between revisions of "Command/setupinterlinespace"

From Wiki
Jump to navigation Jump to search
m (Format code block)
(5 intermediate revisions by 3 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 ==
  
== Description ==
+
{{cmd|setupinterlinespace}} sets up the distance between lines. can be used in three variants:
<pre>
 
can be used in 3 variants:
 
  
1. \setupinterlinespace
+
* Without any keywords:<texcode>\setupinterlinespace</texcode> The command sets the baselineskip to <code>2.8ex</code>.
  (without any param) set line=2.8ex
 
  
2. \setupinterlinespace[...]
+
* With a keyword: <texcode>\setupinterlinespace[...]</texcode> The following keywords are available:
  reset
+
**  reset
  small
+
**  small
  medium
+
**  medium
  big
+
**  big
  on
+
**  on
  off
+
**  off
  
3. \setupinterlinespace[...,...=...,...]
+
* Setting all the parameters involved in line positioning:\setupinterlinespace[...,...=...,...]
  line:  base interline spacing (baselineskip) (e.g. 3ex or 12pt)
+
**  <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
  
  height: size of strut as multiple of line height (e.g. 0.72)
+
When setting up the interlinespace, it matters which unit one chooses:
  depth:  size of strut as multiple of line height (e.g. 0.28)
 
  
  top:    topskip (as multiple of line height)
+
<texcode>
  bottom: maxdepth (as multiple of line height)
+
% interline space adapts itself to body font size
 +
\setupinterlinespace[line=2.8ex]
  
  stretch: (glue) line stretching
+
% set interlinespace to 12pt for every font size --- don't do this!
</pre>
+
\setupinterlinespace[line=12pt]
  
== Comment ==
+
% 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]
 +
</texcode>
  
It seems, that <tt>\setupinterlinespace[line=XX\baselineskip]</tt> interacts badly with <tt>\setuplayout</tt> while <tt>\setupinterlinespace[big]</tt> works fine.
+
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.
  
Those used to traditional typography specifications (e.g. "eleven point type on fourteen point leading" written as 11/14) would use the following:
+
== Example ==
 +
<context source=yes mode=mkiv>
 +
\setuppapersize[A5][A5]
 +
\setupwhitespace[big]
  
<texcode>
+
\starttext
\setupbodyfont [11pt]            % 12pt is the default font size
+
 
\setupinterlinespace [line=14pt] % default: line=2.8ex
+
\the\baselineskip
</texcode>
+
 
 +
% 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
  
 +
</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}} -->
+
* {{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}}).
  
 
== Help from ConTeXt-Mailinglist/Forum ==
 
== Help from ConTeXt-Mailinglist/Forum ==
Line 94: Line 140:
  
 
[[Category:Command/Paragraphs|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: