Skip to the content.

DHARMA List of Elements for Critical Editions

An official full length release is to be published soon, you can find the candidate release here

Elements name Attributes Description Reference
ab -@xml:lang -@xml:id -type(values: invocation, colophon, speaker) -@prev -@next -@rend(value: check) Anonymous Block. Contains any arbitrary component-level unit of text, acting as an anonymous container for phrase or inter level elements analogous to, but without the semantic baggage of a paragraph. §3.2; §3.3.2; §, §; §3.5.3; §4.8.1; §6.2.2; §7.3.1
abbr -@type (values: siglum, hand) -@rend(value: check) Abbreviation. Contains an abbreviation of any sort. In the context of the critical edition, it is used to provide the expected rendering display of any witnesses sigla. §2.1.3; §7.2.3; §8.6.5; §
add -@place(values:inline, below, above, top, bottom, left, right, overstrike, unspecified -mandatory) -@hand -@rend(values: mark, check) Addition. Contains premodern correction and insertion in the source text made by an author, scribe, or a previous annotator or corrector. Can work as twin with <del> by being wrapped in <subst>. §
anchor -@xml:id Allows to provide a anchoring point in the edited text §
app -@xml:id -@prev -@next -@type(values: imitation, adaptation) -@from -@to -@loc -@rend(value: check) Apparatus. Contains one entry in a critical apparatus, with a lemma <lem> and usually one or more readings <rdg> or notes <note> on the relevant passage. Each apparatus entry must be individually wrapped in the element <app> . §5.1.1; §5.1.2; §5.1.5; §5.2.4; §5.3; §5.4; §6.2.1; §; §6.3; §7.3.2; §8.2.1
author Identify an author. §2.1.3
authority Release Authority. Supplies the name of a person or other agency responsible for making a work available, other than a publisher or distributor. By default, contain "DHARMA". §2.1.2
availability A description of the conditions for the distribution and use of the text. Contains <licence>. §2.1.2
back Comes after the edited text, mostly for appendices §3.1; §10; §10.2
bibl -@n -@corresp -@xml:id -@rend(values: omitname, ibid) Bibliographic citation. Used for each bibliographic reference. Contains <ptr> and possibly <citedRange>. §2.1.3; §7.2.3; §8.3.1; §8.4.1; §; §
biblFull Fully-structured bibliographic citation, used to declare a previous project or linked external files to the main one. §9.1.1; §9.2.1; §9.3.1
biblStruct Structured bibliographic citation §9.1.1; §9.2.1; §9.3.1
body The main body of the text. This element is required in any TEI conformant document. §3.1; §; §; §
certainty -@match(Xpath) -@locus(values: value or name) Indicates the degree of certainty associated with some aspect of the text markup. If a text in damaged and you cannot identify the metre with absolute certainty. To be used as child of <gap reason="lost"> or of first child of <lg> §8.7.2
change -@status -@when -@who Records a change or set of changes made during the production of a source document, or during the revision of an electronic file. §2.2.3; §9.1.1; §9.2.1; §9.3.1
choice -@rend(value: check) Used to declare any encoding alternative with unclear and abbreviations. §5.5.6; §8.6.5
cit Citation. Encodes a direct quotation from a published source. §8.3.1
citedRange -@unit(values: page, part, volume, note, item, entry, line, figure, plate, table, appendix, section, book, stanza) To refer to page numbers. §2.1.3; §8.4.1
collection Declares a collection for a manuscript Rsisasana
colophon -@xml:lang (mandatory) Record scribal statements not shared between your different witnesses. §2.1.3
correction Give specifications regarding the correction principles within your edition §
date -@from -@to Contains a date in any format. §2.1.2
del -@rend (values: strikeout, dots, ui, check) Purposeful deletion. Text deleted by scribe. §
div -@type(values:chapter, canto, dyad, section, group, interpolation) - @n(Recommended) -@met -@real -@xml:id -@rend(value: check) -@corresp -@resp -@source Text division. Contains a subdivision of the text. §3.2; §3.4.2; §4.4; §4.6; §4.7; §4.8; §4.8.1; §5.6.1; §; §; §; §
editor -@ref(Mandatory) -@xml:id The <editor> element is allowed to record the editors of the critical edition. It must contained either <forename>and <surname>, either <name>. §; §9.1.1; §9.2.1; §9.3.1
editorialDecl Formulates methodological choices underlying your edition. It is especially useful if you need to give more detail than, or need to make exceptions from DHARMA Guides and practices. §; §5.2.2
encodingDesc Use to document the encoding process and work. §2.2; §7.2; §9.1.1; §9.2.1; §9.3.1
expan -@rend(value: check) Resolves an abbreviation §8.6.5
fileDesc File Description. Contains information on the title, on the publication and on the source. This element is a mandatory part of the header and is treated in two separate subsections, one dealing with the meta-level information on the file history, <titleStmt>, the other concerning the source from which the XML-file is created <sourceDesc>. §2.1; §7.2.1
filiation Provides information on the relationship between the manuscript and other surviving manuscripts of the same text, either specifically or in a general way. §2.1.3
foreign -@xml:lang -@rend(value: check) Identifies a word or phrase as belonging to some language other than that of the surrounding text. Note that in the context of the DHARMA, this element is used to encode any element identified as foreign, even under the level of the word and that should be italicized in the render of the edition. §8.9.2; §9.1.4
forename The first name of a person, contained in the <persName> element. Used with <surname>.
front Contains any prefatory matter (headers, abstracts, title page, prefaces, dedications, etc.) found before the body §3.1; §10; §10.1
g -@type(values: numeral, filler, symbol) -@subtype Glyph or Gaiji. Represents a non-standard character. This element indicates that no equivalent is available in DHARMA transliteration system. §
gap -@reason(values: omitted, lost, illegible, ellipsis) -@quantity -@unit(values: character, component) -@precision(value: low) -@extent(value: unknown) -@rend(value: check) Indicates a point where material has been omitted in a transcription because it is physically missing for whatever reason.Can contained <certainty/>. §5.1.3; §5.1.5; §5.5.4; §5.5.6; §5.5.7; §5.5.8; §5.5.9; §; §5.5.11; §; §; §8.7.1; §
gloss -@rend(value: check)-@rend(value: check) Identifies a phrase or word used to provide a translation within an inscription. Must be used in correlation with <term>. §4.9
handDesc -@hands Description of hands. Contains a description of all the different hands used in a manuscript. The description may be encoded as one or more paragraphs, <p>, but more commonly, the various paragraphs are structured as a series of <handNote> elements, each containing a prose description of the hands. §2.1.3; §; §
handNote -@xml:id(Mandatory) -@scriptRef(Mandatory) Note on a hand. Contains a prose description of one of the hands, containing one or more paragraphs, <p>. §2.1.3; §
head -@xml:lang -@type(value:editorial - mandatory if editorial header) -@rend(value: check) Heading. Contains headings on all levels of the document. Allows you to give an editorial title to a part of your edition. This element can contained only <foreign> as child. §3.2.1; §; §
hi -@rend (values: superscript, subscript, italic, bold, check) -@xml:lang Distinguishes graphical features when there is not pre-existing element. §2.1.3; §8.8.1; §9.1.4
history Describes the history of a manuscript §2.1.3
idno -@type(Mandatory in teiHeader with value filename) Identifier. §2.1.2; §2.1.3; §9.1.1; §9.2.1; §9.3.1
institution Identifies an institution §2.1.3
interpretation Describe any additions you are making to the text edition that relate to issues of analysis or interpretation §
item -@rend(value: check) Element as a container for each list item. §8.8.2
join -@result -@scope -@target Element used to recreate a fragmented text §4.8.1; §4.8.2
keywords List containing keywords. §2.2.2
l -@n (mandatory) -@real -@enjamb(value: yes) -@corresp -@rend(value: check) Individual verse line. §3.2; §3.4.3; §3.4.4; §3.4.5; §3.7; §4.5; §5.8.3; §6.2.2
label -@rend(value: check) Heading used to identify changes of interlocutor in a dialogue context §3.5.3; §8.8.2
lacunaEnd Marks the end of a lacuna §
lacunaStart Marks the start of a lacuna §
language -@ident(mandatory) Declare a language used in the file. §2.2.2
langUsage Record the languages used in the file. §2.2.2
lb -@n -@break(value: no) -@source Line beginning. An empty element which marks the beginning of a new line. §5.5.1; §8.1; §8.1.1
lem -@wit -@type(values: emn, conj, norm, absent_elsewhere, reformulated_elsewhere) -@rend(values: hyphenfront, hyphenback, hyphenaround,circlefront, circleback, circlearound, check) -@hand -xml:id -@varSeq(values: 1 ou 2) -@resp Lemma. Contains a lemma for an apparatus entry. First child of the element <app>. §5.1.1; §5.1.2; §5.1.5; §5.3; §; §; §; §5.3.2; §5.3.3; §5.4; §5.5.4; §5.5.5; §; §; §; §6.3; §7.3.2; §8.5
lg -@met(mandatory/ might be changing) -@n(mandatory for edited text, not for supplied text) -@xml:id -@xml:lang -@part(values: I, M, F) -@prev -@next -@rend(value: check) Line group. Marks the stanza as a whole. §3.2; §3.2.1; §3.6; §3.7; §4.5; §4.8.2; §6.2.2
licence -@target(Mandatory) Licence set by default to a Creative Commons licence identifying the author §2.1.2; §3.4; §3.4.1
list -@rend(values: bulleted, numbered, check) Contains any sequence of items organized as a list. §8.8.2
listApp @type(values: parallels, apparatus) Contains a list of apparatus entries. §4.5; §6.2.1; §6.2.4; §6.3
listBibl Citation list. Contains a list of bibliographic citations of any kind regarding the manuscript as a whole. Inside the <listBibl> element, one or more <bibl> elements are used for each bibliographic reference. §
listPrefixDef List of paths to external file containing some data relevant to the edition. §2.2; §7.2
listWit container for all the witnesses that you will be referring to in the critical apparatus §2.1.3; §5.2.1; §5.4
locus -@type(value: displacement) -@from -@to Indicates locations inside manuscripts §2.1.3; §5.8.1
measure -@type (values: volume, weight, currency...) -@quantity -@unit -@commodity -@rend(value: check) Encodes quantity references. §8.6.3
msContents Describes the intellectual content of any manuscript or part of it §2.1.3
msDesc Manuscript description. Contains a description of a single identifiable manuscript. Within this element six sub-elements are available: <msIdentifier><msContents><physDesc><history><additional> and <msPart>. §2.1.3
msFrag To declare if your text is transmitted in a fragmented manuscript §2.1.3
msIdentifier Manuscript identifier. §2.1.3
msItem -@n Describes an individual work or item within the intellectual content of a manuscript §2.1.3
msName -@xml:lang Unstructured alternative name used for a manuscript §2.1.3
msPart Declares that your witness belongs to a manuscript composed of parts that were originally separated and that have been bound together at a later stage §2.1.3
name Contains a name, i.e. a proper noun or a noun phrase. §
normalization Explain the extent of normalization and regularization applied on the text as critically edited §; §6.1
note -@type(values: altLem, prosody) -@copyOf -@corresp -@sameAs -@resp -@source -@rend(value: check) Contains comments to the text by the editor. It can be in a freeform text pertaining to a particular lemma. §5.1.1; §5.1.2; §5.1.5; §; §; §6.2.1; §6.2.2; §6.2.3; §; §; §7.2.3; §7.4; §8.2.1; §8.5; §9.1.4; §
notesStmt Gathers any notes or remarks providing information about additions to that recorded in other parts of the bibliographic description §9.1.1; §9.2.1; §9.3.1
num -@value -@cert(value:low) -@rend(value: check) Numeral. Contains a numeral, including any delimiters. It does not replace the element. §; §8.6.4; §8.7.1
objectDesc Description of the physical components of your manuscript §2.1.3
origDate @when Date of creation of your manuscript §2.1.3
origPlace Place of creation of your manuscript §2.1.3
p -@xml:id -@next -@prev -@part(values: I, M, F) -@rend(value: check, stanza) -@n -@corresp -@cource -@resp Paragraph. Marks paragraphs in prose of at least one complete sentence or the equivalent of a semantic paragraph. §2.1.2; §2.1.3; §3.2; §3.3.1; §3.6; §3.7; §4.5; §4.7; §4.8.1; §6.2.2; §8.2.1; §; §; §; §; ; §
pb -@n -@break(value: no) -@source -@wit -@edRef Page beginning. An empty element which marks the beginning of a new page in a paginated document. It is also used in foliated documents (having numbers like ‘1r’, ‘1v’, ‘2r’, ‘2v’, and so on.) §5.5.1; §8.1; §8.1.1; §8.1.2
persName -@ref(mandatory in the teiHeader) -@type(values: divine, human, personification) -@subtype(values: coronation, sobriquet, title, other) -@key -@rend(value: check) Personal name. Contains a proper noun or a proper noun phrase referring to a person, consisting of one or more words. For Occidental names, use <forename> and <surname> structures and for others <name>. §; §3.5.3; §7.2.1; §
physDesc Physical description of a manuscript §2.1.3
placeName -@type(values: district, site, sitePart) -@subtype (values: temple, shrine, monastery, feedingHall, tank, pavillion, garden) -@ref -@key A name of a specific location. §
prefixDef -@ident(mandatory) -@matchPattern(mandatory) -@replacementPattern(mandatory) Path toward some data to complete the edition §2.2
profilDesc Provide metadata related to non-bibliographic aspects of the text §2.2.2
projectDesc Use to state your project §2.2; §2.2.1; §9.1.1; §9.2.1; §9.3.1
ptr -@target -@rend(values:title, siglum) Pointer for bibliographical data and citing witnesses, sigla and hands §2.1.3; §2.1.4; §7.2.3; §; §7.4; §; §8.4.1; §
publicationStmt Publication statement. Groups information concerning the publication or distribution of an electronic or other text. §2.1.2; §9.1.1; §9.2.1; §9.3.1
pubPlace Publication place for legal matters stating the edition. §2.1.2; §9.1.1; §9.2.1; §9.3.1
punctuation Explain the degree of correspondence between punctuation of your constituted text and the punctuation found in the witnesses §
q -@rend(value: check) Quoted text not attributed to a publish source. §8.3.2
quote -@xml:lang -@rend(values: block, check) -@type(value: base-text)) Quotation. Contains a quotation from another source or a base text segment §3.7; §4.1; §4.2; §4.3; §4.4; §4.5; §4.6; §8.3; §8.3.1
rdg -@wit -@cause(values:eye-skip, line_omission, haplography, dittography, lexical, morphological, ordinal, syntatic, subtrative, additive) -@hand -@varSeq(values: 1 ou 2) -@sameAs -@type(values: paradosis, transposition) -@resp -@rend(value: check) Reading. Contains an alternative reading. Must be wrapped inside the element <app> and follow a <lem>. §5.1.1; §5.1.2; §5.1.5; §5.4; §5.5.3; §5.5.4; §; §5.5.8; §; §5.8.2; §5.8.3; §6.3; §8.5
ref @target -@cRef -@rend(value: check) Reference. Defines a reference to another inscription in the DHARMABase. §2.2; §7.4; §7.4.1; §7.4.2; §8.3.1
repository Contains the name of a repository which stored the inscription. §2.1.3
resp Responsibility. Contains a phrase describing the type of responsibility, e.g. transcription, conversion, proof-reading. §
respStmt Statement of responsibility. Particularly important when listing the contributors to an edition. §
revisionDesc Revision description. Summarizes the revision history of the text. §2.2.3; §7.2.1; §9.1.1; §9.2.1; §9.3.1
roleName -@type(values: king, subordinateRuler, landlord,godLegalEntity, priest, brahmin, monk, merchant, artisan, brahminDelegate, regionalDelegate, officer, dancer, singer, peasant, shepherd, unknown) -@subtype(values: donor, donee, founder, administrator, inChargeDonation, witness, orderIssuer, orderAddressee, auditor, beneficiaryMerit, commemoratedPerson, scribe, composer, handwriter, engraver, sealer/solderer) -@rend(value: check) Contains a name component which indicates that the referent has a particular role or position in society, such as an official title or rank. §
said -@who(recommended in case of ambiguity) -@rend(value: check) Direct speech quotations §3.5.2
samplingDesc Record free-text information about inclusion or omission of portions of the text, manuscripts, or witnesses §
schemaRef -@type -@key @url(mandatory) Point to any external customization file of the TEI. §2.2; §
secl -@rend(value: check) Secluded. Genuine interpolation for which you can't determine a position in the text §5.6.4
seg -@type(value: highlight, interpolation) -@met -@cert(value:low) -@rend(values: check, pun) Segment. Groups one or more strings of text, e.g. words. §5.5.2; §; §5.6.2; §8.7.1; §; §
settlement Name of a settlement such as a city, town, or village identified as an administrative unit §2.1.3
sic -@rend(value: check) Contains a passage reproduced as is although apparently incorrect or inaccurate. By EpiDoc convention, this markup is used for text that is legible but does not seem intelligible. §5.9; §
sourceDesc Source description. Mandatory part of the header and describes the source material. Sub-element of <fileDesc>. Record details about the original manuscripts and printed texts used as witnesses in establishing your critical edition §2.1.3; §9.1.1; §9.2.1; §9.3.1
sp -@rend(value: check) Individual speech in a dramatic text §3.5.1
space -@type(values: vacat, binding-hole, defect, feature, ascender, descender, other) -@unit(values: characters) -@quantity Space is an empty element which indicates a "blank space". DHARMA does not follow regular TEI practice and is not Epic conformant either regarding the attributes. §; §; §§
span -@type(values: omissionStart, omissionEnd) Mark the start and the end of a scribal omission §
speaker Specialized heading or label, giving the name of one or more speakers in a dramatic text §3.5.1
stage Identify content that can be identified as a stage direction §3.5.1
subst Substitution. Wraps the combination of deletion and addition. §
summary -@xml:lang Provides a summary of the edition §2.1.3
supplied -@reason (mandatory - values: implied, omitted, lost, undefined, subaudible, explanation) -@evidence(values: internal, external, conjectural) -@cert(value:low) -@rend(value: check) Signifies text supplied by the transcriber, encoder or editor either in place of text which is missing or to clarify a reading. §4.2; §4.3; §5.7; §5.7.1; §8.7.1; §; §
supportDesc Description of the materials etc. which make up the physical support for the written part of a manuscript §2.1.3
surname Contains a family (inherited) name of a person, excluding patronyms and metronyms. §
surplus -@rend(value: check) Characters were erroneously added by the scribe, and you correct the text by suppressing the superfluous segment. §5.6.3
TEI -@corresp (mandatory for external files) -@type (values: bibliography, commentary, edition and translation- Mandatory) -@xml:id (mandatory on the main file) -xml:lang (by default eng) The element <TEI> must wrap all TEI-compliant content as a root tag. The <TEI> element must contain two sub-elements, <teiHeader> and <text>. §1; §7.3; §8.9.1; §; §; §
teiHeader The TEI-based header contains additional descriptive information (metadata) about the digital document and is a mandatory component of every TEI document. §2; §9.1.1; §9.2.1; §9.3.1
term -@xml:lang -@xml:id -@rend(value: check) Contains a single-word, multi-word, or symbolic designation which is regarded as a technical term. Use it to wrap a foreign element followed by its translation into a local language that can be encoded as <gloss>. §2.2.2; §4.9; §7.3.2
text -@xml:space(Default value must be ‘preserve’) -@xml:lang Contains a single text of any kind. §3.1; §7.3; §8.9.1; §; §; §
textClass Contain the element <keywords>. §2.2.2
textLang -@mainLang (Recommended) Describes the languages and writing systems identified in the manuscript §2.1.3
title -@type (values: main, sub) -@subype (values: editorial, base-text, commentary, translation) -@xml:lang (only if the title isn't in English) -@n (Only if more than one title bear the same @subtype) -@level(values: a) -@rend(values: plain, check) Contains a title for any kind of work. §; §2.1.3; §7.2.3; §8.4.2; §9.1.1; §9.2.1; §9.3.1
titleStmt Title statement. Contains information on the title, editor and other people who have been involved in the edition. §2.1.1; §9.1.1; §9.2.1; §9.3.1
unclear -@reason (values: eccentric_ductus) -@cert(values: low) -@rend(value: check) Stands in EpiDoc for any character “of which at least traces survive, but not adequately to identify the letter unambiguously outside of its context”. §2.1.1; §5.5.6; §8.7.1
variantEncoding -@method(mandatory; values: parallel-segmentation, double-end-point and location-referenced) -@location(mandatory; values: internat, external) Declare the methodology chosen to encode the apparatus §
witDetail -@wit -@type(values: pc, ac) -@rend(value: check) Specialized type of note, used to declare an ante and post correctionem §5.5.4; §8.2.2
witness -@xml:id (Mandatory) Declaration of witnesses §2.1.3