Figure Naming Conventions

eXtyles STS has a paragraph style for figure captions: Figure Caption. Further, any images/graphics included in the document should be styled as Figure Graphic. Whenever the XML export encounters a paragraph styled as either Figure Caption (which may or may not start with a figure number, e.g., “Figure 1”) or Figure Graphic, it will automatically insert a <graphic> element in the XML. The file pointer in the graphic element will follow these naming conventions:

For this example, where the style Figure Credit is used for the source line:

Figure 1. Security Software Log Entry Examples

Sources: Information regarding the source of the figure.

the full XML output would be:

<fig id="fig_1" position="anchor" fig-type="figure">
<label>Figure 1</label><caption><title>Security Software Log Entry Examples</title></caption><graphic xlink:href="jms10-Image001"/>
<attrib>Sources: Information regarding the source of the figure.</attrib>
</fig>

Default naming conventions are also in place for plates and schemes; plates will be named, for example, jms10-plt1 and schemes jms10-scm1.

For cases where a figure caption does not have a figure number (e.g., a picture in an introduction), the naming system is slightly modified by eXtyles; for example, instead of “fig_1”, an ID of “fig_a” will be used (e.g., jms10-fig_a, jms10-fig_b, etc.). For example, the following paragraph in Figure Caption style:

Security Software Log Entry Examples

yields this XML:

<fig id="fig_a" position="anchor" fig-type="figure">
<caption><title>Security Software Log Entry Examples</title></caption>
<graphic xlink:href="jms10-fig_a"/>
</fig>

Image Export and File Extensions

If the image is included in the Word document (styled as Figure Graphic), eXtyles will export the image into a subdirectory in your working folder. The image file will be named the same as the xlink in the <graphic> pointer in the XML (e.g., jms10-Image001.jpg). This is to facilitate easy import of the images during layout, a process that most likely will require the image file name to match exactly the pointer in the XML.

Further, the file type extension will be included as a mime-subtype attribute in the <graphic> pointer in the XML. For example,

<graphic xlink:href="jms10-Image002" mime-subtype="jpg"/>

Figure Caption Location in the Word Document

The location of the figure captions in the Word document is important, because eXtyles will not move the caption content during XML export. That is, if all of the figure captions (and possibly also the images themselves) are concatenated at the end of the Word document, they will stay at the end of the document in the XML regardless of whether they are cited elsewhere in the body.

Because of this, it is recommended that you ensure that figure captions (and images, if they are included in the Word document) are placed near where they are cited in the body of the document; if they are not numbered or are not cited, they should still be placed logically in the body.

Inline Graphics/Images

Your document may contain images that appear inline with the body text. For example,

This paragraph will export like this:

<p>The Lewis structure of water (<inline-graphic xlink:href="jms10-Image002" mime-subtype="png"/> ) is basic chemistry.</p>

Note that the image number in the <graphic> element is sequential with the rest of the images in the document (e.g., Image002). But for these types of inline graphics you may want the image name to be different from the sequential run of numbered images (e.g, labeled Figures).

In these instances, the eXtyles Inline Graphic tag can be used to force eXtyles to use a different name for the inline image in the XML. For example, you can replace the image with the Inline Graphic tag:

The Lewis structure of water (<graphic>LewisH2O.png</graphic>) is basic chemistry.

To produce this XML:

<p>The Lewis structure of water (<inline-graphic xlink:href="LewisH2O.png"/>) is basic chemistry.</p>