<!– ============================================================= –> <!– MODULE: Book Interchange DTD with OASIS and XHTML Tables –> <!– Customize Classes Module –> <!– VERSION: BITS 2.0 –> <!– DATE: June 2015 –> <!– –> <!– ============================================================= –>
<!– ============================================================= –> <!– PUBLIC DOCUMENT TYPE DEFINITION –> <!– TYPICAL INVOCATION –> <!– “-//NLM//DTD BITS Book Interchange DTD with OASIS and XHTML Tables Customize Classes Module v2.0 20151225//EN” Delivered as file “BITS-book-oasis-custom-classes2.ent” –> <!– ============================================================= –>
<!– ============================================================= –> <!– SYSTEM: Book Interchange Tag Suite –> <!– –> <!– PURPOSE: To declare the Parameter Entities (PEs) used to –> <!– over-ride the JATS DTD Suite default named –> <!– element classes. –> <!– –> <!– Note: Since PEs must be declared before they –> <!– are used, this module must be called before the –> <!– NISO JATS default classes module as well as before–> <!– the content modules that declare elements. –> <!– –> <!– TAG SET SPONSOR –> <!– National Center for Biotechnology –> <!– Information (NCBI) –> <!– National Library of Medicine (NLM) –> <!– –> <!– CREATED FOR: –> <!– This DTD was created as a superset customization –> <!– of the ANSI/NISO JATS Z39.96-2012 Version 1.0 –> <!– Journal Article Tag Set. –> <!– –> <!– Digital archives and publishers may use the –> <!– DTD as is for markup of books or book-like –> <!– material for archiving and transferring –> <!– such material between archives or they may create –> <!– a custom XML DTD from the BITS Suite for –> <!– these purposes. –> <!– –> <!– 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 new DTD-specific customization –> <!– modules 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 BITS 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 Book Interchange Tag Suite (BITS). –> <!– –> <!– 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 Book Interchange Tag Suite –> <!– (BITS).“ –> <!– –> <!– ORIGINAL CREATION DATE: –> <!– April 2012 –> <!– –> <!– CREATED BY: Mulberry Technologies, Inc. for the National –> <!– National Center for Biotechnology Information –> <!– (NCBI), a center of the US National Library of –> <!– Medicine (NLM). –> <!– –> <!– The BITS Book Interchange DTD is built from the –> <!– Journal Archiving and Interchange DTD of the –> <!– ANSI/NISO Journal Article Tag Suite (JATS) –> <!– Version 1.0 (Z39.96-2015). –> <!– ANSI/NISO JATS DTD modules. –> <!– –> <!– Suggestions for refinements and enhancements to –> <!– this DTD should be sent in email to: –> <!– bits@ncbi.nlm.nih.gov –> <!– ============================================================= –>
<!– ============================================================= –> <!– DTD VERSION/CHANGE HISTORY –> <!– ============================================================= –> <!– Version Reason/Occasion (who) vx.x (yyyy-mm-dd)
============================================================= BITS Version 2.0 (DAL/BTU) v2.0 (2015-12-25) JATS Version 1.1 (DAL/BTU) v1.1 (2015-12-15) JATS is a continuing maintenance NISO Standard, which requires voting by the ANSI and NISO memberships to be changed. JATS 1.1 was approved in late 2015, and BITS modified to use the most recent version. No other changes to BITS were made. 10. BITS remained version "2.0" but became "v2.0 20151225" JATS became version "1.1" and "v1.1 20151215" ============================================================= BITS Version 2.0 (DAL/BTU) v2.0 (2015-03-15) JATS Version 1.1 (DAL/BTU) v1.1 (2015-03-01) BITS was modified, based on user feedback collected in 2014 and January/February 2015, according to the decisions made by the BITS Working Group. This DTD represents current BITS and an interim version of the non-normative JATS DTD Suite (version 1.1), as an indication to JATS users of the decisions that have been made by the JATS Standing Committee. NISO JATS is a continuing maintenance NISO Standard, which requires voting by the NISO membership to be changed. This Committee Draft 1.1 will be sent to the NISO voting membership, to become (if approved) NISO JATS 1.1. 9. QUESTIONS AND ANSWERS - A new class to hold just the <option> element - Added <question-wrap-group> and <explanation> to the block display elements - Enhanced question-answer.class to also hold <explanation> and <question-wrap-group> 8. BLOCK DISPLAY ELEMENTS - Three new elements added to the block display elements: - explanation - <name-address-wrap> (new element) - <question-wrap-group> (new element) 7. ATTRIB - Created a new class to add the following elements to <attrib>: - collab - element-citation - mixed-citation - name - string-name 6. SERIF HIGHLIGHTING - Added a new emphasis element <serif>, which means retain the serif nature of this content no matter what the surrounding text does. Typically used for variables in math, chemistry, and physics. 5. REFERENCES LIST - Made a new class holding just the <ref-list> element, so that it can be added to the large OR group inside <front-matter>, for example. 4. FOOTNOTE GROUP CLASS - Made a new class to hold just the <fn-group> element, so it can be used in the model of Table of Contents, for example. 3. BOOK APPENDIX AND BOOK APPENDIX GROUP - Created a new book-back-only class, modeled on back-only class to hold the new element Book Appendix (<book-app>), a book-part-level appendix structure, as well as the other things that may be in a <book-back>. - Revised book-back-only class to contain both the <book-app> (Book Appendix) element and the <book-app-group> (grouping element for book-level appendices). 2. BITS became version "2.0" and "v2.0 20150630" JATS became version "1.1" and "v1.1 20150301" ============================================================= BITS Version 1.1 (DAL/BTU) v1.1 (2014-09-30) JATS Version 1.1d2 (DAL/BTU) v1.1d2 (2014-09-30) NISO JATS is a continuing maintenance NISO Standard, which requires voting by the NISO membership to be changed. This Committee Draft 1.1d2 will be sent to the NISO voting membership, to become (if approved) NISO JATS 1.1. This catalog represents an interim version of the non-normative JATS DTD Suite, as an indication to JATS users the decisions that have been made by the JATS Standing Committee. 1. BITS became version "1.1" and "v1.1 20140930//EN" JATS became version "1.1d2" and "v1.1d2 20140930//EN" ============================================================= -->
<!– ============================================================= –> <!– INLINE CLASSES –> <!– ============================================================= –>
<!– PHRASE CLASS ELEMENTS –> <!– Small inline elements, that surround a word
or phrase in the text because the subject (content) should be identified as something special or different -->
<!ENTITY % phrase.class “abbrev | index-term | index-term-range-end |
milestone-end | milestone-start | named-content | styled-content" >
<!– ============================================================= –> <!– PRESENTATION/FORMAT CLASSES –> <!– ============================================================= –>
<!– EMPHASIS/RENDITION ELEMENTS –> <!– Elements concerning with marking the location
of typographical emphasis (highlighting) DTD Design Note: There are no emphasis elements for <fractur>, <openface> (black board), <script>, etc. because this DTD recommends the use of the STIX extensions to accomplish this, as soon as they are available. -->
<!ENTITY % emphasis.class
"bold | fixed-case | italic | monospace | overline | overline-start | overline-end | roman | sans-serif | sc | serif | strike | underline | underline-start | underline-end | ruby" >
<!– FACE MARKUP ELEMENTS –> <!– All of the emphasis/rendition elements
except <ruby>, for use (initially) inside <ruby> itself. -->
<!ENTITY % face-markup.class
"bold | fixed-case | italic | monospace | overline | overline-start | overline-end | roman | sans-serif | sc | serif | strike | underline | underline-start | underline-end" >
<!– X-GENERATED PUNCTUATION CLASS –> <!– Class containing a single element that will
hold generated punctuation or other generatable text, for example, the commas or semicolons between keywords. -->
<!ENTITY % x.class “x” >
<!– ============================================================= –> <!– CITATION CLASSES (references.ent) –> <!– ============================================================= –>
<!– CITATION CLASS ELEMENTS –> <!– Reference to an external document, as used
within, for example, the text of a paragraph (from Publishing; removed <nlm-citation>) -->
<!ENTITY % citation.class
"citation-alternatives | element-citation | mixed-citation" >
<!– CITATION MINUS ALTERNATIVES CLASS ELEMENTS –> <!– All the citation elements except the
<citation-alternatives> element. (from Publishing; removed <nlm-citation>) -->
<!ENTITY % citation-minus-alt.class
"element-citation | mixed-citation" >
<!– CITATION ADDITIONS CLASS ELEMENTS –> <!– Elements that are not part of the broader
-references.class, but that need to be part of the model for citations. -->
<!ENTITY % citation-additions.class
"string-date" >
<!– ============================================================= –> <!– BOOK METADATA CLASSES –> <!– ============================================================= –>
<!– ATTRIBUTION CLASS ELEMENTS –> <!– Identify the parts of an attribution
(element <attrib>). -->
<!ENTITY % attrib.class “collab | element-citation |
mixed-citation | name | string-name" >
<!– CONTRIBUTOR INFORMATION –> <!– Metadata about a contributor
(from Publishing) -->
<!ENTITY % contrib-info.class
"address | aff | aff-alternatives | author-comment | bio | email | etal | ext-link | fn | on-behalf-of | role | uri | xref" >
<!– EVENT CLASS ELEMENTS –> <!– Dates and other matters of history –> <!ENTITY % event.class “event” >
<!– ============================================================= –> <!– BLOCK DISPLAY CLASSES –> <!– ============================================================= –>
<!– ADDRESS-ONLY CLASS –> <!– Holds the <address> element, for use in
content models. -->
<!ENTITY % address-only.class
"address" >
<!– DISPLAY CLASS ELEMENTS –> <!– Graphical or other image-related elements.
The display elements may occur within the text of a table cell or paragraph although they are typically at the same hierarchical level as a paragraph. -->
<!ENTITY % block-display.class
"address | alternatives | answer | answer-set | array | boxed-text | chem-struct-wrap | code | explanation | fig | fig-group | graphic | media | name-address-wrap | preformat | question | question-wrap | question-wrap-group | supplementary-material | table-wrap | table-wrap-group" >
<!– DISPLAY CLASS ELEMENTS (NO ALTERNATIVES) –> <!– Graphical or other image-related elements.
The display elements may occur within the text of a table cell or paragraph although they are typically at the same hierarchical level as a paragraph. -->
<!ENTITY % block-display-noalt.class
"address | answer | answer-set | array | boxed-text | chem-struct-wrap | code | explanation | fig | fig-group | graphic | media | name-address-wrap | preformat | question | question-wrap | question-wrap-group | supplementary-material | table-wrap | table-wrap-group" >
<!– DISPLAY CLASS ELEMENTS MINUS EXPLANATION –> <!– The same as block-display.class without
the explanation element, for use in <answer> and <option> elements. -->
<!ENTITY % block-display-minus-explanation.class
"address | alternatives | answer | answer-set | array | boxed-text | chem-struct-wrap | code | fig | fig-group | graphic | media | name-address-wrap | preformat | question | question-wrap | question-wrap-group | supplementary-material | table-wrap | table-wrap-group" >
<!– QUESTION AND ANSWER CLASS –> <!– Questions and answers (also in block display
class, for use in other places). -->
<!ENTITY % question-answer.class
"answer | answer-set | explanation | question | question-wrap | question-wrap-group" >
<!– QUESTION WRAP CLASS –> <!– Class to hold just the element
<question-wrap> for use in models. -->
<!ENTITY % question-wrap.class
"question-wrap" >
<!– OPTION-ONLY CLASS –> <!– Holds the <option> element, for use in
content models. -->
<!ENTITY % option.class “option” >
<!– ROLE-ONLY CLASS –> <!– Holds the <role> element, for use in
content models. -->
<!ENTITY % role-only.class
"role" >
<!– ============================================================= –> <!– BOOK STRUCTURES CLASSES –> <!– ============================================================= –>
<!– BOOK PART CLASS –> <!– Holds the <book-part> element, for use in
content models. -->
<!ENTITY % book-part.class
"book-part | xi:include" >
<!– BOOK-PART BACK MATTER ONLY CLASS –> <!– Ancillary elements, used in back matter of
a book -->
<!ENTITY % book-back-only.class
"book-app | book-app-group | floats-group | index | index-group | ref-list" >
<!– BACK MATTER ONLY CLASS –> <!– Ancillary elements, used in back matter of
a book or book part. -->
<!ENTITY % back-only.class
"app | app-group | floats-group | index | index-group | ref-list" >
<!– FOOTNOTE GROUP CLASS –> <!– A class to hold just the <fn-group> element
for use in content models. -->
<!ENTITY % fn-group.class
"fn-group" >
<!– FRONT ONLY CLASS –> <!– Ancillary elements, used in front matter of
a book or book part. -->
<!ENTITY % front-only.class
"front-matter-part | foreword | preface" >
<!– FRONT AND BACK CLASS –> <!– Ancillary elements, typically used in the
front or back matter of an article, but also as part of book metadata. -->
<!ENTITY % front-back.class
"notes" >
<!– BOTH FRONT AND BACK MATTER CLASS –> <!– Ancillary elements, typically used in the
back matter of a <book> or a <book-part>. -->
<!ENTITY % both-front-back.class
"ack | bio | dedication | fn-group | glossary | toc | toc-group" >
<!– REFERENCE LIST CLASS –> <!– Class to hold just the <ref-list> element,
so it can be used in t <front-matter>, for example. -->
<!ENTITY % ref-list.class
"ref-list" >
<!– SECTION BACK MATTER CLASS –> <!– Ancillary elements, typically used in the
back matter of a section, etc. Added <sig-block> to Publishing. -->
<!ENTITY % sec-back.class
"fn-group | glossary | ref-list | sig-block" >
<!– SIGNATURE BLOCK CLASS –> <!– Class to hold just the signature block,
which is used in the backs of sections and book-parts, but not in the back of books. -->
<!ENTITY % sig-block.class
"sig-block" >
<!– XINCLUDE CLASS –> <!– Class to hold just the <xi:include> element
so that it can be used in book front matter as well as other places. -->
<!ENTITY % xinclude.class
"xi:include" >
<!– ============================================================= –> <!– INDEX CLASSES –> <!– ============================================================= –>
<!– INDEX CLASS –> <!– Used for grouping multiple Indexes. –> <!ENTITY % index.class “index” >
<!– INDEX DIVISION CLASS –> <!– Division, typically for the purposes of
display, in a structural index, for example a division holding the heading "A" and all of the initial alphabetically arranged index entries. -->
<!ENTITY % index-div.class
"index-div" >
<!– INDEX ENTRY CLASS –> <!– Entry in a structural Index. –> <!ENTITY % index-entry.class
"index-entry" >
<!– NAVIGATION POINTER CLASS –> <!– Navigation pointer for use in a structural
Index or table of contents. -->
<!ENTITY % nav-pointer.class
"nav-pointer" >
<!– SEE AND SEE-ALSO ENTRY CLASS –> <!– See (use) and see-also (related) entries
in a structural Index. -->
<!ENTITY % see-also-see-entry.class
"see-entry | see-also-entry" >
<!– ============================================================= –> <!– TABLE OF CONTENTS CLASSES –> <!– ============================================================= –>
<!– TABLE OF CONTENTS CLASS –> <!– Used for grouping multiple Tables of Contents.
-->
<!ENTITY % toc.class “toc” >
<!– TABLE OF CONTENTS DIVISION CLASS –> <!– Division, typically for the purposes of
display, in a structural ToC, for example a division holding the first Part of a 3-part book, and the titles of all the chapters in that Part. -->
<!ENTITY % toc-div.class
"toc-div" >
<!– TABLE OF CONTENTS ENTRY CLASS –> <!– Entry in a structural Table of Contents. –> <!ENTITY % toc-entry.class
"toc-entry" >
<!– ABTRACT CLASS FOR TABLE OF CONTENTS –> <!– Used to add the <abstract> and
<trans-abstract> elements to a Table of Contents entry <toc-entry>. -->
<!ENTITY % toc-abstract.class
"abstract | trans-abstract" >
<!– ============================================================= –> <!– BOTH TABLE OF CONTENTS AND INDEX CLASSES –> <!– ============================================================= –>
<!– STRUCTURAL LINKING CLASS –> <!– Elements that might be used to make a link
in a structural Table of Contents, Index, or similar non-generated structure. -->
<!ENTITY % struct-link.class
"ext-link | nav-pointer | nav-pointer-group" >
<!– ============================================================= –> <!– TABLE CLASSES –> <!– ============================================================= –>
<!– ALTERNATIVES DISPLAY CLASS ELEMENTS –> <!– Display elements that can be alternatives to
each other inside an alternatives element. XHTML Table Model table OASIS CALS Table oasis:table -->
<!ENTITY % alternatives-display.class
"array | chem-struct | code | graphic | inline-graphic | inline-supplementary-material | media | preformat | private-char | supplementary-material | table | %otable.qname; | textual-form" >
<!– TABLE CLASS ELEMENTS –> <!– Elements that will be used to contain the
rows and columns inside the Table Wrapper element <table-wrap>. The following elements can be set up for inclusion: XHTML Table Model table OASIS CALS Table oasis:table -->
<!ENTITY % table.class “table | %otable.qname;” >
<!– TABLE BODY CLASS –> <!– To include just a table body <tbody>
element. Both XHTML and OASIS table types. -->
<!ENTITY % tbody.class “tbody | %otbody.qname;” >
<!– ================== End BITS Book Classes Customization ====== –>