Open topic with navigation

Associating Condition Tags with Targets

After creating and applying condition tags, you need to tell Flare what your target should do with the condition tags that you have created and applied. Should content with a particular condition tag be included in or excluded from that target?

How to associate a condition tag with a target

1. Make sure the Project Organizer is open. By default, the Project Organizer is located on the left side of the interface in an accordion structure with the Content Explorer, unless you have previously moved it and saved the new layout. You may have to click the Project Organizer bar to bring it into view.

2. Double-click the Targets folder. The folder opens, showing the targets in your project.

3. Double-click the target that you want to associate with one or more condition tags. The Target Editor opens to the right.

4. Click the Conditional Text tab. The Conditional Text tab shows all of the condition tags in your project and their associated colors. An Include and Exclude check box appears next to each condition tag.

5. By default, all tags will be included in the target unless you specify otherwise. If you want to exclude a condition tag from the output for this target, click the Exclude check box next to it. If you want to make sure a condition tag is included in the output for this target, click the Include check box next to it.

   Why is there an Include check box if all tags are included by default? The Include check box is necessary in case you have two or more tags associated with the same content and there is a conflict.

   example

   Suppose you have two condition tags in your project—one called "Beginner" and another called "Advanced." Let's say that you have a topic containing three paragraphs. You apply the "Advanced" tag to the first two paragraphs, and you apply the "Beginner" tag to the last two paragraphs.

   You have created a target called "Advanced Set Up." For this target, you obviously want to include all content associated with the "Advanced" tag, but you want to exclude content associated with the "Beginner" tag.

   By default, Flare will include content associated with both tags, unless you tell it not to. So you tell Flare to exclude the content associated with the "Beginner" tag. The problem is the middle paragraph from the topic mentioned above. It is associated with both tags. You have told Flare to exclude content associated with the "Beginner" tag, and it will do so, overriding the default. But you want to make sure that paragraph is included in the "Advanced Set Up" output. That is why you need to make sure you select the Include check box next to the "Advanced" tag.

6. Press CTRL+S or click to save your work.

Note: Condition tags are not supported if you are generating a target using the DITA output type, in the sense that you cannot include or exclude condition tags for that DITA output. Therefore, when you open a DITA target, the options in the Conditional Text tab are disabled. However, DITA-specific condition tag attributes are preserved in Flare when you import from DITA; the DITA attributes are converted to condition tag sets in Flare. In fact, you can create custom condition tag sets in Flare that can be useful when you generate DITA output from Flare. You simply need to make sure that the condition tag sets follow the established DITA naming conventions for those attributes: condition tag sets can be named "audience," "product," "platform," "props," and "otherprops." When you generate the output, the condition tag sets are converted to the appropriate DITA attributes.

See Also

Open topic with navigation