In technical publications, it is quite common to have list items and steps that are repeated in various different topics. For example, if you are documenting software, it is likely that you will use a 'Save' step in lots of different procedures.
In Paligo, there are two different ways to reuse steps. You can use:
The reuse text feature for single list items or steps
An informal topic to reuse a sequence of list items or steps.
If you want to reuse an entire list or procedure, add the list/procedure to an informal topic. You can then add the informal topic to other topics where appropriate.
To find out how to reuse items in lists, see the following sections.
If you only want to reuse a single item or step in a list, you can use the Reuse text feature. This works in the same way as reusing a text fragment.
The text in a step or list item is enclosed in a
para element. For example, a step in a procedure looks like this: <
para>The text for the step.</
step>. So to reuse a single step, you should first create a new step, and then reuse a
para element inside it.
To find out how to reuse a single step, watch the video or read the following instructions:
Open the topic that you will insert the reused step into.
Add an extra step for the list or procedure. You can add an extra step by clicking at the end of the previous step and pressing Enter. Alternatively, position the cursor at the appropriate position and use the Element Context Menu to add a new
Click in the
paraelement that is created for the new step.
In the Reuse text section, search for the text of the step/listitem that you want to reuse.
When Paligo finds the step/listitem, select it and choose the Reuse fragment option.
Paligo adds the text into the step.
The text is a reused fragment and is locked. If you want to edit it, you will need to unlock it, but be aware that any changes you make will apply wherever that text is used, not just in your topic.
To reuse a sequence of items or steps in a list, add the sequence to an informal topic. You can then insert the informal topic inside a list in a regular topic. This is useful when you have multiple steps that are the same in many different topics.
You will also want to make sure that any numbering flows with the rest of the list. Paligo has a
role attribute called
reuse-range that makes this possible.
To find out how to reuse a sequence of steps in a list, watch the video or follow the instructions:
Open the informal topic in the Editor.
Add the list or procedure steps you want to reuse in other topics. You can add a bullet list, number list, or procedure by using the toolbar icons in the Edit menu.
procedureelement (itemized list or orderedlist) in the Element Structure Menu and choose the Go to element.
roleattribute in the Element Attributes Panel and set its value to
If the topic does not already contain the list or procedure, insert one.
Position the cursor at the position where you want the steps in the informal topic to appear.
The cursor position is very important, as if it is an incorrect position, the informal topic cannot be added.
Use the Element Structure Menu to make sure that the cursor position is correct.
Select the Insert tab in the Toolbar.
Select Component and browse to the informal topic.
Paligo adds the informal topic at the selected position (as long as you selected a valid position). The numbers of the steps in the informal topic adjust to fit in with the sequence of numbers in the existing list. If you add steps before or after the informal topic, they will also continue the correct numbering sequence.