Difference between revisions of "Command old/setuptolerance"

From Wiki
Jump to navigation Jump to search
m (moved Reference/en/setuptolerance to Command/setuptolerance: Text replace - "Reference/en/" to "Command/")
m (Taco moved page Command/setuptolerance to Command old/setuptolerance without leaving a redirect)
 
(10 intermediate revisions by 5 users not shown)
Line 5: Line 5:
  
 
== [[Help:Reference|Syntax]] ==
 
== [[Help:Reference|Syntax]] ==
<table cellspacing="4" cellpadding="2" class="cmd">
 
  <tr>
 
    <td colspan="2" class="cmd">\setuptolerance<span class="first" >[...,...,...]</span></td>
 
  </tr>
 
  <tr valign="top" class="first">
 
    <td class="cmd">[...,...,...]</td>
 
    <td>[horizontal vertical stretch space <strong>verystrict</strong> strict tolerant verytolerant]</td>
 
  </tr>
 
</table>
 
  
 +
<syntax>setuptolerance</syntax>
  
 
== Description ==  
 
== Description ==  
  
Use <code>\setuptolerance[horizontal,...]</code> for interword spacing  
+
Set up how tolerant TeX should be of ‘ugly’ stretching of spaces. The more stretching you allow, the easier it is for TeX to choose a stretched-out underfull line instead of a margin-invading overfull line.
and <code>\setuptolerance[vertical,...]</code> for column stretching.
+
 
Don't try to combine these two.
+
Use <code>\setuptolerance[horizontal,...]</code> for interword spacing and <code>\setuptolerance[vertical,...]</code> for column stretching. Don't try to combine these two.
  
 
The default orientation is ''horizontal'', so the following two are equivalent:
 
The default orientation is ''horizontal'', so the following two are equivalent:
Line 34: Line 26:
 
{|
 
{|
 
|stretch:
 
|stretch:
|<tt>\emergencystretch\bodyfontsize</tt>
+
|make <tt>\emergencystretch</tt> equal to <tt>\bodyfontsize</tt> (i.e. 11pt), default is 0pt
 
|-
 
|-
 
|space:
 
|space:
Line 69: Line 61:
 
|}
 
|}
  
 +
== Tolerance of float captions ==
 +
 +
Float captions don't inherit the global tolerance setting, but instead use their own tolerance:
 +
 +
<texcode>
 +
%% global tolerance
 +
\setuptolerance
 +
  [tolerant]
 +
 +
%% tolerance for captions
 +
\setupcaption
 +
  [align=tolerant]
 +
</texcode>
 +
 +
== Tolerance of framed texts ==
 +
 +
Framed texts don't inherit the global tolerance setting, but instead use their own tolerance as well:
 +
 +
<texcode>
 +
%% global tolerance
 +
\setuptolerance
 +
  [tolerant]
 +
 +
%% tolerance for framed texts
 +
\setupframedtext
 +
  [align=verytolerant]
 +
</texcode>
 
== Example ==
 
== Example ==
 
<!-- Please fill in an example if you can -->
 
<!-- Please fill in an example if you can -->
  
 
== See also ==
 
== See also ==
<!-- something like [[cmd:goto|\goto]] -->
+
<!-- something like {{cmd|goto}} -->
 +
 
 +
== Help from ConTeXt-Mailinglist/Forum ==
 +
All issues with:
 +
{{Forum|{{SUBPAGENAME}}}}
  
[[Category:Commands|setuptolerance]]
+
[[Category:Command/Hyphenation|setuptolerance]]

Latest revision as of 14:38, 3 December 2021

\setuptolerance

Syntax

\setuptolerance[...,...]
[...,...]horizontal vertical verystrict strict tolerant verytolerant space stretch


Description

Set up how tolerant TeX should be of ‘ugly’ stretching of spaces. The more stretching you allow, the easier it is for TeX to choose a stretched-out underfull line instead of a margin-invading overfull line.

Use \setuptolerance[horizontal,...] for interword spacing and \setuptolerance[vertical,...] for column stretching. Don't try to combine these two.

The default orientation is horizontal, so the following two are equivalent:

\setuptolerance[horizontal,tolerant]
% and
\setuptolerance[tolerant]

In horizontal orientation the keywords have the following effect:

stretch: make \emergencystretch equal to \bodyfontsize (i.e. 11pt), default is 0pt
space: \spaceskip .5em plus .25em minus .25em
verystrict: \tolerance 200
strict: \tolerance 1500
tolerant: \tolerance 3000
verytolerant: \tolerance 4500

In vertical orientation the keywords define a factor bottomtolerance which is only used(?) in columns. The factors are:

verystrict: 0
strict: 0.050
tolerant: 0.075
verytolerant: 0.100

Tolerance of float captions

Float captions don't inherit the global tolerance setting, but instead use their own tolerance:

%% global tolerance
\setuptolerance
  [tolerant]

%% tolerance for captions
\setupcaption
  [align=tolerant]

Tolerance of framed texts

Framed texts don't inherit the global tolerance setting, but instead use their own tolerance as well:

%% global tolerance
\setuptolerance
  [tolerant]

%% tolerance for framed texts
\setupframedtext
  [align=verytolerant]

Example

See also

Help from ConTeXt-Mailinglist/Forum

All issues with: