Madcap Flare – Cross References

Cross references are the preferred type of navigation link to be used when generating Word output, since they are the only type that is converted to a useful format.

To change the language that precedes a cross-reference in printed output

  1. Open styles.css in the Stylesheet Editor.
  2. Scroll down to and select the xref style.
  3. Buried in the most unobvious location is a feature to change the language. Click in the second cell of the mc-format row. The Cross-Reference Format dialog magically appears. Who would have thunk it?
  4. In the white text box below the Enter format {preview below} box, replace “See” with something more friendly to the Word reader, like:

See on page {para}

The {para} string will automatically be converted to the appropriate page number upon generation.

Madcap Flare – Conditional Text

Controlling What’s Included/Excluded in Your Output

Facts to know:

  1. In WebHelp or HTMLHelp a topic can show up even though it’s not in the Table of Contents. How? During target generation, Flare processes the topic’s Conditional Text settings from the Content Explorer first. If the topic makes that first cut, it is included in the output and all search results. Flare then processes the Conditional Text settings of the topic’s shortcut in the Table of Contents. If it makes that cut, the topic also appears in the Table of Contents. If it doesn’t, it’s still included in the Search results.
  2. A topic ‘s Conditional Text settings can be different between the Content Explorer and the shortcut to the topic in the Table of Contents.
  3. A topic’s Conditional Text settings in the Content Explorer DO NOT automatically become part of the topic’s shortcut in the Table of Contents. You must set them separately in the Table of Contents.
  4. If a topic’s Conditional Text from the Content Explorer has ANY matching Conditional Text to be INCLUDED in the target, it will show up in search results, even if there are matching EXCLUDES, as INCLUDE takes precedence.
  5. Be careful with many Conditional Text items. Conditional Text does not support nesting. If there are any matching INCLUDES, it’s INCLUDED. There needs to be one controlling Conditional Text item per target.