Getting Started with Paligo

Headings and Subheadings

One of the most common questions from authors who are new to structured authoring and topic-based authoring is "How do I create headings and subheadings like I would in a word processor?

The simple answer is that you don't apply this manually. It is created for you when you nest your topics in a publication in the Structure View.

For instance, if you have a number of topics, and drag them into the Structure View and nest them in the structure you want there (of course the topics and titles of your topics wouldn't be "Heading 1" etc, that is just to make the example clear:

The nesting level of each topic reused here will then determine the headings in your output, e.g if we publish to PDF:

The heading sizes and styling are applied because of the nesting in the publication in the Structure View.

One further benefit of this is that you can always change exactly the look and feel of each heading level, since it is all controlled by stylesheets (that you can configure in the Layout Editor).

As you can see, other elements, like figures can also have headings of their own. And you determine what style they should have too in your layout configuration.

Subheadings within a topic

Sometimes you might not think that a section warrants a topic of its own. And then you can create a subheading within the topic too. It's called bridgehead element.

In fact, the subheading at the end of the example PDF above is such a bridgehead subheading.

But you should really strive to use subheadings inside a topic as the exception only, trying instead to keep topics separate for each section of your content to make is as reusable as possible.