Skip to main content

Add a Figure

This section explains how to add a figure to a topic. A figure is a picture with a title and a caption, and it can support some DocBook elements that are unavailable for regular images. However, at the moment, most of these additional elements, such as calloutlist do not have any functionality in Paligo.

A topic containing a figure. There is an image of a space shuttle and it has a title and a caption.

Note

There are separate sections that explain how to Add an Image, Add an Inline Image, and Add Side-By-Side Images.

There are several ways to add a figure:

Tip

You can use Keyboard Shortcuts to add images, figures, inline images and side-by-side images.

Use the Insert Menu to Add a Figure

Use the Element Context Menu to Add a Figure

If you prefer, you can add the elements for a figure manually, and for this, you can use the element context menu.

  1. Place your cursor where you want to add a figure, for example, inside a step element or after a para.

  2. Press Alt + Enter ⏎ (Windows) or Command ⌘ + Enter ⏎ (Mac) to display the Element Context Menu.

    Element context menu shows a search field and a list of elements that are valid at the current position.

  3. Add the figure element.

    Paligo adds the figure element and also adds the title, caption, imageobject and imagedata elements that are needed for a figure.

  4. Right-click on the placeholder for the image and select Image browser.

  5. In the dialog that opens, browse or search for the image in your Media library.

    Note

    If the dialog does not open automatically, right-click on the placeholder icon for the image and select Image browser.

    Media browser dialog. It shows the images in a "Space Manual" folder. There is a search field at the bottom to search for other images , a folder path at the top to browse to different folders. There are also options for creating a folder, uploading new images, and refreshing the browser view.

    Note

    If the image is not in the Media library yet, you can upload it directly in this dialog by using the upload icon in the top-right.

    To find out more about uploading images, see Upload Images.

  6. Select the image to insert it into your topic.

    Note

    To use alt text in PDF outputs, it is important that you do not use tagged PDFs as images. For PDFs to use alt text, the layout has to have Generate tagged PDF enabled. The PDF processor cannot complete the publishing if your content contains tagged PDFs as images and Generate tagged PDF is enabled. You will need to use untagged PDFs as images or use different types of image files.

    If you try to publish content that has a tagged PDF embedded as an image and the Generate tagged PDF enabled, you will get a "production failed" error.

  7. Enter the text for the figure title in the title element.

  8. Enter a caption for the figure in the caption element. You can delete the caption element if you do not want a caption.

  9. Select Save. Save icon.