Skip to main content

Admonitions

You can add notes, warnings, tips and other "admonition" elements to make parts of your content stand out. Admonitions is the term for collectively describing all of the notes, warnings and tips. Insert_Admonition.png

The admonition elements include Note, Caution, Warning, Danger, Notice , Important and Tip. You can add them from the Insert tab in Toolbar and some of them can be added with keyboard shortcuts, see Keyboard Shortcuts.

You can use the admonition elements in most types of block content, including paragraphs and tables. Paligo does not restrict how you use the elements, but you need to be aware that some industries have rules about how they are used. For example, in some industries, you must use a warning if there is a risk of injury.

Toolbar_Insert_small.png

To add a note, warning, tip or other type of admonition to your content:

  1. Select the Insert tab.

  2. Select the Admonitions option (the warning icon) admonitions_button.png.

  3. Choose the type of admonition you want to create from the list.

    insert-admonition.png

The appropriate admonition is added to your content, ready for you to add your message.

note-example.png

Alternatively, you can use this technique to add an admonition:

  1. Place your cursor where you want to add the admonition.

    Note

    If you want to place an admonition after a paragraph, you must place the cursor after the paragraph and before the next element.

    cursor_position.png
  2. Press Alt and Enter (Windows) or Command and Enter (Mac) to access the Element list.

  3. Select the type of admonition that you want to add, for example, Warning. (You can search for the admonition by name, if required).

Note

You can add most types of element inside an admonition element. For example, you can add text, images, tables, etc.

You can quickly change one type of admonition to another. 

  1. Select the admonition element that you want to change into a different type of admonition. For example, select the note element. 

    select-admonition-element.png

    Tip

    Use the Element Structure Menu (1) to make sure that you have the admonition element selected. The admonition element should be the last element shown.

  2. Select the Insert tab.

  3. Select the Admonitions option (the warning icon) admonitions_button.png.

  4. Choose the type of admonition you want to create from the list.

You can change the appearance of your notes, warnings, and tips to meet your needs. 

For HTML/HTML5 outputs, you can use CSS to customise the appearance.

For PDF outputs, you can set the colours and icons in the PDF layout. 

  1. Select Layout.

  2. Select the PDF layout that you use for publishing the content.

  3. In the Layout Editor, use the Annotations options (1 and 2 in the following image) to define the appearance. There are settings for adjusting the font size, colour, icons, and spacing.

    change-admonitions-pdf.png
  4. Select Save.

By default, Paligo creates a label for each admonition element and does not include a title. The label adds the name of the element in the published content, for example, if you add a tip, the word "tip" is used as the label (shown as 1 in the following image).

tip-label.png

The labels that Paligo generates, such as "tip" and "warning" are translated automatically for most languages.

If you prefer, you can add a title. Paligo will then use your title instead of generating a label (but your title will not be translated automatically).

To add a title:

  1. Select the admonition element that you want to give a title.

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

    admonition-title-context-menu.png
  3. Select the Title option.

  4. Enter the text for the title.

  5. Select Save.