Body Style Examples
- Jenny Seifert (Unlicensed)
- Christine Benson
Content in the document body should be styled using items on the Body tab of the eXtyles style palette. This section describes how to correctly style the body section of your content.
Section Titles and Headings
In an XML workflow it is important to ensure that sections of a document are organized in correct hierarchical order; for example, the Heading 2 style should never be used before Heading 1, because Heading 2 denotes a section that is subordinate to a main section (indicated with Heading 1).
Heading levels should therefore not be used because the “look right,” but, rather, because they reflect the correct structure of the document.
Section Title
The Section Title style should be used when a report is separated into multiple parallel sections; for example, a report that has two sections each with their own reference list or appendices.
For example, this report has two parallel Patient Group sections.
The use of Section Title in this case creates distinct “parts” in the XML, which ensures that section-level material remains in the correct location (e.g., appendices or reference lists).
<book-part id="bp1">
<book-part-meta>
<title-group>
<title>Patient Group: Canadian Liver Foundation</title>
</title-group>
</book-part-meta>
<body>
<sec id="S1" sec-type="other1" disp-level="1">
<label>1</label><title>About Your Patient Group</title>
<p>Founded in 1969, the Canadian Liver Foundation (CLF) was the first organization in the world dedicated to supporting education and research into all forms of liver disease.
...
</p>
</body>
</book-part>
<book-part id="bp2">
<book-part-meta>
<title-group>
<title>Patient Group: The Isaac Foundation</title>
</title-group>
</book-part-meta>
<body>
<sec id="S8" sec-type="other11" disp-level="1">
<label>1</label><title>About Your Patient Group</title>
<p>The Isaac Foundation's mission is to fund innovative research projects that aim to find a cure for MPS, a rare, debilitating, and devastating disease.
...
</p>
</body>
</book-part>Headings 1-5
Document subheadings should be used to impose correct structure on the document. For example, the first heading in the body of a document (that is not a Section Title) should always be Heading 1, followed by Heading 2, Heading 3, and so on, as appropriate.
Subheadings will “nest” into their parent section during XML export, which ensures that the proper document structure is maintained.
These correctly styled headings will produce properly nested XML, as shown here.
<body>
<sec id="S1" sec-type="other1" disp-level="1">
<title>Executive Summary</title>
<sec id="S1-1" disp-level="2">
<title>Context and Policy Issues</title>
<p>Pharmacologic treatment of type 2 diabetes following the failure of conventional diet and exercise ....</p>
</sec>
<sec id="S1-2" disp-level="2">
<title>Objectives and Research Questions</title>
<sec id="S1-2-1" disp-level="3">
<title>Clinical Review</title>
<p>The objective of this project is to update a previous CADTH systematic review, ....</p>
</sec>
</sec>
</sec>Key Messages Title
Key Messages sections must begin with a title styled using the Key Messages Title paragraph style. This ensures that the content is uniquely tagged in the XML, which allows it to be rendered differently from the other body text.
For example,
Produces the following XML (note the sec-type="key-message" attribute, which uniquely identifies this section from other body text):
<sec sec-type="key-message" id="S2">
<title>Key Messages</title>
<p>Following are key messages for this report.</p>
<list id="L2" list-type="order">
<list-item><p>Here are some key messages</p></list-item>
<list-item><p>Some more</p></list-item>
<list-item><p>The last one</p></list-item></list>
</sec>Lists
All lists, regardless of the symbol or number that precedes them, should be styled with the appropriate list level paragraph style. During XML export, eXtyles will identify the list type, and assign the proper identifying attribute in the XML (e.g., ordered, bulleted, alpha).
List Level 1 should be used for all primary list items, and Levels 2-4 should be used as appropriate for sublist items. For example:
Which produces the following XML:
If a list item contains more than one paragraph, the List Continued styles of the appropriate level should be used. For example,
Produces the following XML:
Literature Search Item
Literature Search Item is a style that should be applied to literature search strings that need to be protected from automated changes made by the Auto-Redact function. These strings may include alternate spellings or purposefully misspelled words.
See the below example of the Literature Search Item paragraph style as applied in Microsoft Word:
The Literature Search Item paragraph style will produce a list in the exported XML, as seen below: