After you have implemented conditional content in your project, you need to add or configure condition expressions and filters that you want to use during publishing. Both condition expressions and dynamic content filters use condition tags for granular control over content. Then, configure the output preset from which you want to publish, to include the appropriate condition expressions and dynamic content filters. Next, generate the output for the configured output preset.
A condition expression controls the inclusion of tagged source content or its exclusion from the output. Depending on the condition tags used in an expression, the corresponding source content is included in the output. You can define various tag combinations in the expression using OR, AND, and NOT operators to customize the inclusion or exclusion of content in the output. Condition expressions are not published along with the source content and do not appear in the output.
From the Condition Tags panel, drag a tag and drop it in the expression editor panel.
The tag is removed from the Condition Tags panel and appears in the expression editor panel as a condition.
Against each condition in the expression editor panel, do one of the following:
- Select Include to add the tag in the expression. This action includes all source content associated with the tag in the output.
- Select Exclude to exclude the tag from the expression. This action excludes all source content associated with the tag from the output.
To combine multiple conditions, use the AND and OR operators.
To ensure that the expression runs only when all conditions are met, use the AND operator between the conditions. Use the OR operator to let the expression run if one or more conditions are met.
The following expression displays Developer or EndUser content for Canadian locale.
Dynamic content filter
A dynamic content filter controls the display of content in the output. Add a dynamic content filter and then customize it by adding condition tags. The filters are published along with the tagged source content. From the published filters displayed in the output, your end-users can select specific filters to view selective content and hide the rest of the content. Dynamic content filters facilitate quick retrieval and consumption of specific information, instead of having to go through the entire published content.
From the Condition Tags panel, drag a tag and drop it in the filter editor panel.
The tag is removed from the Condition Tags panel and appears in the filter editor panel along with its original group. For example, the US tag and its original group, Others, appear in the filter editor panel.
If you do not want the original group to appear with the tag, create a new filter group by clicking in the filter editor panel.
A new filter group with the editable title New Group appears. Rename the title as required, for example, rename the title as US-only.
From the Condition Tags panel, drag a tag and drop it under the new filter group in the filter editor panel. For example, drag-and-drop the US tag.
The US tag is removed from the Condition Tags panel and appears under the US-only filter group without its original group Others.
To be able to generate conditional content, you must configure the appropriate output preset to use a specific condition expression and/or dynamic content filter.
Adobe RoboHelp provides several output presets that you can use to generate output as required. If you want to use an existing output preset, proceed to Step 3.
(Optional) If you want to create a new output preset for additional custom requirements, you can add a new output preset for one of the output preset types available in RoboHelp. For information about how to create a custom output preset, see Create an output preset.
After creating an output preset, it appears in the Output Presets panel. Now proceed to Step 3.
In the Output Presets panel, select the configured output preset you want to publish with and click the Generate Preset icon ().
Or, against the configured output preset you want to publish with, choose Options () > Generate.
While the output is being generated, a progress bar appears against the output preset.
Adobe RoboHelp displays a message confirming successful output generation. It also intimates if publishing fails.
When you create a new project, by default, output files are saved in the outputs folder inside the user area:
<user_area>/Documents/My RoboHelp Projects/outputs/<folder_name>/<output_preset_name>.
C:/Users/jdoe/Documents/My RoboHelp Projects/outputs/Travel the Whirls/Responsive HTML 5.
To change the output folder path of an output preset, do the following:
- Against the output preset, choose Options () > Edit.
- In the preset editor panel, select General.
- In the general editor panel, in the Output Path field, choose or type an alternative path. Choose an output path outside your main project folder.
- To save the change, click the Save icon in the standard toolbar.
The option to change the output folder path is available for all output presets, except for Mobile App.
To view the output, in the Output Presets panel, against the output preset you published with, choose Options () > View.
Depending on the output type, it opens in its default viewer. For example, responsive output opens in your default browser. Output generated for mobile app, however, opens in a dialog box:
If you have generated the output in a previous session and if it exists in the system, you can view it anytime, irrespective of which session you are in.