Encode Pointer Links
Principles of Encoding Pointer Links
Using the
<ptr>
element will create programatically generated citations.We only use the
<ptr>
element to link to
<div>
elements when they have a child
<head>
element and to the text in modern and semi-diplomatic files.We use the
@type attribute with a value of "localCit" when linking to the text in modern and semi-diplomatic files in order to trigger
the processing to generate canonical reference numbers for citations.Practice: Encode the Pointer Element
You will generally follow the same steps when encoding all of your
<ptr>
elements. The exception to this is when you encode
<ptr>
elements linking to the text of your modern or semi-diplomatic files; these links
require an extra step. See Special Case: Linking to Canonical References.Follow these steps to encode
<ptr>
links:
Add a
<ptr>
element to your text. This will become hyperlinked text in the digital output of
your edition and a citation in the print output of your edition.Add a
@target attribute to your
<ptr>
element.Add the pathway to the entity that you are linking to as the value of the
@target attribute. See Hash Characterfor information on creating pathways.
Special Case: Linking to Canonical References
There is one additional step that you will take when encoding
<ptr>
elements that link to acts, scenes, speeches, or anchors in your modern and semi-diplomatic
transcriptions. We add the
@type attribute with a value of "localCit" on
<ptr>
elements in these scenarios. This triggers our processor to generate a canonical
reference as the hyperlinked text in the digital output and as the citation in the
print output of your edition.Follow these steps when linking to your modern or semi-diplomatic transcription using
the
<ptr>
element:
Add a
<ptr>
element to your text.Add a
@type attribute with a value of "localCit" to your
<ptr>
element.Add a
@target attribute with a pathway to the act, scene, speech, or anchor that you are linking
to as the value. See Hash Characterfor information on creating pathways.
Special Case: Linking to a Span of Text
There are a few scenarios in which you will link to a span of text by pointing to
two entities. Generally, you can simply point to one entity that contains the span
of text (i.e., the act, scene, or speech) or point to the anchor at the beginning
of the span of text that you are pointing to—this will create a canonical reference
citation using the numbers for the act, scene, and speech that your anchor is in and,
in the digital edition, will link to the start of the span of text that you are pointing
to. However, if the section of text that you wish to point to spans more than a single
speech, you will put two values separated by a space as the value of the
@target attribute on your
<ptr>
element. Note that you will only do this when pointing to your modern or semi-diplomatic
transcription.Follow these steps:
Add a
<ptr>
element to your text.Add a
@type attribute with a value of "localCit" to your
<ptr>
element.Add a
@target attribute to your
<ptr>
element.Add a pathway to the first entity that you wish to link to (i.e., the first speech
that you are linking to or the anchor at the beginning of your span of text) as the
value of your
@target attribute.Add a space after the first pathway, then add a second pathway to the second entity
that you are linking to (i.e., the final speech that you are linking to or the anchor
at the end of your span of text).
Examples
This pointer links to a
<div>
element with a child
<head>
element that is in the same file as the
<ptr>
element:
<ptr target="#emdDEVI3_genIntro_crit"/>
In this case, the pointer links from somewhere in the General Introductionto Laurie Ellinghausen’s edition of Device of the Pageant to the
<div>
element with an xml:id of "emdDEVI3_genIntro_crit".This pointer links to an entire file:
<ptr target="doc:emdSel_critIntro"/>
In this case, the pointer links to the Critical Introductionto Kirk Melnikoff’s edition of Selimus, which has the xml:id of
"emdSel_critIntro".This pointer links to a canonical reference:
<ptr type="localCit" target="doc:emdAHDM_M#emdAHDM_M_s5_sp1"/>
In this case, the pointer links to Speech 1 in Scene 5 of Eleanor Lowe’s edition
of An Humorous Day’s Mirth. This pointer would render as Sc5 Sp1and would bring people to the start of that speech if they clicked the link.
This pointer links to a canonical reference using an anchor:
<ptr type="localCit" target="doc:1HW_M#emd1HW_M_anc_33"/>
In this case, the pointer links to the
<anchor>
element with an xml:id of "emdTim_M_anc_9" in the modernized text of Joost Daalder’s edition of The Honest Whore, Part 1. This anchor is in Act 1, Scene 1, Speech 3, so it would render with the canonical
reference A1 Sc1 Sp3.It would bring people to the exact spot where the anchor is if they clicked the link.
This pointer links to a span of speeches:
<ptr type="localCit" target="doc:emdH5_FM#emdH5_FM_a4_s7_sp22 doc:emdH5_FM#emdH5_FM_a4_s7_23"/>
In this case, the pointer links to Speeches 22–23 in James Mardock’s modern edition
of Henry V, Folio.This pointer links to a span of text using anchors:
<ptr type="localCit" target="doc:emdOth_M#emdOth_M_anc_14 doc:emdOth_M#emdOth_M_anc_12"/>
In this case, the pointer links to a span of text marked at the beginning by an anchor
that is partway through Act 1, Scene 1, Speech 3 and marked at the end by an anchor
that is partway through Act 1, Scene 1, Speech 4 of Jessica Slight’s edition of Othello.Prosopography
Janelle Jenstad
Janelle Jenstad is a Professor of English at the University of Victoria, Director
of The Map of Early Modern London, and Director of Linked Early Modern Drama Online. With Jennifer Roberts-Smith and Mark Kaethler, she co-edited Shakespeare’s Language in Digital Media: Old Words, New Tools (Routledge). She has edited John Stow’s A Survey of London (1598 text) for MoEML and is currently editing The Merchant of Venice (with Stephen Wittek) and Heywood’s 2 If You Know Not Me You Know Nobody for DRE. Her articles have appeared in Digital Humanities Quarterly, Elizabethan Theatre, Early Modern Literary Studies, Shakespeare Bulletin, Renaissance and Reformation, and The Journal of Medieval and Early Modern Studies. She contributed chapters to Approaches to Teaching Othello (MLA); Teaching Early Modern Literature from the Archives (MLA); Institutional Culture in Early Modern England (Brill); Shakespeare, Language, and the Stage (Arden); Performing Maternity in Early Modern England (Ashgate); New Directions in the Geohumanities (Routledge); Early Modern Studies and the Digital Turn (Iter); Placing Names: Enriching and Integrating Gazetteers (Indiana); Making Things and Drawing Boundaries (Minnesota); Rethinking Shakespeare Source Study: Audiences, Authors, and Digital Technologies (Routledge); and Civic Performance: Pageantry and Entertainments in Early Modern London (Routledge). For more details, see janellejenstad.com.
Joey Takeda
Joey Takeda is LEMDO’s Consulting Programmer and Designer, a role he assumed in 2020
after three years as the Lead Developer on LEMDO.
Mahayla Galliford
Project manager, 2025-present; research assistant, 2021-present. Mahayla Galliford
(she/her) graduated with a BA (Hons with distinction) from the University of Victoria
in 2024. Mahayla’s undergraduate research explored early modern stage directions and
civic water pageantry. Mahayla continues her studies through UVic’s English MA program
and her SSHRC-funded thesis project focuses on editing and encoding girls’ manuscripts,
specifically Lady Rachel Fane’s dramatic entertainments, in collaboration with LEMDO.
Martin Holmes
Martin Holmes has worked as a developer in the UVic’s Humanities Computing and Media
Centre for over two decades, and has been involved with dozens of Digital Humanities
projects. He has served on the TEI Technical Council and as Managing Editor of the
Journal of the TEI. He took over from Joey Takeda as lead developer on LEMDO in 2020.
He is a collaborator on the SSHRC Partnership Grant led by Janelle Jenstad.
Navarra Houldin
Training and Documentation Lead 2025–present. LEMDO project manager 2022–2025. Textual
remediator 2021–present. Navarra Houldin (they/them) completed their BA with a major
in history and minor in Spanish at the University of Victoria in 2022. Their primary
research was on gender and sexuality in early modern Europe and Latin America. They
are continuing their education through an MA program in Gender and Social Justice
Studies at the University of Alberta where they will specialize in Digital Humanities.
Nicole Vatcher
Technical Documentation Writer, 2020–2022. Nicole Vatcher completed her BA (Hons.)
in English at the University of Victoria in 2021. Her primary research focus was women’s
writing in the modernist period.
Rylyn Christensen
Rylyn Christensen is an English major at the University of Victoria.
Tracey El Hajj
Junior Programmer 2019–2020. Research Associate 2020–2021. Tracey received her PhD
from the Department of English at the University of Victoria in the field of Science
and Technology Studies. Her research focuses on the algorhythmics of networked communications. She was a 2019–2020 President’s Fellow in Research-Enriched
Teaching at UVic, where she taught an advanced course on
Artificial Intelligence and Everyday Life.Tracey was also a member of the Map of Early Modern London team, between 2018 and 2021. Between 2020 and 2021, she was a fellow in residence at the Praxis Studio for Comparative Media Studies, where she investigated the relationships between artificial intelligence, creativity, health, and justice. As of July 2021, Tracey has moved into the alt-ac world for a term position, while also teaching in the English Department at the University of Victoria.
Orgography
LEMDO Team (LEMD1)
The LEMDO Team is based at the University of Victoria and normally comprises the project
director, the lead developer, project manager, junior developers(s), remediators,
encoders, and remediating editors.
Metadata
| Authority title | Encode Pointer Links |
| Type of text | Documentation |
| Publisher | University of Victoria on the Linked Early Modern Drama Online Platform |
| Series | Linked Early Modern Drama Online |
| Source |
TEI Customization created by Martin Holmes, Joey Takeda, and Janelle Jenstad; documentation written by members of the LEMDO Team
|
| Editorial declaration | n/a |
| Edition | Released with Linked Early Modern Drama Online 1.0 |
| Encoding description | Encoded in TEI P5 according to the LEMDO Customization and Encoding Guidelines |
| Document status | prgGenerated |
| Funder(s) | Social Sciences and Humanities Research Council of Canada |
| License/availability |
This file is licensed under a CC BY-NC_ND 4.0 license, which means that it is freely downloadable without permission under the following
conditions: (1) credit must be given to the author and LEMDO in any subsequent use
of the files and/or data; (2) the content cannot be adapted or repurposed (except
in quotations for the purposes of academic review and citation); and (3) commercial
uses are not permitted without the knowledge and consent of the editor and LEMDO.
This license allows for pedagogical use of the documentation in the classroom.
|