Oxford University Press Text Capture Instructions

 

Cross-references (internal links)

Capture cross-references using xrefGrp and xref elements by capturing the id of the target in the cross-reference ref attribute.

XR Cross-reference
Xref_bibInline Inline bib cross-reference
Xref_bib Superscript bib cross-reference
Xref_fig Figure cross-reference
Xref_tab Table cross-reference
Xref_box Box cross-reference
Xref_vid Video cross-reference
Xref_chap Chapter cross-reference
Xref_part Part cross-reference
Xref_eqn Equation cross-reference
Xref_sect Section cross-reference
Xref_article Article cross-reference
Xref_para Paragraph cross-reference
Xref_note Note cross-reference
Xref_appx Appendix cross-reference
ABV abbreviation reference 
//xrefGrp/xref

Do not capture references within a document to sections of itself as bibliography items. Capture them as cross references using the xref element.

Do not capture references to 'chapter' or 'part' that are within bibliographic references as an internal cross-reference when they make up information within a bibItem.

List of valid target elements for xref links:

  • affiliation
  • article
  • appendix
  • appendixGroup
  • bibItem
  • bibList
  • bibliography
  • bibliographyGroup
  • boxedMatter
  • chapter
  • chapterFrontMatter
  • displayMaths
  • displayText
  • div1
  • div2
  • div3
  • div4
  • div5
  • div6
  • div7
  • divN
  • e
  • eSub
  • figureGroup
  • indexGroup
  • indexList
  • indexItem1
  • indexItem2
  • indexItem3
  • indexItem4
  • indexItemN
  • item1
  • item2
  • item3
  • item4
  • itemN
  • line
  • lineGroup
  • list
  • milestone
  • miscMatter
  • miscMatterGroup
  • multiBibItem
  • note
  • p
  • parallelText
  • part
  • section
  • tableGroup
  • mediaGroup

If the reference is pointing to a different volume then capture it using the extRef element.

Where a cross-reference refers to an individual’s surname and forename or initial, capture the name using nameGrp with all relevant attributes within the xref.

Any styling that occurs within cross-references (eg. small-capitals) should be tagged correctly.

When there are multiple cross-references in a group or sentence (such as multiple pages cited as a group for an index term separated by commas, or several cross references listed in a sentence separated by commas and the word and), capture multiple xref elements within xrefGrp.

Sub-topics

  1. Print-only and online-only cross-references

    In cases where the link text is specific to a format capture two xref elements and use the display attribute to differentiate the online and print versions.

  2. Cross-reference in A-Z reference works

    Capture A-Z cross-references with the correct identifying type attribute, target ref attribute, homograph, and asterisk when required.

  3. Cross-references to structured text, figures, and tables

    Where internal cross-references to specific (often numbered) sections, paragraphs, or other items are identified capture the number of the target in an xref element with the label (e.g. Chapter, Figure, etc.) outside the xref element but inside the xrefGrp element..

  4. Cross-references to heading and page number together

    Where a cross-reference to a heading and a page number are listed together, mark both together in an xrefGrp with the heading in an xref element and the page number in a pageNum element.

  5. Cross-references to page numbers

    Capture cross-references to pages using a pageNum element within the xrefGrp group and surround the page number text with the xref.

  6. Cross-References with paragraph and section ids

    For XML-first titles, where the Section IDs have been indicated on the title passport, use the paragraph and section id workflow for indexing and cross references within the text.

  7. Cross-references to notes

    Capture references to notes using xref and capture the note types in the role attribute of the xrefGrp.

  8. Cross-references to indexes

    Capture cross-references to Index headings by capturing the id of the indexGroup or indexList that contains the heading in the ref attribute of the the xref.

  9. Cross-references to bibliography

    Wherever references to bibliography items occur (e.g. within notes, tables, figures or the main text), link them to the relevant bibItem element using xref within xrefGrp.

  10. Cross-references to glossaries or definitions of words or phrases

    Words or phrases in the text may be highlighted or formatted in such a way as to indicate that they are defined in a glossary or note. Capture these as a cross reference (formatting need not be captured).

  11. Cross-references in OxLawML

    Restriction of cross reference targets in OxLawML content.

  12. Cross-references in law report headnotes

    The headnote of a case report can contain internal cross-references to specific paragraphs within the judgment for the case report.

  13. Abbreviations to help identify references and their targets

    Commonly used abbreviations in editorial text identify the location of cross-references.

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