Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Following examples show how to use the styles on the Title tab of the style palette, and the BITS XML that is produced for each style.

Table of Contents
minLevel1
maxLevel1

Title Information

The document title, subtitle (if present),

...

suggested citation title, and running head should be styled as follows to produce correct XML.

...

Image Added

Code Block
breakoutModewide
languagexml
<book-title-group>
<book-title>Northeast Coastal and Barrier Network Geomorphological Monitoring Protocol</book-title>
<subtitle>Part I&#x2014;Ocean Shoreline Position, Version 2</subtitle>
<alt-title alt-title-type="sentence-case">Northeast coastal and barrier network geomorphological monitoring protocol: Part I&#x2014;Ocean shoreline position, version 2</alt-title>
<alt-title alt-title-type="running-head">Northeast Coastal and Barrier Network </alt-title>
</book-title-group>

Note that the Citation Title produces an <alt-title> element with a type attribute of "sentence-case". This markup will facilitate the creation of the suggested citation in the rendered content, which has a title casing format different from the main document title.

Note

Because the suggested citation will be constructed from existing metadata it should not be retained in the Word document.

Cover Information

...

Running Head Title should be used if the document’s running head needs to include a shortened version of the document title.

Cover Photos

Cover photos and/or inside cover photos and their associated captions and credits should be styled in the following ways.

Tip

Note that any images that appear in the Word document will be exported from the file during document Activation. In their place will be text such as [EXTYLES REMOVED IMAGE 001], which should be styled as Non-XML Text.

Cover Photos

...

Image Added
Code Block
breakoutModewide
languagexml
<fig fig-type="cover">

...


<caption><p>Foredune and beach face on Profile 12 at the Sandy Hook Unit of Gateway National Recreation Area. The upper photo was taken in the spring of 2019, by Glenn Liu, Rutgers. </p></caption>
<alt-text>Alt-text for the cover photo.</

...

alt-text>
<attrib>The lower photo was taken in the spring of 2020 by Katy Ames.</attrib>
</fig>
Tip

Remember that any image or photo that remains in the Word document should be styled as Non-XML Text/Graphics.

Cover Notes

Availability statements or other content that is specific to the document and is not boilerplate text should be styled using Cover Note.

...

Inside Cover Photos

Captions for photos that will appear on the inside cover should be styled using the Inside Cover Photo paragraph style. Cover Photo Alt Text and Cover Photo Credit can also be used, as necessary.

Image Added
Code Block
breakoutModewide
languagexml

...

<fig 

...

fig-type="inside-cover

...

">

...

<caption><p>Location 

...

of 

...

coastal 

...

areas in Gateway 

...

National 

...

Recreation 

...

Area 

...

monitored 

...

according 

...

to 

...

the 

...

1D 

...

shoreline 

...

position and the 

...

2D 

...

dune/beach 

...

profile protocols</p></caption>
<alt-text>Alt-text for the cover photo.</alt-text>
<attrib>The lower photo was taken in the spring of 2020 by Katy Ames.</attrib>
</fig>

Cover Notes

In some cases a document may contain cover content that is not boilerplate text. This content should be styled using Cover Note.

Note

Boilerplate text is any text that is the same in every document; for example, disclaimers. This text is included in the BITS XML export filter and will automatically be included in the XML for every document. Because of this, it should be removed from the cover page of the Word document to avoid duplication in the XML.

Authors and Affiliations

Document authors and their affiliations and other notes should be styled using the Authors, Affiliations, and Author Footnote styles.

Image Modified
Code Block
breakoutModewide
languagexml
<contrib-group content-type="authors">
<contrib contrib-type="author">
<string-name><x>Dr.</x><x> </x><given-names>Norbert P.</given-names><x> </x><surname>Psuty</surname></string-name>
<xref ref-type="aff" rid="aff1"><sup>1</sup></xref>
...
<aff id="aff1">
<label>1</label><institution>New Jersey Agricultural Experiment Station, Rutgers, The State University of New Jersey</institution>, 
<institution content-type="dept">Sandy Hook Cooperative Research Program</institution>, 
<addr-line>130 Great Bay Boulevard</addr-line>, Tuckerton, 
<addr-line>NJ 08087</addr-line>
</aff>
...
</contrib-group>
...
<author-notes>
<fn id="afn1">
<p>These authors all contributed equally to the report.</p>
</fn>
</author-notes>

In the XML the author will automatically be associated with their affiliation.

Note

Author Processing must be run before BITS XML export to ensure that the author and affiliation markup is correct in the XML.