Guidelines for XML file uploads to Stemmaweb

Guidelines for TEI parallel segmentation input

The Stemmaweb uploader can accept a collated text tradition in TEI parallel-segmentation format that adheres to the following guidelines:

The file must have a <sourceDesc> element in its header which contains a list of all witnesses used in the text in the <listWit> element. Each <witness> element within <listWit> must have an xml:id attribute; this is taken to be the witness sigil, and is expected to appear in the "wit" attribute of the relevant apparatus readings within the text.
Individual reading words may be wrapped in <w> tags; if the tag has an xml:id it will be preserved as the reading ID.
All text within the main <text> element of the TEI file will be taken to be part of the collation. Paragraph and line divisions are not currently preserved.
At the point where any witness appears in the collation, this should be signified with a <witStart> tag within its own apparatus. The first of these will therefore be the first element in any collated text, for example:
```
      	<body>
            <p xml:id="am_1_1">
              <app xml:id="AppStart">
                <rdg wit="#Jer #K #A #F #B #I #D #J #O #V #X #Y #Z #W"><witStart/></rdg>
              </app>
            [...]
            </p>
      	</body>
      	
```
Likewise, when a witness text ends this should be noted with a <witEnd> tag. Lacunae within the text may be indicated through successive uses of the <witEnd> and <witStart> tags.

Readings as they appeared before scribal corrections may be indicated using the "type" attribute on the <rdg> element, as shown here:

              <app xml:id="App530">
                <lem wit="#Jer #K #F #B #I #A #D #J #O #V #X #Y #Z #W">
                  <w xml:id="L414">զոր</w>
                </lem>
                <rdg type="a.c." wit="#B"><w>զո</w></rdg>
              </app>

An apparatus entry may contain the <lem> tag as well as the <rdg> tag; these are treated as equivalent for the purpose of creating the graph.

Guidelines for Classical Text Editor export

The Stemmaweb uploader can accept a collated text tradition exported from CTE, provided that certain guidelines are observed:

Common abbreviations (e.g. 'om.', 'add.', and the like) should be set correctly via the Format -> Document... menu under the General tab. Any other abbreviations or notes are likely to be interpreted as literal readings by the uploader.
Avoid notations such as "tr. post word"; this is difficult to parse even for a human and almost impossible for a computer.
Be extremely careful with overlapping apparatus entries; if, for example, a pair of entries reads:
```
      		dominus deus] tr. A
      		deus] deo A
      		
```
then you are simultaneously telling CTE that A reads "deus dominus" and "deo dominus", and the export will become confused. Ensure that there is no scope for confusion.
Ensure that the critical apparatus (and the apparatus siglorum, if any) is marked as such via the Format -> Notes/Apparatus settings menu.
Ensure (via the menu item Options -> Preferences, under the 'XML' tab) that the 'Apparatus export' option is set to "<app> tags".

Stemmaweb Help - XML upload guidelines

Guidelines for TEI parallel segmentation input

Guidelines for Classical Text Editor export