Publishing Changes in Classes

The following changes were made to journalpubcustom-classes3.ent:

• Appearance Class / Font — Deleted the element fontfrom the Tag Sets, which removed it from %appearance.class;. Then removed %appearance.class; altogether, as <hr> in the Publishing Tag Set was only allowed inside table cells, and those horizontal rules should now be accomplished using the XHTML attributes.
• References Class — The Publishing 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 journalpubcustom-classes3.ent, removed the %references.class; as duplicative of the Suite default.
  In default-classes3.ent, in %references.class;, added the elements:
  • <chapter-title>,
  • <part-title>,
  • <date-in-citation>,
  • <size>,
  • <string-name>, and
  • <volume-series>.
  
  Also deleted the following elements from %references.class;:
  • <access-date> (replaced by <date-in-citation>),
  • <page-count> (replaced by <size>), and
  • <time-stamp> (replaced by <date-in-citation>).
  
  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

• Roman Emphasis — Added <roman> to the %emphasis.class;.

Publishing Journal Metadata

In journalpubcustom-models3.ent, in the model for <journal-meta>:

• ISBN — Added <isbn>, optional and repeatable following <issn>.
• Journal Title Group — Removed the following sequence:

  journal-title*, journal-subtitle*,
  trans-title*, trans-subtitle*, 
  abbrev-journal-title*,

  
  and replaced it with the new element <journal-title-group> (optional, repeatable) inside <journal-meta> (using %journal-meta-model;):

  (journal-id*, journal-title-group*, issn*, publisher?, 
  notes?, custom-meta-group?)

  
  Inside the model for <journal-title-group>, replaced the sequence:

  trans-title, trans-subtitle*

  
  with the new element <trans-title-group>, optional repeatable.
• Translated Title Group — In common3.ent, created a new element <trans-title-group> with the model (trans-title, trans-subtitle*), and gave <trans-title-group> all the attributes that <trans-title> had (@content-type, @id (of type ID), and @xml:lang). Made the @xml:lang required on the <trans-title-group>, leaving it as optional on <trans-title>, since this element is now used only be used inside a <trans-title-group> or inside citations. Because of the usage inside citations, the attributes were left on <trans-title>, although, for an such a title inside a <trans-title-group>, the attributes should be on the outer container element.
• Thus the <journal-meta> override is:

  (journal-id+, journal-title-group*, 
  issn+, isbn*, publisher?, notes?)

Publishing Article Metadata

The new <article-meta> element, after all changes to %article-meta-model;, is:

(article-id*, article-categories?, 
title-group, (contrib-group | aff)*, 
author-notes?, pub-date+, 
volume?, volume-id*, volume-series?, 
issue?, issue-id*, issue-title*,
issue-sponsor*, issue-part?, isbn*, 
supplement?, 
((fpage, lpage?, page-range?) | 
elocation-id)?, 
(%address-link.class; | product | 
supplementary-material)*, history?, 
permissions?, self-uri*, related-article*, 
abstract*, trans-abstract*, kwd-group*, 
funding-group*, conference*, counts?,
custom-meta-group?)

In the module journalpubcustom-models3.ent, the following changes were made to the article metadata override %article-meta-model; to produce the model above:

• Loose Copyright — Inside %article-meta-model;, moved <copyright-statement>, <copyright-year>, and <license> to inside <permissions> instead of being both inside it and outside it. The modeling:

   history?, copyright-statement?, 
  copyright-year?, license?, permissions?, self-uri*, 

  
  was changed to:

   history?, permissions?, self-uri*,

• Custom Metadata— Changed <custom-meta-group> from optional repeatable to just optional.
• Funding Information — Replaced the following sponsor sequence:

  contract-num*, contract-sponsor*, grant-num*, grant-sponsor*,

  
  with “funding-group”. Also, deleted the override for contract-elements since the contract element has been removed form the Tag Sets.
• Issue Part — Added <issue-sponsor> and <issue-part> to <article-meta> directly after the other issue information.
• ISBN — Added an optional, repeatable <isbn> as part of the potential issue information inside <article-meta>.
• Volume Series — Added <volume-series> to <article-meta> to hold the series number, in those odd cases where, for example, a Journal has started reissuing with number one and has added a series number to its volume numbers.

Other changes to article metadata elements:

• Author Notes — In journalpubcustom-models3.ent, removed the parameter entity %author-notes-model;, since Publishing now uses the default model, which is defined in articlemeta3.ent.

Publishing Expand model of <front-stub>

In journalpublishing3.dtd, enhanced the <front-stub> model to include all elements already present in <article-meta>. Therefore, in the Publishing Tag Set, the model for <front-stub> now differs from <article-meta> only by allowing the grouping element <title-group> (which includes the article title and translated titles) to be optional, and the <pub-date> to be optional and repeatable. This model should accommodate any publisher’s subset of metadata for a <sub-article> while retaining the convenience of not requiring the repetition of the full infrastructure that must be present inside <front> for the main article.

Publishing Chemical Structures Changes

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 default-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 default-classes3.ent).
• As an inline object, <chem-struct> must be inside <chem-struct-wrap> (using %chem-struct-wrap-model;) (in 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; and %floats-display.class;, which it already was in display3.ent.
• As a block object, <chem-struct-wrap> should be inside figures (using %fig-model;), which it already was in the Publishing override.
• 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]

• <td> and <th> (using %inside-cell;)
• <term> (using %term-elements;)

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]

• <table-wrap> (using %inside-table-wrap;)

Following these changes, <chem-struct> is now allowed within the following elements:

• <addr-line>
• <alt-title>
• <alternatives>
• <article-title>
• <attrib>
• <award-id>
• <bold>
• <chem-struct-wrap>
• <mixed-citation>
• <collab>
• <comment>
• <conf-theme>
• <def-head>
• <disp-formula>
• <element-citation>
• <funding-source>
• <inline-formula>
• <italic>
• <label>
• <license-p>
• <meta-name>
• <meta-value>
• <monospace>
• <named-content>
• <overline>
• <p>
• <product>
• <roman>
• <sans-serif>
• <sc>
• <strike>
• <styled-content>
• <sub>
• <subject>
• <subtitle>
• <sup>
• <supplement>
• <td>
• <term>
• <term-head>
• <th>
• <title>
• <trans-subtitle>
• <trans-title>
• <underline>
• <verse-line>

Following these changes, <chem-struct-wrap> is now allowed within the following elements:

• <app>
• <app-group>
• <bio>
• <body>
• <boxed-text>
• <disp-quote>
• <fig>
• <floats-group>
• <glossary>
• <license-p>
• <named-content>
• <notes>
• <p>
• <ref-list>
• <sec>
• <styled-content>
• <supplementary-material>
• <table-wrap>

Publishing Back Matter

Publishing New Labels

Added an optional <label> to just before <title> in all the following elements:

• <app-group> (in backmatter3.ent)
• <back> (in journalpublishing3.dtd)
• <disp-quote> (in para3.ent)
• <fn-group> (in backmatter3.ent)
• <kwd-group> (in articlemeta3.ent)
• <list> (in journalpubcustom-models3.ent)
• <ref-list> (in references3.ent)
• <trans-abstract> (in journalpubcustom-models3.ent)
• <verse-group> (in para3.ent)

Publishing Attribute Changes

• Article — In journalpubcustom-models3.ent, changed the attribute @article-type in %article-atts; from a fixed set of values to CDATA. Therefore, in journalpublishing3.dtd, deleted the parameter entity article-types.
• Article Types — In journalpublishing3.dtd, removed the parameter entity that named the article types and made the value of the @article-type on the element <article> into CDATA.

  <!ENTITY % article-atts
  "article-type 
  CDATA #IMPLIED
  

• Citation Types — Removed the override for %citation-atts; as it is now the same as the default, which is described below.
  The previous values for the citation-type used on <mixed-citation> and <nlm-citation> were confusing, mixing together values such as “book” and “thesis” that described the type of publication and “gov” that described the publisher. There was no way to say that something was a government-published book. Therefore, in journalpubcustom-models3.ent, the attribute citation-type was deleted from %citation-atts;, and the following attributes were added for all three types of citations (<mixed-citation>, <element-citation>, and <nlm-citation>):
  • @publication-type — The type of object (journal, book, patent) containing the cited material. While not constrained, typical values include: journal, book, patent, report, thesis, standard, website, book-part (a chapter or an article from a book where the entire book is not being cited), conf-proc (conference proceeding), working paper, list (list serve), blog, online ref (an online reference such as Wikipedia or an online dictionary), court-case, database, communc (a personal communication such as a conversation, letter, or personal email), or discussion (implies group communication, usually face to face, as opposed to an online list discussion). This is the most important of the new attributes and best practice is now to use it whenever possible, as downstream processing many require this information.
  • @publisher-type — The type of organization that publishes the cited material. While not constrained, typical values include: government (gov), standards body (std-body), personal imprint (personal), society, non-profit, ngo, etc. Unless it is important that the cited material is of a particular type, this attribute need not be used. For example, while it may be true that a cited journal was published by a commercial publisher (value “commercial”), that is rarely recorded. This attribute can preserve information about the publisher where a citation has recorded this material.
  • @publication-format — What format of the reference is being cited, for example, print, online, video, audio, etc. This attribute should be used when known for non-print sources.
  • @content-type — Provides a way to preserve or add semantic distinctions.
• Graphic Attributes — In journalpubcustom-models3.ent,
  • Removed the attribute alternative-form-of from:
    • <graphic> (using %graphic-atts;)
    • <inline-graphic> (using %inline-graphic-atts;).
  • Also removed the attribute alt-version from <graphic> (using %graphic-atts;).
  • Also added @specific-use to <graphic> (using %graphic-atts;).
• Orientation — In journalpubcustom-models3.ent, added a new attribute @orientation, that takes the values “portrait” and “landscape”.
  The attribute was added to %display-atts; (therefore adding it to <boxed-text>, <chem-struct-wrap>, <fig>, <fig-group>, <graphic>, <media>, <preformat>, <supplementary-material>, <table-wrap>, and <table-wrap-group>).
  @orientation was also added to <array> through default (display3.ent).
• In journalpubcustom-models3.ent, added @specific-use to:
  • <graphic> (using %graphic-atts;)
  • <sec> (using %sec-atts;)