We have had a couple of requests from folks asking how to change a handful of books or pages in a WebHelp TOC.  The reason for this is that they want a different icon displayed when linking to multimedia, PDF files, spread sheets, etc. To do this all you have to do is create a style class for the TOCEntry Style in the skin.

Before you begin it would be good to get the different icons that you may need.  They should be around 16 px x 16 px unless you want to change the line height of the TOC items.


1. Create a style class in the active WebHelp skin

  •  Open the skin that you use for WebHelp from the Project Organizer (Project Organizer | Skins | Double-click).
  • Click on the Styles Tab and then right-click on the TOCEntry Style.
    Create Class
  • Select Add Class from the UI and name the class.  In this sample we created two styles, one named PDF and one XLS.
  • Select one of the classes that you just created and open the TocIcons Property Group.
  • You will see the property TocIcon.  Click the drop-down and then browse for the image that you want to use for this file type.
    Topic Icon
  • Do the same for the other class that you created.
  • Save all.

2. Apply the style to the desired TOC items

  • Open the TOC that you want to edit (Project Organizer | TOC | Double-click the TOC that you want to open).
  • Right-click on the TOC Page that you want to change and select Properties.
  • On the General Tab, select the one of the classes that you just created and click OK
  • Save all

Note: You will not see the changed icons in the TOC editor in Flare.  Once you compile the help you will see the changes.

3. Build and View the output

All that is left to do is to build the WebHelp output that uses the TOC and skin that you set up.


About The Author

Jose Sermeno

About Jose Sermeno

With over 10 years of experience in the software industry, Mr. Sermeno brings a wealth of knowledge and expertise to the product evangelist team, helping introduce new users to everything MadCap Software. In his spare time, Jose is the Project Director for San Diego City Robotics, the San Diego community college systems robotics program, and enjoys working in software design and open source hardware development. Prior to joining MadCap in late 2010, Jose ran a Drupal development shop, and was an application manager for Temple University Health System.

Last Modified: October 17, 2014

This entry was posted in MadCap Flare, Tech Comm, Tips & Tricks. Bookmark the permalink.

Have Something to Say?

Your email address will not be published. Required fields are marked *