Add Content to Topics

In this section, we explain how to add elements and content to your topics. We assume that you are already familiar with Topic-Based Authoring.

Writing in XML is different to writing content in a word processing program, such as Microsoft Word. That's because XML is structured. When you author in Paligo, you add the structure as well as the text, images, videos, etc., that form your content.

To add the structure, you use elements. There are many different types of element that you can add, but they can all be categorized as either:

  • Block elements: Use these to build the structure of your topics. Think of them as "building blocks" that define a type of content. For example, to add a paragraph, you add a para element.

  • Inline elements: Use these to add meaning to parts of content inside a block element. A common example of an inline element is emphasize, which you can use to italicize one or more words in a paragraph.

You can add as many block elements and inline elements as you need, but the maximum permitted size for a topic is 1MB.

When you are creating content, you may find that you want to change the order of paragraphs, steps, etc. Being able to move entire blocks of content easily is one of the benefits of using structured content.

You can find out more about the basics of block elements and inline elements in Elements.

To learn how to work with elements in your content, see:

Elements can also have attributes, which are properties that have certain values. For example, a paragraph element <para> can have an xinfo: product attribute, which is a type of filter that allows you to include or exclude the paragraph in different scenarios. To find out more about attributes, see: Element Attributes.