Table of Contents

Syntax #

p.figure

p.figure.desc

p.title.figure

Purpose #

Figure annotations are used to mark up images and any information associated with them.

The annotation p.figure is usually applied to paragraphs that contain an image and no text.

The annotation p.figure.description is used to mark up information associated directly with an image that contains more detail than is usually included in a title.

The annotation p.title.figure is applied to short pieces of information associated directly with an image, shorter than a description.

Example: Creating a figure from an image

The following screenshot is an example of what an image may look like in your original document.

figure-from-image-original

The following image is an example of what your rule may look like to create a figure from an image.

figure-from-image-rule

You saw in the original document that there are several images together; if not told to close the figure tags, Migrate will keep them open until forced to close them. The outside annotation forces Migrate to close the figure tags after each image.

The following XML is an example of what the figure could look like in your output.

<p>These images are by themselves and do not have any other information associated with them.</p>
<fig>
  <image href="image1.jpg" width="3.493cm" height="4.234cm"/>
</fig>
<fig>
  <image href="image2.jpeg" width="5.027cm" height="7.602cm"/>
</fig>
<fig>
  <image href="image3.jpg" width="3.048cm" height="2.337cm"/>
</fig>

The following screenshot is a published view of this figure as the code above could look.

figure-from-image-dita-result

Example: Creating a figure description

The following image is an example of what a figure description may look like in your original document.

figure-description-original

The following image is an example of what your rule may look like to create a figure description.

figure-description-rule

The following XML is an example of what the figure description could look like in your output.

<p>The following images have descriptive information added to each one.</p>
<fig>
  <desc>
    This painting is called “Girl with a Pearl Earring”, and was painted 
    by the 17th century Dutch painter Johannes Vermeer. It depicts 
    a young woman wearing a dress and a turban with a headscarf that
    falls down the back of her head. She is wearing an earring, though 
    art experts sometimes argue about the material of which the
    earring is made.
  </desc>
  <image href="image1.jpg" width="3.493cm" height="4.234cm"/>
</fig>

The following image is an example of what the figure description could look like in your published output.

figure-description-dita-result

 

Example: Creating a figure title

The following screenshot is an example of what a figure title may look like in your original document.

figure-title-original

The following image is an example of what your rule may look like to create a figure title.

figure-title-rule

The text “Figure 3:” in this case was typed in manually, instead of being automatically generated as a listmarker. This means that a rule deleting listmarkers will not remove this text from the figure title. You can leave in the word Figure and the numbering if you prefer; in this example, the method for removing the text using a pattern is displayed.

The following XML is an example of what the figure title could look like in your output.

<fig>
  <title>Excerpt from The Birth of Venus, Sandro Botticelli</title>
  <image href="image3.jpg" width="3.048cm" height="2.337cm"/>
</fig>

The following image is a published view of what the figure title could look like, given the above code.

a published view of what the figure title could look like