Applying Conditions to Content

If a Flare author has sent you a topic or contribution template that contains condition tags, you can apply those condition tags to the appropriate content in your document.

You can apply condition tags to many different elements, including full paragraphs, text within paragraphs, table rows and columns, and index keyword markers.

How to Apply Conditions to Selected Text Within a Paragraph

1. Open the document or topic.
2. Highlight the text to which you want to apply the condition tag.
3. Do one of the following, depending on the part of the user interface you are using:
   • Ribbon Select Home > Conditions.
   • Keyboard Shortcut Press CTRL+SHIFT+C.
   • Right-Click Right-click on the text and from 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.

4. If you want to see condition tags for a different condition tag set, select it.
5. For each condition tag that you want to apply to the text, click the check box next to the tag. A check mark appears in the box.
6. Click OK.

7. There are a couple of ways to tell whether a selection of text has one or more condition tags applied to it. In the bottom local toolbar of the XML Editor, click either of the following two toggle buttons to turn the tag indicators on and off.

   Click this button at the bottom of the XML Editor to show or hide shading of the text itself. For example, if your condition tag has blue associated with it and you click this button to show the indicator, the content becomes shaded with a lighter version of blue. If more than one condition tag is applied to the content, the shading appears in a pattern that shows all of the applied condition tag colors.

   You can turn off the condition toggle button mentioned above. Then make sure this button (located at the bottom of the XML Editor) is enabled to show or hide the span bar above the topic. When the cursor is in the paragraph containing the applied tag, the span bar is shaded with a lighter version of the tag color. This is a good feature to use if you find the shading of the actual text distracting.

8. Click to save your work.

How to Apply Conditions to an Entire Block of Content

Topics usually contain several blocks of XML content. For example, there are HTML blocks, body blocks, paragraph blocks, table blocks, and heading blocks. You can apply a condition tag to any block of content in your topics.

1. Open the document or topic.
2. Click on the text to which you want to apply the condition tag. (Do not highlight it.)
3. Do one of the following, depending on the part of the user interface you are using:
   • Structure Bars
     1. If the tag block bars are not shown to the left of the content, click at the bottom of the editor.
     2. Right-click on the tag bar for the block of content to which you want to apply the condition tag.
     3. In the context menu, select Conditions.
   • Ribbon Select Home > Conditions.
   • Keyboard Shortcut Press CTRL+SHIFT+C.
   • Right-Click Right-click on the text and from 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.

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. For each condition tag that you want to apply to the block of content, click the check box next to the tag. A check mark appears in the box.
7. Click OK.

8. There are two ways to tell whether a block of content has condition tags applied to it. In the bottom local toolbar of the XML Editor, click one of the following toggle buttons to turn the tag indicators on and off:

   Click this button at the bottom of the XML Editor to show or hide shading of the text itself. For example, if your condition tag has blue associated with it and you click this button to show the indicator, the content becomes shaded with a lighter version of blue. If more than one condition tag is applied to the content, the shading appears in a pattern that shows all of the applied condition tag colors.

   You can turn off the condition toggle button mentioned above. Then make sure this button (located at the bottom of the XML Editor) is enabled to show or hide the tag block bar to the left of the topic. The tag bar is shaded with a lighter version of the tag color. This is a good feature to use if you find the shading of the actual content distracting.

9. Click to save your work.

How to Apply Conditions to a Bookmark

1. Open the document or topic.

2. Right-click on the bookmark.

   Note If you cannot see the bookmark, make sure the markers are shown in the topic. To turn markers on, click the down arrow next to the Show tags button in the XML Editor. Then select Show Markers.

3. 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.
4. If you want to see condition tags for a different condition tag set, select it.
5. For each condition tag that you want to apply to the bookmark, click the check box next to the tag. A check mark appears in the box.

6. Click OK. A square with the color of the condition tag is displayed next to the bookmark.

7. Click to save your work.

How to Apply Conditions to an Image

1. Open the document or topic.
2. Right-click the image.
3. 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.
4. If you want to see condition tags for a different condition tag set, select it.
5. For each condition tag that you want to apply to the image, click the check box next to the tag. A check mark appears in the box.
6. Click OK. A square with the color of the condition tag is displayed next to the image.
7. Click to save your work.

How to Apply Conditions to an Image Map

1. Open the document or topic.
2. Right-click the image containing the image map.
3. In the context menu, select Image Map.
4. Click on an object on the image (e.g., rectangle) being used as a link. In the local toolbar, click . The Condition Tags dialog opens. (You can also open the Conditions dialog by selecting Edit > Conditions or using the CTRL+SHIFT+C shortcut on your keyboard.)
5. If you want to see condition tags for a particular condition tag set, select it.
6. For each condition tag that you want to apply to that section of the image, click the check box next to the tag. A check mark appears in the box.
7. Click OK. A square with the color of the condition tag is displayed on that section of the image.
8. Click OK in the Image Map Editor.
9. Click to save your work.

How to Apply Conditions to an Index Keyword Marker

1. Open the document or topic.

2. In the XML Editor, right-click on the index keyword marker.

   Note If you do not see the marker, click the Show tags drop-down arrow and select Show Markers.

3. 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.
4. If you want to see condition tags for a different condition tag set, select it.
5. For each condition tag that you want to apply to the index keyword marker, click the check box next to the tag. A check mark appears in the box.

6. Click OK. A square with the color of the condition tag now displays next to the index marker in the topic.

7. Click to save your work.

How to Apply Conditions to a Link

1. Open the document or topic.
2. Make sure the span bars are visible at the top of the XML Editor. If they are not, click at the bottom of the local toolbar to show them.

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 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. For each condition tag that you want to apply to the link, click the check box next to the tag. A check mark appears in the box.
7. In the Exclude Action section, select one of the options.
   • Remove Deletes the link text from the output.
   • Unbind Removes the link from the content in the output, but leaves the text.
8. Click OK.
9. Click to save your work.

How to Apply Conditions to a Slideshow

1. Open the document or topic.
2. If the tag block bars are not shown to the left of the content, click at the bottom of the editor.

3. Right-click on the tag bar for the slideshow to which you want to apply the condition tag. If you want to apply the tag to the entire slideshow, select the MadCap:slideshow bar. If you want to apply the tag to a specific slide, select the Slide bar.

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. For each condition tag that you want to apply to the slideshow, click the check box next to the tag. A check mark appears in the box.
7. Click OK.

8. There are two ways to tell whether a slideshow has condition tags applied to it. In the bottom local toolbar of the XML Editor, click one of the following toggle buttons to turn the tag indicators on and off:

   Click this button at the bottom of the XML Editor to show or hide shading of the text itself. For example, if your condition tag has blue associated with it and you click this button to show the indicator, the content becomes shaded with a lighter version of blue. If more than one condition tag is applied to the content, the shading appears in a pattern that shows all of the applied condition tag colors.

   You can turn off the condition toggle button mentioned above. Then make sure this button (located at the bottom of the XML Editor) is enabled to show or hide the tag block bar to the left of the topic. The tag bar is shaded with a lighter version of the tag color. This is a good feature to use if you find the shading of the actual content distracting.

9. Click to save your work.

How to Apply Conditions to a Snippet

1. Open the document or topic.
2. Right-click on the snippet.
3. 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.
4. If you want to see condition tags for a different condition tag set, select it.
5. For each condition tag that you want to apply to the snippet, click the check box next to the tag. A check mark appears in the box.
6. Click OK. The color of the condition tag is applied to the snippet.
7. Click to save your work.

How to Apply Conditions to a Variable

1. Open the document or topic.
2. Right-click on the variable.
3. 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.
4. If you want to see condition tags for a different condition tag set, select it.
5. For each condition tag that you want to apply to the variable, click the check box next to the tag. A check mark appears in the box.

6. Click OK. A square with the color of the condition tag is displayed next to the variable.

   Note If you cannot see the colored box, make sure the markers are shown in the topic. To turn markers on, click the down arrow next to the Show tags button in the XML Editor. Then select Show Markers.

7. Click to save your work.

What’s Noteworthy?