Inserting Figures

You can insert a figure directly in a topic or from a reference location. Figure numbering restarts at 1 for each topic, but when you publish the document map, it defines a single sequence for all topics in the map.

This task shows you how to:

See Also
Working with Images

Insert Figures

You can insert numbered figures in topics.

  1. Click Insert and select Figure.
    The app adds a Figure # (starting with 1, and incrementing as you add figures to a topic) and a box.
  2. In the box, enter a title for the figure.
  3. In the description box, enter any required text. You can leave the box empty, but you cannot delete it.
  4. Enter any text to include as part of the figure.
  5. To add a figure that includes an image, click Insert and select Image to choose the image and follow the instructions in Working with Images.

Insert a Reference Figure

You can select the location for a figure and then reference a figure in another topic. The app does not display the selected figure in the topic. It adds a text indicator with an icon to indicate that something from a different source is added at that location.

You must include the source topic for the figure in the document map. To reference a figure (or any other content) from a topic without including it in the published file, add it to the document map but exclude it from rendering.

Before you begin: The source figure must have an ID defined.
  1. Insert the cursor where you want to include the figure.
  2. Click Insert and select Cross-Reference, and then Figure.
  3. Enter these details:

    Field Description
    Reference Text Text to display in this topic that explains which figure is referenced. The referenced figure replaces this text when the document map is published.
    Topic Select the topic that contains the figure you want to reference. The topic must be in the current document map, but you can exclude it from rendering.
    Figure Select the ID for the figure you want to reference. The list includes all IDs for all figures that have defined IDs in the selected topic.

    If the topic does not include any figures with IDs defined, an error message displays. You can open the required topic to add an ID, then reference it.

  4. Click OK.

The app adds the reference text underlined in blue, and a blue box with an arrow. You can click the box to open the target of the reference.