Prev | Next |
Glossary Styles
When you are defining your Glossary terms, you can also define a documentation style to apply to terms of a specific Term Type. When you generate RTF, PDF or DOCX documents those terms are shown in the defined color, font and/or emphasis. This applies a visual key to the Glossary terms of each Type, and makes it easier for the reader to recognize all the terms for which they can obtain a definition or explanation.
You apply the glossary styles through the 'Generate Documentation' dialog (as described in the Generate Documentation Help topic). You should not set up glossary styles in a model from which you generate only HTML reports; the HTML report generator does not apply glossary styles.
Configure Glossary Styles
You configure Glossary styles within a Glossary Style Sheet, using the 'Glossary Markup' dialog; you display this dialog from the Glossary View. For each Glossary Term Type, you define one style in the Style Sheet, using the standard CSS style definition language. This is an example of two style definitions in a style sheet:
.paragraph {
font-family: courier;
font-size: 16px;
font-weight: italic;
color: #FF0000;
background: none;
text-transform: capitalize;
}
.language-term {
font-family: arial;
font-size: 14px;
font-weight: bold;
color: #800000;
background: none;
text-transform: capitalize;
}
Access
Ribbon |
Publish > Tools > Glossary > Glossary View > Right-click > Assign Markup Styles |
Keyboard Shortcuts |
> Right-click > Assign Markup Styles |
Define Styles
Assign one style to each of the Glossary Term Types, which have been defined on the 'Glossary' dialog.
Option |
Action |
---|---|
Term |
This column lists the existing Term Types in the Glossary. |
Style Name |
This column identifies the style assigned to each Term Type. If no style has been assigned, the field is blank. To assign or switch the style, double-click on the row, type the style name on the 'Input' prompt and click on the . If the name contains more than one word, link the words with hyphens. The new style name is added to the top of the 'CSS' panel. |
CSS |
Between the parentheses under the style name, type in or copy/paste the new style definition, or edit an existing definition. The styles are created one after another within the single style sheet for the Glossary. |
OK |
Click on this button to save changes to the style definitions and close the dialog. |
Using Glossary Styles
You use Glossary Styles to identify and highlight Glossary terms in your printable reports, and to indicate what kinds of term they might be. You can also use the terms as place-holders for more complex text strings in the term definitions, so that the report generator substitutes the text string for the place-holder term. Both text formatting and text substitution are enabled by selecting options on the 'Generate Documentation' dialog (click on a Package or element and press ).
Configure Reporting for Glossary Styles
You can apply glossary styles to your RTF, PDF or DOCX documentation through the 'Generate Documentation' dialog (select 'Publish > Report > Documentation > Generate Rich Text Documentation').
Task |
Action |
---|---|
Using the Markup Style |
Select the Markup Glossary Terms checkbox to apply, in the generated report, any styles applied to any Glossary terms through the 'Notes' text of an element. A style is applied to a Glossary term according to its Glossary Term Type. |
Notes
Learn more