Applying Condition Tags to Content

1. Open the topic.
2. Highlight the text to which you want to apply the condition tag.

3. Select Format>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 text becomes shaded with a lighter version of blue. If more than one condition tag is applied to the text, the shading appears in a pattern that shows all of the applied condition tag colors.

   Click this button at the bottom of the XML Editor to show or hide the span bar above the topic. When the cursor is on the text 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. See About Structure Bars.

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

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 topic.
2. Make sure the tag block bars are visible on the left side of the XML Editor. If they are not, click at the bottom of the local toolbar to show them. See About Structure Bars.

3. Hover over the tag bar for the block of content to which you want to apply the condition tag. When the cursor displays as a hand , click the tag 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 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 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 block of content itself. For example, if your condition tag has blue associated with it and you click this button to show the indicator, the block of content becomes shaded with a lighter version of blue. If more than one condition tag is applied to the block of content, the shading appears in a pattern that shows all of the applied condition tag colors.

   Click this button at the bottom of the XML Editor to show or hide the tag block bar to the left of the topic. When the cursor is on the block of content containing the applied tag, 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. Press CTRL+S or click to save your work.

You can include or exclude entire files from a target. This includes any file contained in the Content Explorer, such as topic, image, style sheet, snippet, and page layout files. You can apply condition tags to one file at a time or to multiple files at once.

To apply condition tags to one file at a time:

1. Make sure the Content Explorer is open. By default, the Content Explorer is located on the left side of the interface in an accordion structure with the Project Organizer, unless you have previously moved it and saved the new layout. You may have to click the Content Explorer bar to bring it into view.
2. Locate and click on the file to which you want to apply a condition tag. By default, topic files are located at the top level of the Content Explorer (unless you place them in subfolders that you’ve created). Other files are located in subfolders within the Resources folder. For example, snippet files are located in a subfolder called "Snippets."

3. In the local toolbar, click . The Properties dialog for the file opens.

4. Click the Conditional Text tab. The first condition tag set is selected and the associated condition tags are 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 file, click the check box next to the tag. A check mark appears in the box.

7. Click OK. The square next to the file name in the Content Explorer now takes on the color of the condition tag. If you applied more than one condition tag to the file, each color is shown. (If you do not see squares, click in the local toolbar.)

   

To apply condition tags to multiple files at once using the File List window pane:

1. Select View>File List or press CTRL+SHIFT+J on your keyboard.
2. (Optional) From the Filter list in the window pane, select the type of files to view.

3. Select the files to which you want to apply condition tags. Hold down the SHIFT key and click a range of files, or hold down the CTRL key and click individual files.

4. In the local toolbar, click . The Properties dialog opens.

5. Click the Conditional Text tab. The first condition tag set is selected and the associated condition tags are shown on the right.

6. If you want to see condition tags for a different condition tag set, select it.

7. For each condition tag that you want to apply to the files, click the check box next to the tag. A check mark appears in the box.

8. Click OK. The squares next to the file names in the File List window pane now take on the color of the condition tag. If you applied more than one condition tag to the file, each color is shown.

To apply condition tags to multiple files at once using the Split View feature:

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

2. In the Content Explorer, click the Show Files button .

   The Content Explorer splits into two halves (left and right).

3. On the left side of the split Content Explorer, select the folder containing the files to which you want to apply condition tags.

4. On the right side of the split Content Explorer, select the files. Hold down the SHIFT key and click a range of files, or hold down the CTRL key and click individual files.

5. In the local toolbar, click .

   The Properties dialog opens.

6. Click the Conditional Text tab.

   The first condition tag set is selected and the associated condition tags are shown on the right.

7. If you want to see condition tags for a different condition tag set, select it.

8. For each condition tag that you want to apply to the files, click the check box next to the tag.

   A check mark appears in the box.

9. Click OK.

   The square next to the file name in the Content Explorer now takes on the color of the condition tag. If you applied more than one condition tag to the file, each color is shown in the square. (If you do not see squares, click in the local toolbar.)

10. To hide the split view, click the Show Files button again.
11. Press CTRL+S or click to save your work.

Note: Notice that the Resources and other subfolders also have blank squares next to them. This means that you can apply condition tags to everything contained in any folder by following the same steps above.

1. Open the topic.

2. Right-click on the bookmark.

   Note: If you cannot see the bookmark, make sure the markers are shown in the topic. To do this, click the Show tags drop-down arrow and select Show Markers.

3. In the popup 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. Press CTRL+S or click to save your work.

You can include or exclude a specific browse sequence entry (book, topic, external link) from 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 Advanced folder.

3. Double-click the browse sequence that you want to open.

   The Browse Sequence Editor opens to the right.

4. Select the entry in the browse sequence to which you want to apply the tag.

5. In the local toolbar, click .

   The Properties dialog for the browse sequence entry opens.

6. Click the Conditional Text tab.

   The first condition tag set is selected and the associated condition tags are shown on the right.

7. If you want to see condition tags for a different condition tag set, select it.

8. For each condition tag that you want to apply to the browse sequence entry, click the blank square next to the tag.

   A check mark appears in the square.

9. Click OK.

   The square next to the browse sequence entry in the Browse Sequence Editor now takes on the color of the condition tag. If you applied more than one condition tag to the browse sequence entry, each color is shown in the square.

   If you cannot see the squares next to the browse sequence entries, click in the local toolbar to show the condition indicators.

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

You can include or exclude from a target a specific index keyword marker that you have previously added.

1. Open the 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 popup 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. Press CTRL+S or click to save your work.

1. Open the 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 (see About Structure Bars). Then click on its span bar above the topic that corresponds with the link. (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."

3. 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.

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 link, click the check box next to the tag.

   A check mark appears in the box.

6. 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. See Using condition tags to unbind hyperlinks.

     example

     Let's say you are creating both online and print-based 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 print-based output that you are generating. When you build the online output, everything is fine. But when you generate the print-based 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 when viewing the print-based document online) is to apply a condition tag (e.g., "ScreenOnly") to the hyperlink and select the "Unbind" option. If you then exclude that condition tag from your print-based target, you will still see the hyperlink text in the print-based output, but the link will be removed. Therefore, you will no longer receive an error and the link will not be broken.

7. Click OK.
8. Press CTRL+S or click to save your work.

1. Open the topic.
2. Hover over the picture until the cursor is an arrow, and then right-click.

3. In the popup 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 picture, 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 picture.

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

1. Open the topic.
2. Right-click on the snippet.

3. In the popup 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. Press CTRL+S or click to save your work.

Note: Not only can you apply a condition tag to a snippet, but you can also create snippet conditions. Snippet conditions are condition tags that you can apply to content within snippets. With snippet conditions, you can separate certain snippet content so that it displays in some topics or master pages but not in others. This allows you to use one snippet for many purposes, rather than having to create multiple snippets. Whereas regular conditions are included or excluded at the target level, snippet conditions are included or excluded at the topic or master page level. See Using Snippet Conditions.

1. Open the topic.
2. Make sure the table row bars and table column bars are shown by clicking and at the bottom of the local toolbar. See About Structure Bars.
3. Place your cursor in the table row or column to which you want to apply the condition tag.
4. Hover over either the table row bar or table column bar (depending on whether you want to apply the tag to the row or the column) until the cursor is a hand , and then click it.

5. In the popup menu, select Conditions.

   The Condition Tags dialog opens, with the first condition tag set selected and the associated condition tags shown on the right.

6. If you want to see condition tags for a different condition tag set, select it.

7. For each condition tag that you want to apply to the row or column, click the check box next to the tag.

   A check mark appears in the box.

8. Click OK.

9. There are two ways to tell whether a table row or column 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 table row or column itself. For example, if your condition tag has blue associated with it and you click this button to show the indicator, the table row or column becomes shaded with a lighter version of blue. If more than one condition tag is applied to the row or column, the shading appears in a pattern that shows all of the applied condition tag colors.

   Click these buttons at the bottom of the XML Editor to show or hide the table row and column bars, respectively. When the cursor is on the row or column containing the applied tag, the 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 row or column distracting. See About Structure Bars.

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

Note: If you want to apply a condition tag to an entire table, see the steps for how to apply a condition tag to an entire block of content in a topic. You can select the <table> tag next to the table and use it to apply condition tags.

1. Open the topic.
2. Right-click on the variable.

3. In the popup 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 do this, click the Show tags drop-down arrow and select Show Markers.

   

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

You can include or exclude a specific TOC entry (book, topic, external link) from 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 TOCs folder.

3. Either double-click Master (Master) or another TOC that you may have created.

   The TOC Editor opens to the right.

4. Select the entry in the TOC to which you want to apply the tag.

5. In the local toolbar, click .

   The Properties dialog for the TOC entry opens.

6. Click the Conditional Text tab.

   The first condition tag set is selected and the associated condition tags are shown on the right.

7. If you want to see condition tags for a different condition tag set, select it.

8. For each condition tag that you want to apply to the TOC entry, click the blank square next to the tag.

   A check mark appears in the square.

9. Click OK.

   The square next to the TOC entry in the TOC Editor now takes on the color of the condition tag. If you applied more than one condition tag to the TOC entry, each color is shown in the square.

   If you cannot see the squares next to the TOC entries, click at the bottom of the local toolbar to show the condition indicators.

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