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 they “look right,” but, rather, because they reflect the correct structure of the document.
Document Headings
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.
Numbered Headings 1-6
The paragraph styles Heading 1 through Heading 6 on the Body tab of the eXtyles palette are formatted to apply auto-numbering per the appropriate heading level and per the appropriate section. For example,
Word
XML
| Code Block | ||||
|---|---|---|---|---|
| ||||
<body>
<sec id="sec1">
<label>1</label><title>ECONOMIC ENVIRONMENT</title>
<sec id="sec1.1">
<label>1.1</label><title>Main Features of the Economy</title>
<p>1.1.  Switzerland is a high-income country whose wealth is highly dependent on international trade....</p>
</sec>
</sec>
</body> |
In the example, you can see that the Heading 2 section (<sec>) is “nested” within the Heading 1 section; that is, Heading 1’s <sec> does not close (</sec>) before Heading 2’s <sec> begins.
Note also that the heading numbers are automatically correctly tagged as <label> in the XML, and a section id is automatically added to the XML for each section; for example, heading 1.1 has id="sec1.1".
Headings 3-6 behave similarly, with appropriate auto-numbering applied in Word and correct section nesting and id’s assigned in the XML.
Unnumbered Headings 2-9
eXtyles also supports unnumbered headings that may appear in documents. Starting with heading level 2, you can use the Heading 2, 3, 4, 5, 6 Unnumbered options on the Body tab of the style palette to style unnumbered headings at the appropriate, semantically correct level. By default, the styles Heading 7, Heading 8, and Heading 9 are not numbered.
Word
XML
| Code Block | ||||
|---|---|---|---|---|
| ||||
<sec id="sec1.2"> <label>1.2</label><title>Recent Economic Developments</title> <p>1.3.  The Swiss economy has shown resilience in a difficult environment, faced with headwinds from the economic problems in the euro zone and a strong Swiss franc. Since the last trade policy review in 2013, the economy has continued to grow (1.5% on average during the period 2013-15), accompanied by low unemployment (in the range of 4-4.5%, based on ILO methodology) (<xref ref-type="table" rid="t01.01">Table 1.1</xref>).</p> <sec> <title>Monetary policy</title> <p>1.4.  In the course of 2011, the debt crisis in the euro zone and a high degree of uncertainty in the financial markets triggered a flight to safe havens by investors, which prompted a strong appreciation of the Swiss franc (<italic>vis‑à‑vis</italic> the euro...</p> </sec> </sec> |
Body Text Styles
Five Body Text styles are available on the eXtyles style palette. Each should be used deliberately to achieve correct XML.
Body Text
Body Text should be used on all regular, numbered body text paragraphs on a document. It is formatted to apply auto-numbering to the paragraphs on which it is used.
| Tip |
|---|
eXtyles will automatically apply the Body Text style to body text paragraphs in the document when the Auto Style Body Text option is selected in the Cleanup dialog. |
Word
XML
| Code Block | ||||
|---|---|---|---|---|
| ||||
<p>2.1.  The Swiss Confederation is a federal State comprising 26 cantons, according to the Federal Constitution of 18 April 1999....</p> <p>2.2.  At the federal level, legislative power is vested in the bicameral Federal Assembly, comprising a National Council and a Council of States....</p> |
Note that, unlike headings, the paragraph numbers are not marked up as <label>. This is because the BITS DTD does not allow for labeled paragraphs.
Body Text 2 and Body Text 3
WTO documents occasionally have body text paragraphs that may be labeled with lowercase letters or lowercase Roman numerals. To ensure that these text paragraphs include the correct label and are exported with the correct markup, the Body Text 2 and Body Text 3 styles must be used.
Word
XML
| Code Block | ||||
|---|---|---|---|---|
| ||||
<p>3.129.  At the federal level, Switzerland has five state-owned enterprises that are wholly owned ... In terms of performance:</p>
<list id="L4" list-type="alpha-lower">
<list-item><label>a</label><p>Swisscom has been profitable in recent years (2014, 2015) without any federal subsidies...</p></list-item>
<list-item><label>b</label><p>In the last few years, Swiss Federal Railways (SBB) yielded profits...</p></list-item>
<list-item><label>c</label><p>Swiss Post was profitable in 2014 and 2015, mainly due to the performance...</p></list-item>
</list>
<p>3.130.  Switzerland does not have a privatization agenda...</p> |
Note that the Body Text 2 paragraphs are exported with <list> markup. The list-type is correctly, automatically captured as "alpha-lower", and the <label>s are also present.
Body Text 2 Continued should be used when a Body Text 2 paragraph is interrupted by an object, such as an equation, and continues after the object. For example,
Word
XML
| Code Block | ||||
|---|---|---|---|---|
| ||||
<list-item><label>b</label><p>In the last few years, Swiss Federal Railways (SBB) yielded profits (SwF 373 million in 2014 and SwF 246 million 2015). <disp-formula id="e"><italic>a </italic>+ <italic>b </italic>= <italic>c</italic></disp-formula></p> <p>SBB received subsidies for three purposes: ...</p> </list-item> |
The use of the Body Text 2 Continued style for the paragraph following the equation ensures that the closing paragraph is included in the same <list-item> as the first paragraph.
Likewise, Body Text 3 and Body Text 3 Continued can be used for paragraphs that are subordinate to Body Text 2 paragraphs; for example,
Word
XML
| Code Block | ||||
|---|---|---|---|---|
| ||||
<list id="L4" list-type="alpha-lower">
<list-item><label>a</label><p>Swisscom has been profitable in recent years (2014, 2015)...</p></list-item>
<list-item><label>b</label><p>In the last few years, Swiss Federal Railways (SBB) yielded profits...</p>
<list id="L5" list-type="roman-lower">
<list-item><label>i</label><p>infrastructure (major share of the subsidies, co-financed by public long-term loans...</p></list-item>
<list-item><label>ii</label><p>regional passenger transport services; and </p></list-item>
<list-item><label>iii</label><p>goods transport services. In total, SBB and its subsidiaries received...</p></list-item>
</list>
</list-item>
<list-item><label>c</label><p>Swiss Post was profitable in 2014 and 2015, mainly due to the performance ...</p></list-item>
</list>
<p>3.130.  Switzerland does not have a privatization agenda...</p> |
Note that the Body Text 3 style is given the correct attribute list-type="roman-lower", and that it is nested within the preceding Body Text 2 <list-item>.
Quotations and Lists
WTO documents occasionally include quotations and bulleted lists. These items should be styled with the correct paragraph style from the eXtyles style palette.
Quotations
Quotations (extracts) should be styled using the Quotation set of styles on the Body tab of the palette. For example,
Word
XML
| Code Block | ||||
|---|---|---|---|---|
| ||||
<p>1.6.  The Panel's terms of reference are the following:</p> <disp-quote> <p>To examine, in the light of the relevant provisions of the covered agreements cited by the parties to the dispute, the matter referred to the DSB by China in document WT/DS543/7 and to make such findings as will assist the DSB in making the recommendations or in giving the rulings provided for in those agreements.<xref ref-type="fn" rid="fn8"><sup>8</sup></xref><fn id="fn8"><label>8</label><p> Constitution Note of the Panel, WT/DS543/8, para. 2.</p></fn></p> </disp-quote> <p>1.7.  On 24 May 2019, China requested the Director-General to determine the composition...</p> |
More complex quotations may include lists and notes. In those instances, the appropriate quotation styles should be used; for example,
Word
XML
| Code Block | ||||
|---|---|---|---|---|
| ||||
<p>7.37.  China's panel request reads, in relevant parts:</p> <disp-quote> <p>The measures at issue in this request include the actions taken by the United States, based on the USTR's investigation into China's acts, policies, and practices related to technology transfer, intellectual property, and innovation under Section 301 of the Trade Act of 1974 and pursuant to sections 301(b), 301(c), and 304(a) of the Trade Act of 1974 and the direction made in the President's statement to impose an additional ad valorem duty upon certain imported products of Chinese origin. The above mentioned actions include:</p> <p>1. An additional 25% duty <italic>ad valorem</italic> on approximately $34 billion worth of imports from China announced by the USTR on 15 June 2018 and implemented by the Federal Register notice of 20 June 2018 (<italic>Notice of Action and Request for Public Comment Concerning Proposed Determination of Action Pursuant to Section 301: China's Acts, Policies and Practices Related to Technology Transfer, Intellectual Property and Innovation</italic>, (83 Fed. Reg. 28,710)); and</p> <p>2. An additional 10% duty <italic>ad valorem</italic> on approximately $200 billion worth of imports from China implemented on 24 September 2018, and the rate of additional duty will increase to 25% ad valorem on 1 January 2019,[<sup>13</sup>] according to the announcement by the USTR on 21 September 2018 (<italic>Notice of Modification of Section 301 Action: China's Acts, Policies and Practices Related to Technology Transfer, Intellectual Property and Innovation</italic>, (83 Fed. Reg. 47,974)).<xref ref-type="fn" rid="fn84"><sup>84</sup></xref><fn id="fn84"><label>84</label><p> China's panel request, p. 2. (emphasis original)</p></fn></p> <p><sup>13</sup> The application of this additional 25% tariff for $200 billion imported products of Chinese origin may be postponed as per the statement by the United States after the bilateral meeting between China and the United States on 1 December 2018 in Argentina. […]</p> </disp-quote> <p>7.38.  This statement is followed by a list of legal instruments through which, among others...</p> |
Bulleted Lists
Bulleted lists should be styled using the Bulleted List styles on the Body tab of the eXtyles style palette. Bullet List Level 1 should be used for all primary list items, and Bullet List Levels 2-3 should be used as appropriate for sublist items. For example:
Word
XML
| Code Block | ||||
|---|---|---|---|---|
| ||||
<p>3.3.  The United States requests that:</p>
<list id="L3" list-type="bullet">
<list-item><label>•</label><p>The Panel reject China's request for findings under Articles I and II of the GATT 1994 with respect to the allegedly WTO-inconsistent tariff measures, and, instead, issue a report with a "brief description" of the pertinent facts of the dispute and "reporting that a solution has been reached" by the parties, as prescribed by Article 12.7 of the DSU.<sup> </sup><xref ref-type="fn" rid="fn24"><sup>24</sup></xref><fn id="fn24"><label>24</label><p> United States' first written submission, para. 113.</p></fn></p></list-item>
<list-item><label>•</label><p>If the Panel examines China's contentions:</p>
<list id="L4" list-type="bullet">
<list-item><label>o</label><p>The Panel find that the measures at issue are justified under Article XX(a) of the GATT 1994; and</p></list-item>
<list-item><label>o</label><p>The Panel find that the increase of the additional duties on List 2 products from 10% to 25% falls outside the Panel's terms of reference.<xref ref-type="fn" rid="fn25"><sup>25</sup></xref><fn id="fn25"><label>25</label><p> United States' first written submission, para. 114.</p></fn></p>
</list-item>
</list>
</list-item>
</list> |