Getting Started with Paligo

Zendesk Publishing Structure

Paligo has no limit in the nesting of topics in a publication. Zendesk has 3 levels for structuring the content (Category, Section, Article), but really just one level of actual textual content, the article.

This means the topic levels of Paligo must be mapped to the limits of levels in Zendesk, and Paligo has two ways of doing that depending on the option chosen in the publishing dialog:

Multi-section option

With a publication structure in Paligo as in the image below, all top level topics (or "chapter level" if you will), become section titles in Zendesk. All topics on the second level become articles in that section. 

Top-level topic becomes section in Zendesk, and second level becomes article

As the image shows, the top-level topic content will also be inserted as the first article ("Introduction" in this example).

If a topic has several sub topic levels in Paligo at the third level and below, they will become sub headings in an article in Zendesk:

Topics 7.31 and 7.3.2 here become sub headings in the article 7.3 "Creating Topics and Other Components"

Tip

The multi-section option is the most recommended option for most use cases, as it will usually work well directly on an existing publication, creating multiple sections for each top-level topic.

For a concrete example of this option, take a look at the Paligo Help Center, published with the multi-section option and compare it to the original Paligo structure that you can see in the online help version.

Single-section option

With the single-section option, the whole publication itself becomes a section, and each "top-level" or "chapter" topic becomes an article. Every topic on lower levels becomes a sub heading.

This option is only recommended if you want everything in just one section, and have a rather shallow publication structure so each article would be rather short.