Appendix 4. Legacy Markup

This chapter of our documentation is still in beta. We welcome feedback, corrections, and questions while we finalize the page in our 2024–2025 work cycle.

IML Conversion Table

Context

IML Tags to TEI Elements

IML Tag TEI Element TEI Attributes and Values Notes
AB <ab>
ABBR <choice> with a child <abbr> and child <expan> <abbr> contains a sequence of appropriate style elements and <expan> contains the value of the IML attribute expan or EXPAN.
ACT <div> @type = act
ADD N/A There is no equivalent for this boutique handling of extended texts in LEMDO.
AMBIG N/A This tag was developed by the ISE to capture textual ambiguity and animate the possibilities. There is no equivalent in TEI or LEMDO. Handle ambiguities via annotations and collations.
annotations N/A LEMDO processes the annotation files separately and then links the apparatus to the main text using XSLT and Ant builds.
BACKMATTER <back> The content of the backmatter is transformed as per the corresponding templates.
BL This tag has been deprecated in IML and replaced by <L>.
BLL <hi> @rendition = rnd:blackletter
BLOCKQUOTE <quote> @source The TEI @source attribute is only generated if the IML element had a source/SOURCE attribute.
BR <lb>
C <hi> @rendition = rnd:centre.
CL <closer> The style attributes are also added to the note element.
COL <cb> @n = value of IML attribute @N
coll This is the top level element for the collations file in IML. LEMDO processes the collation files separately and then links the apparatus to the main text using XSLT and Ant builds.
collations N/A LEMDO processes the collation files separately and then links the apparatus to the main text using XSLT and Ant builds.
CW <fw> @type = catch
DD N/A
DIV <div> The style attributes are also added to the note element.
DL N/A
DT N/A
EM N/A
EPILOGUE N/A This tag has been deprecated in IML and replaced by <BACKMATTER> WITH A CHILD <DIV>.
FONT LEMDO handles FONT using CSS and not TEI elements.
FONTGROUP N/A Style switches are processed into <milestone> elements.
FOREIGN <foreign> @lang If the FOREIGN tag has a lang or LANG attribute with any value other than gibberish, then the TEI <foreign> element gets a @xml:lang with the corresponding value. If the value of the IML LANG/lang attribute is Dog Latin, then the value of the @xml:lang attribute would be changed to la-x-doglatin.
FRONTMATTER <front> The content of the frontmatter is transformed as per the corresponding templates.
H1 <head> @n with a value of 1 AND corresponding @style or @rendition attributes and their corresponding values This tag has been deprecated in IML and replaced by <LD>.
H2 <head> @n with a value of 2 AND corresponding @style or @rendition attributes and their corresponding values This tag has been deprecated in IML and replaced by <LD>.
H3 <head> @n with a value of 3 AND corresponding @style or @rendition attributes and their corresponding values This tag has been deprecated in IML and replaced by <LD>.
H4 <head> @n with a value of 4 AND corresponding @style or @rendition attributes and their corresponding values This tag has been deprecated in IML and replaced by <LD>.
H5 <head> @n with a value of 5 AND corresponding @style or @rendition attributes and their corresponding values This tag has been deprecated in IML and replaced by <LD>.
H6 <head> @n with a value of 6 AND corresponding @style or @rendition attributes and their corresponding values This tag has been deprecated in IML and replaced by <LD>.
HW <seg> OR <ab> @style AND @type If the HW is the descendant of S, SD, or STANZA, or when the HW is a descendant of the prologue.
I <hi> @rendition = rnd:italic
I - for foreign language foreign @xml:lang with the value corresponding to the proper language.
I - for title <title> @level = m
iembed N/A
ilink N/A
INDENT Style switches are processed into <milestone> elements.
iseHeader N/A
J <hi> @rendition = rnd:justify
L <l> Do not use <l> in semi-diplomatic transcriptions. In modern texts, wrap <l> around the entire line of verse.
LB This tag has been deprecated in IML and replaced by <L>.
LD <head> OR <ab> OR <div> followed by <head> OR <seg> With <ab> and <seg> : @type = literaryDivision When <LD> is the only child of <ACT>, <SCENE>, or <DIV>, OR when it is a child of <ACT>, <SCENE>, or <DIV> with no siblings <SD>, <S>, or <L>, OR when it is a child of <WORK>, it is processed into a <head> element followed by the appropriate sequence of appropriate elements. When <LD> is the child of <ACT>, <SCENE>, or <DIV>, it gets processed into a <ab> element. When <LD> is the child of <FRONTMATTER>, it gets processed into a <div> element followed by a <head> element and the sequence of appropriate elements. When the <LD> is neither the descendant of a <S> element nor of a <SD> element, it gets processed into an <ab> element followed by the appropriate sequence of elements.
LEM N/A
level N/A
LINEGROUP <lg> with children elements <l> @n for IML attributes n and N | @type for IML attributes form and FORM | @rhyme for rhyme and RHYME IML attributes | @part for IML attibutes part or PART When the LINEGROUP does have <l> or <L> descendents, then they are processed accordingly. Otherwise we add <l> elements by grouping per TLN. This processing is not perfect and needs attention from the remediator.
LINK N/A
linklist N/A
linkText N/A
ln N/A
LS <hi> @rendition = rnd:letterspace
MARG <note> @type = marginal AND @place = plc-left-margin or plc-right-margin depending on the source attributes
META <p> The META is part of the teiHeader and gets processed by adding its content into a <p> element.
MODE: verse <l> In semi-diplomatic transcriptions, the encoding would be different: it would account for modes in the attributes for <div> elements.
MODE: prose <p> In semi-diplomatic transcriptions, the encoding would be different: it would account for modes in the attributes for <div> elements.
NOTE <note> The style attributes are also added to the note element.
note <note>
OL N/A <OL> is used for bibliography entries in IML. LEMDO has a bibliography document and links to it from the texts using <ref> elements and @target attributes, with the value corresponding to the ID of the work in BIBL1.
ORNAMENT <figure> OR <seg> Printerʼs ornaments are converted into figures. Otherwise they are converted into <seg> elements, for the remediator to evaluate at a later stage.
PAGE <pb> @n = the values of IML attributes: @N, @n, @SIG, and @sig
PN <fw> @type = pageNum
POEM N/A This tag has been deprecated in IML and replaced by <DIV>.
PROLOGUE This tag has been deprecated in IML and replaced by <FRONTMATTER> with <DIV>.
PROP <ab> with a child <rs> OR <rs> @n AND/OR @subtype When the parent tag of <PROP> is <SCENE>, the <rs> element needs a parent <ab> element; otherwise a <rs> element is the TEI element of choice. As for the attributes, if the PROP tag has a DESC or desc attribute, then the TEI attribute would be @n. If the PROP tag has an ITEM or item attribute, then the TEI attribute would be @subtype.
PROSEQUOTE <quote> @type with value taken from that of the type attribute in the source file AND @source The @source attribute is only available if the IML tag had a source or SOURCE attribute.
q N/A
QLN <lb> @type with the value of the n or N attributes in the IML instance
QUOTE TEI comment declaring beginning and end of the quote OR <quote> @source If the <QUOTE> tag has a source attribute in the IML, we process its value to adhere to the taxonomy standards of LEMDO.
R <hi> @rendition = rnd:normalstyle
RA <hi> @rendition = rnd:right
RDG N/A
RT <fw> @type = runningTitle
RULE <figure> @type = rule AND @n with the value of the IML attribtue n or N
S <sp> The code adds a <speaker> element as part of the conversion process.
SC N/A
SCENE <div> @type = scene
SD <stage> @type with the respective values of the SD @T or @t When the value of the @T or @t attributes is action it gets replaced with @business, and when it is whoto, it gets replaced with delivery.
SECTION <div> @type = section AND @n with the value of n or N attributes in the IML instance The @n attribute is dependant on the existence of the n or N attributes in IML.
SIG <fw> @type = sig
SP <speaker> Although an <P> tag becomes the <speaker> element, this conversion happens as pert of the processing of <S> tags. In fact, we simply delete <SP> tags when we are processing them.
SPACE <space> @unit = chars and @quantity = the value of IML attributes @N, @n, @l, and @L When the SPACE IML element has a @T attribute, the TEI <space> element gets a @type attribute.
STANZA <lg> with children elements <l> @n for IML attributes n and N | @type for IML attributes form and FORM | @rhyme for rhyme and RHYME IML attributes | @part for IML attibutes part or PART When the LINEGROUP does have <l> or <L> descendents, then they are processed accordingly. Otherwise we add <l> elements by grouping per TLN. This processing is not perfect and needs attention from the remediator.
SUB <hi> @rendition = rnd:subscript
SUP <hi> @rendition = rnd:superscript
SWASH <seg> @type = swash AND @subtype with the value of the where or WHERE attributes in the IML instance The @subtype attribute is dependant of the presence of a where or WHERE attribute in the IML.
TITLE <head> In some instances, we process IML TITLE elements into <seg> elements with a @type attribute and a value of titleHead.
TITLEHEAD <head> OR <div> with a child <head> OR <ab> OR <seg> OR <docTitle> OR <dateline> @type = titleHead for <ab> and <seg> elements The TEI element for IML <TITLEHEAD> depends on the IML parent and ancestor elements, as well as preceding sibling elements.
TITLEPAGE N/A This tag has been deprecated in IML and replaced by <DIV> with a NAME attribute.
TLN <lb> @type AND @n with the respective values of the IML attribute
var N/A
VERSEQUOTE <quote> @type with value taken from that of the type attribute in the source file AND @source The @source attribute is only available if the IML tag had a source or SOURCE attribute.
WLN N/A
WORK N/A IML documents were rooted on WORK. LEMDO documents are rooted on <TEI> elements and contain a <teiHeader> . IML <WORK> elements are processed and added to the <body> of the corresponding TEI file.

IML to TEI Typographical Conversion

IML Typographical TEI Element TEI Attributes Notes
[...] <supplied> @reason with the appropriate value Square brackets correspond to supplied material
"..." <soCalled> , <mentioned> , <quote> , <title> A propos <title> : @level = a The programmatic conversion will replace all quotations with <q> elements, and the remediator will make an informed decision during the remediation process.

Tips for Editors Working in IML

This documentation contains tips for editors who are still working in IML (the old ISE Markup Language). If you follow these tips, our programmatic conversions will be better able to convert your IML tags to TEI tags, thus saving the person running the conversions a good deal of time.

General Tips

Below is a list of general tips for working in IML:
Do not add TEI tags to your IML. Our conversion processor is expecting valid IML, not a hybrid of two markup languages.
Check your tag hierarchy carefully. Misplaced closing tags trip up our conversion.
Close all of your tags properly with </elementName>. Check that every closing tag begins with a forward slash.
Do not use straight apostrophes or straight quotation marks except in the tags themselves. It will be helpful if you can correct these before sending the files to LEMDO.
Check that quotations in the annotations and critical paratexts are properly wrapped in beginning and ending quotation marks. Our processor is looking for opening and closing quotation marks to wrap the quotation in the <q> element that LEMDO requires. It is very time consuming for the LEMDO team to look up quoted material to see where the quotation begins and ends, and we do not have the resources to do that kind of work for you.
Edit the annotations and modern text file simultaneously. LEMDO uses string matching in the process of adding anchors and pointers, but, unlike the ISE, we no longer rely on string matching once the anchors and pointers are in place. If the lemma in the annotation differs from the reading in the modern text, we have to compare the files and try to figure out what the editor wants to annotate. Mistakes can occur if you edit either the modern text or the annotation file without updating the other file to match.

Spaces

Do not use the <SPACE> element to add vertical space to your modern texts. LEMDO applies generic styling to all modern texts, so there is no need to spend time adding tags that will be deleted when we convert your IML to TEI and remediate it for publication on the LEMDO platform.
You may continue to use the <SPACE> element in your semi-diplomatic texts to describe vertical white space in the early modern manuscript or printed playbook.
If you are using the <SPACE> element to make something indent, there is probably a semantic reason you are doing so. For example, it may be a letter read aloud within a speech, or the couplet in a sonnet. In those cases, leave a note in your file and we will encode the letter/couplet appropriately for you. You can wrap your note in an xml comment like the one below:
<!-- LEMDO team: This passage of the speech is a letter. -->

Collation

Do not use the @subst attribute. If you need to say more about the reading you have adopted, add a <note> to your <app> element in the collation or a <note type="textual> in your annotation.

Use LEMDO Values in IML Annotations

IML annotations were organized into four levels: 1, 2, 3, and perf (for performance notes, used mainly by QME editors). Editors working in IML were encouraged to think about the levels according to the length of the annotation and whether or not it should appear in a printed edition.
LEMDO annotations are based on an entirely different logic, that of the challenge addressed by the annotation. Length is immaterial from LEMDO’s perspective; you will want to consult with your anthology lead about your anthology’s requirements and standards. Allowed LEMDO values are:
gloss
commentary
textual
pedagogical
performance
lexical
You will find definitions of these values in Types of Annotations
You may begin using these values in your IML, or continue to use IML’s levels. LEMDO prefers that you begin using our values because you will save our remediators a lot of time (and that in turn saves money that is better spent on new features and remediating other texts). In particular, we encourage you to start identifying notes about textual matters as textual instead of Level 2 or Level 3 notes. Likewise, if you have extensive commentary notes that quote from the OED or other dictionaries, please begin labelling these as lexical notes.
Our IML-to-TEI conversion process is expecting this encoding in your IML: <LEVEL="[value]">. As of 2021-08-04, our conversion process will convert <LEVEL="[value]"> to TEI’s <note> element with a @type attribute and value as follows:
Value in IML <LEVEL="[value]"> Post-conversion value
1, gloss gloss
2, 3, comm, commentary commentary
perf, performance performance
text, textual textual
perf, performance performance
lex, lexical lexical
video video (a temporary value assigned during conversion but not ultimately allowed in the LEMDO schema; LEMDO does not treat video links as annotations)
Note that we have allowed for short forms of values in your IML. We know that many of you are typing these values out in a word processed document and expect that you may prefer to type a shorter form. We have also tried to anticipate typos and accidental reversions to the numbers of the ISE’s levels.

Substitutions and Notes

For <LEVEL="1">, start using <LEVEL="gloss">.
For <LEVEL="2"> or <LEVEL="3">, start using <LEVEL="commentary">, <LEVEL="textual">, <LEVEL="lexical">, or <LEVEL="performance"> to describe the purpose of the note rather than its length.
Note that performance is meant for discussions of specific performances. IML introduced this value for QME’s Performance-As-Research. LEMDO extends QME’s practice to allow the use of performance to describe any specific production listed in your bibliography. General speculations about early modern performance practices and observations about performance cruces that have to be solved by directors (e.g., the timing of Feste’s exit when the letter plot is fomenting in Twelfth Night) are commentary notes, not performance notes.
LEMDO’s pedagogical note type has no precedent in IML. LEMDO’s primary intention is to allow future scholars and teachers to add pedagogical notes to an edition. If you wish to use it to point out pedagogical opportunities or challenges in your own edition, consult with your anthology lead.

Prosopography

Isabella Seales

Isabella Seales is a fourth year undergraduate completing her Bachelor of Arts in English at the University of Victoria. She has a special interest in Renaissance and Metaphysical Literature. She is assisting Dr. Jenstad with the MoEML Mayoral Shows anthology as part of the Undergraduate Student Research Award program.

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.

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

Project manager 2022–present. Textual remediator 2021–present. Navarra Houldin (they/them) completed their BA in History and Spanish at the University of Victoria in 2022. During their degree, they worked as a teaching assistant with the University of Victoriaʼs Department of Hispanic and Italian Studies. Their primary research was on gender and sexuality in early modern Europe and Latin America.

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.

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.

Metadata