Learn how to implement conditional content by creating and applying condition tags to your content.

To implement conditional content in your project, you need to add condition tags and apply the tags to your content. After applying the tags, you can preview tagged content to check if the applied tags are working as expected.

Add a condition tag

Adobe RoboHelp provides two default condition tags—Online and Print. You can add new tags and group a bunch of related tags using the Group field in the Define Condition Tag dialog box. For example, you can group the Beginners, Intermediate, Experts, Developers, Administrators, and EndUsers tags under the Audience group. You can also choose background and text colors to differentiate the tags, and the content to which the tags are applied. 

To add a new tag, do the following:

  1. Click the Author tab at the left side of the Standard toolbar.

    The Author view opens.

  2. In the Author toolbar, click the Condition Tags icon. 

  3. In the Condition Tags panel, click the New Tag icon () in the upper-right corner.

  4. In the Define Condition Tag dialog box, do the following:

    1. Choose the group in which you want to create a tag, from the Group drop-down list. For example, to tag audience-specific content, choose the Audience group.

      Märkus.

      If you upgraded to Adobe RoboHelp 2019 from an earlier version, all your previous tags are grouped under the Others group in the Condition Tags panel. This is because the previous versions of Adobe RoboHelp did not contain the Group field. Adobe recommends that you organize your tags under appropriate groups. To do so, drag-and-drop tags from the Others group to the appropriate group in the Condition Tags panel.

      In the Condition Tags panel, groups (such as, Audience and Others) and tags (such as Developer and Adventure) under each group appear as shown in the image:

      condition_tag_groups

      Märkus.

      You can also add a new tag group, and rename and delete existing tag groups. Check out the steps in Manage tag groups.

    2. Specify the tag name in the Name field. 

    3. In the Identify with area, select the background and text colors.

      Background and text colors help differentiate multiple condition tags by highlighting the content chunks to which the tags are applied.

    4. Click Done.

      The group and the condition tag appear in the Condition Tags panel.

Manage tag groups

You can add a tag group to the list of default tag groups. You can also rename and delete existing tag groups.

  1. Choose File > Project Settings or press Ctrl+Shift+/.

    The Project Settings dialog box opens. 

  2. To manage tag groups, use the Tag Groups tab in the Project Settings dialog box. For more information, see Tag Groups.

  3. Click Done to save the changes.

Apply a condition tag

You can apply a condition tag to topics, topic content, TOCs, and indexes. Learn more here:

Apply to a topic

To learn how to work with topics to build your content in RoboHelp, see Create, save, and edit a topic.

  1. Click the Author tab at the left side of the Standard toolbar.

    The Author view opens.

  2. In the Author toolbar, click the Contents icon. 

  3. In the Contents panel, double-click a topic to open it. 

  4. Apply a condition tag to the topic through the Apply Tags button, which is accessible in two ways:

    • Option 1: 

    In the Properties panel, click the Topic tab. Under Condition Tags > Topic-Level, click Apply Tags.

    topic_condition_tags_2

    The Apply Condition Tags dialog box appears.

    • Option 2:

    In the Contents panel, right-click the topic, and then click Properties. In the Topic Properties dialog box, under Condition Tags > Topic-Level, click Apply Tags.

    topic_condition_tags

    The Apply Condition Tags dialog box appears.

  5. In the Apply Condition Tags dialog box, do the following:

    1. From the left side of the dialog box, click the tag you want to apply.
      The selected tag and its group appear in the right side of the dialog box. From here also, you can remove a tag by clicking .
    2. Click Apply Tags to apply the selected tag.

    The applied tag and its group appear under Condition Tags > Topic-Level in the Properties panel or the Topic Properties dialog box. 

  6. To save the changes, click the Save icon in the standard toolbar.

Apply to topic content

To learn how to add content to your topic, see Add content to or edit a topic

  1. Click the Author tab at the left side of the Standard toolbar.

    The Author view opens.

  2. In the Author toolbar, click the Contents icon. 

  3. In the Contents panel, double-click a topic to open it. 

  4. In Author view, select the content element to which you want to apply a tag. For example, select a paragraph.

    content_element_selection
  5. From the Author toolbar, click the Condition Tags icon.

  6. From the Condition Tags panel, drag the condition tag that you want to apply and drop it anywhere on the selected content element in the topic. 

    tag_applied_to_para

    The content element is highlighted in the background and text colors of the condition tag applied.

    In the Properties panel > Topics tab, under Condition Tags > Content-Level, the applied tag and its group appear.

  7. To save the changes, click the Save icon in the standard toolbar.

Apply to a snippet

To learn about how to use and work with snippets in RoboHelp, see Single-source with snippets.

  1. Click the Author tab at the left side of the Standard toolbar.

    The Author view opens.

  2. In the Author toolbar, click the Snippets icon. 

  3. In the Snippets panel, expand and double-click a snippet to open it.

  4. In Author view, select the snippet content to which you want to apply a tag.

    snippet_content_selection
  5. From the Author toolbar, click the Condition Tags icon.

  6. From the Condition Tags panel, drag the condition tag that you want to apply and drop it anywhere on the selected content in the snippet. 

    tag_applied_to_snippet_content

    The snippet content is highlighted in the background and text colors of the condition tag applied.

    In the Properties panel > Topics tab, under Condition Tags > Content-Level, the applied tag and its group appear.

  7. To save the changes, click the Save icon in the standard toolbar.

Apply to a master page

To learn how to work with master pages in RoboHelp, see Work with master pages. You can apply condition tags to the header, topic, footer, breadcrumbs, and topic TOC placeholders in a master page.

  1. Click the Author tab at the left side of the Standard toolbar.

    The Author view opens.

  2. From the Author toolbar, click the Master Pages icon.

  3. From the Master Pages panel, double-click a master page to open it. 

  4. Select the content to which you want to apply condition tags.

  5. To apply condition tags, do one of the following:

    • Right-click the selected content, and click Apply Condition Tags. In the Apply Condition Tags dialog box, drag a condition tag from the left panel and drop it in the right panel. Click Apply.
    • From the Author toolbar, click the Condition Tags icon. From the Condition Tags panel, drag the condition tag that you want to apply and drop it on the selected content. 

    The selected content is highlighted in the background and text colors of the condition tag applied.

    In the Properties panel > Topic tab, under Condition Tags > Content-Level, the applied tag and its group appear.

  6. To save the changes, click the Save icon in the standard toolbar.

Apply to a Table of Contents

To learn how to work with Table of Contents (TOC) in RoboHelp, see Create, edit, and format a Table of Contents.

  1. Click the Author tab at the left side of the Standard toolbar.

    The Author view opens.

  2. In the Author toolbar, click the Table of Contents icon. 

  3. In the Table of Contents panel, double-click a TOC to open it.

    Märkus.

    If the TOC is blank, that is, elements inside the TOC are not visible, click the Auto-create ToC icon on the standard toolbar to create the TOC. Note that clicking the Auto-create ToC icon includes all the topics in your project.

    If you want to apply condition tags to selective pages, books, or TOC, click the Insert Page, Insert Book, or Insert TOC icons on the standard toolbar. Alternatively, click the Contents icon in the Author toolbar and from the Contents panel, drag-and-drop selective topics. 

  4. Select a book or a page inside the ToC.

  5. In the Properties panel, under Condition Tags, click Apply Tags.

    The Apply Condition Tags dialog box appears.

  6. In the Apply Condition Tags dialog box, do the following:

    1. From the left side of the dialog box, click the tag you want to apply.
      The selected tag and its group appear in the right side of the dialog box. From here also, you can remove a tag by clicking .
    2. Click Apply Tags to apply the selected tag.

    In the Properties panel > Topics tab, under Condition Tags > Topic-Level, the applied tag and its group appear.

  7. To save the changes, click the Save icon in the standard toolbar.

Apply to an index

To learn how to work with an index in RoboHelp, see Create and manage an index.

  1. Click the Author tab at the left side of the Standard toolbar.

    The Author view opens.

  2. In the Author toolbar, click the Index icon. 

  3. In the Index panel, right-click an index entry and click Apply Condition Tags.

    The Apply Condition Tags dialog box appears.

  4. In the Apply Condition Tags dialog box, do the following:

    1. From the left side of the dialog box, click the tag you want to apply.
      The selected tag and its group appear in the right side of the dialog box. From here also, you can remove a tag by clicking .
    2. Click Save to apply the selected tag.
  5. To save the changes, click the Save icon in the standard toolbar.

Preview a topic with associated condition tags

You can preview the tagged elements in a topic to verify if the tagging is correct.

  1. Click the Author tab at the left side of the Standard toolbar.

    The Author view opens.

  2. In the Author toolbar, click the Contents icon. 

  3. In the Contents panel, double-click to open the topic that you want to preview.

  4. To switch to Preview mode, click the Preview icon on the right side of the standard toolbar.

    preview_icon

    The preview mode opens and displays all tagged and untagged content. For example, the following image displays content tagged using three tags and untagged content.

    preview_default_view
    A. Content tagged with the EndUser tag B. Content tagged with the Marketing tag C. Content tagged with the Sales tag D. Untagged content 
  5. Select specific condition tags to check which content elements are tagged using the selected tags. For example, select the EndUser and Sales tags.

    In the preview window, all content elements tagged with the selected tags (EndUser and Sales), and all untagged content remain. Content element tagged with the unselected tag (Marketing tag indicated by callout B in the Step 3 image) is filtered out.

    preview_tags_selection
    A. Content tagged with the EndUser tag B. Content tagged with the Marketing tag is filtered out and not visible in the current image C. Content tagged with the Sales tag D. Untagged content 
  6. Select the Highlight selected condition tags field to visually differentiate tagged (only the selected tags) and untagged content.

    In the preview window, tagged content is highlighted in the respective background and text colors of the selected tags (EndUser and Sales). Untagged content is not highlighted.

    preview_highlight_selected_tags

See töö on litsentseeritud Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported litsentsiga  Süsteemi Creative Commons tingimused ei kehti Twitter™-i ja Facebooki postitustele.

Juriidilised märkused   |   Privaatsuspõhimõtted veebis