Tables
Accurate styling of table content is critical to ensure that it is both rendered correctly during layout and formatted properly for screen readers and other accessibility requirements.
The following examples show how to use the table paragraph styles correctly.
Although eXtyles Cleanup will auto-style most table content at the start of the eXtyles workflow, you must still carefully proof table styling before exporting to XML and correct any misapplied styles.
Simple Table
The style of content within Word table cells will not show up in the Style Area Pane that is exposed in Draft view (see the following image). This is a limitation of Word. To proof the styles of content in Word table cells, place your cursor in the cell and the style will appear in the style drop-down window on the eXtyles ribbon.
A simple table will include a title, headings, body content, and possibly notes. For example,
which produces the following XML:
<table-wrap id="t01" position="float"> <label>Table 1</label> <caption> <title>Health Canada Indications</title> </caption> <table frame="border" rules="groups"> <col width="50.58%"/> <col width="49.42%"/> <thead> <tr> <th valign="top" align="center" scope="col" style="border-left: solid 0.50pt; border-top: solid 0.50pt; border-right: solid 0.50pt; border-bottom: solid 0.50pt; background-color:rgb(0,112,192)"><bold>Sacubitril/ Valsartan (Entresto)</bold></th> <th valign="top" align="center" scope="col" style="border-left: solid 0.50pt; border-top: solid 0.50pt; border-right: solid 0.50pt; border-bottom: solid 0.50pt; background-color:rgb(0,112,192)"><bold>Ivabradine (Lancora)</bold></th> </tr> </thead> <tbody> <tr> <td valign="top" align="left" style="border-left: solid 0.50pt; border-top: solid 0.50pt; border-right: solid 0.50pt; border-bottom: solid 0.50pt" scope="row">Treatment of heart failure with reduced ejection fraction in patients with New York Heart Association Class II or III, to reduce the incidence of cardiovascular death and heart failure hospitalization</td> <td valign="top" align="left" style="border-left: solid 0.50pt; border-top: solid 0.50pt; border-right: solid 0.50pt; border-bottom: solid 0.50pt">Treatment of stable chronic heart failure with reduced left ventricular ejection fraction (≤ 35%) in adult patients with New York Heart Association Classes II or III who are in sinus rhythm with a resting heart rate ≥ 77 beats per minute, to reduce the incidence of cardiovascular mortality and hospitalizations for worsening heart failure</td> </tr> </tbody> </table> </table-wrap>
Complex Tables
More complex tables can include subheadings and lists in the table body, accessibility captions, and source notes. eXtyles can support all of these structures. For example,
This table includes an accessibility caption; an internal subheading (“Randomized Controlled Trial”); and bulleted lists, which as shown in the Apply Styles palette, have the List Level 1 paragraph style applied.
This produces the following XML for the alternative title:
<table-wrap id="t04" position="float"> <label>Table 4</label> <caption> <title>Results of the Studies Included in the Rapid Response Report</title> </caption> <long-desc>Table 4 includes an accessibility caption, which is an alternative title that describes the table in more detail for screen readers.</long-desc> ...
The Subheading produces the following:
<thead> .... <tr> <th colspan="3" valign="top" align="left" scope="colgroup" style="border-left: solid 0.50pt; border-top: solid 0.50pt; border-right: solid 0.50pt; border-bottom: solid 0.50pt; background-color:rgb(217,217,217)"> <bold>Randomized Controlled Trial</bold> </th> </tr> </thead>
And the lists produce the following markup within the table:
<td>Ivabradine combined with carvedilol was statistically significantly different from carvedilol monotherapy for the following outcomes (mean, SD): <list id="L5" list-type="bullet"> <list-item><p>NYHA classification: 1.5 (1.3) vs. 1.9 (0.6)</p> <p>  P = 0.047</p></list-item> <list-item><p>CSS KCCQa score: 82 (14) vs. 71(21)</p> <p>  P = 0.002</p></list-item> ... </list> </td>
Local Formatting and and Other Design Elements
Unlike other parts of the text, eXtyles will capture in the XML formatting and design elements in tables. This information will come directly from the Word document, so it is important that tables in Word are carefully proofed for display as well as content prior to generating XML.
Bold and Italic
As with elsewhere in the text, bold and italic formatting that is used in tables is preserved in the XML. For example, in the following table, the text “Population” is not bold, but “Intervention” is:
This formatting will be reflected in the XML with <bold> markup:
<td>Population</td> ... <td><bold>Intervention</bold></td>
This might result in unwanted formatting in the PDF, and so the application of bold must be carefully proofed, and adjusted if necessary, in the Word file.
Borders, Shading, and Alignment
Table borders, cell shading, and text alignment will be preserved in the XML. This formatting information can be important when representing data, and so eXtyles will capture it directly from the Word document. For example, table borders are represented as a style attribute:
style="border-left: solid 0.50pt; border-top: solid 0.50pt; border-right: solid 0.50pt; border-bottom: solid 0.50pt"
Cell shading is represented as RGB values (again, per the precise shading used in the Word document):
style="background-color:rgb(0,112,192)"
And the alignment of the text in the table cells - right, center, left, or decimal - is captured as:
align="center"
Because of this it is important to carefully review the format of the table in the Word document. For example, if the final table should not include cell shading, there should be no shading in the table in the Word document.
Table Placement in the Document
Tables are not moved during XML export; that is, eXtyles will not move tables to the location of their citation in the text - they will remain where they are placed in the Word document. Because of this, it is important to ensure that in Word tables are placed where they are intended to be set in the PDF.
Figures
Figures (images) can be retained in the Word document during eXtyles processing; or, they can be removed, leaving just the figure title and notes. Often the latter is preferred because images can bloat a Word document and slow eXtyles processing.
eXtyles Cleanup can automatically remove any images in the Word document and replace them with placeholder text.
A typical setup for a figure that is not included in the Word document is:
This title and note will produce the following XML:
<fig id="fig07" position="float" fig-type="figure"> <label>Figure 7</label> <caption> <title>Cost-Effectiveness Acceptability Curve for the Reference-Case Analysis</title> <p><fn><p>GLP-1 = glucagon-like peptide-1 analogue; MET = metformin; QALY = quality-adjusted life-year; SGLT-2 = sodium-glucose cotransporter-2; SU = sulfonylurea.</p></fn></p> </caption> <graphic xlink:href="CADTH-1234-fig07"/> </fig>
Figure Naming and the <graphic> Element
eXtyles will automatically generate a <graphic> element for each figure caption in the Word document. This element is very important, because it will be used by rendering systems to pull in the correct image file during layout. For example, in the above instance, the system will be looking for an image named CADTH-1234-fig07, from the <graphic xlink:href="CADTH-1234-fig07"/> element.
These IDs will be generated by eXtyles using information from the Document Information dialog. In the dialog, the Object ID Prefix field will be used to construct the graphic ID:
Add Comment