The hyphenation settings determine the method used by TopLeaf when it is forced to split a word over two lines. Hyphenation is used to avoid excessive interword space when a long word can’t fit onto the end of the current line. TopLeaf provides three types of hyphenation:

  • dictionary — TopLeaf looks up a hyphenation dictionary for the current language;

  • rule-based — TopLeaf splits words according to a set of rules appropriate to the current language;

  • soft — TopLeaf splits a word if a soft hyphen (Unicode character U+00AD) appears within the word.

The available settings for the Hyphenation Mode property are:

  • Normal — apply hyphenation as required to avoid excessive interword space. Permission to apply dictionary and rule based hyphenation is a global style sheet property controlled from the Options dialog in the TopLeaf GUI.

  • Emergency — only attempt hyphenation as a last resort. This will occur for words that are too large to fit in the current measure (for example, in a narrow table cell). In emergency mode all possible hyphenation points are considered; soft hyphen characters will be tried first, followed by “good” hyphenation points and finally “poor” hyphenation points.

  • Off — disallow all hyphenation.

  • {inherit} — continue using the current hyphenation mode setting.

The available settings for the Hyphenation Type property are:

  • Explicit — only use explicit hyphenation points identified by soft hyphen characters (U+00AD) . Do not attempt other types of hyphenation.

  • Good — only consider the hyphenation points that are specified by the dictionary, or that the rule-based method identifies as acceptable.

  • Poor — consider all hyphenation points. This may produce results that are considered to be poor hyphenation.

  • {inherit} — continue using the current hyphenation type setting.

Other hyphenation parameters can be set with the <hyphenation/> command.

[Note] Note

The xml:lang attribute specifies the language of a given content. If an element is declared with an xml:lang=ID attribute, then the value of ID may influence the hyphenation method used by TopLeaf to process content within that element.

[Warning] Warning

It is inadvisable to disable hyphenation when alignment is set to Justify, as excessive interword space could result.