Getting Started

Adding 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.

Note

For more information on block elements and inline elements, see Elements

Add Block Elements to Topics

To add structural "block" elements to a topic:

  1. Open your topic in the editor.

  2. Position the cursor (also known as the caret) where you want to add a block element. You can position the cursor manually or you can select an element in the element structure menu and choose Go to element. (The element structure menu is immediately below the toolbar, and it shows the position of the currently selected element).

    go-to-element.png

    The position of the cursor is important as there are rules that govern where each type of element can be used. For most types of block element, you can place the cursor on the next line, just like you would in a word processing program. But there are some exceptions, for example, you cannot add a table inside a para element.

    Paligo will advise you if you try to add an element in a position that is not permitted.

  3. Add the element for the type of content you want to insert. There are several ways to add elements:

    • Use the Edit toolbar and Insert toolbar to add commonly used block and inline elements, including paragraphs, images, tables, italicized text, and underlined text.

    • Use keyboard shortcuts.

    • Use the element context menu.

      To access the element context menu, press Alt and Enter (Windows) or Option ⌥ and Enter (Mac).

      element-context-menu.png

      The most commonly used elements are shown at the top of the list, and the list only shows elements that are valid in the position you have selected.

      If there are many elements available, you can select More > to reveal extensions to the list. Alternatively, you can use the search at the top of the element context menu to find a specific element.

  4. Add your content inside the block element. For paragraphs, list items, etc., enter your text. For some types of block element, Paligo prompts you to choose an image, enter a video url, etc.

Add Inline Elements to a Topic

To add inline elements to the text in a topic:

  1. Open your topic in the editor.

  2. Highlight the content that you want to apply the inline element to.

  3. Add the element for the type of content you want to insert. There are several ways to add elements:

    • Use the Edit toolbar and Insert toolbar to add commonly used block and inline elements, including paragraphs, images, tables, italicized text, and underlined text.

    • Use keyboard shortcuts.

    • Use the element context menu.

      To access the element context menu, press Alt and Enter (Windows) or Option ⌥ and Enter (Mac).

      element-context-menu.png

      The most commonly used elements are shown at the top of the list, and the list only shows elements that are valid in the position you have selected.

      If there are many elements available, you can select More > to reveal extensions to the list. Alternatively, you can use the search at the top of the element context menu to find a specific element.