Extracted from official github repo https://github.com/lombardpress/lombardpress-schema on 2020-01-23
layout: page title: “Lombard Press Schema 1.0.0 - Diplomatic Transcription Guidelines” date: 2016-07-15 categories: schema —
Editors:
Document Status: Draft
The goal of the LombardPress Diplomatic Transcription specification is to offer a set of guidelines for the markup of medieval scholastic commentaries and texts that conform as much as possible to existing standards. In the case of diplomatic transcriptions, this means following as closely as possible the EpiDoc specification. In most cases, we aim only to expand the EpiDoc specifications and offer a detailed list of available attributes and attribute values. Where specifications are not stated, the EpiDoc guidelines should be followed. Where EpiDoc does not state a specification, the more general TEI specification should be followed.
The fileDesc contains the full bibliographic description of an electronic file.
fileDesc MUST contain titleStmt.fileDesc MUST contain editionStmt.fileDesc MUST contain publicationStmt.The titleStmt determines the bibliographical information of the encoded file.
titleStmt MUST have a title.titleStmt MUST have an author.titleStmt SHOULD have an editor.titleStmt MAY have responseStmt.<titleStmt>
<title>Dicta super librum De anima</title>
<author>Simon Magister</author>
<editor>Michael Stenskjær Christensen</editor>
<respStmt>
<name xml:id="comments-JJ">John Johnson</name>
<resp>Editorial suggestions</resp>
</respStmt>
</titleStmt>
editionStmt indicates the edition of the document within the context of its source history.
editionStmt MUST contain an edition element.edition@n MUST be n=X.X.X-dev; usually, when starting a new document it should be listed as n=0.0.0-dev.edition MUST contain a date element.date that is the child of edition MUST include a machine-formatted @when attribute corresponding to the date in the text node.edition SHOULD NOT contain any other children besides the date.<editionStmt>
<edition n="0.0.0-dev">
<date when="2016-06-18">June 18, 2016</date>
</edition>
</editionStmt>
publicationStmt indicates the authority supporting this edition (usually a sponsoring or funding research group). It should also list the license and availability of the text.
publicationStmt MUST have EITHER authority and availability elements as children OR a general p element.
authority and availability to identify the entity that makes the creation of the current document possible. See examples below.p MAY contain a ref to provide an external link to the authority-like entity.authority MAY contain a ref to provide an external link to the authority entity.availability SHOULD contain @status.availability SHOULD contain a p describing the license under which the edition is published.<publicationStmt>
<authority>Scholastic Commentaries and Texts Archive Project</authority>
<availability status="free">
<p>Published under a <ref target="http://creativecommons.org/licenses/by-nc-nd/3.0/">Creative Commons Attribution-NonCommercial-NoDerivs 3.0 License</ref></p>
</availability>
</publicationStmt>
<publicationStmt>
<authority>
<ref target="http://representationandreality.gu.se">
Representation and Reality: Historical and Contemporary Perspectives on the Aristotelian Tradition
</ref>
</authority>
<availability status="free">
<p>Published under a <ref target="http://creativecommons.org/licenses/by-nc-nd/3.0/">Creative Commons Attribution-NonCommercial-NoDerivs 3.0 License</ref></p>
</availability>
</publicationStmt>
<publicationStmt>
<authority>
<ref target="http://petrushispanusproject.po">Petrus Hispanus Project</ref></authority>
<availability status="free">
<p>Published under a <ref target="http://creativecommons.org/licenses/by-nc-nd/3.0/">Creative Commons Attribution-NonCommercial-NoDerivs 3.0 License</ref></p>
</availability>
</publicationStmt>
sourceDesc should list the witnesses and sources used to construct the edition.
sourceDesc MUST contain either a listWit or listBibl, but NOT both.listWit MUST contain only one wit.listBibl MUST contain only one bibl.witness MUST have a @xml:id.witness SHOULD have a n giving a short id of the witness.
@n SHOULD correspond to the short id for the manuscript or codex in the SCTA database. If the value is not known, leave it out. It will be added later during processing.handDesc, follow TEI guidelines.<listWit>
<witness xml:id="P" n="bnf15705">Paris, Lat 15705</witness>
</listWit>
<listBibl>
<bibl xml:id="Q" n="quaracchi1924">Quaracchi 1924 Edition</bibl>
</listBibl>
<listWit>
<witness xml:id="P" n="bnf15705">Paris, Lat 15705
<msDesc>
<physDesc>
<handDesc hands="2">
<handNote sameAs='#P'>This is the main hand of the text. German hand of the XIIIc with an inclination toward particularly complex majuscules.</handNote>
<handNote xml:id="#P1">Flemish hand of the XVc written in mauve ink. Used for minor corrections.</handNote>
</handDesc>
</physDesc>
</msDesc>
</witness>
</listWit>
encodingDesc provides details about the encoding methods used in the text and the schema followed. In a diplomatic edition the encodingDesc only serves to declare which schema the edition should be validated against.
encodingDesc MUST be stated.encodingDesc MAY NOT contain variantEncoding.encodingDesc MUST contain a schemaRef.schemaRef MUST contain a @url that points to the URL of the LBP schema.schemaRef MUST contain an @n pointing to the version number of the LBP schema.encodingDesc MAY take an editorialDecl that contains a p with a prose description of the guidelines followed in the preparation of this edition.<encodingDesc>
<schemaRef
n="lbp-diplomatic-1.0.0"
url="https://raw.githubusercontent.com/lombardpress/lombardpress-schema/master/src/diplomatic.rng">
</schemaRef>
<editorialDecl>
<p>Encoding of this text has followed the recommendations of the LombardPress 1.0.0 guidelines for a diplomatic edition</p>
</editorialDecl>
</encodingDesc>
The revisionDesc contains a description of the current and previous versions of the current edition.
The individual editor would usually not be responsible for maintaining the revisionDesc, as it should (ideally) be generated as part of the publication workflow.
revisionDesc MUST be stated.revisionDesc MUST contain @status.revisionDesc MUST contain listChange.listChange MUST contain at least one change.change MUST contain @when.change MUST contain @status. Possible values of the attribute are:
change MUST contain @n.change MUST contain either @corresp pointing to a description of the change or a p describing the change.<revisionDesc status="draft">
<listChange>
<change when="2015-11-11" status="draft" n="0.0.0">
<p>Created file for the first time.</p>
</change>
</listChange>
</revisionDesc>
<revisionDesc status="draft">
<listChange>
<change when="2015-12-24" status="draft" n="0.1.0" corresp="versionlog.xml#v0.1.0" />
<change when="2015-11-11" status="draft" n="0.0.0">
<p>Created file for the first time</p>
</change>
</listChange>
</revisionDesc>
text is the main wrapper of the edition and sibling to the teiHeader.
text SHOULD take an @type attribute the value of which is “diplomatic”.
text@type are:text SHOULD take an @xml:lang attribute indicating the dominant language of the edition, usually la for “latin”.front is used to make prefatory declarations about the text. For now that only includes the starting location of the text in the witness.
front MUST take a div with the xml:id="starts-on".
pb, cb, and lb elements indicating the page, column, and line on which the text begins in the different witnesses. For the encoding of pb, cb and lb see the relevant section below.<front>
<div xml:id="starts-on">
<pb ed="#V" n="5-r"/><cb ed="#V" n="b"/><lb ed="#V" n="13"/> <!-- V5rb -->
</div>
</front>
body is the primary wrapper of the edited text.
body MUST immediately follow front.body MUST take a div as an immediate child.div is the fundamental section unit of an edition.
div in each edition as a direct child of body.div MAY only contain head and p as children.div MAY NOT contain any text nodes as direct children.head is the wrapper heading declaration for a div.
head MUST be an immediate child of a div.head MUST precede p elements in parent div.head MAY take an @type attribute.
@type values include:p (along with head) is the wrapper of all text nodes within the body element.
head element, MUST be descendants of a p element.p MUST be an immediate child of a div.If it is not a priority to encode every abbreviation and expansion, the editor might want to indicate several possible expansions in cases of doubt.
See the examples below for the relation between ex and expan. Generally ex only gives the content that is added by the editor while expan gives the whole word, including the characters that constitute the abbreviation.
expan MUST include an abbr and at least one ex as children.abbr not contained within a expan MUST be wrapped in a choice element.ex is present, they MUST be wrapped in a choice element.expan is present, they MUST be wrapped in a choice element.In the examples below, option 2 is preferred in cases dealing with characters glyphs that stand for an entire word.
Option 1
<expan>
<abbr>Aug</abbr>
<choice>
<ex cert="high">ustinus</ex>
<ex cert="low">usta</ex>
</choice>
</expan>
Option 2
<choice>
<abbr>Aug</abbr>
<choice>
<expan cert="high">Augustinus</expan>
<expan cert="low">Augusta</expan>
</choice>
</choice>
<choice>
<abbr>sᵈ</abbr>
<expan>sicud</expan>
</choice>
<choice>
<abbr>sᵈ</abbr>
<expan>
<choice>
<orig>sicud</orig>
<reg>sicut</reg>
</choice>
</expan>
</choice>
Corrections mark places where an erroneous word has been marked as present in the text alongside its corrected form.
choice element.sic element which is a child of choice.corr element following the sic element and a child of the choice element.<choice>
<sic>fidei</sic>
<corr>fide</corr>
</choice>
Normalizations mark places where an original orthographic form has been preserved alongside its normalized form.
choice element.orig element which is a child of choice.reg element following the orig element and a child of the choice element.<choice>
<orig>sicud</orig>
<reg>sicut</reg>
</choice>
The situation where the editor has difficulties reading the text might be caused by a physical damage to the manuscript or by the editor’s inability to interpret the text although it is perfectly visible on the page. The difference between those two situations is indicated with the @reason tag added to the unclear element.
If the editor has a suggestion for a reading, the unclear element is used, otherwise the gap is used.
unclear and gap MAY contain @reason to indicate the reason for the difficult reading. The possible values are:
difficult (default, assumed when nothing is stated)damage (referring to a physical damage of the manuscript)reproduction (referring to the quality of the reproduction)unclear elements MAY be wrapped in a choice element to indicate any number of possible but mutually exclusive suggestions.unclear SHOULD contain @cert to indicate the relative certainty of the suggestions.
gap MUST contain @quantity and @unit indicating the extent of the gap.unclear MAY contain note for discussing the difficulty.choice MAY contain note for discussing the different possible suggestions.A simple case where the editor has a suggestion:
<unclear>suggestion</unclear>
A simple case where the editor has no suggestion:
<gap extent="5" unit="characters"/>
In both of the above examples, the @reason is assumed to be difficult. If the problem is caused by a physical damage, it should be indicated like so:
<unclear reason="damage">suggestion</unclear>
Or
<gap reason="damage" extent="5" unit="characters"/>
A case where multiple possibilities are noted could appear as follows. The @reason is assumed to hold for all sibling nodes as the difficulty has the same cause.
<choice>
<unclear cert="high" reason="damage">scilicet</unclear>
<unclear cert="medium">sicud</unclear>
<unclear cert="low">sed</unclear>
</choice>
A case where multiple possibilities and the note element is used:
<choice>
<unclear cert="high" reason="damage">scilicet
<note>This is the best choice if what looks like a descender is a stray ink mark</note>
</unclear>
<unclear cert="low">sicud</unclear>
<note>I prefer the second because ...</note>
</choice>
A case where the editor has no suggestion for a difficult reading.
<gap reason="damage" quantity="5" unit="word"/>
Or
<gap reason="difficult" quantity="5" unit="word"/>
add indicates a place where a word or phrase has been inserted, typically inter-linearly or in the margin.
add MUST have an @place attribute.<add place="above-line" hand="#N1">fides</add>
del indicates a place where a word or phrase has been deleted.
del MUST have an @rend attribute.
@rend:rend="strikethrough vacat"<del rend="erasure" hand="#N1">fides</del>
subst indicates a place where a word has been deleted and another word has been added as a replacement
subst MUST contain an add and del element as children.add and del elements MUST follow above outlined rules.<subst hand="#N1">
<del rend="strikethrough">fides</del>
<add place="margin-right">spes</add>
</subst>
<subst>
<del rend="strikethrough" hand="#N1">fides</del>
<add place="margin-right" hand="#N2">spes</add>
</subst>
seg@type="correction" is used to wrap a word that is being corrected through an addition, deletion, or substitution of only part of the word.
seg@type="correction" MUST must contain a add, del, or subst as a child element.seg@type="correction" MUST also contain text nodes as direct children (otherwise seg is unnecessary and add, del, or subst alone are sufficient).add, del, and subst MUST follow above outlined rules.<seg type="correction">
carit
<subst>
<del>as</del>
<add>atis</add>
</subst>
</seg>
References and quotations are marked with ref and quote elements.
ref is used when the author makes an internal or external reference. The whole reference to the target may contain several elements, normally title and name.
ref MAY contain name to indicate the author of the referenced work.ref MAY contain title to indicate the title of the referenced work.Ut dicit <ref><name>Augustinus</name> in <title>De civitate dei</title></ref>
quote is used when the author makes a direct quote from another text (or a different passage of his/her own text).
quote element MUST surround the quoted text.Simple indication of a quote:
Librum sic incipitur <quote>In principio Deus creavit caelum</quote> et cetera
Recommended indication with xml:id:
Librum sic incipitur
<quote xml:id="mockid-1">In principio Deus creavit caelum</quote>
et cetera
Use of the @ana attribute:
Librum sic incipitur
<quote ana="#gen1_1" xml:id="mockid-1">
In principio Deus creavit caelum
</quote>
et cetera
pc is reserved for the use of marking punctuation characters within the text.
pc MAY take a @type attribute indicating the type of punctuation that corresponds to the punctuation character inserted as a child text node.
@type attribute are:For now, we recommend a small subset of the many possible punctuation marks are included by the unicode glyph. Any unicode code point can be encoded, but not all media will be able to represent the adequately, so here we include some that are in a standard font set.
Names, code points and renderings of the punctuation marks:
| Name | Code point | Rend | Note |
|---|---|---|---|
| pilcrow | U+00B6 | ¶ | |
| punctus | U+002E | . | regular full stop |
| punctus elevatus | U+003B | ; | regular semi colon |
| punctus medius | U+00B7 | · | middle dot |
| virgula | U+002F | / | solidus, regular slash |
| punctus interrogativus | U+003F | ? | regular question mark |
Aficionados for medieval font encoding will find glyphs and font suggestions at http://folk.uib.no/hnooh/mufi/.
<pc type="pilcrow">¶</pc>
<pc type="virgula">/</pc>
<pc type="punctus">.</pc>
<pc type="punctus-elevatus">;</pc>
<pc type="punctus-interrogativus">?</pc>
<pc type="punctus-medius">·</pc>
Alternative examples that do not write the glyphs explicitly but only encode their presence:
<pc type="pilcrow"/>
<pc type="virgula"/>
<pc type="punctus"/>
<pc type="punctus-elevatus"/>
<pc type="punctus-interrogativus"/>
<pc type="punctus-medius"/>
lb is a milestone element used to mark line breaks in a material witness to the edition in question. lb elements are used to indicate the start of a new line.
@ed MUST indicate the source text in which the line break occurs.@n MAY be used to indicate the line number.<lb n="1"/> line content word<lb n="2" break="no">break
new line content
<lb n="3"> new line content
<lb n="4"> new line content
<lb n="5"> new line content
cbcb is a milestone element used to mark column breaks in a material witness to the edition in question. cb elements are used to indicate the start of a new column.
@ed MUST indicate the source text in which the column break occurs.@n MUST be used indicate the start of the column in question, e.g. “a” or “b”.<cb ed="#W" n="a"/>
pbpb is a milestone element used to mark page breaks in a material witness to the edition in question. pb elements are used to indicate the start of a new page.
@ed MUST indicate the source text in which the page break occurs.@n MUST indicate the page or folio number (determined by @type). In the case of type="folio", the side of the folio is delimited by a -.
@type MAY explicitly indicate the type of numbering as either paginated (“page”) or foliated (“folio”). If none is given, @type="folio" is assumed.- is used in the value of @n, folio is assumed.- appears in the value of @n, type page is assumed.Page break in folio format
<pb ed="#W" n="15-v"/>
Page break in paged format
<pb ed="#W" n="15" type="page" />
Marginalia in a material witness are encoded using the element note@type='marginal-note'
note MUST have an @type='marginal-note'.note MUST have an @place attribute.note MAY have contain lb elements to indicate the line breaks of the marginal note.
//note//lb when attempting to count the lines in a main column.Example where marginal note is simply in the vicinity of a paragraph or line.
<p>
<lb ed="#A"/>
<note type="marginal-note" place="margin-right" hand="#N1">
<lb ed="#A"/>this marginal note
<lb ed="#A"/>is in the right margin
<lb ed="#A"/>and spans three lines in the margin
</note>
The main text is here and
<lb ed="#A"/>there is a marginal note
<lb ed="#A"/>in the margin near
<lb ed="#A"/>this line. And now the text continues.
</p>
Example where a marginal note is made about a word or phrase in the text, such as in a gloss.
<p>
<lb ed="#A"/>The word
<seg>fides
<note type="marginal-note" place="margin-right "hand="#N1">
<lb ed="#A"/>this is a gloss on the
<lb ed="#A"/>word fides that spans
<lb ed="#A"/>three lines
</note>
</seg>
this is still part of the first line
<lb ed="#A"/>more lines continue
<lb ed="#A"/>in the margin near
<lb ed="#A"/>this line. And now the text continues.
</p>
Example where a marginal note is best seen as a note about a quotation in the text.
<p>
<lb ed="#A"/>Augustine says
<quote>the commonwealth is united by a common love
<note type="marginal-note" place="margin-right" hand="#N1">
<lb ed="#A"/><ref>Augustine, City of God</ref>
</note>
</quote>
this is still part of the first line of the main text,
<lb ed="#A"/> and this is then a new line in the main text
</p>