Oxford University Press Text Capture Instructions

 

Metadata

Capture metadata on the root level (in bookMeta, docMeta, regMeta, caseMeta, or, if chapter or e are the root, in metaInfo). Capture metadata also at the lower levels chapter, e, and part within books in a metaInfo. Capture metadata on miscMatter, bibliography, and appendix using metaInfo if they are in the frontMatter or endMatter.

To contain metadata, each OUP DTD uses an element such as bookMeta or docMeta as the child of the root element. Within this, create a metaItem element that includes the name of the root element in the about attribute.

For lower level elements chapter,e, and part create a metaItem within metaInfo that includes the name of the element in the about attribute.

For miscMatter, appendix, and bibliography elements in the frontMatter or endMatter, create a metaItem within metaInfo that includes the name of the element in the about attribute.

For lower level document elements create a metaItem within docMeta that includes the name of the element in the about attribute. 

/book/bookMeta/metaItem[@about = "book"]
//chapter/metaInfo/metaItem[@about = "chapter"]
//e/metaInfo/metaItem[@about = "e"]
/regGroup/regMeta/metaItem[@about = "regGroup"]
/case/caseMeta/metaItem[@about = "case"]
/document/docMeta/metaItem[@about = "document"]
//part/metaInfo/metaItem[@about="part"]
//(frontMatter|endMatter)/miscMatter/metaInfo/metaItem[@about="miscMatter"]
//(frontMatter|endMatter)/appendix/metaInfo/metaItem[@about="appendix"]
//(frontMatter|endMatter)/bibliography/metaInfo/metaItem[@about="bibliography"]

DTD name

Root level metadata element

OxChapML

bookMeta (or metaInfo if root or level is chapter or part)

OxEncyclML

bookMeta (or metaInfo if root or level is e or part)

OxStructML

docMeta (with regMeta for legal metadata)

OxLawML

regMeta

OxLawRepML

caseMeta

For all other chunks that are not the root, metaInfo is the appropriate element.

Metadata at book level


      <bookMeta>
        <metaItem about="book"><metaItem about="DTD">
 <metaDescribes predicate="DTDname">OxChapML</metaDescribes></metaItem><metaItem about="TCIgroup">
 <metaItem about="TCI">
   <metaDescribes predicate="TCIname">OUP TCI</metaDescribes>
   <metaDescribes predicate="version">20130403.0</metaDescribes>
 </metaItem></metaItem><metaDescribes predicate="product">OSO</metaDescribes><metaDescribes predicate="publishing-group">AcTrade-UK</metaDescribes><metaDescribes predicate="product-grouping">history</metaDescribes><metaDescribes predicate="captured-by">Newgen</metaDescribes>
        </metaItem>
      </bookMeta>

Metadata at chapter level


      <metaInfo id="he-9780199595310-chapter-1-metaInfo-1">
        <creatorGroup><creator class="author" invertedForm="Berry, Elspeth">
                     <forenames>Elspeth</forenames>
                     <surname>Berry</surname>
                 </creator><creator class="author" invertedForm="Homewood, Matthew J.">
                     <forenames>Matthew
              J.</forenames>
                     <surname>Homewood</surname>
                 </creator><creator class="author" invertedForm="Bogusz, Barbara">
                     <forenames>Barbara</forenames>
                     <surname>Bogusz</surname>
                 </creator>
        </creatorGroup>
        <abstract><p>Titles in the Complete series combine extracts from a wide range of primary materials
            with clear explanatory text to provide readers with a complete introductory resource.
            This chapter discusses the history of the European Union. It covers the historical
            rationale for the EU; the aims of the EU; the four stages of economic integration;
            economic and political difficulties; expansion of membership; institutional
            developments; legal developments; closer European integration; the Single European Act
            (1986); regional development; social policy; the Treaty on European Union (1992);
            economic and monetary union; the Treaty of Amsterdam (1997); the Charter of Fundamental
            Rights; the Treaty of Nice (2001); and the Lisbon Treaty (2007).</p>
        </abstract>
        <keySubjectWords><keyword>economic integration</keyword><keyword>membership</keyword><keyword>institutional development</keyword><keyword>European integration</keyword><keyword>Single European Act</keyword><keyword>European Union</keyword><keyword>monetary union</keyword><keyword>Treaty of Amsterdam</keyword><keyword>Lisbon Treaty</keyword><keyword>Fundamental Rights</keyword>
        </keySubjectWords>
        <metaItem about="chapter"><metaItem about="DTD">
 <metaDescribes predicate="DTDname">OxChapML</metaDescribes></metaItem><metaItem about="TCIgroup">
 <metaItem about="TCI">
   <metaDescribes predicate="TCIname">OUP TCI</metaDescribes>
   <metaDescribes predicate="version">20130605.0</metaDescribes>
 </metaItem></metaItem><metaDescribes predicate="product">OHEO</metaDescribes><metaDescribes predicate="publishing-group">HE-UK</metaDescribes><metaDescribes predicate="captured-by">Newgen</metaDescribes>
        </metaItem>
      </metaInfo>

Metadata at miscMatter level


      <miscMatter id="oso-9780199679669-miscMatter-4">
        <metaInfo id="oso-9780199679669-miscMatter-4-metaInfo-1"><creatorGroup>
 <creator class="author" invertedForm="Chiang, Allan">
                         <forenames>Allan</forenames>
                         <surname>Chiang</surname>
                     </creator></creatorGroup><metaItem about="miscMatter">
 <metaItem about="DTD">
   <metaDescribes predicate="DTDname">OxChapML</metaDescribes>
 </metaItem>
 <metaItem about="TCIgroup">
   <metaItem about="TCI">
     <metaDescribes predicate="TCIname">OUP TCI</metaDescribes>
     <metaDescribes predicate="version">20140702.0</metaDescribes>
   </metaItem>
 </metaItem>
 <metaDescribes predicate="product">OSO</metaDescribes>
 <metaDescribes predicate="publishing-group">Law-UK</metaDescribes>
 <metaDescribes predicate="captured-by">SPI</metaDescribes></metaItem>
        </metaInfo>
        <textMatter><!--...--></textMatter>
      </miscMatter>
Example showing miscMatter requiring metaInfo with 2 authors at beginning 

      <miscMatter id="oso-9780199895458-miscMatter-4" class="preface">
        <metaInfo id="oso-9780199895458-miscMatter-4-metaInfo-1"><creatorGroup>
 <creator class="author" invertedForm="Moorey, Peter">
                         <forenames>Peter</forenames>
                         <surname>Moorey</surname>
                     </creator>
 <creator class="author" invertedForm="Williamson, James">
                         <forenames>James</forenames>
                         <surname>Williamson</surname>
                     </creator></creatorGroup><metaItem about="miscMatter">
 <metaItem about="DTD">
   <metaDescribes predicate="DTDname">OxChapML</metaDescribes>
 </metaItem>
 <metaItem about="TCIgroup">
   <metaItem about="TCI">
     <metaDescribes predicate="TCIname">OUP TCI</metaDescribes>
     <metaDescribes predicate="version">20160302.0</metaDescribes>
   </metaItem>
 </metaItem>
 <metaDescribes predicate="product">OSO</metaDescribes>
 <metaDescribes predicate="publishing-group">Law-UK</metaDescribes>
 <metaDescribes predicate="captured-by">SPI</metaDescribes></metaItem>
        </metaInfo>
        <titleGroup><title>
 <p>Preface</p></title><creatorInfo>
 <p>By <nameGrp role="author" foreNames="Peter" mainName="Moorey">Peter Moorey</nameGrp>
              and <nameGrp role="author" foreNames="James" mainName="Williamson">James
                Williamson</nameGrp>
 </p></creatorInfo>
        </titleGroup>
        <textMatter><p>The scholar invited to be the...</p>
        </textMatter>
      </miscMatter>
Example showing miscMatter requiring metaInfo with author at end 

      <miscMatter id="oso-9780199895458-miscMatter-5" class="foreword">
        <metaInfo id="oso-9780199895458-miscMatter-5-metaInfo-1"><creatorGroup>
 <creator class="author" invertedForm="Delacroix, Fiona">
                         <forenames>Fiona</forenames>
                         <surname>Delacroix</surname>
                     </creator></creatorGroup><metaItem about="miscMatter">
 <metaItem about="DTD">
   <metaDescribes predicate="DTDname">OxChapML</metaDescribes>
 </metaItem>
 <metaItem about="TCIgroup">
   <metaItem about="TCI">
     <metaDescribes predicate="TCIname">OUP TCI</metaDescribes>
     <metaDescribes predicate="version">20160302.0</metaDescribes>
   </metaItem>
 </metaItem>
 <metaDescribes predicate="product">OSO</metaDescribes>
 <metaDescribes predicate="publishing-group">Law-UK</metaDescribes>
 <metaDescribes predicate="captured-by">SPI</metaDescribes></metaItem>
        </metaInfo>
        <titleGroup><title>
 <p>Foreword</p></title>
        </titleGroup>
        <textMatter><p>This text is written for an LL.M. preparatory course that...</p><p>
                     <nameGrp role="author" foreNames="Fiona" mainName="Delacroix">Fiona
            Delacroix</nameGrp>
                 </p>
        </textMatter>
      </miscMatter>

Metadata at appendix level


      <appendix display="online" doi="10.1093/med/9780199673643.005.0030" id="med-9780199673643-appendix-0030">
        <metaInfo id="med-9780199673643-metaInfo-1"><creatorGroup>
 <creator class="author" invertedForm="Morton, Alison">
                         <forenames>Alison</forenames>
   <surname>Morton</surname>
                     </creator>
 <creator class="author" invertedForm="Narayan, Harini">
                         <forenames>Harini</forenames>
   <surname>Narayan</surname>
                     </creator></creatorGroup><metaItem about="appendix">
 <metaItem about="DTD">
   <metaDescribes predicate="DTDname">OxChapML</metaDescribes>
 </metaItem>
 <metaItem about="TCIgroup">
   <metaItem about="TCI">
     <metaDescribes predicate="TCIname">OUP TCI</metaDescribes>
     <metaDescribes predicate="version">20140702.0</metaDescribes>
   </metaItem>
 </metaItem>
 <metaDescribes predicate="product">OXMEDO</metaDescribes>
 <metaDescribes predicate="publishing-group">Medicine US</metaDescribes>
 <metaDescribes predicate="captured-by">Newgen</metaDescribes></metaItem>
        </metaInfo>
        <titleGroup id="med-9780199673643-titleGroup-572"><title>
 <p>
                         <enumerator>1.</enumerator> Role of the midwife in the care of high-risk
              pregnancies</p></title><creatorInfo>
 <p>
                         <nameGrp foreNames="Alison" mainName="Morton" role="author">Alison Morton</nameGrp>
              and <nameGrp foreNames="Harini" mainName="Narayan" role="author">Harini
                Narayan</nameGrp>
                     </p></creatorInfo>
        </titleGroup>
        <!--...-->
      </appendix>

Sub-topics

  1. Metadata for DTD name

    Capture metaItem elements for the DTD name within the metadata at root element level as well as chapter, e, appendix, miscMatter with a specified class, and document level.

  2. Metadata for TCI version

    Capture metaItem elements for the TCI information within the metadata at root element level as well as chapter, e, appendix, miscMatter with a specified class, and document level.

  3. Product and Publishing Group information

    Capture a metaDescribes element with attribute predicate="publishing-group" within the metadata at root element level, chapter, e, appendix, miscMatter element with a specified class, and document level. If the XML is being created for a particular product, capture a sibling metaDescribes element with attribute predicate="product".

  4. Content shared between products

    When a piece of content is to appear on more than one product, the same XML file is used for both products.

  5. Metadata for Series

    If the title passport contains the Series then add this value to a metaDescribes element with predicate="series".

  6. Metadata for publication dates

    If provided in the handover capture metadata for various publication dates in a metaDescribes element with a predicate denoting the type of publication - either 'onlinePubDate', 'printPubDate', or 'firstPubDate'.

  7. Metadata for supplier name

    Capture a metaDescribes element with attribute predicate="captured-by" within the metadata at root element level, chapter, e, appendix, miscMatter element with a specified class, and document level.

  8. Metadata for DOI registration

    When requested, capture a metaDescribes element with attribute predicate="doi-registration".

  9. ONIX metadata

    ONIX metadata is required for whole-book OxChapML and OxEncyclML documents. It is not required for First Proofs XML, or for documents written to other DTDs, and is not required in Chunk First XML (e.g. documents that are part of the chapter/article first workflow).

  10. Legal metadata

    Capture additional metadata for law publications as provided

  11. ISO 3166 and extensions - Country codes used by OUP

    List of codes used to represent countries and associated jurisdictions based on ISO 3166

  12. ISO 639 - Codes for the Representation of Names of Languages

    External reference to the codes and languages in ISO 639-2.

  13. Version information (root level)

    To indicate the stage at which the XML was captured use the versionInfo element on the root level (e.g. book or documents, or a lower level chunk like chapter, document or e if not combined).

  14. Version information (Case Law)

    Version information includes the original date, the date of substantial changes, the version number, and version date.

  15. Biographic profile metadata

    Capture biographic profile metadata in a metaItem element with about="profile"

  16. Metadata for sort order

    If source data contains a sort order element capture it in a metaDescribes element with attribute predicate="sortTitle" within the metadata at root element level, chapter, e, and document level.

  17. Metadata for Authors, Editors and other contributors

    Capture each author, editor, or contributor in a creator element.

  18. Abstract in metadata

    When an abstract is supplied, capture it in the abstract element.

  19. Keywords

    When keywords are supplied, capture each keyword or phrase using keyword within the keySubjectWords element.

  20. Open Access licence

    Capture the URL of the Creative Commons licence in a metaDescribes about="open-access-licence" element.

  21. Metadata for works

    Capture metadata about a work (i.e. a piece of art, music, or literature) in a metaItem element with about="work".

  22. Metadata for presence of media

    If source data contains a figure, then capture this metadata at the root level.

  23. Metadata for Affiliate Logos

    Affiliate logo images (along with alternate text and a URL for the affiliate) may be provided at handover. When provided, capture these in metaItem about='affiliateLogos' within /book/bookMeta/metaItem[@about='book'].

  24. Metadata for Colour figures for online

    Instructions for the production of image files, formats and DPI, colour, etc have been moved out of the TCIs as of June 2019.

  25. Metadata for Topic or Chapter based content (for Medical content only)

    If, on the title passport, the Topic based or Chapter based checkboxes are selected then add a metaDescribes element with predicate="chunk" and the value Topic or Chapter.

  26. Metadata for excluding from search

    If indicated on the handover form that an article should be excluded from search, then capture this metadata at the root level in a metaDescribes element with predicate="excludeFromQuickSearch".

  27. Metadata for web PDF

    If a book is accompanied by a web PDF, add a reference to the PDF file name in the book's metadata.

Release ID:
20260304
ID:
OUP_Structured_Text_TCI_topic_2_2
Author:
dunnm
Last changed:
Wed, 04 Jun 2025
Modified by:
buckmasm
Revision#:
4400