Getting Started

Convert Subsections into Topics

Long topics that contain many subsections can be difficult for people to use, because there's too much information provided in one place. To avoid this "cognitive overload", you can convert the subsections into separate topics, so that there are lots of shorter topics instead of one long topic. You can then use cross-references to guide people from one topic to another.

To convert a topic's subsections into separate topics, you can use Paligo's Convert reusable component feature.

  1. Select the title text of the subsection you want to convert and then, in the Element Structure Menu, select the section element for the subsection. Make sure that you select the subsection's section element and not the main section element for the topic.

    select-section-for-subtopic.jpg
  2. Select the Convert reusable component option.

  3. On the Convert to reusable component dialog, enter the title for the new topic (it will default to having the same title as the existing subsection). Also, choose the folder that will contain the new topic that Paligo will create.

    convert-to-reusable-component.jpg

    If you want the new topic to be embedded in the topic that currently contains the subsection, check the Reuse the component at position checkbox.

    In some people's opinion, sections and subsections should always be separate topics as this makes them more reusable. You can then create subtopics by embedding a topic inside another topic.

When you select OK, Paligo converts the subsection into a topic. The subsection is removed from the topic. If you checked the Reuse the component at position checkbox, the new topic is embedded in place of the subsection.

subsections-as-embedded-topics.jpg

In the image above, the subsections have been converted into separate topics and they are embedded in the main topic.

Tip

If you need a topic to contain several subsections, you can make the content less overwhelming for the reader by using accordions.