<!-- ============================================================= -->
<!-- MODULE: Display Class Elements -->
<!-- VERSION: 2.3 -->
<!-- DATE: February 2007 -->
<!-- -->
<!-- ============================================================= -->
<!-- ============================================================= -->
<!-- PUBLIC DOCUMENT TYPE DEFINITION -->
<!-- TYPICAL INVOCATION -->
<!--
"-//NLM//DTD Archiving and Interchange DTD Suite Display Class Elements v2.3 20070202//EN"
Delivered as file "display.ent" -->
<!-- ============================================================= -->
<!-- ============================================================= -->
<!-- SYSTEM: Archiving and Interchange DTD Suite -->
<!-- -->
<!-- PURPOSE: Describes display-related elements such as -->
<!-- Figures, Graphics, Math, Chemical Structures, -->
<!-- Graphics, etc. -->
<!-- -->
<!-- CONTAINS: 1) Parameter Entities for attribute lists -->
<!-- 2) Parameter Entities for content models -->
<!-- 3) The display class elements (alpha order) -->
<!-- a) Array -->
<!-- b) Boxed text -->
<!-- c) Chemical Structure -->
<!-- d) Figure -->
<!-- e) Graphic -->
<!-- f) Inline Graphic -->
<!-- g) Pre-formatted text -->
<!-- e) Supplementary Information -->
<!-- h) Table Group -->
<!-- i) Table Wrapper -->
<!-- j) Table (invoked module) -->
<!-- -->
<!-- CREATED FOR: -->
<!-- Digital archives and publishers who wish to -->
<!-- create a custom XML DTD for original markup of -->
<!-- journal literature, books, and related material, -->
<!-- or for archiving and transferring such material -->
<!-- between archives. -->
<!-- -->
<!-- This DTD is in the public domain. An organization -->
<!-- that wishes to create its own DTD from the suite -->
<!-- may do so without permission from NLM. -->
<!-- -->
<!-- The suite has been set up to be extended using a -->
<!-- new DTD file and a new DTD-specific customization -->
<!-- module to redefine the many Parameter Entities. -->
<!-- Do not modify the suite directly or redistribute -->
<!-- modified versions of the suite. -->
<!-- -->
<!-- In the interest of maintaining consistency and -->
<!-- clarity for potential users, NLM requests: -->
<!-- -->
<!-- 1. If you create a DTD from the Archiving and -->
<!-- Interchange DTD Suite and intend to stay -->
<!-- compatible with the suite, then please include -->
<!-- the following statement as a comment in all of -->
<!-- your DTD modules: -->
<!-- "Created from, and fully compatible with, -->
<!-- the Archiving and Interchange DTD Suite." -->
<!-- -->
<!-- 2. If you alter one or more modules of the suite, -->
<!-- then please rename your version and all its -->
<!-- modules to avoid any confusion with the -->
<!-- original suite. Also, please include the -->
<!-- following statement as a comment in all your -->
<!-- DTD modules: -->
<!-- "Based in part on, but not fully compatible -->
<!-- with, the Archiving and Interchange DTD -->
<!-- Suite." -->
<!-- -->
<!-- Suggestions for refinements and enhancements to -->
<!-- the DTD suite should be sent in email to: -->
<!-- archive-dtd@ncbi.nlm.nih.gov -->
<!-- -->
<!-- ORIGINAL CREATION DATE: -->
<!-- December 2002 -->
<!-- -->
<!-- CREATED BY: Jeff Beck (NCBI) -->
<!-- Deborah Lapeyre (Mulberry Technologies, Inc.) -->
<!-- Bruce Rosenblum (Inera Inc.) -->
<!-- -->
<!-- NLM thanks the Harvard University Libraries, both -->
<!-- for proposing that a draft archiving NLM DTD for -->
<!-- life sciences journals be extended to accommodate -->
<!-- journals in all disciplines and for sponsoring -->
<!-- Bruce Rosenblum's collaboration with other DTD -->
<!-- authors in completing Version 1.0. The Andrew W. -->
<!-- Mellon Foundation provided support for these -->
<!-- important contributions. -->
<!-- -->
<!-- ============================================================= -->
<!-- ============================================================= -->
<!-- DTD VERSION/CHANGE HISTORY -->
<!-- ============================================================= -->
<!--
=============================================================
Version Reason/Occasion (who) vx.x (yyyy-mm-dd)
=============================================================
Version 2.3 (DAL/BTU) v2.3 (2007-02-02)
Enhancement Release (2.3) following the Working Group meetings
of Oct-Nov/2006-Jan/2007. No backward-incompatible changes.
Archiving loosened even more. New structures for all the DTDs.
30. FIG MODEL ELEMENTS - Added <chem-struct-wrapper> to the
contents of <figure> using -%chem-struct-wrap.class; inside
-%fig-mod; so that you can use a <chem-struct-wrapper> anywhere
you can use a <disp-formula>.
29. NEW TYPE ATTRIBUTES - Added "content-type" attribute to the
following elements
- fig-group
- graphic
- inline-graphic
- media
- supplementary-material
- table-wrap-group
28. INLINE GRAPHIC ATTS - In the parameter entity
-%inline-graphic-atts; made the following changes:
a) Unfixed the "mimetype" attribute from
mimetype CDATA #FIXED 'image'
into this:
mimetype CDATA #IMPLIED
b) Added "content-type" attribute to preserve or add semantic
distinctions.
c. Added "baseline-shift" attribute to preserve the positioning
of the inline graphic relative to the text baseline.
27. GRAPHIC ATTS - In the parameter entity -%graphic-atts;
made the following changes:
a) Unfixed the "mimetype" attribute from
mimetype CDATA #FIXED 'image'
into this:
mimetype CDATA #IMPLIED
b) Made the "mime-subtype" attribute into a CDATA rather
than a list of values
c) Added "content-type" attribute to preserve or add semantic
distinctions.
26. NEW PARAMETER ENTITIES - Added parameter entities for the
attribute lists of:
- array
- caption
25. Updated public identifier to "v2.3 20070202//EN"
=============================================================
Version 2.2 (DAL/BTU) v2.2 (2006-04-30)
Backwards-compatible changes to meet operational needs.
Typical changes include adding attribute values and making
required elements optional.
24. NEW CONTENT MODEL PARAMETER ENTITIES - Added content model
parameter entities for the following elements, to make it
easier to change their content:
- caption
- inline-graphic
23. PREFORMAT ELEMENTS - Added -%phrase.class; to allow use of
<named-content> inside <preformat>.
22. Updated public identifier to "v2.3 20070202//EN"
=============================================================
Version 2.1 (DAL/BTU) v2.1 (2005-06-30)
Changed to MathML 2.0 and MathML 2.0 Character Sets
Added new material requested by NCBI
21. Minor, non-functional changes to element order in PEs and to
wording in comments as part of 2.1 release.
20. Updated public identifier to "v2.3 20070202"
=============================================================
Version 2.0 (DAL/BTU) v2.0 (2004-08-30)
Major requirement changes led to the new release, producing
DTD version "2.0":
a) The splitting of the Archival and Interchange Tag Set
DTDs into three DTDs from two: an authoring DTD, an
archive regularization and interchange DTD (the
current Blue Publishing DTD), and a preservationist
archive DTD (the current Green Archiving and Interchange
DTD).
b) AIT Working Group suggestions from the June 04 meeting
and June/July 2004 followup discussions
c) Suite remodularization to meet new (and newly articulated)
modularization requirements
d) New or renamed classes and mixes to make modifications
easier and more consistent
19. OTHER-TABLE-WRAP-ATTS - Moved this Parameter Entity from
the Archiving (Green) customization module to this module,
so that all variant DTDs could use it. Possible for both
<table-wrapper> and <table-group>.
18. COMPLETE MODELS WHEN OVER-RIDING A MODEL
(for all Parameter Entities suffixed "-model")
### Customization Alert ###
Made all the model over-rides consistent. Some included
the outer parentheses, some did not. They all do now,
as this is the most flexible system, allowing for
#PCDATA, mixed, or element content. (This is in direct
contrast to the "-element" suffixed models, which are
designed to prohibit element content and permit only
#PCDATA or mixed content.) Added parentheses to Parameter
Entity and removed them from the Element Declaration.
- %array-model;
- %boxed-text-model;
- %chem-struct-wrapper-model;
- %fig-model;
- %fig-group-model;
- %preformat-model;
- %table-wrap-model;
- %table-wrap-group-model;
- %table-wrap-foot-model;
17. LOOSENING FIGURE - %label.class; and %caption.class; both
allowed to repeat in <fig> model, to allow for alternate
placements.
16. OBJECT ID/DOI - added to elements by request of AIT WG.
Elements with DOIs are those a publisher could expect to sell
or handle separately. DOI is placed in an <object-id> element,
part of the %id.class; and added to:
- <boxed-text> (through %boxed-text-model;)
- <chem-struct-wrapper> (through %chem-struct-wrapper-model;)
- <fig> (through %fig-model;)
- <graphic> (through %graphic-model;)
- <media> (through %graphic-model;)
- <pre-format> (through %preformat-elements;)
- <supplementary-material> (through %fig-model;)
- <table-wrap> (through %table-wrap-model;)
A "pub-id-type" attribute identifies the type of ID, DOI,
archive-issued ID, etc.
15. PARAMETER ENTITY CLEANUP AND REGULARIZATION
a. RENAME EXISTING CLASSES
### Customization Alert ###
Some classes did not have the ".class" suffix. Changed the
names to add the class suffix:
- %display-back-matter.class; used in
-%array-model; -%boxed-text-model;
-%fig-model; -%chem-struct-wrapper-model;
-%graphic-model; -%preformat-model;
-%table-wrap-model; -%table-wrap-foot-model;
- %block-math.class; (used in -%fig-model;)
b. INLINE MIXES USE OR BARs
### Customization Alert ###
Changed the following PEs to start with an OR bar:
- %preformat-elements;
c. NEW CLASSES - To correct potential classing problems, new
Parameter Entities were created:
New Content Models PEs
- %preformat-model;
New Classes PEs
- %caption.class; used in:
- %fig-model; - %fig-group-model;
- %table-wrap-model; - %chem-struct-wrapper-model;
- %graphic-model;
- %fig-display.class; used in:
-%fig-group-model;
- %just-para.class; used in:
- <caption>
- %table-wrap-foot-model;
- %just-table.class; used in:
- %table-wrap-group-model;
- %fig-model;
- %just-base-display.class; used in:
- %array-model; - %fig-group-model;
- %chem-struct-wrapper-model;(where using it added
the <preformat> element to <chem-struct-wrapper>
- %tbody.class; used in
- %array-model;
- %chem-struct-elements; used in:
- %chem-struct-model;
d. ACCESS CLASS
### Customization Alert ###
- Took <ext-link> out of -%access.class;. It did not belong.
It belongs in -%address-link.class;
- Added -%address-link.class; to anywhere regular
%access.class; was used.
14. DEFAULT CLASSES - Were moved from this module to
%default-classes.ent;
13. Updated public identifier to "v2.3 20070202"
=============================================================
Version 1.1 (TRG/BTU) v1.1 (2003-11-01)
12. Added "mimetype" and "mime-subtype" attributes to all graphic
and multi-media elements, including:
- <graphic>
- <inline-graphic>
- <media>
- <supplementary-material>
11. Created parameter entity %media-atts; to hold attribute list
for <media> (and replace %graphic-atts; as attribute list
holder)
Rationale: Needed to split attribute list for <media> from
that for <graphic>, in order to have different values for
new attribute "mimetype".
10. Added attribute "alternate-form-of" to the following elements:
- <array>
- <chem-struct> (by modifying parameter entity
%chem-structs-atts;)
- <graphic> (by modifying parameter entity %graphic-atts;)
- <media> (by modifying parameter entity %graphic-atts;)
- <supplementary-material> (by modifying parameter entity
%supplementary-material-atts;)
- <inline-graphic> (by modifying parameter entity
%inline-graphic-atts;)
- <preformat>
Rationale: Where multiple formats of an item (e.g., graphic
file, media object, chemical structure) are available, this
attribute indicates that a format is a secondary one and
provides a link to the primary format, so that only one
format of an item is displayed.
9. Modified parameter entity %array-model; so that the elements
<graphic> and <media> could be used multiple times.
Rationale: A series of <graphic> (or <media>) elements
may occur in the same content, especially if they are
variants of one graphic (or media object) may be linked,
with only one variation being displayed.
8. Added attribute "id" to the following:
- <inline-graphic> (via parameter entity %inline-graphic-atts;)
- <chem-struct> (via parameter entity %chem-struct-atts;)
Rationale: Provide unique identifier so these elements can be
linked to. Some will have alternate versions which will point
to them, others may be the target internal cross-references.
7. Created parameter entity %inline-graphic-atts; to hold
various attributes associated with <inline-graphic>
Rationale: In order to distinguish between attribute lists
used by the Archiving DTD and the Publishing DTD, it was
necessary to create a parameter entity that could be overridden.
6. Added attribute "content-type" to the following:
- <array>
- <boxed-text> by modifying parameter entity %boxed-text-atts;
- <fig-group> by modifying parameter entity %fig-group-atts;
- <table-wrap> by modifying parameter entity %table-wrap-atts;
- <supplementary-material> by modifying parameter entity
%supplementary-material-atts;
- <chem-struct> by modifying parameter entity %chem-struct-atts;
- <chem-struct-wrapper> by modifying parameter entity
%chem-struct-wrapper-atts;
Rationale: To identify and preserve the semantic intent of
semantically rich source documents.
5. Added ID attribute to element <array>.
Rationale: Provide unique identifier so <array> can be linked to.
4. Added parameter entity %label.class; to parameter entity
%chem-struct-model;
Rationale: To allow label as a format override on <chem-struct>.
3. Added element <label> to the parameter entity %array-model;
Rationale: To allow label as a format override
2. Added element <media> to the following parameter entities:
- %block-display.class;
- %simple-display.class;
- %array-model;
- %chem-struct-wrapper-model;
- %fig-group-model;
Rationale: Media object <media> to occur everywhere element
<graphic> is allowed to occur.
1. Added element <media> for media objects; <media> will be used
in the same way <graphic> is and will have the same content,
but be used for animation or movies.
Rationale: To distinguish alternate media (such as movies or
animation) from traditional print graphic forms.
-->
<!-- ============================================================= -->
<!-- PARAMETER ENTITY DEPENDENCIES
Requires the following parameter entities
be defined before calling this module,
usually accomplished in the Customization
Module for the specific DTD:
Element Classes and Groups
%access.class;
%block-math.class;
%break.class;
%emphasis.class;
%inside-table-wrapper;
%intable-para.class;
%label.class;
%list.class;
%math.class;
%simple-display.class;
%simple-link.class;
%subsup.class;
Content Models
%sec-opt-title-model;
Attribute Lists
%link-atts;
%might-link-atts;
%other-table-wrap-atts;
-->
<!-- ============================================================= -->
<!-- ============================================================= -->
<!-- DEFAULT PES FOR ATTRIBUTE LISTS -->
<!-- ============================================================= -->
<!-- ARRAY ATTRIBUTES -->
<!-- Attributes for the <array> element -->
<!ENTITY % array-atts
"alternate-form-of
IDREF #IMPLIED
id ID #IMPLIED
content-type
CDATA #IMPLIED
xml:lang NMTOKEN #IMPLIED" >
<!-- CAPTION ATTRIBUTES -->
<!-- Attributes for the <caption> element -->
<!ENTITY % caption-atts
"xml:lang NMTOKEN #IMPLIED" >
<!-- DISPLAY ATTRIBUTES OPTIONAL ID -->
<!-- Attributes used for several of the block
display elements -->
<!-- position Must this display object (figure, boxed text,
etc.) be anchored in its exact location
within the text or may it float, for example
to the top of the next page, next column, or
within a separate window? Values are:
anchor Object must remain in place
float Object is not anchored and
may be moved to a new column,
a new window, etc.
margin In print, item should be placed
in the margin or gutter.
Online the item should
remain closely associated
with the text. -->
<!ENTITY % display-atts
"position (anchor | float | margin) 'float'" >
<!-- BOXED TEXT ATTRIBUTES -->
<!-- Attributes for the <boxed-text> element -->
<!ENTITY % boxed-text-atts
"id ID #IMPLIED
%display-atts;
xml:lang NMTOKEN #IMPLIED
content-type
CDATA #IMPLIED" >
<!-- CHEMICAL STRUCTURE WRAPPER ATTRIBUTES -->
<!-- Attributes for the <chem-struct-wrapper>
element, the outer wrapper around one or more
chemical structures -->
<!ENTITY % chem-struct-wrapper-atts
"id ID #IMPLIED
%display-atts;
content-type
CDATA #IMPLIED" >
<!-- CHEMICAL STRUCTURE ATTRIBUTES -->
<!-- Attributes for <chem-struct> -->
<!ENTITY % chem-struct-atts
"%might-link-atts;
alternate-form-of
IDREF #IMPLIED
content-type
CDATA #IMPLIED
id ID #IMPLIED" >
<!-- FIGURE GROUP ATTRIBUTES -->
<!-- Attributes for Figure Groups <fig-group> -->
<!ENTITY % fig-group-atts
"id ID #IMPLIED
%display-atts;
content-type
CDATA #IMPLIED" >
<!-- FIGURE ATTRIBUTES -->
<!-- Attributes for Figures <fig> -->
<!ENTITY % fig-atts
"id ID #IMPLIED
%display-atts;
xml:lang NMTOKEN #IMPLIED
fig-type CDATA #IMPLIED" >
<!-- GRAPHIC ATTRIBUTES -->
<!-- Attributes for the <graphic> element -->
<!ENTITY % graphic-atts
"alternate-form-of
IDREF #IMPLIED
alt-version
(yes|no) 'no'
id ID #IMPLIED
content-type
CDATA #IMPLIED
mime-subtype
CDATA #IMPLIED
mimetype CDATA #IMPLIED
%display-atts;
%link-atts;" >
<!-- INLINE GRAPHIC ATTRIBUTES -->
<!-- Attributes for the <inline-graphic> element-->
<!ENTITY % inline-graphic-atts
"alternate-form-of
IDREF #IMPLIED
id ID #IMPLIED
content-type
CDATA #IMPLIED
baseline-shift
CDATA #IMPLIED
mimetype CDATA #IMPLIED
mime-subtype
CDATA #IMPLIED
%link-atts;" >
<!-- MEDIA ATTRIBUTES -->
<!-- Attributes for the <media> element -->
<!ENTITY % media-atts
"alternate-form-of
IDREF #IMPLIED
id ID #IMPLIED
content-type
CDATA #IMPLIED
mimetype CDATA #IMPLIED
mime-subtype
CDATA #IMPLIED
%display-atts;
%link-atts;" >
<!-- PREFORMATTED TEXT ATTRIBUTES -->
<!-- Attributes for the <preformat> element -->
<!ENTITY % preformat-atts
"alternate-form-of
IDREF #IMPLIED
id ID #IMPLIED
%display-atts;
preformat-type
CDATA #IMPLIED
xml:space (default | preserve) #FIXED 'preserve'
xml:lang NMTOKEN #IMPLIED" >
<!-- SUPPLEMENTARY INFORMATION ATTRIBUTES -->
<!-- Attributes for Supplementary Material
<supplementary-material> -->
<!ENTITY % supplementary-material-atts
"alternate-form-of
IDREF #IMPLIED
content-type
CDATA #IMPLIED
id ID #IMPLIED
mimetype CDATA #IMPLIED
mime-subtype
CDATA #IMPLIED
%display-atts;
%might-link-atts;
xml:lang NMTOKEN #IMPLIED" >
<!-- ============================================================= -->
<!-- TABLE ATTRIBUTE PARAMETER ENTITIES -->
<!-- ============================================================= -->
<!-- TABLE WRAPPER ATTRIBUTES -->
<!-- Attributes to be added to the regular NLM
table attributes, for example, when the
Elsevier or OASIS Exchange table models are
used. -->
<!ENTITY % other-table-wrap-atts
"" >
<!-- TABLE GROUP ATTRIBUTES -->
<!-- Attributes for groups of <table-wrap>
elements <table-wrap-group> -->
<!ENTITY % table-wrap-group-atts
"id ID #IMPLIED
content-type
CDATA #IMPLIED
%other-table-wrap-atts;
%display-atts;" >
<!-- TABLE WRAPPER ATTRIBUTES -->
<!-- Attributes for the <table-wrap> element,
the container for <table>s -->
<!ENTITY % table-wrap-atts
"id ID #IMPLIED
%display-atts;
content-type
CDATA #IMPLIED
%other-table-wrap-atts;
xml:lang NMTOKEN #IMPLIED" >
<!-- ============================================================= -->
<!-- PARAMETER ENTITIES FOR CONTENT MODELS -->
<!-- ============================================================= -->
<!-- FIGURE-LIKE CONTENT MODEL -->
<!-- Content model for the Figure element and any
similarly structured elements -->
<!ENTITY % fig-model "((%id.class;)*, (%label.class;)*,
(%caption.class;)*,
(%access.class; | %address-link.class;)*,
(%block-math.class; |
%chem-struct-wrap.class; |
%intable-para.class; |
%just-table.class; | %just-para.class; |
%list.class; | %simple-display.class;)*,
(%display-back-matter.class;)* )" >
<!-- ============================================================= -->
<!-- ARRAY ELEMENTS -->
<!-- ============================================================= -->
<!-- ARRAY CONTENT MODEL -->
<!-- The element used to contain material in
rows and columns that is just a block insert
into the text flow, not numbered or called a
table, and not titled or captioned -->
<!ENTITY % array-model "(label?,
(%access.class; | %address-link.class;)*,
( (%just-base-display.class;)* |
%tbody.class; ),
(%display-back-matter.class;)* )" >
<!-- ARRAY (SIMPLE TABULAR ARRAY) -->
<!-- Used to define in-text table-like (columnar)
material. Uses the XHTML table body element
or a graphic to express the rows and columns.
These have neither labels nor captions,
arrays with labels and captions are table
wrappers.
Remarks: Arrays are not allowed to float,
they are tied to their position in the
text.
Authoring Note: While this element
contains an optional Label element, the
Label element should be included only in
those circumstances where a formatting
override is needed; Label should NOT
be used in the ordinary course of
tagging. -->
<!ELEMENT array %array-model; >
<!-- alternate-form-of
Where multiple formats of an item (e.g.,
graphic file, media object, chemical
structure) are available, this attribute
indicates that a format is a secondary
one and provides a link to the primary
format, so that only one format of an
item is displayed.
id Unique identifier so the element may be
referenced
content-type
Identification of the subject, type of
content, or reason that this word or phrase
is considered semantically special, as a
means of preserving the semantic intent of
the original tagging.
xml:lang The language in which the value of the
element is expressed. Recommended best
practice is to use values as defined in
RFC 1766, typically 2-letter language
codes such as "FR" (French), "EN" (English),
and "DE" (German). These values are NOT
case sensitive, so "EN" = "en". The values
may include hyphenated differentiations such
as "EN-AU" (Australian English) and "EN-US"
(United States English).
Display Note: An Array element is assumed
to be anchored at its position within the
text. -->
<!ATTLIST array
%array-atts; >
<!-- ============================================================= -->
<!-- BOXED TEXT ELEMENTS -->
<!-- ============================================================= -->
<!-- BOXED TEXT MODEL -->
<!-- Complete content model for the boxed text
element, made into a PE so that it could be
redefined, for example, by an authoring DTD.
-->
<!ENTITY % boxed-text-model
"((%id.class;)*, %sec-opt-title-model;,
(%display-back-matter.class;)* )" >
<!-- BOXED TEXT -->
<!-- Textual material that is outside the flow
of the narrative text, for example, a
sidebar, marginalia, text insert, caution or
note box, etc. -->
<!ELEMENT boxed-text %boxed-text-model; >
<!-- id Unique identifier so the element may be
referenced
content-type
Identification of the subject, type of
content, or reason that this word or phrase
is considered semantically special, as a
means of preserving the semantic intent of
the original tagging.
position Must this display object (figure, boxed text,
etc.) be anchored in its exact location
within the text or may it float, for example
to the top of the next page, next column, or
within a separate window? Values are:
anchor Object must remain in place
float Object is not anchored and
may be moved to a new column,
a new window, etc.
margin In print, item should be placed
in the margin or gutter.
Online the item should
remain closely associated
with the text.
xml:lang The language in which the value of the
element is expressed. Recommended best
practice is to use values as defined in
RFC 1766, typically 2-letter language
codes such as "FR" (French), "EN" (English),
and "DE" (German). These values are NOT
case sensitive, so "EN" = "en". The values
may include hyphenated differentiations such
as "EN-AU" (Australian English) and "EN-US"
(United States English). -->
<!ATTLIST boxed-text
%boxed-text-atts; >
<!-- ============================================================= -->
<!-- CHEMICAL STRUCTURE ELEMENTS -->
<!-- ============================================================= -->
<!-- CHEMICAL STRUCTURE WRAPPER MODEL -->
<!-- Content model for the Chemical Structure
Wrapper <chem-struct-wrapper> element -->
<!ENTITY % chem-struct-wrapper-model
"((%id.class;)*, (%label.class;)?,
(%caption.class;)?,
(%access.class; | %address-link.class;)*,
(%simple-intable-display.class;)+,
(%display-back-matter.class;)* )" >
<!-- CHEMICAL STRUCTURE WRAPPER -->
<!-- A chemical expression, reaction, equation,
etc. that is set apart within the text.
These may be numbered. They may be modeled
as ASCII characters or as one or more
graphics.
Implementer's Note: CML will go here, if
added.
Display Note: A chemical structure is assumed
to be anchored at its position within the
text. -->
<!ELEMENT chem-struct-wrapper
%chem-struct-wrapper-model; >
<!-- id A unique identifier for the chemical structure
content-type
Identification of the subject, type of
content, or reason that this word or phrase
is considered semantically special, as a
means of preserving the semantic intent of
the original tagging.
position Must this display object (figure, boxed text,
etc.) be anchored in its exact location
within the text or may it float, for example
to the top of the next page, next column, or
within a separate window? Values are:
anchor Object must remain in place
float Object is not anchored and
may be moved to a new column,
a new window, etc.
margin In print, item should be placed
in the margin or gutter.
Online the item should
remain closely associated
with the text. -->
<!ATTLIST chem-struct-wrapper
%chem-struct-wrapper-atts; >
<!-- CHEMICAL STRUCTURE ELEMENTS -->
<!-- Those elements that may mix with the data
characters inside a Chemical Structure
<chem-struct> -->
<!ENTITY % chem-struct-elements
"| %access.class; | %address-link.class; |
%break.class; |
%emphasis.class; | %label.class; |
%list.class; | %math.class; |
%simple-display.class; |
%simple-link.class; | %subsup.class; " >
<!-- CHEMICAL STRUCTURE MODEL -->
<!-- A chemical expression, reaction, equation,
etc. that is set apart within the text
Design Note: The list class was added to
cover the Elsevier DTD <compound-info>
element.
Authoring Note: This model allows for a
<graphic> element inside of the <chem-struct>
that holds the structure or for using the
linking attributes to point directly to the
URI of such as graphic.
Authoring Note: Accessibility elements should
not be used with this element if they can be
used as part of the <chem-struct-wrapper>
wrapper element. They are allowed as part of
this element only for those
<chem-struct-wrapper> elements that
contain more than one <chem-struct>. -->
<!ENTITY % chem-struct-model
"(#PCDATA %chem-struct-elements;)* " >
<!-- CHEMICAL STRUCTURE (DISPLAY) -->
<!-- A chemical expression, reaction, equation,
etc. that is set apart within the text.
Authoring Note: While this element
contains an optional Label element, the
Label element should be included only in
those circumstances where a formatting
override is needed; Label should NOT
be used in the ordinary course of
tagging. -->
<!ELEMENT chem-struct %chem-struct-model; >
<!-- alternate-form-of
Where multiple formats of an item (e.g.,
graphic file, media object, chemical
structure) are available, this attribute
indicates that a format is a secondary
one and provides a link to the primary
format, so that only one format of an
item is displayed.
content-type
Identification of the subject, type of
content, or reason that this word or phrase
is considered semantically special, as a
means of preserving the semantic intent of
the original tagging.
xlink:href Provides an address or identifier of the
object to which the link points, for
example a URI or a filename -->
<!ATTLIST chem-struct
%chem-struct-atts; >
<!-- ============================================================= -->
<!-- FIGURE ELEMENTS -->
<!-- ============================================================= -->
<!-- FIGURE GROUP MODEL -->
<!-- Content model for a Figure Group element -->
<!ENTITY % fig-group-model
"((%label.class;)?, (%caption.class;)?,
(%access.class; | %address-link.class;)*,
(%fig-display.class; |
%just-base-display.class;)* )" >
<!-- FIGURE GROUP -->
<!-- Used for a group of figures that must be
displayed together -->
<!ELEMENT fig-group %fig-group-model; >
<!-- id Unique identifier so the element may be
referenced
Authoring Note: The value of the "id"
attribute for a Figure Group should begin
with "FG" (FG1, FG2, FGIII).
content-type
Identification of the subject, type of
content, or reason that this word or phrase
is considered semantically special, as a
means of preserving the semantic intent of
the original tagging.
position Must this display object (figure, boxed text,
etc.) be anchored in its exact location
within the text or may it float, for example
to the top of the next page, next column, or
within a separate window? Values are:
anchor Object must remain in place
float Object is not anchored and
may be moved to a new column,
a new window, etc.
margin In print, item should be placed
in the margin or gutter.
Online the item should
remain closely associated
with the text. -->
<!ATTLIST fig-group
%fig-group-atts; >
<!-- FIGURE -->
<!-- A block of graphic or textual material that
is identified as a "Figure", usually with
a caption and a label such as "Figure" or
"Figure 3.".
The content of a Figure need not be
graphical in nature, for example a list or a
table may be the content of a Figure.
Authoring and Conversion Note: Unlabeled
graphical objects found in the content
should be tagged as <graphic>s. A common
test for Figure versus Graphic is to ask
yourself whether, if you were to create a
"List of Figures" for this article, the
object would or would not appear in such a
list. -->
<!ELEMENT fig %fig-model; >
<!-- id Unique identifier so the element may be
referenced
Authoring Note: The value of the "id"
attribute for a Figure should begin with "F"
(F1, F2, FIII).
Authoring Note: The value of the "id"
attribute for a scheme should begin with "S"
(S1, S2). The value of the "id" attribute
for a plate should begin with "P" (P1, P2).
position Must this display object (figure, boxed text,
etc.) be anchored in its exact location
within the text or may it float, for example
to the top of the next page, next column, or
within a separate window? Values are:
anchor Object must remain in place
float Object is not anchored and
may be moved to a new column,
a new window, etc.
margin In print, item should be placed
in the margin or gutter.
Online the item should
remain closely associated
with the text.
xml:lang The language in which the value of the
element is expressed. Recommended best
practice is to use values as defined in
RFC 1766, typically 2-letter language
codes such as "FR" (French), "EN" (English),
and "DE" (German). These values are NOT
case sensitive, so "EN" = "en". The values
may include hyphenated differentiations such
as "EN-AU" (Australian English) and "EN-US"
(United States English).
fig-type Some DTDs make a distinction between
different types of graphical objects, some
with attributes, some with elements. This
attribute is for use in preserving that
intellectual content. For example, this
attribute could record the fact that the
contents of this figure are: a cartoon,
chart, diagram, drawing, exhibit,
illustration, map, plate, scheme, workflow,
etc. -->
<!ATTLIST fig
%fig-atts; >
<!-- CAPTION BODY PARTS -->
<!-- Elements that may be included in the body of
the <caption> element -->
<!ENTITY % caption-body-parts
"(%just-para.class;)*" >
<!-- CAPTION MODEL -->
<!-- Content model for the <caption> element -->
<!ENTITY % caption-model
"(title?, %caption-body-parts;)" >
<!-- CAPTION OF A FIGURE, TABLE, ETC. -->
<!-- Wrapper element for the textual description
associated with a figure, table, etc. In
some source document captions, the first
sentence is set off from the rest as a title.
In some source document, figures may posses
both a title and a caption, in which case
the title will be moved inside the caption
during conversion. -->
<!ELEMENT caption %caption-model; >
<!-- xml:lang The language in which the value of the
element is expressed. Recommended best
practice is to use values as defined in
RFC 1766, typically 2-letter language
codes such as "FR" (French), "EN" (English),
and "DE" (German). These values are NOT
case sensitive, so "EN" = "en". The values
may include hyphenated differentiations such
as "EN-AU" (Australian English) and "EN-US"
(United States English). -->
<!ATTLIST caption
%caption-atts; >
<!--ELEM title Defined in %common.ent; -->
<!--ELEM p Defined in %common.ent; -->
<!-- ============================================================= -->
<!-- THE GRAPHIC AND MEDIA OBJECT ELEMENTS -->
<!-- ============================================================= -->
<!-- GRAPHIC MODEL -->
<!-- Content model for the <graphic> element -->
<!ENTITY % graphic-model
"(%access.class; | %address-link.class; |
%id.class; | %label.class; |
%caption.class; |
%display-back-matter.class;)* " >
<!-- GRAPHIC -->
<!-- An external file that holds a picture,
illustration, etc., usually as some form of
binary object. The "content" of the <graphic>
element is not the object, but merely
information about the object. The "href"
attribute points to the file containing
the object.
Authoring and Conversion Note: Internal
elements such as <caption> should always be
used at the highest possible level, in
other words, if a <graphic> is inside a
Figure, the <caption>, <long-desc>, etc.
should be part of the Figure, not inside the
<graphic>. Elements such as <caption> are
used inside <graphic> when a standalone
graphic requires them or when multiple
graphics within a container element such as
a Figure need them individually. Similarly,
the "position" attribute should not be used
on a <graphic> that is inside a larger
display, container such as a Figure. -->
<!ELEMENT graphic %graphic-model; >
<!-- alternate-form-of
Where multiple formats of an item (e.g.,
graphic file, media object, chemical
structure) are available, this attribute
indicates that a format is a secondary
one and provides a link to the primary
format, so that only one format of an
item is displayed.
alt-version
Whether an alternative version of a graphic
has also been provided, for example, a
thumbnail or a different resolution
mimetype The mimetype of the object. For graphics
the mimetype will usually be "image".
mime-subtype
The mime-subtype of the object. Taken from
IANA (Internet Assigned Numbers Authority)
Suggested values include:
cgm
g3fax
gif
ief
jpeg
naplps
png
prs.btif
prs.pti
t38
tiff
tiff-fx
id Unique identifier so the element may be
referenced. The "id" attribute such as
should be used at the highest level
possible, therefore a graphic only needs an
"id" when it is standalone.
position Must this display object (figure, boxed text,
etc.) be anchored in its exact location
within the text or may it float, for example
to the top of the next page, next column, or
within a separate window? Values are:
anchor Object must remain in place
float Object is not anchored and
may be moved to a new column,
a new window, etc.
margin In print, item should be placed
in the margin or gutter.
Online the item should
remain closely associated
with the text.
xlink:href Provides an address or identifier of the
object to which the link points, for
example a URI or a filename
NOTE: A graphic will always have an
"xlink:href" attribute that points to the
URI where the graphic may be found.
Authoring and Conversion Note: Best practice
for graphic file names is to limit the names
and path names to the characters: letters,
numbers, underscore, hyphen, and period. All
such names are assumed to be case sensitive.
DOS-style file extensions may be used. -->
<!ATTLIST graphic
%graphic-atts; >
<!-- MEDIA OBJECT -->
<!-- An external file that holds a media object,
such as an animation or a movie. The
"content" of the <media> element is not the
object, but merely information about the
object. The "href" attribute points to the
file containing the object.
Authoring and Conversion Note: Internal
elements such as <caption> should always be
used at the highest possible level, in
other words, if a <media> element is inside a
Figure, the <caption>, <long-desc>, etc.
should be part of the Figure, not part of
the <media>. Elements such as <caption>
are used when a standalone media object
requires them or when multiple media objects
within a container element such as a Figure
need them individually. Similarly, the
"position" attribute should not be used on
a <media> element that is inside a larger
display container such as a Figure. -->
<!ELEMENT media %graphic-model; >
<!-- alternate-form-of
Where multiple formats of an item (e.g.,
graphic file, media object, chemical
structure) are available, this attribute
indicates that a format is a secondary
one and provides a link to the primary
format, so that only one format of an
item is displayed.
mimetype The mimetype of the object.
mime-subtype
The mime-subtype of the object
id Unique identifier so the element may be
referenced. The "id" attribute such as
should be used at the highest level
possible, therefore a graphic only needs an
"id" when it is standalone.
position Must this display object (figure, boxed text,
etc.) be anchored in its exact location
within the text or may it float, for example
to the top of the next page, next column, or
within a separate window? Values are:
anchor Object must remain in place
float Object is not anchored and
may be moved to a new column,
a new window, etc.
margin In print, item should be placed
in the margin or gutter.
Online the item should
remain closely associated
with the text.
xlink:href Provides an address or identifier of the
object to which the link points, for
example a URI or a filename
NOTE: A graphic will always have an
"xlink:href" attribute that points to the
URI where the graphic may be found.
Authoring and Conversion Note: Best practice
for graphic file names is to limit the names
and path names to the characters: letters,
numbers, underscore, hyphen, and period. All
such names are assumed to be case sensitive.
DOS-style file extensions may be used. -->
<!ATTLIST media
%media-atts; >
<!-- ============================================================= -->
<!-- INLINE GRAPHIC -->
<!-- ============================================================= -->
<!-- INLINE GRAPHIC MODEL -->
<!-- Content model for the <inline-graphic>
element -->
<!ENTITY % inline-graphic-model
"(alt-text?)" >
<!-- INLINE GRAPHIC -->
<!-- A small graphic such as an icon or a small
picture symbol that is displayed or set
in the same line as the text.
Authoring and Conversion Note: Although the
DTD cannot enforce it, this element should
NOT be used for custom-built or private
characters, such as those in the Unicode
private use areas. For such characters,
use the <private-char> element, see
%chars.ent; -->
<!ELEMENT inline-graphic
%inline-graphic-model; >
<!-- alternate-form-of
Where multiple formats of an item (e.g.,
graphic file, media object, chemical
structure) are available, this attribute
indicates that a format is a secondary
one and provides a link to the primary
format, so that only one format of an
item is displayed.
id Unique identifier so an inline-formula
can be referenced
content-type
"content-type" attribute provides a way to
preserve or add semantic distinctions.
baseline-shift
Allows the inline-graphic to be positioned
above or below the current text baseline.
This is a CDATA attribute and may take any
values, but potential values include the
CSS values set:
baseline There is no shift. Graphic
displays on the text baseline.
sub Graphic is offset below the
baseline by the same amount as
an ordinary subscript. (This
is also an XSL-FO value.)
sup Graphic is offset above the
baseline by the same amount as
an ordinary superscript. (This
is also an XSL-FO value.)
top Graphic aligns with tallest
character on the same line.
text-top Graphic is offset above the
baseline to the top of the
tallest ascender.
middle Graphic is aligned to the middle
of the text line (baseline plus
half x-height).
bottom Graphic aligns with lowest element
on the same line.
text-bottom
Graphic is offset below the
baseline, to the bottom of the
lowest descender.
percentage
Graphic is offset above (positive
percent) or below (negative
percent) this percentage of the
line height. 0% is baseline.
(This is also an XSL-FO value.)
length Graphic is offset above (positive
value) or below (negative
value) by this amount. This value
must carry its units as well as
a numeric value.
(This is also an XSL-FO value.)
mimetype The mimetype of the graphic
mime-subtype
The mime-subtype of the graphic
xlink:href Provides an address or identifier of the
object to which the link points, for
example a URI or a filename
NOTE: An inline graphic will always have an
"xlink:href" attribute that points to the
URI where the graphic may be found. -->
<!ATTLIST inline-graphic
%inline-graphic-atts; >
<!-- ============================================================= -->
<!-- PRESERVE THE WHITESPACE TEXT -->
<!-- ============================================================= -->
<!-- PREFORMATTED TEXT ELEMENTS -->
<!-- Elements that may be used, along with data
characters, inside the content model for the
<preformat> element, in which white space,
such as tabs, line feeds, and spaces will
be preserved -->
<!ENTITY % preformat-elements
"| %access.class; | %address-link.class; |
%display-back-matter.class; |
%emphasis.class; | %id.class; |
%phrase.class; | %subsup.class;" >
<!-- PREFORMAT MODEL -->
<!-- Content model for the <preformat> element -->
<!ENTITY % preformat-model
"(#PCDATA %preformat-elements;)*" >
<!-- PREFORMATTED TEXT -->
<!-- Used for preformatted text such as
computer code in which whitespace, such as
tabs, line feeds, and spaces, should be
preserved. Typically displayed or printed
in a monofont to preserve character
alignment.
Related Elements: Poetry may be tagged with
<preformat> if spacing is critical, but
usually poetry should be tagged with the
<verse-group> element, which may not preserve
the exact indentation but is likely to be
displayed in a proportional font. -->
<!ELEMENT preformat %preformat-model; >
<!-- alternate-form-of
Where multiple formats of an item (e.g.,
graphic file, media object, chemical
structure) are available, this attribute
indicates that a format is a secondary
one and provides a link to the primary
format, so that only one format of an
item is displayed.
id Unique identifier so the element may be
referenced.
position Must this display object (figure, boxed text,
etc.) be anchored in its exact location
within the text or may it float, for example
to the top of the next page, next column, or
within a separate window? Values are:
anchor Object must remain in place
float Object is not anchored and
may be moved to a new column,
a new window, etc.
margin In print, item should be placed
in the margin or gutter.
Online the item should
remain closely associated
with the text.
preformat-type
What kind of content, for example:
code Computer code
poetry Poems
ascii ASCII art
This attribute is added to preserve the
intellectual content of DTDs that provide
this information. Many documents will not
be able to provide this data.
xml:space Request that, when printing or displaying
this element, all white space such as tabs
and spaces and line breaks be preserved.
xml:lang The language in which the value of the
element is expressed. Recommended best
practice is to use values as defined in
RFC 1766, typically 2-letter language
codes such as "FR" (French), "EN" (English),
and "DE" (German). These values are NOT
case sensitive, so "EN" = "en". The values
may include hyphenated differentiations such
as "EN-AU" (Australian English) and "EN-US"
(United States English). -->
<!ATTLIST preformat
%preformat-atts; >
<!-- ============================================================= -->
<!-- SUPPLEMENTARY MATERIAL -->
<!-- ============================================================= -->
<!-- SUPPLEMENTARY MATERIAL MODEL -->
<!-- Content model for the
<supplementary-material> element -->
<!ENTITY % supplementary-material-model
"%fig-model;" >
<!-- SUPPLEMENTARY MATERIAL -->
<!-- Additional data files that contain
information directly supportive of the item,
for example, an audio clip, movie, database,
spreadsheet, applet, or other external file.
Remarks: This is similar to the audio-visual
element in some DTDs and the unprinted-item
element (meaning that it is used only for
electronic files) in other DTDs.
Remarks: This element is used in two senses:
inside the article front matter as an alert
to the existence of supplementary material
and as part of the textual flow, where it is
similar to a Figure, in that it can be
positioned as a floating or anchored object
and may take a caption.
In addition, the supplementary material
may identify its file type with the
"mimetype" attribute.
Authoring Note: Supplementary material may
contain a preview image (e.g., the first
frame of a movie, tagged as a <graphic> or
<media>), with the caption/preview placed
in a manner similar to a Figure and a
cross-reference made to the material from
the text.
Related Elements: See related element
<inline-supplementary-material> for
a simpler form that can be used to mark up
text references to supplementary material
where the reference appears in the regular
flow of the text and does not have a preview
image or separate caption. -->
<!ELEMENT supplementary-material
%supplementary-material-model; >
<!-- alternate-form-of
Where multiple formats of an item (e.g.,
graphic file, media object, chemical
structure) are available, this attribute
indicates that a format is a secondary
one and provides a link to the primary
format, so that only one format of an
item is displayed.
content-type
Identification of the subject, type of
content, or reason that this word or phrase
is considered semantically special, as a
means of preserving the semantic intent of
the original tagging.
id Unique identifier so the element may be
referenced
mimetype The mimetype of the object.
mime-subtype
The mime-subtype of the object
position Must this display object (figure, boxed text,
etc.) be anchored in its exact location
within the text or may it float, for example
to the top of the next page, next column, or
within a separate window? Values are:
anchor Object must remain in place
float Object is not anchored and
may be moved to a new column,
a new window, etc.
margin In print, item should be placed
in the margin or gutter.
Online the item should
remain closely associated
with the text.
xlink:href Provides an address or identifier of the
object to which the link points, for
example a URI or a filename
xml:lang The language in which the value of the
element is expressed. Recommended best
practice is to use values as defined in
RFC 1766, typically 2-letter language
codes such as "FR" (French), "EN" (English),
and "DE" (German). These values are NOT
case sensitive, so "EN" = "en". The values
may include hyphenated differentiations such
as "EN-AU" (Australian English) and "EN-US"
(United States English). -->
<!ATTLIST supplementary-material
%supplementary-material-atts; >
<!-- ============================================================= -->
<!-- TABLE ELEMENTS -->
<!-- ============================================================= -->
<!-- TABLE WRAPPER GROUP MODEL -->
<!-- Content model for the <table-wrap-group>
element -->
<!ENTITY % table-wrap-group-model
"(label?, caption?,
(%access.class; | %address-link.class;)*,
(%just-table.class;)+ )" >
<!-- TABLE WRAPPER GROUP -->
<!-- Used as a wrapper tag to contain a group of
tables that must be displayed together -->
<!ELEMENT table-wrap-group
%table-wrap-group-model; >
<!-- id Unique identifier so the element may be
referenced
Authoring Note: id of table group should
begin with "TG" (TG1, TGIV, TG43)
position Must this display object (figure, boxed text,
etc.) be anchored in its exact location
within the text or may it float, for example
to the top of the next page, next column, or
within a separate window? Values are:
anchor Object must remain in place
float Object is not anchored and
may be moved to a new column,
a new window, etc.
margin In print, item should be placed
in the margin or gutter.
Online the item should
remain closely associated
with the text.
content-type
"content-type" attribute provides a way to
preserve or add semantic distinctions. -->
<!ATTLIST table-wrap-group
%table-wrap-group-atts; >
<!-- TABLE WRAPPER CONTENT MODEL -->
<!-- Content model for the container element that
surrounds the standard table models for row
and columns. -->
<!ENTITY % table-wrap-model
"((%id.class;)*, (%label.class;)?,
(%caption.class;)?,
(%access.class; | %address-link.class;)*,
(%inside-table-wrapper;)*,
(%table-foot.class; |
%display-back-matter.class;)* )" >
<!-- TABLE WRAPPER -->
<!-- Used to hold a complete table, that is, not
only the rows and columns that make up a
table, but also the table captions, list
of table footnotes, alternative descriptions
for accessibility, etc. Within the Table
Wrapper element, the row and column tags that
describe the table cells are defined by one
of the popular "standard" table models, for
example the XHTML table model, OASIS Exchange
(CALS) table model, of the Elsevier Science
Full Length Article table body <tblbody>
model, et al.)
Remarks: This model has been designed to allow
for a "table" that is just a graphic or a list
rather than the explicit rows and columns of a
table element such as XHTML <table>.
Authoring and Conversion Note: Many journal
DTDs use an element Called Table Footnote,
with a tag such as <tblfn> for the footnotes
inside a table. This DTD uses <fn> inside
tables as well as everywhere. They are
differentiated by context. Footnotes inside
a Table Wrapper are assumed to be footnotes
to the table and part of the table,
printed at the bottom of it, etc. -->
<!ELEMENT table-wrap %table-wrap-model; >
<!-- id Unique identifier so the element may be
referenced
Authoring Note: The value of the "id"
attribute of table should begin with
"T" (T1, TIV, T43)
content-type
Identification of the subject, type of
content, or reason that this word or phrase
is considered semantically special, as a
means of preserving the semantic intent of
the original tagging.
xml:lang The language in which the value of the
element is expressed. Recommended best
practice is to use values as defined in
RFC 1766, typically 2-letter language
codes such as "FR" (French), "EN" (English),
and "DE" (German). These values are NOT
case sensitive, so "EN" = "en". The values
may include hyphenated differentiations such
as "EN-AU" (Australian English) and "EN-US"
(United States English). -->
<!ATTLIST table-wrap
%table-wrap-atts; >
<!-- TABLE WRAP FOOTER MODEL -->
<!-- Content model for the <table-wrap-foot>
element -->
<!ENTITY % table-wrap-foot-model
"(title?,
(%just-para.class; | %fn-link.class; |
%display-back-matter.class;)+ )" >
<!-- TABLE WRAP FOOTER -->
<!-- Wrapper element to hold a group of footnotes
or other notes or general paragraphs at the
end of a table. Not the same as the
Table Foot <tfoot>, which contains rows
and columns like the rest of the table. -->
<!ELEMENT table-wrap-foot
%table-wrap-foot-model; >
<!-- ================== End Display Class Module ================= -->