4.4. Positioning a Figure


4.4.1. Horizontal Alignment

The alignment of a figure can be specified using the align attribute of the import macro. The supported values are:

Align Description
Center centered within the region (the default)
Left left side of region
Right right side of region
Inner inner side of region for double sided documents (otherwise Left)
Outer outer side of region for double sided documents (otherwise Right)

For example:

  !import "my_graph"; align=Left

4.4.2. Wide Figures

By default, figures are aligned within the main text area. To align a figure within the full text area (i.e. including the side-head), use the wide attribute. For example:

  !import "my_graph"; align=Left; wide

4.4.3. Figures Within a List

To align a figure with a given list indent, use the listitem attribute. For example:

  * The graphs are impressive:
    - savings per year
    !import "my_graph"; listitem=2

4.4.4. Vertical Positioning

The vertical position of a figure can be specified via the position attribute. The supported values are:

Position Description
Below below the current paragraph (the default)
Top top of the current column/page
Bottom bottom of the current column/page

For example:

   !import "my_logo"; position=Bottom; align=Right

4.4.5. Wrapping Text Around a Figure

To wrap text around a figure, set the wrap_text attribute. For example:

    !import "my_graph"; wrap_text


Note: When generating HTML, text can be wrapped around a figure but unfortunately, the rules are quite different:

  1. The wrap_text attribute has no affect.
  2. Text is implicitly wrapped if the align attribute is set to Left or Right.
  3. The wrapping must be explicitly disabled using the clear macro.