The two Tag Sets, book3.dtd and bookcollection3.dtd, were brought up
to version 3.0, with the DTD version attribute (@dtd-version) set to
“3.0 ” and the version and date changed in every module set to “v3.0 20080202 ”. The former Historical
Tag Set (historical.dtd) will no longer be maintained.
- Related Object
- Renamed the module bookrelated-object.ent to
related-object3.ent as it became part of the full Archiving and Interchange Suite instead of book-specific.
- The module references was moved to modules3.ent from
bookcustom-modules3.ent, as it is now named in the full Suite’s
modules3.ent.
- Renamed the module’s formal public identifier from:
"-//NLM//DTD NCBI Book Tag Set Book Related Object Element v2.3 20070202//EN"
to
"-//NLM//DTD Archiving and Interchange DTD Suite Related Object Element v3.0 20080202//EN"
- Module name and file name were updated in both catalogs.
- Alternatives Clashes — There was sometimes a need to allow alternatives, but since DTDs cannot handle interleaving, there was also a grammar requirement
to name only one <alternatives> element even when
groups of display objects were combined. So the following elements were created for use
in combinations. In default-classes3.ent, created new PEs that held the
entire contents of the like-named Parameter Entity, minus only
<alternatives>:
- just-base-display-noalt.class (used in Book
bookcustom-mixes3.ent)
- Block Display Class — In
bookcustom-classes3, added <alternatives> and
<address> to the %block-display.class;.
- Citation Class — In
bookcustom-classes3.ent, added <element-citation> to the
%citation.class;.
- Emphasis Class — Implementor’s Note: The
%emphasis.class; (containing all the face markup) in Book
(bookcustom-classes3.ent) has, in previous versions, included
<named-content>. This was done originally to ensure that
<named-content> (and now <styled-content>) were available for use everywhere. Since the base Suite has now added the use of these two elements nearly
everywhere, the two elements were removed from the Book emphasis class override. The
two elements (using %phrase-content.class;) were then added to any overrides in Book and
Collection that had lost <named-content>. The net change to the
content models has been to add <styled-content> to all elements that previously contained <named-content>.
Phrase Class — As part of the same cleanup, deleted %phrase.class; from
bookcustom-classes3.ent as it was duplicative of the Suite default.
-
References Class — The Book Tag Set no longer overrides
%references.class;, which is used in the models of
<mixed-citation>, <element-citation>,
<product>, <related-article>, and
<related-object>.
In bookcustom-classes3.ent, removed %references.class; as
duplicative of the Suite default.
In default-classes3.ent, in %references.class;, added the
elements:
Also deleted the following elements from %references.class;:
The current default references class (used by all Tag Sets) is now:
annotation | article-title | chapter-title |
collab | comment | conf-date | conf-loc |
conf-name | conf-sponsor | date |
date-in-citation | day | edition | email |
elocation-id | etal | ext-link | fpage |
gov | institution | isbn | issn |
issue | issue-id | issue-part | issue-title |
lpage | month | name | object-id |
page-range | part-title |
patent | person-group | pub-id |
publisher-loc | publisher-name | role |
season | series | size | source | std |
string-name | supplement |
trans-source | trans-title | uri |
volume | volume-id | volume-series | year
- Simple Link Class — In
bookcustom-classes3.ent, removed %simple-link.class; as it
was duplicative of the Suite default.
- Book Title Group — In %bookmeta.ent;,
inside <book-title-group> (using
%book-title-group-model;), replaced the optional, repeatable
<trans-title> and <trans-subtitle> with an
optional, repeatable <trans-title-group>.
- Book Part Title Group — In
bookcustom-models3.ent, inside <title-group> (using
%title-group-model;), replaced the optional, repeatable
<trans-title> and <trans-subtitle> with an
optional, repeatable <trans-title-group>. In books, the
<title-group> element is included in
<book-part-meta>.
- Funding Information — Added the new funding
information (<funding-group>, optional and repeatable) to book
metadata (<book-meta>) following the keyword group (using
%book-meta-model; in bookcustom-models3.ent).
- Loose Copyright —
- In bookcustom-models3.ent, removed
<copyright-statement> and <copyright-year>
from directly inside <book-meta> (using
%book-meta-model;), to inside <permissions>, which
is inside <book-meta> (thus moving the copyright material one
level in). The <book-meta> model:
..., history?, copyright-statement?, copyright-year?, permissions?,...
was changed to:
..., history?, permissions?, ...
(with the copyrights inside <permissions>).
- Similarly, in %bookpart.ent;, removed
<copyright-statement> and <copyright-year>
from directly inside <book-part-meta> ( using
%book-part-meta-model;) to inside <permissions>,
instead of the copyrights being both inside and outside of
<permissions>. The <book-part-meta> model:
..., history?, copyright-statement?, copyright-year?, permissions?,...
was changed to:
..., history?, permissions?, ...
- Title Components — In
bookcustom-models3.ent, removed %title-elements; since it was
the same as the default.
Added an optional <label> to just before the
<title> of all the following elements:
The Book Tag Sets no longer have an override for %references.class;. This
Tag Set uses the default references elements.
- New Elements in Citations — In
default-classes3.ent, added the following new elements to
%references.class;:
- Date Elements Deleted from Citations — In
default-classes3.ent, deleted the following elements from
%references.class;: [Backward incompatible]
-
Duplicate Sizes — Since <size> was already present inside
<product> and <related-object> (through
%references.class;), in the Suite default
(articlemeta3.ent), removed size.class from
Book-redefined %product-elements;. Also, in related-object3.ent (which, in previous versions, was only part of the Book Tag Set and named bookrelated-object.ent), removed size.class from
%related-object-elements;.
- Parameter Entity Modification — Implementor’s Note:
In previous Tag Set versions, the Parameter Entity %citation-elements; was only
used to create mixed-content, so by convention it started with an “|”
bar. Now it may be used mixed with #PCDATA or used as an entire
element-only model, so the initial “|” bar has been removed. For the Book
Tag Set, removed from the “|” from the beginning of
%citation-elements; in common3.ent and added the
“|” to the <mixed-citation> model.
Although it was not the intent when the Tag Sets were written, most Tag Set users have
been treating <chem-struct> as an inline and
<chem-struct-wrap> as a block structure. This greatly simplifies all
processing with the two and seems quite flexible, so steps were taken to regularize this usage:
- As an inline object, <chem-struct> should be able to be used
anywhere that <inline-formula> is used, therefore
<chem-struct> has been added to %inline-math.class;
(in the Book overrides in bookcustom-classes3.ent).
- As an inline object, <chem-struct> should not be used as a block-level object, so it was removed from
%block-display.class; (in the Book override in
bookcustom-classes3.ent).
- As an inline object, <chem-struct> must be inside
<chem-struct-wrap> (using %chem-struct-wrap-model;)
(in the default display3.ent).
- As a block object, <chem-struct-wrap> needs to be everywhere
block display objects are used, so it needs to be part of the
%block-display.class;, which it
already was in the Book overrides in bookcustom-classes3.ent.
- As a block object, <chem-struct-wrap> should be inside figures
(using %fig-model;), which it already was in the default model in display3.ent.
- Changed the OR group allowed inside a <table-wrap> (using
%inside-table-wrap;) to allow <chem-struct-wrap>
instead of <chem-struct> in display3.ent.
The element <chem-struct-wrap> has been removed from within the following
elements, where it has been allowed in previous versions, allowing only the inline
<chem-struct> to be used. [Backward incompatible]
The element <chem-struct> has been removed from within the following
elements, where it has been allowed in previous versions, allowing only the block
<chem-struct-wrap> to be used. [Backward incompatible]
As a result of these changes, <chem-struct> is now allowed within the
following elements:
As a result of these changes, <chem-struct-wrap> is now allowed
within the following elements:
- Alternate Form Of — The previous (never
particularly successful) attempt to provide alternate version functionality consisted of
the alternative-form-of attribute. As part of adding
<alternatives> to hold multiple versions of the same logical
object, the alternative-form-of attribute was removed from
<graphic> (using %graphic-atts; in
bookcustom-models3.ent).
- Content Type — In
bookcustom-models3.ent, added the new @content-type attribute
to the attribute override list for <isbn>.
- Graphic Attributes — In
bookcustom-models3.ent,
- Orientation — In
bookcustom-models3.ent, added a new attribute @Orientation,
that takes the values “portrait” and “landscape” to
%display-atts;, thus adding the attribute to
<boxed-text>, <chem-struct-wrap>,
<fig>, <fig-group>,
<graphic>, <media>,
<preformat>, <supplementary-material>,
<table-wrap>, and <table-wrap-group>. Also added
to <array> through the default Tag Set in
display3.ent.
- Specific Use — In
bookcustom-models3.ent, added @specific-use to