Oxford University Press Text Capture Instructions

 

OxMed: External references

Capture External references between different Oxford Medical books in extRef elements.

External references are commonly found in the Clinical Specialties (OHCS) and Clinical Medicine (OHCM) handbooks, which cross-reference each other frequently. In these books they are identified by the acronym OHCM or OHCS followed by a page number.

Example

media/448815_image12.png

An extRef external link element needs 2 attributes, docRef for the reference of the handbook, and ref for the ID value of the target.

  1. Look in the Symbols and Abbreviations' table in the miscMatter at the start of the book and determine the edition of the target handbook.OHCM and OHCS have been published in several editions.

    Example XML for a Symbols and abbreviations table showing an entry Oxford Handbook of Clinical Specialties 8.


    <miscMatter class="other" id="med-9780199232178-miscMatter-22007" doi="10.1093/med/9780199232178.002.22007">
    <titleGroup><title>
    <p>Symbols and abbreviations</p></title>
    </titleGroup>
    <textMatter><div1 id="med-9780199228881-chapter-1-div1-4" role="prelim">
    <p>
    <list class="abbreviations">
    <list1 id="med-9780199228881-chapter-1-list1-2">
    <item1 id="med-9780199232178-chapter-1-item1-22262">
    <title>
    <p>
    <sc>ohcs</sc>
    </p>
    </title>
    <p>
    <i>Oxford Handbook of Clinical Specialties 8</i>
    </p>
    </item1>
    </list1>
    </list>
    </p></div1>
    </textMatter>
    </miscMatter>
  2. Obtain a copy of the XML document for the correct edition of the target handbook.
  3. Set the docRef attribute value to the id attribute value of the root element in the target.
    For example, docRef="med-9780199228881" for OHCS edition 8.
  4. In a XML copy of the target document find the relevant <?Page?> processing instruction.

    <titleGroup>
    <title><p><?Page pageId="137"?>
    <milestone unit="page" num="137" id="med-9780199228881-chapter-1-milestone-137"/>Murmurs and heart sounds in
    children</p>
    </title>
    </titleGroup>
  5. Work backwards from the Page processing instruction looking for the appropriate chapter or div[1-7,N].
    For OHCS edition 8, on page 137 the first div[1-7,N] ancestor of the <?Page?> processing instruction, is about Murmurs and sounds in children, div1 id="med-9780199228881-div1-115".
  6. Copy the id attribute value of the chapter or div[1-7,N] to the ref attribute of the extRef link.
    In this example, attribute ref="med-9780199228881-div1-115".

Extract of the XML from OHCS edn. 8


<div1 id="med-9780199228881-chapter-1-div1-115">
<titleGroup><title>
<p><?Page pageId="137"?>
<milestone unit="page" num="137" id="med-9780199228881-chapter-1-milestone-137"/>Murmurs and heart sounds in
children</p></title>
</titleGroup>
<p>††† We hear benign flow murmurs (eg parasternal low-frequency
‘twangs' in early systole) in ~80% of children, at some time (eg with
fever, anxiety, exercise).</p>
<div2 id="med-9780199228881-chapter-1-div2-3377"><div3 id="med-9780199228881-chapter-1-div3-2245">
<titleGroup>
<title>
<p>
<i>Still's murmur</i>
</p>
</title>
</titleGroup>
<p>is an example, and may be abolished ...</p></div3>
</div2>
</div1>

The XML for and external reference to this piece of text is therefore:


<p>...(see also Heart murmurs in children, <xrefGrp>
<extRef docRef="med-9780199228881" ref="med-9780199228881-div1-115" sysId="med-9780199228881-Collier.xml">
<i>
<sc>ohcs</sc>
</i> p137</extRef>
</xrefGrp>)...</p>
Release ID:
20261202
ID:
Oxford_Medicine_Online_TCI_topic_7_3
Author:
dunnm
Last changed:
Wed, 04 Jun 2025
Modified by:
buckmasm
Revision#:
4400