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
An extRef external link element needs 2 attributes, docRef for the reference of the handbook, and ref for the ID value of the target.
-
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 entryOxford 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>
- Obtain a copy of the XML document for the correct edition of the target handbook.
-
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.
-
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>
-
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 aboutMurmurs and sounds in children
, div1 id="med-9780199228881-div1-115". -
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>