Applying Conditions for Print-Based Output

By applying condition tags to content, you can separate what is intended for printed output and what is not. That way, content intended for online output does not show up in your printed manuals, and content intended for print is left out of the online documentation.

Keep in mind that condition tags are not used only to separate online from print-based output. That's simply a very common use for condition tags. You could have 12 print-based targets and you might use condition tags in all of them so that they each have some unique content.

Applying Conditions

After you create your condition tags (or determine that you will use the tags provided by Flare, you need to apply them to the appropriate portions of content in your topics (e.g., text, blocks of content, tables). For example, the content to be included only in the printed output could be assigned a "PrintOnly" condition tag, the content to be included only in the online output could be assigned a "ScreenOnly" condition tag, and the content to be included in both outputs would be left alone. See Applying Conditions to Content.

In addition to applying condition tags to various content in your project, you may want to use them to unbind hyperlinks from the printed output, displaying the text only.

Example You are creating both online and printed output from your project. You might have some content where you have inserted hyperlinks, and you might want this content to be included in both the online and printed output. However, let's say that a particular hyperlink connects to another topic that you are not including in the printed output. When you generate the online output, everything is fine. But when you generate the printed output, an error is displayed in the log because Flare cannot find the topic referenced in the hyperlink. The way to avoid seeing the error (and to avoid users experiencing a broken link in the output) is to apply a condition tag (e.g., "OnlineOnly") to the hyperlink and select the option in the Condition Tags dialog to unbind the link. If you then exclude that condition tag from your print target, you will still see the hyperlink text in the printed output, but the link will be removed. Therefore, you will no longer receive an error and the link will not be broken.

How to Use a Condition to Unbind a Hyperlink

  1. Open the content file.
  2. Make sure the span bars are visible at the top of the XML Editor. If they are not, click in the local toolbar at the bottom of the editor to show them (see Structure Bars).
  3. Right-click on the span bar above the topic that corresponds with the link.

    Note If you first click on the link in the topic, the corresponding span bar is highlighted above. For hypertext links, the span bar is labeled "a." For cross-references, the span bar is labeled "MadCap:xref."

  4. In the context menu, select Conditions. The Condition Tags dialog opens, with the first condition tag set selected and the associated condition tags shown on the right.
  5. If you want to see condition tags for a different condition tag set, select it.
  6. Click the check box next to the tags where you want the hyperlink to remain. A check mark appears in the box.
  7. In the Exclude Action section, select Unbind.

    In other words, you are telling Flare this: Keep the hyperlink in the targets that are associated with the tags that I selected. For the targets not associated with those tags, get rid of the hyperlink, but do not remove the text.

    On the other hand, if you had selected the "Remove" option, you would have been telling Flare this: Keep the hyperlink in the targets that are associated with the tags that I selected. For the targets not associated with those tags, remove both the hyperlink and the text.

  8. Click OK.
  9. Click to save your work.

What’s Next?

After you create and apply condition tags for printed output, you need to associate the condition tags with the print target that you plan to build. See Associating Conditions With a Print Target.