Figure tags

Search this space

Special figure filenames

By default, eXtyles auto-generates figure filenames during XML Export, based on criteria you specify during configuration. Sometimes you may need to use a specific filename for a figure instead of this auto-assigned filename, especially for unnumbered figures. (For example, in a book about animals, you might want to name each image with the name of the animal.)

You can override an auto-generated figure filename by using the Insert Tag menu on the eXtyles tab to insert an Inline Graphic or Named Graphic tag, depending on your configuration:

  1. Remove any existing tags around your figure caption.

  2. Place your cursor at the end of the figure caption paragraph (but before the paragraph mark!).

  3. Click Insert Tag on the eXtyles tab.

  4. Choose Named Graphic / Inline Graphic from the menu. You should now see opening and closing tags like this:

    Fig. 1. Effect of DGC or PDE overexpression in B. bronchiseptica biofilm formation.<graphic></graphic>

  5. Type your figure filename between the tags, like this:

    Fig. 1. Effect of DGC or PDE overexpression in B. bronchiseptica biofilm formation.<graphic>Biofilm-image</graphic>

When you export XML from this file, the name inside the tags will become the pointer to the image file, like this:

<graphic xlink:href="Biofilm-image"/>

 

 

 

 

 

 

 

 

If the figure has a multi-paragraph caption, this tag should be inserted at the end of the last paragraph. If the figure has an attribution, source, or copyright line, the tag should be inserted after any of these paragraphs.

 

You don’t need to add a file extension to the filename, because the file extension will be added during rendering. But if you do add a file extension inside the <graphic> tags, it will carry through to the XML!

Figure placement

Inline graphics, no caption

Sometimes you need to insert a graphic with no caption in an arbitrary location (e.g., a custom logo at the end of each article).

You can do this by using the Insert Tag menu on the eXtyles tab to insert an Inline Graphic or Named Graphic tag, depending on your configuration:

  1. Remove any existing tags around the text where you need to add the graphic.

  2. Place your cursor at the end of the paragraph.

  3. Click Insert Tag on the eXtyles tab.

  4. Choose Named Graphic / Inline Graphic from the menu. You should now see opening and closing tags like this:

    ....end of article text.<graphic></graphic>

  5. Type the name of the figure file between the tags, like this:

    ...end of article text.<graphic>CustomLogo</graphic>

When you export XML from this file, the name inside the tags will become the pointer to the image file, like this:

...end of article text.<inline-graphic xlink:href="CustomLogo"/>

Graphics that are not “inline”

In addition to "inline," you can define the orientation of a graphic as Anchor, Float, or Landscape by using other graphic tags at the end of a figure caption instead of Inline Graphic.

For example, when a graphic should be displayed as a landscape image during final production, choose the Landscape tag:

Fig. 3. Illustration of a large map<landscape></landscape>

Here’s how this translates in your XML export:

<fig id="f3" position="float" fig-type="figure" orientation="landscape"><label>Fig. 3</label><caption><p>Illustration of a large map</p></caption><graphic xlink:href="123-f3"></graphic></fig

 

Figures made up of multiple image files

Some figures, particularly multi-part figures, consist of multiple image files (panels). For example, if an author has created figures 1A, 1B, 1C, and 1D, each as a separate file, you will need four <graphic> elements in the XML.

To do this, follow the Insert Tag instructions to insert a Figure Panels tag at the end of the figure caption, which inserts a tag like this:

<panel></panel>

If each panel is a separate image file, fill in the letter of the last panel, like this:

Figure 1: This is a figure<panel>d</panel>

The resulting XML will look like this:

If each panel is not a separate file, you’ll need to specify how the panels are grouped. In this example, Figure 2 consists of 11 panels (a-k) distributed across 3 image files (panels a-d, panels e and f, panels g-k):

Figure 2: This is a figure title<panel>ad,ef,gk</panel>

The resulting XML will look like this:

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

In most multi-part figures, the parts are distributed evenly (1 panel = 1 image file). But not always! That’s okay: the Figure Panels tag works in those cases, too.

Video files

Video files can essentially be treated like static figures when you export JATS or BITS XML from eXtyles, with one main exception:

  • As well as including a caption paragraph, you’ll also need to include a media block paragraph to specify details about the video file.

When you include a media block paragraph as well as a caption for the video, and the video is cited in the text (e.g., "see Video 1") so that it can be matched to the caption, eXtyles will export the appropriate XML:

This XML will need to be accompanied by files named

  • CDT-2012-35-vid1.tif (or .png or .jpg …) for the placeholder

  • CDT-2012-35-vid1.avi (or .mpg or .mp4 …) for the video itself

 

MIME type tags

The XML exported from eXtyles doesn’t include file type extensions for image files, but there may be times when you need to specify which type of image file is associated with a given <graphic> element.

In this situation, follow the Insert Tag instructions to insert a MIME Type tag at the end of the figure caption and add the file type inside the tags:

Figure 1: This is a figure title<mime>TIFF</mime>

The resulting XML looks like this:

 

 

Copyright © 2022 Atypon Systems, LLC. All Rights Reserved.