View source for Transcription: annotations (Mondrian)


==Explanatory notes==

For the preferred mechanism of placing notes, see [[Annotation and indexing]].
For Mondrian, the type of editorial notes that we distinguish are 'source', 'explanation', 'bibiliography'. 

==Recurring annotation==

See [[Secondary files (Mondrian)#Recurring notes to persons and other subjects|Recurring notes to persons and other subjects]].

==<rs>==

Referencing string. Into <rs> are encoded names, with attributes, so they can be easily identified (i.e. You have different spellings of the same person's name and you want that they point to the same person), retrieved, indexed.
* '''@type'''	kind of entity encoded (i.e. Person, exhibition, museum, journals, location, etc). The available types have been defined in the schema
* '''@ref'''		to indicate an external url (RDKarchive url)
* '''@key'''	a coded value that identifies the entity encoded (i.e. a number, a normalised spelling, etc.) We prefer to use @key rather than @ref. 

It is possible to use multiple values in the key or ref attributes. 

In the postal data (transcription of envelope) we don’t use <rs> to index the addressee, as his role is known from the letter metadata. Similarly, we don’t index persons saluted at the beginning or end of a letter, if these are addressees. (But we do tag ‘Jan’ in ‘Give my love to Jan’ if Jan is not an addressee). 

When encoding a referring phrase as <rs>, we only tag the noun. This avoids potential problems with other words that need their own encoding. 

Not: 
<pre>
<rs>the woman who lives next door</rs>
</pre>
but
<pre>
the <rs>woman</rs> who lives next door
</pre>

In the case of multiple references to a person within  a single paragraph, we encode each of them. 

==References==

The element <ref> points to another resource and it is used for instance when a letter, a painting or another resource is mentioned in the text. @target provides the resource location (local or not). 

<ref> is also used for pointing to the [[Secondary files (Mondrian)|bibliography]]. For example:
<pre>
... as mentioned in <ref target="biblio.xml#Andersen1861">Andersen 1861</ref>, we ...
</pre>
Here, 'Andersen1861' should be an entry in the bibliography.


==See also==
* [[Transcription: structure (Mondrian)]]
* [[Transcription: representation of the source (Mondrian)]]
* [[Transcription (Mondrian)]]

[[Category:XML Mondrian]]