For the image captions it is not necessary to have separate paragraph styles for the number of the figure, table, or box and the rest of the caption. In the XML, eXtyles will automatically separate the number from the rest of the caption paragraph, provided that the display item is referred to by a recognized name (e.g., Figure, Fig., Example, Illustration, Table, Box, Video, etc.) and a consistent character (e.g., period, colon) is used to separate the two parts (i.e., caption and label). Special allowance can be made for captions that span more than one paragraph.

Figure Captions

eXtyles includes four distinct paragraph styles for figure captions: Figure Caption, Figure Caption Continued, TOC Figure Caption, and Figure Alt Text.

• Figure Caption is used to style the full caption of the image as it will appear next to the image in the body of the document.

• Figure Caption Continued is used to style subsequent paragraphs of a caption, if there are more than one. Do not use Figure Caption to style additional paragraphs of the figure caption.

• TOC Figure Caption is the version of the caption that will be used to generate the list of figures in the front matter in the PDF. This caption is often (but does not have to be) different from the primary caption. This paragraph style, when used, will export to <p content-type="toc"> in the <caption> for the figure in the XML (see the following sample).

• Figure Alt Text is the version of the caption that is written to achieve accessibility standards. For example, this version of the caption is what will be read by screen readers, and so on. This paragraph style, when used, will export to <alt-text> in the <caption> for the figure in the XML (see the following sample).

•  

The following figure caption paragraphs in Word will yield the subsequent XML.

Open

Figure Numbers and the <graphic> Element

In the XML eXtyles will generate a unique ID for each figure in the document, both numbered and unnumbered. It is important that this figure ID in the XML match exactly the file name of the image, which is external to the XML, so that an automated InDesign layout system can pull in the correct image.

where jms0912 is whatever value was entered into the Object ID Prefix box in the Document Information dialog and fig001 and figa are generated by eXtyles during XML export.

The <graphic> Element

eXtyles will automatically generate unique figure IDs during XML export. The IDs will be placed in a <graphic> element in the XML that looks like this:

This information is then used to pull in and place the correct image during layout.

The information for how these IDs are constructed comes from different places in the document; specifically, the Document Information dialogue and the Word file. The prefix for the ID (jms0912) comes from the Object ID Prefix field in the Document Information dialogue. The figure number (fig001) comes from the figure label in the caption in the Word document (e.g., Figure 1. Caption text).

Figure Caption Location in the Word File

Figure captions must be located just after the paragraph where each figure is first cited. If captions have been collected at the end of the document, they will need to be moved to the proper place within the document before you export to XML.

Similarly, in the case of unnumbered figures, the caption must be placed in the Word file just after the paragraph where the figure should appear in the PDF file or HTML page.

Tables

All tables, or content styled with the Table elements of the paragraph styles palette, must be in Word table format. Otherwise, the export is likely to produce parsing errors. All content for each table should be in a single Word table.

Tables will be exported to XHTML format in the XML file. We recommend using the XHTML table model, because it has stronger support for borders and shading.

The more formatting you set correctly in Word, the more that formatting will be correctly reflected in the XML (cell alignment, column widths, cell borders, cell shading). Note that eXtyles supports the use of the decimal tab in Word tables, as well as left- and right-aligned and centered content.

Table Titles

eXtyles includes two distinct styles for table titles: Table Title and TOC Table Title. As with figure captions, titles styled as TOC Table Title will be used to generate a list of tables in the front matter in the PDF.

Table Formatting Example

This relatively simple table has been set up with the following formatting options in Word:

• column headings are centered

• the contents of columns 1-4 are left aligned

• column 5 is aligned on a decimal tab

• column 6 is left aligned

• row 2 has grey shading applied

Note that the cells in the top row carry the TableHead style, while the other rows are styled as TableBody.