In my last post, I showed you how to use auto-numbering and cross-references to build numbered figures and references to those figures in preceding paragraphs.

Now I’m going to show you how to create a List of Figures in your PDF document using the work you did on the figures.

I’m going to make the following assumptions:

• You’ve already created auto-numbering for your figure captions (or you know how to do it)
• You’ve already created and applied a style class for those captions

If you don’t know how to do either of the steps above, click here to learn.

Now let’s create a List of Figures and make it look all nice and attractive. I’m going to build mine on the same page as my printed TOC.

So I open the Printed TOC topic and I add a List of… proxy.

Flare doesn’t care what you’re making a list of so you don’t need to worry about it not saying List of Figures.

It’s when the List-of Proxy window opens that you’ll tell Flare what kind of list you want. This is where the magic happens!

If you recall from my previous post, we set all figure captions to the p.caption style class. We’re going to use that here by selecting <p> as the tag name and caption as the Tag Class. With this setting, every p.caption in your project will appear in your list of figures.

Now, to determine how the list items will look, I selected TOCHeading from the pull-down menu. This is a <p> style class that I created for this effort. The settings for this class are:

p.TOCHeading
 {
 color: #000000;
 mc-heading-level: 1;
 mc-leader-format: '.';
 font-size: 11pt;
 font-family: Verdana;
 font-weight: normal;
 margin-bottom: 4pt;
 margin-top: 4pt;
 }

Note that this is in the Print medium!

Without these properties set, my List of Figures would look entirely different than the TOC and I needed them to look like a matched pair. Here’s the final result:

There are a couple of things to mention here:

• The TOCHeading style is designed to change the look of the list entries, not the figure captions themselves. In my project, my figure captions are italicized and 9pt, in the list of figures, the captions are normal and 11pt.
• Making these changes in the wrong medium will result in frustration, wasted time, and possibly the use of foul language. So keep confirming that you’re working the Print medium.
• Unlike Word you don’t have to remember to do that annoying Update TOC thing. Every time you build your print target, the page numbers will be recalculated. Yeah!

In my next post, I’ll talk about how to keep the Table of Contents and List of Figures headings from appearing in your TOC.

I recently completed a project where I needed to build in auto-numbering for figures and then cross-references to those figures in preceding paragraphs. I’ve built many an auto-numbered figures, and had inserted many cross-references but never both in the same project. This was just my kind of challenge.

The parts to this task are:

• Creating the auto-numbering style class
• Assigning that style class to your figures
• Creating book-marks
• Editing cross-reference style
• Creating cross-references

It sounds like a lot but it isn’t.

Before I go any further with instructions, please be sure that you are working in your Print medium. I cannot stress this enough.

Creating an Auto-Numbering Style

Let’s create a new style class in the <p> tag called caption. We will be applying the auto-numbering to that class.

Open your stylesheet and go to the <p> tag and create a new class called ‘caption’ and set the properties as shown:

This is standard format for numbering figures. In this document, I didn’t need to add chapter numbers or anything else to the caption – just the figure number. I added the H to separate this style from all other auto-numbering that I had established in the project. If you don’t do this, then Flare won’t know to separate numbering chapters from numbering figures and you’ll have a big mess:

Chapter 1

Figure 2

Figure 3

Chapter 4

etc.

That would be bad.

Applying That Style to P Tags

Apply that new p.caption style class to all captions that need a figure number. Where ever you’ve applied the style, this is what you’ll see in your XML Editor:

 Note that in each topic, the figures will start at number 1, regardless of that topic’s location in the document. The auto-numbering will not be sorted out until you build the output.

Creating Bookmarks

While you’re applying the style to the <p> tags that are captions,  go ahead and create bookmarks. This step will allow you to create cross-references in a few more steps.

To create a bookmark, click at the beginning of the caption name (note that you won’t be able to click in front of  ‘Figure.’) and go to Insert > Bookmark and, when the bookmark window opens, name the bookmark. For this project, I just used the first word of the caption.

Here’s an example of one of the bookmarks.

Now that you’ve applied the caption style to all the <p> tags that need it and you’ve created bookmarks as well, you are ready to work with the cross-references.

Editing Cross-References Style

Now to tell Flare how to refer to those figures in the preceding paragraph. For this project, I only want to show the figure number, not the caption too. I’ll save you the trouble and tell you that there isn’t a pre-made style for this. SO, we get to make a new xref style.

Go to your stylesheet and look for MadCap|Xref and create a new style. I called mine fig_ref.

In the Unclassified section of Properties, find mc-format and edit it to look like this:

You’ll see in the preview that only the caption number will appear.

Adding Cr0ss-References to Your Document

We’re almost done!

Now go to where ever you want to add a cross-reference to your figure. Click Insert > Cross-Reference.

(Here’s where your bookmarks come in!)

When the window opens, select:

• Link to: Place in this Document
• The correct bookmark
• The new xref class

You’ll see a preview of what you’ll get in the lower right hand corner of this window. If it looks good, click OK.

Here’s what I see in my XML Editor:

Using this method, when you build your PDF output, your figures will be numbered correctly and your figure references in preceding paragraphs will be correct as well.

In my next post, I’ll show you how to create and format a List of Figures based on what you’ve done above.