Editing the Look of a List of Elements

When you use the List-Of proxy to create a list of elements (such as a list of figures or tables), you have the option of selecting a couple of style classes in the List-Of Proxy dialog.

  • In the field labeled Stylesheet class for each generated entry, you can select a style class for determining how each item in the generated list looks. You would use this style class, for example, if you want to change the font of the entries or add a leader (e.g., series of dots) between the entries and the page numbers. This should be a custom class of the p style that you have created.
  • In the field labeled Stylesheet class for proxy, you can select a class to affect the look of the entire list.

    You might create and use a proxy style class, for example, if you want to add a border around the generated list. If you do not select a class from this field, the generated list will use the style settings from the parent MadCap|listOfProxy style. You have the option of creating a class for this proxy style in the Stylesheet Editor. To do this, select the MadCap|listOfProxy style and in the local toolbar click Add Selector to create a class. The class will then be available from this field.

Therefore, when you want to change the way a list of elements looks (either each entry or the entire container), you simply need to adjust the properties for the appropriate style. See Editing Styles in a Regular Stylesheet.

How to Edit the Look of a List of Elements (Entire Container)

  1. From the Content Explorer, open the stylesheet that you want to modify.
  2. In the local toolbar, make sure the first button displays . 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 of the editor, make sure the drop-down field is set to .
  4. On the left side of the editor, scroll down and select the MadCap|listOfProxy style or a class that you have created under it (e.g., MadCap|listOfProxy.myclass).

    This is the same style that you selected in the field labeled Stylesheet class for proxy in the List-Of Proxy dialog (when you inserted the List-Of proxy).

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

    Note If you want to see properties that are of particular importance for a style, you can select Show: Assorted Relevant Properties.

  6. (Optional) You can use the toggle button in the local toolbar to show properties below in a group view or an alphabetical view .
  7. Locate the property you want to change.
  8. The area to the right of the property is used for selecting and entering values. If you know how to enter the information correctly, you can click in the value field and type it directly. Otherwise, click the ellipsis button to the right of the property. Depending on the type of property, the appropriate controls and options display, allowing you to choose or enter values (e.g., select from a drop-down list, click a button, complete fields in a dialog or popup). If you completed values in a popup, click OK at the bottom of the box.

    For example, if you want to change the width of the entire list of elements, you would first expand the Box property group. Then to the right of width, click , and in the popup 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 Styles and Stylesheets, Editing Styles in a Regular Stylesheet, and Stylesheet Editor.

  9. Click to save your work.

How to Edit the Look of a List of Elements (Individual Entries)

  1. From the Content Explorer, open the stylesheet 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 displays styles in a grid view and is often best for brand new users.

      This view provides an easy way to apply properties to styles, with format options available from a toolbar and dialogs (similar to the way one would use an interface such as Microsoft Word). In some cases, only the most common property options are available in the Simplified view (e.g., font, letter/word spacing, paragraph alignment/indentation, autonumbering 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 styles in a tree structure, and despite the name, is user friendly for authors of all levels.

      For the properties, you can toggle between a grouped display and an alphabetical display. The Advanced view of the Stylesheet Editor lets you edit more settings than are available in the Simplified view. In addition, the Advanced view lets you see and apply settings to multiple mediums and media queries at the same time.

    Warning Mediums can be used if you want to use one group of settings for online output types and another group of settings for print-based output types. For example, you might use the default medium for your online outputs and the print medium for your print outputs.  From the Medium drop-down in the Stylesheet Editor, make sure the proper medium is selected before you begin. In the Advanced view, you can open multiple mediums at once; you just need to look at the title at the top of the medium pane and make sure you are working in the correct one. If you are not using stylesheet mediums for your different outputs or if you want all mediums to have the same settings, just leave the medium set to default and continue. Please note that Flare remembers the last medium that you used when working in the stylesheet, so it may or may not be the one that you want to use the next time around. See Mediums and Media Queries.

    If Using 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 of the editor, make sure the drop-down field is set to .
    3. In the Styles section of the editor, scroll down and select the style to be used for each generated item. This is the same style that you selected in the field labeled Stylesheet class for each generated entry in the List-Of Proxy dialog (when you inserted the List-Of proxy).

      Note The page numbers in the generated list inherit their style settings from the list items before them. However, if you want the page numbers to look differently, you can modify the MadCap|xref.ListOfPageNumber style.

    4. In the local toolbar of the editor, click . The Properties dialog opens.
    5. Select the Leader tab.
    6. Modify any of the following fields on the tab.
      • Leader Select the format of the area between the item in the list and the page number (None, Dot, Dash, Underline).
      • Page Number Select the alignment (Left, Center, Right) of the page number.
      • Page Number Width To change the width of page numbers in the list, click the upper-right arrow and select Length. Then enter a number and unit of measurement.

      Additional changes can be made in the Advanced view.

    If Using Advanced View

    1. In the local toolbar, make sure the first button displays . If the button displays instead, then click it.
    2. In the upper-left of the editor, make sure the drop-down field is set to .
    3. On the left side of the editor, scroll down and select the style to be used for each generated item. This is the same style that you selected in the field labeled Stylesheet class for each generated entry in the List-Of Proxy dialog (when you inserted the List-Of proxy).

      Note The page numbers in the generated list inherit their style settings from the list items before them. However, if you want the page numbers to look differently, you can modify the MadCap|xref.ListOfPageNumber style.

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

      Note If you want to see properties that are of particular importance for a style, you can select Show: Assorted Relevant Properties.

    5. (Optional) You can use the toggle button in the local toolbar to show properties below in a group view or an alphabetical view .
    6. Locate the property you want to change.
    7. The area to the right of the property is used for selecting and entering values. If you know how to enter the information correctly, you can click in the value field and type it directly. Otherwise, click the ellipsis button to the right of the property. Depending on the type of property, the appropriate controls and options display, allowing you to choose or enter values (e.g., select from a drop-down list, click a button, complete fields in a dialog or popup). If you completed values in a popup, click OK at the bottom of the box.

      Following are some of the more common properties that you might change.

      • Alignment of Page Number (Print Output) To change the alignment (left, right, center) of the page number, expand the Unclassified property group. Then to the right of mc-leader-align, click , and select one of the alignment options.
      • Font Family To change the font family (e.g., Arial, Verdana), expand the Font property group. To the right of font-family, click , and select the font or a font set you want to use.
      • Font Size To change the font size (e.g., 10 pt, 11 pt), expand the Font property group. To the right of font-size, click , and set the font size.
      • Leader Format (Print Output) To change the format of the area between the item in the list and the page number, expand the Unclassified property group. To the right of mc-leader-format, click , and type the character to use. For example, if you want a series of dots, type a period. If you do not want to use a leader format, leave this field blank.

        Note You can enter one character only (period, hyphen, or underscore). Spaces are also supported, and if you use a character that is not supported, a space will automatically be used.

      • Leader Space Before/After (Print Output) Expand the Unclassified property group. To change the distance from the end of the list entry to the start of the leader, click to the right of mc-leader-indent, and set the margin value. To change the distance between the end of the leader and the page number, click to the right of mc-leader-offset, and set the margin value.
      • Padding Above To change the amount of empty space (padding) above the item in the list, expand the Box property group. To the right of padding-top, click , and set the padding value. You can also use the other cells in this property group to add padding below, to the left, or to the right.
      • Space in Front (Indentation) To change the distance from the left page margin to the beginning of the item in the list, expand the Box property group. To the right of margin-left, click , and set the margin value. You can specify additional indentation for headings that wrap to more than one line. To do this, expand the Unclassified property group. To the right of mc-multiline-indent, click , and set the margin value. See Creating Multiline Indentation.

      Note For more information about the components and properties in the editor, as well as the tasks that you can perform in it, see Styles and Stylesheets, Editing Styles in a Regular Stylesheet, and Stylesheet Editor.

  3. Click to save your work.