Format Options

The Options dialog lets you set various options that affect the formatting of the current publication.

From this dialog you can set:

  • The document table model;

  • The document hyphenation method;

  • The document language;

  • The displayed measurement units used within stylesheet editors;

  • General style sheet preferences.

Table model

TopLeaf supports either CALS or HTML table markup.

If you do not know which table model to choose, then select Unknown.

Rule Weight

This value sets the default rule weight used for margin rules and horizontal rules that appear above or below mapped element content.

Measurement units

A number of different measurement units can be used to display the values shown in the stylesheet editors. The following list describes the available units:

  • One Inch = 720dp (1.5in is stored internally as 1080 decipoints).

  • One Centimeter = 283.5dp (4.5cm is stored as 1276 decipoints).

  • One Millimeter = 28.35dp (45mm is stored as 1276 decipoints).

  • One Point = 10dp (65.2pt is stored as 652 decipoints).

  • Decipoints are stored directly (15dp is stored as 15 decipoints).

[Note] Note

You can use centimeters, millimeters, or picas to specify and display the values shown in the stylesheet editors. TopLeaf converts all values to decipoints, and this may result in a slight loss of accuracy. Choose points or decipoints if you need to use the full accuracy of the program.

Document language

The document language controls layout direction and hyphenation rules. An embedded Dashes™ hyphenation module provides Language specific hyphenation support for most European languages. The document language declares the implied initial setting for the document. In the case where the content of a partition is sourced from a multi-document book list, the document language declares the implied language for each document in the book list.

Use of this option is deprecated and may not be supported in future releases. The preferred way to set the language is with the xml:lang attribute in the content or by using the <text-properties lang="LA"/> command in the stylesheet.

Hyphenation method

The hyphenation method specifies the action TopLeaf can take when it tries to split a word that would otherwise extend beyond the right margin of a data or fixed block.

TopLeaf provides three types of hyphenation:

  • soft — TopLeaf splits a word if a soft hyphen (Unicode code point U+00AD) appears within a word;

  • Use hyphenation dictionary — TopLeaf looks up a hyphenation exception list or dictionary for the current language;

  • Use language hyphenation rules — TopLeaf splits words according to a set of rules appropriate to the current language.

Hyphenation precedence rules

When TopLeaf determines that it is permitted to hyphenate a word, it applies the following precedence rules to determine the hyphenation break points:

  1. Use embedded soft hyphens (Unicode code point U+00AD) within the word;

  2. If dictionary hyphenation is enabled, check the hyphenation exception dictionary;

  3. If rule-based hyphenation is enabled, apply a set of language specific hyphenation rules.

[Note] Note

The first precedence rule that is satisfied determines the hyphenation break points. A word will only be hyphenated if one or more hyphenation methods are enabled, and when permitted by the hyphenation mode declared for the context of a mapping.

By default, TopLeaf will not attempt to hyphenate any word of five characters or less.

General preferences

The following preferences can be set:

  • Balance columns. If set, then TopLeaf attempts to minimize the depth of the rendered content by allocating an equal amount of content to each column. If this option is not set, then content flows into the next column only when the previous column is full. You can use the <topleaf-properties/> and <segment-properties/> directives to override this setting.

  • Read-Only Format Files. This provides a simple way to prevent unintentional changes to the publication mapping rules and layout specifications. When enabled, the stylesheet editors will open in read-only mode, permitting a review of the current settings, but inhibiting changes to those settings.

  • Legacy Font Compatibility. This option is only enabled when processing TopLeaf legacy publications.

  • Honor settings for unprintable area. This option is only enabled when processing TopLeaf legacy publications.