Internet Shakespeare Editions

A 4. Summary of tags (listed alphabetically)

This is the complete list of tags and attributes which are understood by Michael Joyce's new Java parser and validator, in the text input files. The list is generated from the actual schema file used to do the validations.

Each tag is listed in the following format:

Sample Tag

NAME

A brief description, three properties for the tag, and then a table of attributes. Most descriptions haven't been added yet.

Empty
Yes, no, or optional. Tags like Ornament may be empty, or may contain content and tags.
Context
One of the context descriptions below.
Deprecated
A message suggesting other options
Name Type Optional Empty Renumberable Deprecated Options
name One of the attribute types yes or no yes or no yes or no A message suggesting other tags or attributes a comma separated list of options
The description of name
attribute2 One of the attribute types yes or no yes or no yes or no A message suggesting other tags or attributes a comma separated list of options
The description of the attribute2
Context can be any one of these values: Attribute type is one of these values:
  • apparatus
    collation or annotation files, excluding level 3 footnotes
  • anywhere
    any non-apparatus text
  • primary
    any main text of an edition (old spelling or modern), encoded using the SGML syntax
  • secondary
    introductory or supplementary materials, encoded in XML
  • old spelling
    non-modern, primary texts
  • modern
    modern primary texts
  • annotations
    level 1 or 2 stand-off footnotes
  • collations
    stand-off collations
  • string
    Anything that isn't an empty string.
  • number
    Anything that looks like a number.
  • list
    A comma separated list of values, chosen from the values in the options column. An empty list is acceptable.
  • select
    Exactly one of the values in the options column.

ABBR

Used to expand old-spelling contractions, e.g. <ABBR expan="the">y<SUP>e</SUP></ABBR>

Empty
no
Context
all
Deprecated
no
Name  Type  Optional  Empty  Renumberable  Deprecated  Options 
expan STRING  false  false  false 
The expanded form of the abbreviated word. This will eventually permit searches on the word.

ACT

Act division as in the modern edition.

Empty
no
Context
primary
Deprecated
no
Name  Type  Optional  Empty  Renumberable  Deprecated  Options 
n NUMBER  false  false  false 
The number of the act. If the original includes an act division which has been retained, the notation would be thus: </ACT><ACT n="2"> <LD>Actus Secundus</LD>.

ADD

Indicates a passage in an "extended" text that has been added from an alternative version. May contain LEM and RDG elements, or directly contain added text for the extended version (as if RDG were used around the entire contents).

Empty
no
Context
modern
Deprecated
no
Name  Type  Optional  Empty  Renumberable  Deprecated  Options 
wit STRING  true  false  false 
An identifier for the textual "witness" that the passage came from. Omit if using a child RDG.

AMBIG

Designates a word with alternative readings (marked up by child RDG elements) where a word in the source material is irreducibly ambiguous. Note: this is not a textual variant, but a product of the process of modernization.

Empty
no
Context
modern
Deprecated
no

annotations

Root element of an annotation file.

Empty
no
Context
annotations
Depreciated
no

BACKMATTER

Surrounds all sections of an edition that follow the last scene. The actual division(s) of BACKMATTER are designated by the <DIV> tag, and include (and replace) such items as Epilogue, Colophon and so on.

Empty
no
Context
all
Depreciated
no

BL

Formerly blank line. Depreciated in favour of L.

Empty
no
Context
unknown
Depreciated
Use BLL for black letter or L for blank line instead of BL.

BLL

Black Letter (not to be confused with BL, previously the indication of a blank line).

Empty
no
Context
oldspelling
Depreciated
no

BLOCKQUOTE

Previously used to denote a quoted piece of text (e.g. letter).

Empty
no
Context
oldspelling
Depreciated
Use QUOTE instead of BLOCKQUOTE

BR

Break between lines of hung-words. Should NOT be used to force line breaks in any other context.

Empty
yes
Context
primary
Depreciated
no

C

Centered text. This tag should be applied to a whole line, except for portions marked up by RA.

Empty
no
Context
all
Depreciated
no

CL

Closing statement (e.g. Finis).

Empty
no
Context
primary
Depreciated
no

COL

Defines columns in a page.

Empty
no
Context
oldspelling
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
n SELECT  false  false  false  0, 1, 2 
<COL n="0">...</COL> Defines pages with no columns in a document that elsewhere has columns. <COL n="1 | 2">...</COL> Column 1 or 2 (Folio).

coll

Top level element for an collation. Contains information on the lemma in the text (<lem>), alternate readings (<rdg>), and notes about the variance (<general_note>).

Empty
no
Context
collations
Depreciated
no

collations

Root element of a collations file.

Empty
no
Context
collations
Depreciated
no

CW

Catchword

Empty
no
Context
oldspelling
Depreciated
no

DIV

Named Division of the text that is not an ACT or SCENE.

Empty
no
Context
all
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
link STRING  true  false  false  Link attributes should be dropped from the text. 
No description provided.
name STRING  false  false  false 
Name of the section

EM

Words to be emphasized.

Empty
no
Context
anywhere
Depreciated
no

EPILOGUE

No description provided.

Empty
no
Context
primary
Depreciated
Use BACKMATTER with DIV instead of EPILOGUE

FONT

This tag allows the editor to fine-tune font size where necessary, as, for example, on a title page.

Empty
no
Context
oldspelling
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
size SELECT  false  false  false  1, 2, 3, 4, 5, 6 
The normal (default) size is "3", the smallest "1" and the largest "6".

FONTGROUP

This tag allows the editor to fine-tune font size where necessary, as, for example, on a title page.

Empty
no
Context
oldspelling
Depreciated
renamed to FONT
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
n SELECT  false  false  false  renamed to "size"  1, 2, 3, 4, 5, 6 
The normal (default) size is "3", the smallest "1" and the largest "6".

FOREIGN

Surrounds a word or phrase in a language other than English. Used for the content of speeches only, not Latin stage directions, literary divisions etc. Example <FOREIGN lang="fre">Diable!</FOREIGN>.

Empty
no
Context
all
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
lang STRING  false  false  false 
The 3-letter ISO 639-2 abbreviation for the language: fre (for French), ger (for German), lat (for Latin). See list for other codes

FRONTMATTER

Surrounds all sections of an edition that precede the first scene. The actual division(s) of FRONTMATTER are designated by the <DIV> tag, and include (and replace) such items as Prologue, Epistle, Dedication and so on.

Empty
no
Context
all
Depreciated
no

H1

Heading for scenes in the modern text.

Empty
no
Context
modern
Depreciated
Use LD instead of H1.

H2

Heading for scenes in the modern text.

Empty
no
Context
modern
Depreciated
Use LD instead of H2.

H3

Heading for scenes in the modern text.

Empty
no
Context
modern
Depreciated
Use LD instead of H3.

H4

Heading for scenes in the modern text.

Empty
no
Context
modern
Depreciated
Use LD instead of H4.

H5

Heading for scenes in the modern text.

Empty
no
Context
modern
Depreciated
Use LD instead of H5.

H6

Heading for scenes in the modern text.

Empty
no
Context
modern
Depreciated
Use LD instead of H6.

HW

Hung-Word(s). Note that the hung-word should be restored to the line it continues; the "type" indicates whether it was originally displaced to the previous or next line. Multiple lines of hung-word content should be separated with BR.

Empty
no
Context
oldspelling
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
t SELECT  false  false  false  next, prev 
The type of hung-word indicates whether it appears on lines preceding or following the line it continues.

I

Italic text.

Empty
no
Context
anywhere
Depreciated
no

iembed

Embedded content

Empty
no
Context
anywhere
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
align SELECT  true  false  false  auto, center, left, lightbox, right 
how to align the embedded content within the host document
component SELECT  true  false  false  facsimile, friends, imagedb, link, sip, slt, static, text 
The site component to fetch content from.
height NUMBER  true  false  false 
height (in pixels) of the embedded content
href STRING  false  false  false 
identifier of the resource to embed
lightbox STRING  true  false  false 
identifier of the large resource to show in the lightbox
longCaption STRING  true  false  false 
long-form caption to show in the lightbox
showCaption SELECT  true  false  false  false, true 
whether or not to display a caption with the embedded content
site SELECT  true  false  false  dre, ise, qme 
The ISE sub-site to fetch content from.
width NUMBER  true  false  false 
width (in pixels) of the embedded content

ISE link

Empty
no
Context
anywhere
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
component SELECT  true  false  false  facsimile, friends, imagedb, link, sip, slt, static, text 
The site component to fetch content from.
href STRING  false  false  false 
the resource to link to
site SELECT  true  false  false  dre, ise, qme 
The ISE sub-site to fetch content from.

INDENT

Surrounds a passage indented in the original.

Empty
no
Context
all
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
l NUMBER  false  false  false 
Indicates the number of em spaces a block of text (verse or prose) is to be indented.
n NUMBER  false  false  false  use "l" instead 
Indicates the number of em spaces a block of text (verse or prose) is to be indented.

iseHeader

metadata block

Empty
no
Context
all
Depreciated
no

J

Justified line. Only fully justified lines are tagged. Note that verse lines that reach to the end of the column should not be tagged as justified (though many draft texts do), since these are not justified in the way that prose lines are.

Empty
no
Context
all
Depreciated
no

L

Editor's line number. Mainly used in modern texts. Can also be used to mark blank lines so they will not be collapsed.

Empty
yes
Context
all
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
n NUMBER  true  true  false 
Line number. Each scene is renumbered from 1.
part SELECT  true  false  false  f, i, m 
Used to create split-line groups, where each part is positioned as if it were on the same line as the preceding part. The first part in the group should be marked as part "i", intermediate parts as part "m", and the final part as part "f". See Editor Guidelines 4.4.8

LB

Previously used for line break. <L/> is recommended.

Empty
no
Context
anywhere
Depreciated
Use L on an empty line instead of LB to preserve empty lines.

LD

Header for a Literary Division (e.g. Act, Scene.).

Empty
no
Context
all
Depreciated
no

LEM

Used inside of ADD to mark text that will appear only in the non-extended version of the text.

Empty
no
Context
modern
Depreciated
no

level

Surrounds the annotation content.

Empty
no
Context
annotations
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
n SELECT  false  false  false  1, 2 
The "level" of this annotation. Level 1 annotations are short, and tend to focus on basic meaning without context. Level 2 annotations provide longer, deeper explainations of meaning in context.

LINEGROUP

Surrounds a structured group of verse lines.

Empty
no
Context
primary
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
form SELECT  false  false  false  use "t" instead  couplet, coupletSequence, quatrain, rhymeSequence, sonnet 
The form of the rhyme.
rhyme STRING  false  false  false 
The group's rhyming pattern, for example aabbcddc
t SELECT  false  false  false  couplet, coupletSequence, quatrain, rhymeSequence, sonnet 
The structure of verse.

describes a relationship to another document

Empty
yes
Context
all
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
href STRING  true  false  false 
identifier of the related resource
order NUMBER  true  false  false 
order that this item will appear on the edition title page
rel STRING  true  false  false 
the kind of relationship, describe in the forward direction (how the linked resource relates to this one)
rev STRING  true  false  false 
the kind of relationship, described in the reverse direction (how this resource relates to the linked one)

Provides a list of <linkText> describing witness names that should be linked to ISE editions when displayed

Empty
no
Context
collations
Depreciated
no

linkText

A witness name that refers to an ISE edition.

Empty
no
Context
collations
Depreciated
no

ln

The line numbers from the modern edition to which a collation or note is linked. The format of the content follows the MLA style: 1.3.33, for example.

Empty
optional
Context
apparatus
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
l NUMBER  true  false  false 
Editor's line number.
qln NUMBER  true  false  false 
Quarto line number
tln NUMBER  true  false  false 
Through-line number

LS

Surrounds letter-spaced words (e.g., "G O D").

Empty
no
Context
oldspelling
Depreciated
no

MARG

Marginalia

Empty
no
Context
all
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
loc SELECT  false  false  false  left, right 
Which page margin this text appears in

META

A metadata item about the document.

Empty
yes
Context
all
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
content STRING  false  true  false 
the metadata content
name STRING  false  false  false 
metadata key
scheme STRING  true  false  false 
format of the metadata content

MODE

Indicator of verse or prose.

Empty
no
Context
primary
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
t SELECT  false  false  false  prose, uncertain, verse 
Note that you may choose to use a type of "uncertain" where it is not clear that the section is either verse or prose.

note

Additional notes about the variant. Use as a child of <coll> when the note applies to the collation as a whole, or as a child of <rdg> when it applies to a specific reading.

Empty
no
Context
collations
Depreciated
no

ORNAMENT

Self-closing <ORNAMENT /> is a printer's ornament. <ORNAMENT> </ORNAMENT> is used for decorative or large font letters only.

Empty
optional
Context
oldspelling
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
drop NUMBER  true  false  false 
Marks this ornament as a drop-capital, and specifies the number of lines to span.
letter STRING  true  false  false  Give the letter in the content of the ORNAMENT element instead. 
The ornamented letter.

PAGE

Indicates page breaks in the old-spelling texts.

Empty
no
Context
oldspelling
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
compositor STRING  true  false  false 
The compositor(s) of this page.
n NUMBER  false  false  false 
The "through page number" for the text.
sig STRING  true  false  false 
The page signature in its normalized and accurate form. This will include all signatures that are implied rather than actually printed, and must include either "r" or "v" for recto and verso.

PN

Page number as printed.

Empty
no
Context
oldspelling
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
n NUMBER  true  false  false  Use @n on the PAGE element instead. 
Actual page number where it differs from the printed number.

POEM

a single poem in a collection of poems

Empty
no
Context
primary
Depreciated
Use DIV instead of POEM

PROLOGUE

No description provided.

Empty
no
Context
primary
Depreciated
Use FRONTMATTER with DIV instead of PROLOGUE

PROP

Identifies props to be used in the play when they are mentioned in stage directions or speeches.

Empty
optional
Context
primary
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
desc STRING  true  false  false 
A short description of the prop, if needed. Do provide the description for more than one instance of the same prop.
item STRING  true  false  false 
An unique identifier for the item. Where there are more than one in the play (in the case of multiple letters, for example) these should be designated "letter1" "letter2" etc.

PROSEQUOTE

Formerly a prose quotation (e.g. quoted letter).

Empty
no
Context
primary
Depreciated
Use QUOTE instead of PROSEQUOTE.
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
source STRING  true  false  false 
When the passage is a quotation from another source, the source should be recorded.

q

container for a collation reading's text when the reading also has an associated <note>.

Empty
no
Context
collations
Depreciated
no

QLN

Quarto Line Number

Empty
yes
Context
primary
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
n NUMBER  false  false  false 
The line number.

QUOTE

A Quotation.

Empty
no
Context
all
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
source STRING  true  false  false 
a short desecription of the source of the quoted material

R

Roman type. This tag is used only in texts where the default font is black letter.

Empty
no
Context
primary
Depreciated
no

RA

Right Aligned text. This tag may be applied to a portion of a line that is otherwise left aligned (the default), centered (with C), or justified (with J) so that only the indicated portion is affected.

Empty
no
Context
all
Depreciated
no

RDG

A Reading within an AMBIG or ADD.

Empty
no
Context
modern
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
wit STRING  true  false  false 
An identifier for the textual "witness" that the passage came from. Omitted when used within AMBIG.

RT

Running title.

Empty
no
Context
oldspelling
Depreciated
no

RULE

A horizontal rule. The tag is self-closing.

Empty
yes
Context
all
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
l NUMBER  true  false  false 
Length of the rule in m-spaces. The default is a full page rule.
n NUMBER  true  false  false  Use "l" instead. 
Width of the rule in m-spaces. The default is a full width rule.

S

Speech. Should include a speech prefix (SP).

Empty
no
Context
primary
Depreciated
no

SC

Small caps.

Empty
no
Context
oldspelling
Depreciated
no

SCENE

Scene division as in the modern edition. Note: In plays with a non-diegetic chorus, like Henry V (F) and Pericles, use <SCENE n="0"> to designate chorus passages that are not prologues or epilogues. SCENEs may be used with or without enclosing ACTs.

Empty
no
Context
primary
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
link STRING  true  false  false  Link attributes should be dropped from the text. 
No description provided.
n NUMBER  false  false  false 
The number of the scene, not including any Act numbering.

SD

Stage Direction. Consecutive directions of different kinds should be tagged separately.

Empty
no
Context
primary
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
t LIST  false  false  false  action, delivery, entrance, exit, location, optional, other, setting, sound, uncertain, whoto 
The type of the stage direction, a comma-separated list.

SECTION

Previously used as section divisions in essays and supplementary works.

Empty
no
Context
modern
Depreciated
Use DIV with a name attrbute instead of SECTION.
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
n STRING  true  false  false 
The section number or name.

SIG

Page Signature. Encloses the printed page signature.

Empty
no
Context
oldspelling
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
n STRING  true  false  false  Use @sig on PAGE instead 
The signature in its normalized and accurate form. This will include all signatures that are implied rather than actually printed, and must include either "r" or "v" for recto and verso.

SP

Speaker(s) for the enclosing speech. Should appear before any speech text. If a prefix is not given in the source material, use an empty SP tag to indicate its omission.

Empty
no
Context
primary
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
norm STRING  false  false  false 
Normalized form of the name. If there is more than one speaker, separate the noramlized names by commas.

SPACE

Indicates significant space to be left in the text. The most common instance of this will be in formatting the lines of verse in a song or sonnet, where some lines will be indented further than others.

Empty
yes
Context
all
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
l NUMBER  true  false  false 
The length of space, in em's.
n NUMBER  true  false  false  use "l" instead 
The number of m-spaces should be indicated.

STANZA

Stanza of a poem. Use instead of ACT/SCENE/DIV in long-form poems.

Empty
no
Context
primary
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
n NUMBER  false  false  false 
The number of the stanza.

SUB

Subscript characters.

Empty
no
Context
anywhere
Depreciated
no

SUP

Superscript characters.

Empty
no
Context
anywhere
Depreciated
no

SWASH

Indicates an ornamental swash letter. DRE texts only.

Empty
no
Context
primary
Depreciated
Do not use SWASH tags.
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
where SELECT  false  false  false  after, before, both 
The direction of the swash ornament.

TITLE

Title of the work, often appearing in initial headings and introductory pages.

Empty
no
Context
primary
Depreciated
no

TITLEHEAD

Title page material in quartos; initial heading in Folio.

Empty
no
Context
primary
Depreciated
replaced by TITLE

TITLEPAGE

No description provided.

Empty
no
Context
primary
Depreciated
Use DIV with a name attrbute instead of TITLEPAGE

TLN

Through Line Number. The basic method of internal reference for the editions will be the TLN number. Where a quarto or modern edition omits material the numbers will be omitted; where they add material the numbers will be added decimally (<TLN n="1033.1"> etc.); where the line division varies from the Folio the TLN number will be that of the first word of the line.

Empty
yes
Context
primary
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
n NUMBER  false  false  false 
The TLN.

var

"pop-up" variant to show on this lemma when it is hovered.

Empty
no
Context
annotations
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
wit STRING  false  false  false 
Name of the witness that the reading comes from.

VERSEQUOTE

Previously used for a verse quotation (e.g. song).

Empty
no
Context
primary
Depreciated
Use QUOTE instead of VERSEQUOTE.
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
source STRING  true  false  false 
When the verse is a quotation from another source, the source should be recorded (as in Pistol's quotations from earlier plays).

WLN

Witness Line Number.

Empty
yes
Context
primary
Depreciated
no
Name  Type  Optional  Empty  Renumberable  Depreciated  Options 
n NUMBER  false  false  false 
The WLN.
wit STRING  true  false  false 
An identifier for the witness that the passage came from. If omitted, the source witness referenced in the metadata is assumed.

WORK

The tag that surrounds the entire document.

Empty
no
Context
all
Deprecated
no
Name  Type  Optional  Empty  Renumberable  Deprecated  Options 
genre STRING  true  true  false  Use metadata instead of the genre attribute. 
Previously used to decribe the work's genre.