Using Styles to Change the Look of a Glossary

1. Open the style sheet that you want to modify.

2. Complete one of the following sets of steps, depending on whether you want to use the Simplified view or Advanced view in the Stylesheet Editor.

   • Simplified The Simplified view is better for new users. It provides an easier way to apply properties to styles, with format options available from a toolbar (similar to the way one would use the Text Format toolbar to change the look topic content without a style). In many cases, only the most common property options are available in the Simplified view (e.g., font, letter/word spacing, paragraph alignment/indentation, auto-numbering format, borders, background). One advantage of the Simplified view is that you can apply a property to multiple styles at the same time. You can also click a check box to hide the properties in the editor, allowing you to see only the styles.
   • Advanced The Advanced view displays style classes and properties in hierarchical tree structures. It is not as quick as using the Simplified view, but it allows you to edit a great deal more settings than are available in the Simplified view.

Note: If you want to change the actual characters for the alphabetical headings above each section in the glossary, you must use the Advanced view.

If using the Simplified view:

1. In the local toolbar, make sure the first button displays (which means that the Simplified view is currently shown in the editor). If the button displays instead, then click it.
2. In the upper-left corner of the Stylesheet Editor, make sure the Show Styles field is set to Show All Styles.
3. From the grid in the bottom portion of the Stylesheet Editor, select a style.
   • To customize the definition Select div.GlossaryPageDefinition.
   • To customize the container Select div.GlossaryPageEntry. This style class affects the "container" that holds each glossary term/definition group.
   • To customize the heading Select div.GlossaryPageHeading. This style class affects the text for each alphabetical heading that is displayed above each section of the glossary.
   • To customize the term(for online output) Select a.GlossaryPageTerm. You can also use one of the pseudo classes under it to change the look of the term, depending on its hyperlink behavior (focus, hover, link, visited).
   • To customize the term (for print-based output) Select div.GlossaryPageTerm.
   • To customize the glossary term link Select MadCap|glossaryTerm. This style affects the text for glossary term links that you have inserted into topics. You can also use one of the pseudo classes under it to change the look of the term, depending on its hyperlink behavior (focus, hover, link, visited).
     • To customize the glossary term link (Hyperlink style) Select MadCap|glossaryTerm.Hyperlink. This style class affects the hyperlink that displays in topics if you have converted glossary terms to links and selected the "Hyperlink" style when doing so.
     • To customize the glossary term link (Expanding style) Select MadCap|glossaryTerm.Expanding. This style class affects the hyperlink that displays in topics if you have converted glossary terms to links and selected the "Expanding" style when doing so.
     • To customize the glossary term link (Popup style) Select MadCap|glossaryTerm.Popup. This style class affects the hyperlink that displays in topics if you have converted glossary terms to links and selected the "Popup" style when doing so.

4. In the local toolbar of the editor, click . The Properties dialog opens.

5. Use the Properties dialog to change values for the style's properties.

   Note: For more information about the components and properties in the editor, as well as the tasks that you can perform in it, see About Styles and Style Sheets, Editing Styles, and Stylesheet Editor.

6. In the Properties dialog, click OK.

If using the Advanced view:

1. In the local toolbar, make sure the first button displays (which means that the Advanced view is currently shown in the editor). If the button displays instead, then click it.
2. In the upper-left corner of the Stylesheet Editor, make sure the Show Styles field is set to Show All Styles.
3. In the Styles section on the left side of the editor, select the style that you want to edit.
   • To customize the definition Click the plus button next to div. Then select GlossaryPageDefinition under it.
   • To customize the container Click the plus button next to div. Then select GlossaryPageEntry under it. This style class affects the "container" that holds each glossary term/definition group.
   • To customize the heading Click the plus button next to div. Then select GlossaryPageHeading under it. This style class affects the text for each alphabetical heading that is displayed above each section of the glossary.
   • To customize the term(for online output) Click the plus button next to a. Select GlossaryPageTerm. You can also use one of the pseudo classes under it to change the look of the term, depending on its hyperlink behavior (focus, hover, link, visited).
   • To customize the term (for print-based output) Click the plus button next to div. Then select GlossaryPageTerm.
   • To customize the glossary term link Click the plus button next to MadCap|glossaryTerm. This style affects the text for glossary term links that you have inserted into topics. You can also use one of the pseudo classes under it to change the look of the term, depending on its hyperlink behavior (focus, hover, link, visited).
     • To customize the glossary term link (Hyperlink style) Click the plus button next to MadCap|glossaryTerm. Then select Hyperlink under it. This style class affects the hyperlink that displays in topics if you have converted glossary terms to links and selected the "Hyperlink" style when doing so.
     • To customize the glossary term link (Expanding style) Click the plus button next to MadCap|glossaryTerm. Then select Expanding under it. This style class affects the hyperlink that displays in topics if you have converted glossary terms to links and selected the "Expanding" style when doing so.
     • To customize the glossary term link (Popup style) Click the plus button next to MadCap|glossaryTerm. Then select Popup under it. This affects the hyperlink that displays in topics if you have converted glossary terms to links and selected the "Popup" style when doing so.
4. From the Show Properties drop-down list on the upper-right side of the editor, select Show: Property Groups.
5. Click the plus button next to the appropriate property group, depending on what you want to accomplish.

6. Locate the specific property that you want to change. The property name is shown in the left column. The right column is used for selecting and entering values for the property.

7. Click in the value column on the right side. Depending on the type of property, you can either type the value, select it from a drop-down list, or complete the values in a dialog or popup box. If you completed values in a popup, click OK at the bottom of the box.
8. (Optional) If you want to change the actual characters (e.g., A, B, C, D) that are used for the glossary headings, do the following:
   1. Under the div tag on the left side of the editor, make sure GlossaryPageHeading is selected.

   2. From the Show drop-down list on the upper-right side of the editor, select Property Groups.

   3. In the Properties section to the right, click the plus button next to the Unclassified property group.

   4. Click in the cell to the right of mc-heading-format and type the new format. Make sure you place the character within { and } brackets.

      example

      The default format is {A}. This means that the headings will simply look like this: A, B, C, D, and so on. If you change it to {a}, the headings will be lowercase: a, b, c, d, and so on. If you change it to -{A}-, the headings will look like this: -A-, -B-, -C-, -D-, and so on.

Note: For more information about the components and properties in the editor, as well as the tasks that you can perform in it, see About Styles and Style Sheets, Editing Styles, and Stylesheet Editor.

3. Press CTRL+S or click to save your work.

If you use the glossary <div> styles to change the look of a generated glossary, the following information and diagram may help to clarify the purpose of each style. Because these styles use <div> tags, you can think of them as nested boxes. This is important to understand when you try to align the different glossary elements through the use of margin and padding settings.

• Margins Control space outside of the box.
• Padding Controls space inside the box.

As a result of the boxes being nested, the margin and padding settings compound the distances in the output, as the following diagram shows.

In the output, this type of collection of style settings might look like this.

1. Open the style sheet that you want to modify.

2. In the local toolbar, make sure the first button displays (which means that the Advanced view is currently shown in the editor). If the button displays instead, then click it.

   Note: Some of the necessary style properties can also be changed in the Simplified view in the Stylesheet Editor.

3. In the upper-left corner of the Stylesheet Editor, make sure the Show Styles field is set to Show All Styles.
4. In the Styles section of the editor, scroll down and select the MadCap|GlossaryProxy style or a class that you have created under it (e.g., MadCap|GlossaryProxy.myclass).

5. From the Show Properties drop-down list on the upper-right side of the editor, select Show: Property Groups.

6. In the Properties section to the right, click the plus button next to a property group (e.g., Font, Block, Box) to see the actual properties within it.
7. Locate the specific property that you want to change. The property name is shown in the left column. Use the right column to select and enter values for the property. Depending on the type of property, you can either type the value, select it from a drop-down list, or complete the value entries in a popup box.

   For example, if you want to change the width of the entire glossary, you would first expand the Box property group. Then you would click in the cell to the right of the width property and set the value.

   Note: For more information about the components and properties in the editor, as well as the tasks that you can perform in it, see About Styles and Style Sheets, Editing Styles, and Stylesheet Editor.

8. Press CTRL+S or click to save your work.