...
| Info |
|---|
| The examples highlight various aspects of how to set up lists in Word in order to obtain the optimal XML. The examples are taken from the sample document: Sample_6_List-setup.docx |
List Labels
By default, eXtyles NLM does not store the text of the list label (i.e. the bullet, number, letter, etc.) in the XML. Instead, it assigns a @list-type attribute to the list, such as @list-type="bullet". This gives extra flexibility in rendering the XML , because the rendering engine can be set to use whatever bullet or label is required in a particular environment. This works well for "standard" bullet characters (•, o, various dashes) and numbering schemes (a, b, c; i, ii, iii; 1, 2, 3; etc.). However, if you need to support complex or "non-standard" list-numbering schemes, you may need to contact extyles-support@inera.com to discuss capturing the text of the list labels in your JATS XML.
...
| List labels | @list-type |
|---|---|
| No labels | "simple" |
| Bullets, dashes | "bullet" |
| 1, 2, 3 | "order" |
| a, b, c | "alpha-lower" |
| A, B, C | "alpha-upper" |
| i, ii, iii | "roman-lower" |
| I, II, III | "roman-upper" |
Nested Lists
In eXtyles NLM, a group of contiguous list paragraphs will be exported as a single XML list. Nested lists should be styled carefully to ensure that the nesting is reflected in the paragraph styles used. See the following example of a nested list:
...
Note that the level-1 list L1 is not closed when the first of the level-2 list starts, and in the XML, lists L2, L3, and L4 are nested within list L1.
List Continued
If a single item in the list is made up of more than one paragraph, a List Continued style must be used for the continuation paragraphs; otherwise, the subsequent paragraphs will be exported as separate list items. See the following example:
...
| Code Block | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
<list id="L6" list-type="order"> <list-item> <p> Branched learning so subjects mistress do appetite jennings be in. </p> <p> Esteems up lasting no village morning do offices. </p> <list id="L7" list-type="alpha-lower"> <list-item> <p> Settled wishing ability musical may another set age. </p> <p> Diminution my apartments he attachment is entreaties announcing estimating. </p> </list-item> <list-item> <p> And total least her two whose great has which. </p> <p> Neat pain form eat sent good week. </p> </list-item> </list> </list-item> <list-item> <p> Led instrument sentiments she simplicity. </p> </list-item> </list> |
...
Table and Column Widths
By default, eXtyles NLM does not export the overall table width from Word into the XML. It is possible to set up eXtyles NLM to detect the absolute width of the table as it appears in Word and pass through the width to the XML export in whatever unit fits your workflow needs (e.g., inches, centimeters, points, etc.). Please contact extyles-support@inera.com if you need the overall table width to be included in your XML.
Column widths are calculated as percentages of the total width of the table by default. The examples above illustrate tables whose column widths are represented as percentages.
Cell Indents
If a paragraph indent is used within a table cell, it is reflected in the XML on export; this allows great control over the arrangement of the table cell contents. Exactly how the indent is represented depends on your configuration. In the following table, the cell contents in the first cells of rows 3 and 4 have been aligned using a first-line indent of 0.4 cm. In this configuration, the paragraph indent is represented in the output XML by a variable number of non-breaking spaces (represented as   in Unicode) (one for every 0.1 cm):
| Code Block | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
<table-wrap id="t3" position="float">
<label>Table 3</label>
<caption><title>In so melancholy as an sentiments simplicity connection</title>
</caption>
<table frame="hsides" rules="groups">
<col width="33.34%"/>
<col width="33.33%"/>
<col width="33.33%"/>
<thead>
<tr>
<th valign="top" align="left" scope="col" style="border-top: solid 0.50pt; border-bottom: solid 0.50pt">r(Y)</th>
<th valign="top" align="center" scope="col" style="border-top: solid 0.50pt; border-bottom: solid 0.50pt">Y2</th>
<th valign="top" align="center" scope="col" style="border-top: solid 0.50pt; border-bottom: solid 0.50pt">Y</th>
</tr>
</thead>
<tbody>
<tr>
<td valign="top" align="left" style="border-top: solid 0.50pt" scope="col">ϕm</td>
<td valign="top" align="left" style="border-top: solid 0.50pt"></td>
<td valign="top" align="left" style="border-top: solid 0.50pt"></td>
</tr>
<tr>
<td valign="top" align="left" scope="row">    For ηhigh</td>
<td valign="top" align="char" char=".">2.10</td>
<td valign="top" align="char" char=".">2.10</td>
</tr>
<tr>
<td valign="top" align="left" style="border-bottom: solid 0.50pt" scope="row">    For ηlimit</td>
<td valign="top" align="char" char="." style="border-bottom: solid 0.50pt">20.5</td>
<td valign="top" align="char" char="." style="border-bottom: solid 0.50pt">21.0</td>
</tr>
</tbody>
</table>
</table-wrap>
|
Row Headers
While row headers that appear mid-table are supported by eXtyles, the JATS DTD does not include a way to indicate that a row is a heading row when in mid-table. However, there is a "more correct" way to do this in JATS XML. Simply style the mid-table heading rows with the Table Column Head style. This style forces a new <table> element within the <table-wrap> element. For example, the following table:
yields this XML:
| Code Block | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
<table-wrap id="t4" position="float">
<label>Table 4</label>
<caption><title>Mrs him left find are good</title></caption>
<table frame="hsides" rules="groups">
<col width="33.34%"/>
<col width="33.32%"/>
<col width="33.34%"/>
<thead>
<tr>
<th valign="top" align="left" scope="col" style="border-top: solid 0.50pt; border-bottom: solid 0.50pt"><bold>Head 1</bold></th>
<th valign="top" align="center" scope="col" style="border-top: solid 0.50pt; border-bottom: solid 0.50pt"><bold>Head 1a</bold></th>
<th valign="top" align="center" scope="col" style="border-top: solid 0.50pt; border-bottom: solid 0.50pt"><bold>Head 1b</bold></th>
</tr>
</thead>
<tbody>
<tr>
<td valign="top" align="left" style="border-top: solid 0.50pt; border-bottom: solid 0.50pt" scope="row">Body 1</td>
<td valign="top" align="center" style="border-top: solid 0.50pt; border-bottom: solid 0.50pt">Body 1a</td>
<td valign="top" align="center" style="border-top: solid 0.50pt; border-bottom: solid 0.50pt">Body 1b</td>
</tr>
</tbody>
</table>
<table frame="hsides" rules="groups">
<col width="33.34%"/>
<col width="33.32%"/>
<col width="33.34%"/>
<thead>
<tr>
<th valign="top" align="left" scope="col" style="border-top: solid 0.50pt; border-bottom: solid 0.50pt"><bold>Head 2</bold></th>
<th valign="top" align="center" scope="col" style="border-top: solid 0.50pt; border-bottom: solid 0.50pt"><bold>Head 2a</bold></th>
<th valign="top" align="center" scope="col" style="border-top: solid 0.50pt; border-bottom: solid 0.50pt"><bold>Head 2b</bold></th>
</tr>
</thead>
<tbody>
<tr>
<td valign="top" align="left" style="border-top: solid 0.50pt; border-bottom: solid 0.50pt" scope="row">Body 2</td>
<td valign="top" align="center" style="border-top: solid 0.50pt; border-bottom: solid 0.50pt">Body 2a</td>
<td valign="top" align="center" style="border-top: solid 0.50pt; border-bottom: solid 0.50pt">Body 2b</td>
</tr>
</tbody>
</table>
</table-wrap> |
Lists in Tables
Lists in tables should be styled using the appropriate list style, rather than using the table styles. You can apply the list style to a unique paragraph in a table cell by holding the CTRL key while selecting the style from the palette.
Note that a given list in a table cannot extend from one table cell to the next (since, in the XML, the starting <list> tag is inside <td>, so the closing </list> tag must occur before </td> is encountered). Therefore, all of the items in a particular list must be placed in a single table cell, separated by paragraph marks, as in this table:
| Code Block | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
<table-wrap id="t5" position="float">
<label>Table 5</label>
<caption><title>Evening way luckily son exposed get general greatly</title></caption>
<table frame="hsides" rules="groups">
<col width="28.76%"/>
<col width="35.62%"/>
<col width="35.62%"/>
<thead>
<tr>
<th valign="top" align="left" scope="col" style="border-top: solid 0.50pt; border-bottom: solid 0.50pt">Table header </th>
<th valign="top" align="center" scope="col" style="border-top: solid 0.50pt; border-bottom: solid 0.50pt">Table header</th>
<th valign="top" align="center" scope="col" style="border-top: solid 0.50pt; border-bottom: solid 0.50pt">Table header</th>
</tr>
</thead>
<tbody>
<tr>
<td valign="top" align="left" style="border-top: solid 0.50pt; border-bottom: solid 0.50pt" scope="row">Table body</td>
<td valign="top" align="left" style="border-top: solid 0.50pt; border-bottom: solid 0.50pt">Table body
<list id="L1" list-type="bullet">
<list-item><p>Bullet list</p></list-item>
<list-item><p>Bullet list</p></list-item>
</list>
</td>
<td valign="top" align="left" style="border-top: solid 0.50pt; border-bottom: solid 0.50pt">
<list id="L2" list-type="order">
<list-item><p>Number list style</p></list-item>
<list-item><p>Number list style</p></list-item>
<list-item><p>Number list style</p></list-item>
</list>
</td>
</tr>
</tbody>
</table>
</table-wrap> |
Table and Box Location in the Word File
Numbered tables and boxes may be located in the Word file either at the end of the file, or just after the paragraph where the item is first cited. In either situation, eXtyles will correctly place the table or box in the XML file as set up in your configuration.
...
Lists in Tables
See Setting up Tables in Word for information on how to style lists in tables.