Reuse a single topic
To reuse a single topic, add it as the
toc-element to your tree. You can either do it through the UI or manually edit the
.tree file of your help instance.
Add through the UI
In the Table of Contents area of the Writerside tool window, select the node you want to add the new topic and click or press Alt+Insert.
In a popup, click Link Topic Files to TOC to reuse the topic from other instances.
Then select an element you want to include. If the selected
toc-elementdoes not have an
include-idattribute, you will be asked to specify it.
The topic appears in the TOC. Double-click it to open in the editor.
In the Table of Contents area of the Writerside tool window, select the node you want to add the new topic, right-click, and select Go to TOC Element in <instance-id>.tree.
In the editor, you can see the .tree file of your project. By default, the cursor is on the line with the
toc-elementtag you selected in the previous step.<toc-element topic="Getting_Started.topic"> <toc-element topic="Installation.topic"/> <toc-element topic="Setting_up.topic"/> ...
On the next line, add a
toc-elementtag referring to the existing topic file.
For example, to add New_topic.topic, enter the following code:<toc-element topic="New-topic.topic"/>
To include Some_topic.topic from another instance, first add the
include-idattribute to the
toc-elementin the target instance:<toc-element topic="Some-topic.topic" include-id="some-topic"/>
Then use the following code in the .tree file:<include from="cd" target="some-topic"/>
fromattribute specify the instance id, in
include-idof the target topic.
The topic appears in the Writerside tool window in the Table of Contents.