<supplementary-material> Supplementary Material
Container element for a description of, and possibly a pointer to, external resources that support the book or book part, but which are not part of the content of the book.
Defining Supplementary Material
Supplemental material is used to add detail, background, or context to a book by providing, for example, multimedia objects such as audio clips and applets; additional XML-tagged sections, tables, or figures; raw data in a spreadsheet; or a software application in a repository. Supplementary material includes resources such as the following:
- Voluminous material (such as a genomic database or the multiple data sets behind a work that abstracts the highlights of those datasets) that supports the conclusions of the narrative but can never accompany a book based on sheer mass;
- “Extra” tables that do not display with the work, but that record the measurements on which the book is based, for example, that need to be available so the peer reviewers can check the book content;
- Material added to the work for enhancement purposes, such as a quiz, an instructional video, the 3-minute version of the reaction that was described in the work with narrative and a few still images, a form that can be filled out or copied, or similar material;
- A movie, MP3 file, or other binary material that is not directly part of the content of the book or book part; and
- The last several figures of the work that could not be included as part of the base work for stylistic considerations or space limitations.
Contents of the Supplementary Material Element
The <supplementary-material> element does not contain the supplementary object(s), even if the objects are expressed in XML; supplementary objects are external to the XML book or book part rather than part of the XML book. The <supplementary-material> element contains descriptions of the object(s), and it may also, but is not required to, contain a pointer to the objects(s). For example, if the supplementary object is an additional graphic, that graphic is described in the supplementary material but not held there. The <graphic> element that is permissible inside <supplementary-material> is intended for a description of an object, not to hold the object. For example, a <supplementary-material> element could contain a description of an animation, including the first frame of the animation (tagged as a <graphic> element), a caption describing the animation, and a cross-reference made to the external file that held the full animation.
The element is used in two contexts:
- Inside the book metadata (<book-meta>) as an alert to the existence of supplementary material so that such material can be accessed from the book; and
- As part of the textual narrative flow, where it is similar to a <fig>, in that it may take a caption and can be positioned as a floating or anchored object.
For this usage, the @position attribute may be used to indicate whether the element must be anchored at its exact location within the text or whether it may float, for example, to the top of the next page, into the next column, to the end of a logical file, or within a separate window.
The @mimetype attribute may be used to identify a file type for a <supplementary-material> element.
Relationship to NISO Supplemental Material Best Practices
NISO RP-15-2013 Recommended Practices for Online Supplemental Journal Article Materials (http://www.niso.org/apps/group_public/download.php/10055/RP-15-2013_Supplemental_Materials.pdf) and JATS/BITS have identical concepts for “additional” and “integral” material that comprises an article, a book, or a book part, but slightly different practice concerning whether supplementary material is integral or additional.
Both NISO JATS and NISO RP-15-2013 define
- integral content as 'material that is essential for the full understanding of the work by the general scientist or reader in the journal’s discipline'; and
- additional content as 'supplemental material that provides additional, relevant, and useful expansion of the [book or book part] in the form of text, tables, figures, multimedia, or data, and that may aid any reader to achieve deeper understanding of the current work through added detail and context. Additional Content … is not essential to the understanding of the [book].'
Relation to Other Book and Journal Tag Sets
The <supplementary-material> element has a similar function to the <audiovisual> element in some XML tag sets and the <unprinted-item> element (used only for electronic files) in other tag sets.
orientation (default = portrait)
position (default = float)
Models and Context
May be contained in
<abstract>, <ack>, <alternatives>, <answer>, <app>, <app-group>, <bio>, <body>, <book-app-group>, <book-meta>, <book-part-meta>, <boxed-text>, <disp-quote>, <explanation>, <floats-group>, <glossary>, <index>, <index-div>, <index-group>, <license-p>, <named-book-part-body>, <named-content>, <notes>, <option>, <p>, <question>, <question-preamble>, <ref-list>, <sec>, <styled-content>, <toc>, <toc-div>, <toc-entry>, <toc-group>, <trans-abstract>
The following, in order:
- <object-id> Object Identifier, zero or more
- <label> Label (of an Equation, Figure, Reference, etc.), zero or one
- <caption> Caption of a Figure, Table, etc., zero or more
- <legend> Legend, zero or more
- <contrib-group> Contributor Group, zero or more
- <abstract> Abstract, zero or more
- <kwd-group> Keyword Group, zero or more
- <subj-group> Subject Group, zero or more
- Any combination of:
- Accessibility Elements
- Linking Elements
- Any combination of:
- <disp-formula> Formula, Display
- <disp-formula-group> Formula, Display Group
- <chem-struct-wrap> Chemical Structure Wrapper
- <disp-quote> Quote, Displayed
- <speech> Speech
- <statement> Statement, Formal
- <verse-group> Verse Form for Poetry
- <table-wrap> Table Wrapper
- <p> Paragraph
- <alternatives> Alternatives For Processing
- <array> Array (Simple Tabulation)
- <code> Code
- <graphic> Graphic
- <media> Media Object
- <preformat> Preformatted Text
- <xref> X (cross) Reference
- Any combination of:
- Ownership Elements
<!ELEMENT supplementary-material %supplementary-material-model; >
Expanded Content Model
((object-id)*, label?, (caption)*, (legend)*, (contrib-group)*, (abstract)*, (kwd-group)*, (subj-group)*, (alt-text | long-desc | email | ext-link | uri)*, (disp-formula | disp-formula-group | chem-struct-wrap | disp-quote | speech | statement | verse-group | table-wrap | p | def-list | list | alternatives | array | code | graphic | media | preformat | xref)*, (attrib | permissions)*)
Empty link to supplementary resource
... <book-part-meta> ... <contrib-group> <contrib contrib-type="author"> <collab collab-type="committee">Accredited Standards Committee S3, Bioacoustics</collab> </contrib> </contrib-group> <fpage seq="1">1</fpage> <lpage>44</lpage> <supplementary-material mime-subtype="zip" mimetype="application" xlink:href="ASASTD.ANSI.ASA.S3.50.supplementary-material.zip"/> ... </book-part-meta> ...
<supplementary-material> structure describing a supplementary resource
... <sec> ... <p>The molecular determinants of transcription-complex stability and processivity are understood poorly. Several competing mechanistic models of RNAP function have been proposed ...</p> <supplementary-material id="S1" xmlns:xlink="http://www.w3.org/1999/xlink" xlink:title="local_file" xlink:href="1471-2105-1-1-s1.pdf" mimetype="application/pdf"> <label>Additional material</label> <caption> <p>Supplementary PDF file supplied by authors.</p> </caption> </supplementary-material> <p>RNAPs seem to have arisen twice in evolution (see the <inline-supplementary-material xmlns:xlink="http://www.w3.org/1999/xlink" xlink:title="local_file" xlink:href="timeline"> Timeline</inline-supplementary-material>). A large family of multisubunit RNAPs includes bacterial enzymes, archeal enzymes, eukaryotic nuclear RNAPs, plastid-encoded chloroplast RNAPs, and RNAPs from some eukaryotic viruses. ...</p> </sec> ...