Omni Systems, Inc.

  

Mif2Go User's Guide, Version 33u53

  

Valid HTML 4.01!

 

Made with Mif2Go

20 Mapping text formats to HTML > 20.7 Suppressing typographic elements


20.7 Suppressing typographic elements

By default, for HTML output Mif2Go provides typographic elements for FrameMaker paragraph or character formats that specify bold, italic, underline, subscript, or superscript as part of the format. For example, for every paragraph format whose definition includes bold formatting, by default HTML output includes <b> elements as well as the code for the paragraph tag.

You might want to suppress some or all typographic elements for either of the following reasons:

To ensure that output is free of direct formatting, because:

- you are producing XML output, or

- your output uses CSS.

To make overrides show up in the output, so you can insert semantic tags or subsequently provide better formatting in FrameMaker.

For XML output, including DITA XML and DocBook XML, the default is to suppress all typographic elements.

To use or suppress typographic elements:

[Typographics]

; UseTypographicElements = Yes (HTML default) or No (XML default,

; suppress b, i, u, tt, sub, and sup even when specified in a format)

; UseFormatTypographics = Yes (default, use b, i, u, strike, sub

; and sup when set in paragraph or character formats), or No

; (suppress in both para and char formats)

; UseParagraphTypographics = Yes (default, use above when set in

; paragraph formats), or No (suppress in para formats)

; UseCharacterTypographics = Yes (default, use above when set in

; character formats), or No (suppress in char formats)

; UseTypographicStyles = No (default) or Yes (use tags if set)

[HtmlOptions]

; AllowOverrides = Yes (default) or No (ignore untagged char props,

;  default for XML and DITA)

You can choose to:

Suppress all typographics

Suppress typographics used as overrides

Suppress typographics in formats

Suppress typographics only in paragraph formats

Suppress typographics only in character formats

Replace typographics with other tags.

Suppress all typographics

To eliminate all typographic elements, both those used as overrides in FrameMaker and those that are intrinsic to a FrameMaker paragraph or character format:

[Typographics]

UseTypographicElements = No

When UseTypographicElements=No, all settings of character properties are eliminated, including font size, font color, and font name in addition to bold, italic, underline, strike, subscript, and superscript; regardless of whether those properties are intrinsic to a FrameMaker character or paragraph format or were applied as an override. This setting, UseTypographicElements=No, cannot be overridden by any other settings in section [Typographics], nor by [HtmlOptions]AllowOverrides. This is the appropriate value for DITA XML output; see §14.4.4 Mapping character formats to DITA elements.

Suppress typographics used as overrides

To suppress only those typographic elements used as overrides, but keep typographic elements intrinsic to formats:

[Typographics]

UseTypographicElements = Yes

UseFormatTypographics = Yes

[HtmlOptions]

AllowOverrides = No

When AllowOverrides=No, bold, italic, underline, strike, subscript, and superscript are eliminated when they are applied as overrides in FrameMaker; see §20.3.6 Overriding paragraph properties and §20.4.2 Overriding character properties.

Suppress typographics in formats

To eliminate typographic elements that are intrinsic to formats, but keep overrides:

[Typographics]

UseTypographicElements = Yes

UseFormatTypographics = No

[HtmlOptions]

AllowOverrides = Yes

When UseFormatTypographics=No, intrinsic format properties eliminated include bold, italic, underline, strike, subscript, and superscript; however, font size, font color, and font name are retained in the output.

Suppress typographics only in paragraph formats

To eliminate typographic elements intrinsic to paragraph formats, but keep those intrinsic to character formats:

[Typographics]

UseTypographicElements = Yes

UseParagraphTypographics = No

UseCharacterTypographics = Yes

When UseParagraphTypographics=No, format properties intrinsic to paragraph formats are eliminated; these include bold, italic, underline, strike, subscript, and superscript. Font size, font color, and font name are retained in the output.

Suppress typographics only in character formats

To eliminate overrides and typographic elements intrinsic to character formats, but keep those intrinsic to paragraph formats:

[Typographics]

UseTypographicElements = Yes

UseParagraphTypographics = Yes

UseCharacterTypographics = No

[HtmlOptions]

AllowOverrides = No

When UseCharacterTypographics=No, format properties intrinsic to character formats are eliminated; these include bold, italic, underline, strike, subscript, and superscript. Font size, font color, and font name are retained in the output.

Replace typographics with other tags

To specify tags to use for individual typographic elements:

[Typographics]

UseTypographicElements = Yes

UseTypographicStyles = Yes

typographic = tag

When UseTypographicStyles=Yes, you can specify other tags to use in place of typographic elements. The typographic elements you can replace are b, i, u, strike, sub, and sup; and you can specify attributes as well. For example:

[Typographics]

UseTypographicStyles = Yes

i = emphasis

b = emphasis role="bold"

If UseFormatTypographics=Yes, the tags you specify replace any named typographics intrinsic to formats.

If [HtmlOptions]AllowOverrides=Yes, the tags you specify replace any named typographics used as overrides.



20 Mapping text formats to HTML > 20.7 Suppressing typographic elements