Editing the Look of a List of Concepts

After you use the Concepts proxy to create a list of concepts, you can change the look of that list by using styles. You can modify the look of individual entries in the list, as well as the entire container.

How to Edit the Look of a List of Concepts (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 The button to change the stylesheet to the advanced view.. If the button displays The button to change the stylesheet to the simplified view. 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 Use the drop-down filter for "all styles" to view in the stylesheet..
  4. On the left side of the editor, scroll down and select the MadCap|ConceptsProxy style or a class that you have created under it (e.g., MadCap|ConceptsProxy.myclass).
  5. From the Show drop-down list on the upper-right side of the editor, select Show drop-down set to display all properties in styles..

    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 Stylesheet local toolbar button to show properties in a group view. or an alphabetical view Stylesheet local toolbar button to show properties in 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 Display more options. 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 concepts, you would first expand the Box property group. Then to the right of width, click Display more options., and in the popup set the value.

    Another example would involve adding headings to a list of concepts. You would expand the Unclassified property group and select an option next to the the mc-concepts-list-headings property to enable or disable concept list headings.

    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 Save the active file. to save your work.

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

  1. From the Content Explorer, open the stylesheet that you want to modify.
  2. In the local toolbar, make sure the first button displays The button to change the stylesheet to the advanced view.. If the button displays The button to change the stylesheet to the simplified view. 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 Use the drop-down filter for "all styles" to view in the stylesheet..
  4. On the left side of the editor, select a style class, depending on what you want to change.

    To Edit Concept Terms and Text

    Expand the p style, and select either of the following classes under it:

    • Concept Select this class to control the look of the concept terms displayed in the generated list.
    • ConceptContext Select this class to control the look of the text associated with each concept term in the generated list.

    To Edit Page Numbers for Print Output

    Expand MadCap|xref and select the ConceptPageNumber style class.

  5. From the Show drop-down list on the upper-right side of the editor, select Show drop-down set to display all properties in styles..

    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 Stylesheet local toolbar button to show properties in a group view. or an alphabetical view Stylesheet local toolbar button to show properties in 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 Display more options. 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 for concept terms and text. (If changing the look of the actual page numbers, you might use other properties, such as font color.)

    • 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 Display more options., 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 Display more options., 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 Display more options., 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 Display more options., 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 Display more options. 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 Display more options. 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 Display more options., 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 Display more options., 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 Display more options., 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.

  9. Click Save the active file. to save your work.