Conditionalizing a single block element

Background

Starting point

The procedure in this topic assumes Skribenta is installed and configured for normal operation, and:

You have logged into Skribenta.
You are assigned to one of the following user roles: content provider, technical writer or administrator.
You have selected the workspace you want to work in.
A content file or a configuration file is created in the workspace.
You have browsed to and opened the file in the Workspace view or the Publications view.

Your need

You need to conditionalize all the content in an element to be able to use the same content file for multiple publications.

The possibility

It is possible to conditionalize an element, and thereby all the content in the element, by adding a Condition attribute to the element.

By using a variable in the condition, the condition can be evaluated differently depending on the variable value defined in the publication's configuration file. You can then use the same content file in multiple publications, and let the variable value control the published output.

Setting a condition on the include element is not recommended. Instead, set the condition on the included file's maintitle if the condition applies to all places the file is included. If the condition do not apply for all the different places an included file is reused, wrap the include element in an if-wrapper element.

About this task

What you will learn

This instruction tells you how to conditionalize an element, and thereby all the content in the element.

The result

This is the file content before conditionalizing a paragraph element.

This is the file content after conditionalizing a paragraph element.

In the shown images, the XML tags are visible. To show XML tags, see Turning XML element tags on or off.

Overall steps

Right-click the element and select it from the pop-up list, then click Attributes > Condition. Type the condition in the Condition box and then click Apply.

Time

5 minutes

Procedure

In the shown images, the XML tags are visible. To show XML tags, see Turning XML element tags on or off.

1. Make sure that the step(s) in section "Starting point" (see section "Background" above) are performed.

2. In your file content, right-click on an element that you want to conditionalize, for example a paragraph or a section.

A pop-up list opens.

3. In the pop-up list, select the element icon.

A toolbar opens.

4. On the toolbar, click Attributes > Condition.

The Condition tab opens.

5. In the Condition box, type the condition.

In this example the condition is a boolean variable.

6. Click Apply.

The Condition attribute is set on the element.

7. In the publication's configuration file, define the boolean variable, see .

8. To evaluate the condition:

Publish the publication

or
Evaluate the condition directly in the content file, see .