Apply conditional tags

After you have created conditional tags, you apply these tags to conditionalize text in your docu­ment. For example, if an image applies only to the print output of a document, apply the PrintOnly tag. Also, specify the conditional tag at book level without the need to apply conditions or expres­sions to individual chapters.

Applying conditional tags to text

1)Select the text on which to apply the tag.

The following table details the FrameMaker elements that you need to select to apply condi­tional tags to the corresponding types of FrameMaker content:

To apply a tag to the following content

Select

Text in a text frame, table cell, or footnote

Text

Anchored frame and its contents

Frame border or anchor symbol

Table

Table anchor symbol

Table row

Whole row

Cross-reference or variable

Cross-reference or variable text

Footnote

Footnote reference (the number in the main text)

Marker

Marker symbol

note:  To make a graphic, image, or picture conditional, you need to add these in an anchored frame and then apply a conditional tag to the anchored frame.

2)Open the Conditional Tags pod.

The State column in the list of tags grid displays the state of the tag (applied or not applied) with respect to the current selected text.

3)To apply a tag to the selected text, click to select the State check box.

note:  As soon as you click the State check box, an asterisk displays to the right of the check box. This indicates that you have changed the tag state of the selected text but you have not applied (or saved) the changes.

4)To apply the tag to the text, click Apply in the Conditional Tags pod.

If you have defined conditional indicators for the tag, the applied text reflects these indicators. For example, if you apply the tag to a paragraph of text and text color for the tag is defined as red, the text color of the applied text immediately changes to red.

You can apply multiple tags to a piece of text by selecting the text and selecting the tags in the Condi­tional Tags pod. You can also select text to which a tag is applied and then apply more tags to the text. For more details, see Applying multiple conditional tags.

Keyboard shortcut to apply a conditional tag

You can use the Smart Catalog shortcut to apply a conditional tag:

1)Press Ctrl + 4 to display the Smart Catalog to apply a conditional tag.

2)From the Smart Catalog select the tag to apply.

The state of the tag is updated in the Conditional Tags pod.

Applying conditional tags to tables and anchored frames

FrameMaker gives you visual indicators to identify and distinguish between the various conditional tags applied to tables and anchored frames.

Tables

If you choose the Color conditional indicator when you create the conditional tag, the table border is displayed with a hash of the selected color.

If you choose the Background conditional indicator when you create the conditional tag, the table border is displayed with a solid border of the selected color.

If you do not select either the Color or Background indicators, the table border is displayed with a black colored hash.

Anchored frames

If you choose the Color or Background conditional indicators when you create the conditional tag, the anchored frame border is displayed with a hash of the selected color.

If you do not select either the Color or Background indicators, the anchored frame border is displayed with a black colored border.

Applying multiple conditional tags

You can apply any number of tags to a single piece of text in structured or unstructured documents. You can also overlap tags across text.

If you apply multiple tags on the same text in a document, the following conditions hold:

Conditional indicators behavior:

If each tag has different conditional indicators, FrameMaker attempts to combine the indica­tors. For example, if you apply two tags with Color set to blue and yellow to a paragraph of text, the resultant text displays in green.

Show tag precedence:

The show tag takes precedence. If multiple tags are applied to a piece of text, and at least one tag is marked as show, the text will display.

If you apply multiple tags on overlapping text in a document, the following conditions hold:

Apply Show tag to a large piece of text and Hide tag to its subset:

If you apply a Show tag on a large piece of text and a Hide tag on a subset of text, all the text displays. The reason for this behavior is based on the Show tag precedence. Take the following unstructured document example:

If you apply a Show tag to a paragraph of text (large piece of text), each sentence (subset) inherits the Show tag. So, if you apply a Hide tag on one sentence, that sentence now has a Show tag and a Hide tag applied. The paragraph displays because it has a Show tag applied. Also, based on the Show tag precedence, the sentence also displays along with the paragraph.

Apply Hide tag to a large piece of text and Show tag to its subset:

If you apply a Hide tag on a large piece of text and a Show tag on a subset of text, only the subset displays. The reason for this behavior is based on the Show tag precedence. Take the following structured document example:

If you apply a Hide tag to an ordered (ol) list (large piece of text), each list (li) item (subset) inherits the Hide tag. So, if you apply a Show tag on one list item, that item now has a Show tag and a Hide tag applied. The other list items do not display because each of them have inherited the ordered list Hide tag. However, based on the Show tag precedence, the list item on which the Show tag is applied displays.

Applying conditional tags at book level

To apply one or more conditions that are common across chapters in your book:

note:  Your .book file can be a mix of both structured (.XML) and unstructured (.fm) files. However, you cannot apply conditions at the book level for .ditamap and .bookmap files.

1)Select the .book file.

2)Choose View > Show/Hide Conditional Text.

3)Select the condition(s) that you want to apply to all files in the book.

4)Select the Update Book After Apply option.

5)Click Apply and click OK on the alert dialog.

6)Click Update on the Update Book dialog.

The selected condition(s) are applied to all files in the book.

Applying conditional tags in structured documents

In a structured FrameMaker document, elements are arranged hierarchically. FrameMaker allows you to apply conditional tags to any element in the document hierarchy. For example, you can apply a conditional tag to the definition list (dl) or to any element contained within the list.

You need to take care not to break the structure of the document. If you apply a conditional tag to a mandatory child element and mark tag as hidden, the document structure is broken. FrameMaker does not prevent you from doing this; however, the Structure View will indicate the break in the document.

Broken structure when the dt tag is marked as hidden

frm_structview_broken_ct.png
Apply conditional tag to elements in a structured document

To apply a conditional tag to an element, by default, you need to select the entire element (in the Structure View pod) and then apply the conditional tag (in the Conditional Tags pod or by using Ctrl+4). However, if you set (or add) the following maker.ini flag, you can apply a tag to an element by placing the cursor anywhere within the element:

ApplyCondTillElementBoundaries=On

Processing instructions for conditional tags

When you apply conditional tags to a structured document, the processing instructions to handle the tags are defined in the structured application. For details, see the Specifying conditional text output section of the FrameMaker Structure Application Developer’sReference.

Processing instructions for conditional tags applied to table columns

When you apply conditional tags to the columns in a table, FrameMaker adds processing instruc­tions to enable round-tripping in the XML.

For example, the following processing instruction indicates that the condition ConditionCol1, is applied to first column of the table:

<?Fm TableColumnCond start=0 end=0 ConditionCol1?>

The following processing instruction indicates that the condition ConditionCol1, is applied to first column of the table:

<?Fm TableColumnCond start=1 end=2 ConditionCol2?>

Removing conditional tags from text

If you need to make a specific piece of text unconditional, you can remove the conditional tags applied to that text. In this case, FrameMaker does not delete the tags from the document catalog. This implies that can apply the tags to other text in the document. To delete conditional tags from a document, see Deleting conditional tags.

1)Select the text from which you want to remove the applied conditional tag.

2)Open Conditional Tags pod and deselect the State check box for the required Conditional Tag.

note:  As soon as you click the State check box, an asterisk displays to the right of the check box. This indicates that you have changed the tag state of the selected text but you have not applied (or saved) the changes.

3)Click Apply in the Conditional Tags pod.

If you have defined conditional indicators (such as style, color, or background) for the conditional tag, the indicators are removed from the text from which you remove the tag.

Keyboard shortcut to remove a conditional tag

You can use the Smart Catalog shortcut to a remove conditional tag:

1)Press Ctrl + 5 to display the Smart Catalog to remove a conditional tag.

2)From the Smart Catalog select the tag to remove.

The state of the tag is updated in the Conditional Tags pod.

Removing all conditional tags from text

You can choose to remove all conditional tags that are applied to a piece of text in a document.

1)Select the text from which to remove all the tags.

2)Click Uncheck All in the Conditional Tags pod.

note:  As soon as you click Uncheck All, an asterisk displays to the right of the check box for each Conditional tag applied to the text. This indicates that you have changed the tags state of the selected text but you have not applied (or saved) the changes.

3)To remove all the tags from the text, click Apply in the Conditional Tags pod.

If you have defined conditional indicators (such as style, color, or background color) for the tags, the indicators are removed from the text from which you remove the tags.

Keyboard shortcut to remove all conditional tags

1)Press Ctrl + 6 to remove all conditional tags from the selected text.

The state of the tags is updated in the Conditional Tags pod.

Identifying the state of conditionalized text

The conditional tag State check box in the Conditional Tag pod has two functions:

1)The State check box allows you to apply or remove conditional tags from text in a document.

2)If you select text, the check box indicates the current state of the text. This implies that if you select a piece of text to which one or more tags is applied, the State check boxes appear checked for the corresponding tags.

However, the check boxes also have an As Is state. This state indicates that one or more tags are applied to part of the text. For example, if a tag is applied to a sentence and you select the entire para­graph, the tag displays the As Is state. Similarly, if you select two paragraphs to which two different tags are applied, both the tags display the As Is state.

Conditional tag intermediate state

frm_ctpodinterstate_ct.png

Copying conditions across text

You can copy the conditions applied to one piece of text to other pieces of text. For example, say two conditional tags are applied to one paragraph of text. You can use the special Copy - Paste function­ality to apply both these tags to another piece of text.

To copy conditions across text:

1)Select the text from which to copy the condition or conditions.

note:  To check that you have selected the text correctly, ensure that the State checkbox in the Conditional Tags pod displays as checked.

2)From the Edit menu, choose Copy Special > Conditional Tag Settings.

3)Select the text to which to apply the tags.

4)From the Edit menu, choose Paste.