17.4.2.5 Providing aliases for paragraph formats
If you are generating DocBook from an unstructured FrameMaker document, your document might use the same format for different purposes, each purpose requiring that format to be mapped to a different DocBook element, or to be nested in a different hierarchy, or both; or you might have several formats that map to the same DocBook element. Because DocBook uses semantic tags, whereas FrameMaker uses presentational tags, in some cases you need alternate names for paragraph formats to clarify semantic use cases.
To specify an alternate name, or alias, for a paragraph format:
; Frame paragraph format = Frame format name to use in place of that
; paragraph format for DocBook purposes
An alias works in any [DocBook*] configuration section that uses format names. The alias can be the name of another paragraph format in your document, provided the two formats map to exactly the same element with all the same DocBook settings; or, the alias can be a name you invent.
For additional aliases for the same format, insert a DocBookAlias marker in each instance of the format that requires a different alias, with content the name of another alias. You can also use a DocBookAlias marker to override an alias assigned in section [DocBookAlias].
You can use as many different aliases for the same paragraph format as your document requires. If you are creating new alias names, be careful not to duplicate the name of a format that is already in the FrameMaker paragraph catalog.
You might need to create aliases in the following situations:
One-to-many mappings of the same format to different DocBook elements
Many-to-one mappings of two or more formats to the same DocBook element.
Suppose your FrameMaker document includes a paragraph format named Body2, used in the following situations:
• most often as a continuation of a Numbered1 or Numbered paragraph
• less often as a continuation of a Bulleted paragraph
• occasionally as a quotation, not part of any list.
This means that in different places in your document Body2 would have to be mapped to different elements, or participate in different DocBook hierarchies.
To resolve this conflict, you would assign aliases to the alternate uses of Body2. You could keep the original format name for the most frequent use; however, the name Body2 does not convey anything about the differing semantics. Therefore you might want to use aliases for every use; for example, Body2OList, Body2IList, and Body2Quote.
To create an alias for the most prevalent use of Body2:
For the other two uses of Body2, you would have to insert a DocBookAlias marker in each instance, with content one of the other aliases: Body2IList or Body2Quote. Then you could specify the following in your project configuration file:
Suppose your FrameMaker document includes three different paragraph formats for quotations:
All three map to DocBook element <blockquote>. You can make this semantic equivalence explicit in section [DocBookAlias], and use the collective alias in other configuration sections:
> 17 Converting to DocBook XML > 17.4 Configuring DocBook elements > 17.4.2 Mapping paragraph formats to DocBook elements > 17.4.2.5 Providing aliases for paragraph formats