View source for Text structure (ePistolarium)

== Basic structure ==

The documents in the ePistolarium have the following basic structure:

<pre>
<text>
<body>
<div xml:id="div-1" type="artifact" subtype="letter">
...
</div>
<div xml:id="div-2" type="para">
...
</div>
<div xml:id="div-3" type="notes">
...
</div>
</body>
</text>
</pre>

The <code>text</code> and <code>body</code> elements serve as a container for the actual text. The TEI Guidelines allow for <code>front</code> and <code>back</code> elements as siblings of <code>body</code>, but these are not used.

The <code>type</code> attribute of the <code>div</code> element is used to distinguish between various parts of the text, the most important ones being <code>artifact</code> for the 'real' letter text and <code>notes</code> for the text of (editorial) notes.


== Subsections ==

A <code>div</code> element may contain other <code>div</code> elements, which is often used in combination with a <code>head</code> element.

Example: https://correspondence.huygens.knaw.nl/documents/920e5785-62d4-4108-b126-8caa1df370b8
(subdivisions)

<pre>
<div type="artifact" subtype="letter">
<div type="section">
<head>Propositio 5.</head>
<p><figure><graphic url="huyg003oeuv01ill19.gif"/></figure></p>
<p>Si il y a tant de gravitez qu'on veut ...</p>
</div>
<div type="section">
<head>Propositio 6.</head>
<p><figure><graphic url="huyg003oeuv01ill20.gif"/></figure></p>
<p>Eadem methodo probatur si ...</p>
</div>
...
</div>
</pre>


== Headings ==

The <code>head</code> element is used to encode any type of heading, for example the title of a section, or the heading of a list, etc.

Example: see the description of subsections above.


== Paragraphs ==

Paragraphs are encoded with the <code>p</code> element. In the ePistolarium the <code>p</code> element only occurs in <code>div</code> elements. The elements are not allowed to be nested, that is, a <code>p</code> element in a <code>p</code> element is not allowed. Note that this is much stricter than allowed by the TEI Guidelines. The reason for the restriction is that some analysis methods used by the ePistolarium use the paragraph as unit of analysis.


== Segments ==


The <code>seg</code> element is used to encode text segments. In the ePistolarium they are used for various purposes: attaching language assignments to parts of a paragraph, encoding inline notes.

Example: https://correspondence.huygens.knaw.nl/documents/f687c50b-6765-4519-bc5f-833c499ae453
(language assignment)

<pre>
<div xml:lang="fr" type="artifact" subtype="letter">
<p><seg xml:lang="nl">Op mijn brief over uw zoon schrijft de hertog van Bouillon mij terug:</seg> ‘Je vous supplie d'asseurer Mr. Junius que je me gouverneray tousjours aveq son fils comme je doibs, sans luy tesmoigner jamais aucune rigueur, ni mauvais traictement, n'en prenant à tesmoin que Mr. Meteren, qui a veu comme j'y ay procedé et comme je ne me suis jamais pleu à parler de son affaire. Mais les discours de raillerie qu'en faisoyent les enemis et le murmure de la garnison m'ont obligé d'en user comme j'ay faict, remettant le tout à S. Ex.<hi rend="superscript">e</hi>.’</p>
<p xml:lang="nl">Het is dus beter, dezen edelman niet te verbitteren door zijn gedrag openlijk af te keuren; er wordt al te veel gebabbeld door kwaadwillige menschen. 28 Jull. 1634.</p>
</div>
</pre>

Note that in this example "Op mijn brief ..." is explicitly assigned language Dutch, whereas the text "‘Je vous supplie d'asseurer ..." is implicitly assigned French because of the presence of the <code>xml:lang="fr"</code> attribute of the <code>div</code> element.


Example: https://correspondence.huygens.knaw.nl/documents/3ec37404-3be4-4f98-8bdc-02cf100da36d
(inline notes)

<pre>
<div type="para">
<p><seg type="note">Adres:</seg> (A Mon)sieur Monsieur Grotius à Paris.</p>
<p><seg type="note">In dorso schreef Grotius:</seg> 6 Jan. 1629 N. Reigersberg.</p>
</div>
</pre>