XML - User contributions [en]

Secondary files (MVN)

2017-02-15T13:11:09Z

ASC:

The secondary files of the MVN project consist of at least the [[Introduction (MVN)|introduction]] in Wordpress, a bibliography and a set of all digital pictures of the manuscript, preferably the complete set. The introduction and bibliography are not part of the TEI/XML file with the transcription of the text, but will be delivered in Wordpress.

==See also==
* [[Secondary files]]
* [[XML MVN Guidelines]]

XML MVN Guidelines

2017-02-15T13:08:09Z

ASC:

De richtlijnen voor digitale diplomatische edities in de reeks Middeleeuwse Verzamelhandschriften uit de Nederlanden van het Huygens ING.

==Inleiding==
In het tegenwoordige onderzoek van de oudere literatuur heeft de traditionele esthetische visie plaatsgemaakt voor een historische benadering. Zag de literatuurwetenschap voorheen de literatuur in de eerste plaats als een vorm van kunst die de taal als uitdrukkingsmiddel gebruikt, nu bekijkt ze de literatuur vooral ook als een cultuurhistorisch verschijnsel. Daardoor gaat de aandacht niet alleen uit naar de tekst zoals de scheppende kunstenaar hem bedoeld heeft, maar ook naar de tekst zoals die concreet overgeleverd is en gefunctioneerd heeft. Afzonderlijke teksten worden bestudeerd in het verband waarin ze in de middeleeuwse handschriften geplaatst zijn. Daarbij komen ook teksten aan bod die uit literair-esthetisch oogpunt minder groots, fraai of kunstig zijn, zoals artesliteratuur, geestelijk proza, gebruiksteksten en de kleine vormen in het algemeen. Ook komen zo spreukenverzamelingen, liedbundels, compilaties en andere vaste verbanden in het vizier, kortom overleveringsgehelen die het niveau van de afzonderlijke teksten overstijgen. Deze literaire verschijnselen konden moeilijk geplaatst worden in de literair-esthetische opvatting van literatuur als oorspronkelijke schepping van een groot kunstenaar.
De auteur zal met zijn oeuvre altijd een belangrijk uitgangspunt en brandpunt van het letterkundig onderzoek blijven. Er zal dan ook behoefte blijven aan uitgaven die de oorspronkelijke tekst van de auteur trachten te reconstrueren. De cultuurhistorische visie op literatuur vraagt daarnaast om uitgaven die de concrete historische vorm weergeven waarin teksten (voor)gelezen en gebruikt werden. Verzamelhandschriften bieden vele invalshoeken voor dergelijk onderzoek. Deze materieel-tekstuele eenheden stellen het historische verband van de overlevering in de plaats van tekstkeuzen die gewoonlijk gebaseerd zijn op moderne, a-historische, vaak literair-esthetische overwegingen. Wanneer de literatuurwetenschap verzamelhandschriften als een van haar uitgangspunten neemt, verplicht ze zich ook aandacht te schenken aan de minder fraaie literatuur en aan de concrete context waarin de teksten indertijd geplaatst werden. Deze nog altijd actuele overwegingen vormden in 1994 de motieven voor de uitgave van middeleeuwse verzamelhandschriften uit de Nederlanden.

Mede door de uitgave van een reeks delen is de discussie over wat wij onder een verzamelhandschrift dienen te verstaan, goed op gang gekomen. Het oorspronkelijke uitgangspunt dat een verzamelhandschrift een codex is die van meet af aan als materiële eenheid bedoeld is en waarin tenminste twee teksten zijn bijeengebracht, bleek, hoewel in de grond niet onjuist, toch bepaalde nuancering te behoeven. Reflectie op dit onderwerp door verscheidene onderzoekers heeft tot een preciesere conceptualisering van het begrip verzamelhandschrift geleid, een begrip waarachter in feite een veelheid aan historische verscheiningsvormen van de middeleeuwse codex schuilgaat. [nadere invulling door Hans Kienhorst?]
Ondanks deze formele beschrijving van het begrip ‘verzamelhandschrift’ heeft deze reeks zich tot dusverre altijd in de eerste plaats gericht op handschriften waarvan het verzamelkarakter op de voorgrond treedt. Bekende voorbeelden zijn het in de reeks opgenomen handschrift-Van Hulthem en het Comburgse handschrift, die hoewel ze verzamelhandschriften van volkomen verschillende aard zijn, toch juist het verzamelaspect gemeenschappelijk hebben. Ook voor toekomstige uitgaven zal bij voorkeur worden gekozen voor in dit opzicht vergelijkbare handschriften.
Het doel van de reeks diplomatische uitgaven is op korte termijn verantwoorde grondslagen te bieden voor literair-historisch, taalkundig of ander onderzoek van middeleeuwse teksten in de context waarin ze indertijd overgeleverd zijn. Het gaat er hier vooral om materiaal te leveren voor diepgaande studies en niet zozeer om afgeronde resultaten van dergelijke studies te presenteren. De uitgaven zullen (voor zover dat bij diplomatische uitgaven mogelijk is) vlot leesbaar zijn, echter zonder filologische en cultuurhistorische aantekeningen, die immers gedegen en langdurig vooronderzoek vergen.
De diplomatische editie kan snel op ontwikkelingen in het onderzoek inspelen doordat zij in verhouding weinig onderzoek vereist. En ‘snel’ betekent in dit verband niet kortstondig of vluchtig. De diplomatische editie is immers geen voorlopige of lagere vorm van tekstuitgave. Als basisvorm van de uitgave blijft zij de hechte grondslag voor verdere studie en eventuele verdere, tekstkritische uitgaven. Zij bevat minder elementen die snel kunnen verouderen dan de kritische edities die voorzien zijn van uitgebreide filologische apparaten en letterkundige inleidingen. De combinatie van relatieve snelheid en grote duurzaamheid waren aanvankelijk de motieven om de methode van de diplomatische uitgave te verkiezen voor deze reeks en deze gelden nog steeds.

In de inleiding op de tekstuitgave wordt dezelfde doelmatigheid nagestreefd. Uitsluitend die informatie wordt gegeven die op het uitgegeven handschrift betrekking heeft. Hierbij wordt bijzondere aandacht besteed aan de materiële, codicologische aspecten van het verzamelhandschrift dat uitgegeven wordt.
Nadat in de editiereeks Middeleeuwse Verzamelhandschriften uit de Nederlanden (MVN) een aantal publicaties in boekvorm verscheen, is binnen de projectcommissie de behoefte ontstaan om voortaan naast uitgaven in boekvorm ook edities in digitale vorm te publiceren. Met de digitalisering en beschikbaarstelling van het eerste deel uit de MVN-reeks, Het Geraardsbergse handschrift, werd in 2003, bij wijze van proef, een nieuwe weg ingeslagen. Om een zo groot mogelijke duurzaamheid te waarborgen werd besloten de digitale edities in te richten in XML-formaat. Voor de codering van de teksten kon worden aangesloten bij de standaarden die werden ontwikkeld door het Text Encoding Initiative (TEI Guidelines, versie P5). Slechts in gevallen waarin de aanbevelingen van het TEI niet voorzagen moest worden gezocht naar specifieke oplossingen voor coderingsvraagstukken.

Deze richtlijnen zijn allereerst bestemd voor editeurs die van plan zijn een deel te vervaardigen in de MVN-reeks. Ze zullen tevens als uitgangspunt dienen bij de vervaardiging van een digitale werkomgeving waarin veel van de XML-codering onzichtbaar kan blijven voor de terzake minder ervaren editeur.
De basis van een MVN-editie wordt gevormd door een diplomatische uitgave van de teksten uit een handschrift. In een nieuw op te zetten reeks zullen ook kritische edities worden uitgebracht. Vooralsnog is het de bedoeling om de kritische edities in boekvorm te laten verschijnen en de digitale vorm voor te behouden aan de diplomatische uitgaven. Dit sluit overigens niet uit dat diplomatische uitgaven in bepaalde gevallen ook in boekvorm kunnen verschijnen. In elk geval zal aan elke editie, of ze nu alleen digitaal of ook als boek verschijnt, een XML-bestand ten grondslag liggen. In deze richtlijnen wordt getoond hoe een MVN-editie gestalte krijgt als XML-bestand.
Voor kritische uitgaven zijn afzonderlijke richtlijnen beschikbaar.

De voorbeelden in dit document gebruiken de XML-syntax. In het algemeen illustreren ze echter conceptuele vragen over de opbouw van de editie. Van toekomstige editeurs wordt niet noodzakelijkerwijs diepgaande vertrouwdheid verwacht met de XML-syntax.

Een opmerking nog over de programma’s die gebruikt kunnen worden bij de vervaardiging van een digitale MVN-editie. In beginsel wordt er aan editeurs een werkomgeving aangeboden binnen de XML-editor Oxygen. Natuurlijk is het ook mogelijk om te werken met andere programma’s, voorwaarde is echter wel dat deze weten om te gaan met Unicode.

==Wat is een diplomatische uitgave?==
Onder diplomatische uitgave wordt hier een editie verstaan waaraan slechts één handschrift ten grondslag ligt en waarin de tekst en alle verdere grafische informatie weergegeven worden in overeenstemming met dit handschrift. Daarbij wordt niet gestreefd naar een typografische imitatie van het handschrift, maar naar een functionele weergave van de tekst. De functie van alle lettervormen en overige grafische verschijnselen uit het handschrift die de structuur en de betekenis van de tekst tot stand brengen, wordt zodanig gecodeerd dat er een typografische weergave in een webbrowser mogelijk wordt. Een belangrijke kanttekening hierbij is dat dezelfde grafische verschijnselen in het ene geval tot de tekst kunnen behoren en in het andere geval tot de esthetische en functionele aspecten van de tekstopmaak. Zo kan de kopiist een regel wit laten omdat hij onderaan de kolom niet aan een nieuwe tekst wil beginnen, terwijl hij elders bij het tekstbegin geen regel blanco laat. Zo’n witregel is in dat geval eerder een zaak voor de codicoloog-paleograaf dan voor de filoloog-tekstediteur.

Hoewel het uitgangspunt van de reeks een diplomatische uitgave is, kan het voorkomen dat de editeur - in overleg met de commissie - besluit dat kritische ingrepen nodig zijn. Zie daarvoor de pagina over [[Critical interventions|kritische ingrepen]].

==De onderdelen van een digitale MVN-editie==
Een editeur van een digitale MVN-editie vervaardigt de volgende onderdelen:
* Een XML-bestand met de transcriptie van de uitgegeven tekstverzameling;
** De [[TEI Header (MVN)|<teiHeader>]] van het bestand met daarin de meta-informatie;
** Het [[Transcription (MVN)|<text>]]-element met daarin de eigenlijke inhoud van het document;
* Een Wordpress met het voorwerk, de inleiding en het bijwerk;
* Een set digitale foto's van het uitgegeven handschrift. Indien mogelijk wordt een complete set aangeleverd.
De inhoud van de twee XML-bestanden komt tot op zekere hoogte overeen met het onderscheid in de gedrukte delen tussen het deel van het boek met de diplomatische weergave van de teksten uit het handschrift en het overige deel van de editie. Verschillen zijn onder meer de plaats van de Verantwoording van de editie, die nu is opgenomen in de het bestand met de transcriptie en de Registers, die nu zijn gïntegreerd in het transcriptiedeel.

==Zie ook==
* [[Introduction (MVN)]]
* [[TEI Header (MVN)]]
* [[Transcription (MVN)]]
* [[Secondary files (MVN)]]

[[Category:XML MVN]]

Secondary files (MVN)

2017-02-15T13:07:39Z

ASC: Created page with "The secondary files of the MVN project consist of the introduction, a bibliography and a set of all digital pictures of the manuscript, preferably the c..."

The secondary files of the MVN project consist of the [[Introduction (MVN)|introduction]], a bibliography and a set of all digital pictures of the manuscript, preferably the complete set.

==See also==
* [[Secondary files]]
* [[XML MVN Guidelines]]

Secondary files (Mondrian)

2017-02-15T13:03:45Z

ASC:

==Bibliography==

The bibliography is stored in a file called biblio.xml. It is divided into one or more listBibl elements that contain the bibl elements that describe the bibliographical items.

<bibl> elements have an xml:id attribute that can be used to point to the item. Titles are tagged as <title>. The @level attribute on the titles is used to indicate whther the titles refers to an article, monography, series or journal.

Example:
<pre>
<bibl xml:id="VanTilborgh2007">Tilborgh, Louis van, <title level="a">Van Gogh in Cormon’s studio: a chronological puzzle</title>, in <title level="m">Current issues in 19th-century art</title>. <title level="s">Van Gogh Studies</title> 1. Zwolle and Amsterdam 2007, pp. 52-71.</bibl>
</pre>

==Introduction==

Stored in intro.xml. Uses TEI Lite.

==Recurring notes to persons and other subjects==

Stored in notes.xml.

Is divided into one or more sections (<div>s). Each note is its own div within these sections. It has an @xml:id attribute that can be pointed to from elsewhere. The note may have a <head> and can consist of multiple paragraphs.

In the letter texts and notes references to these notes can be made using <seg> elements with an @ana attribute.

Example:
<pre>
in notes.xml:
<div>
<head>Notes about persons</head>
<div xml:id="vandoesburg">
<head>Theo van Doesburg</head>
<p>Van Doesburg was een kunstenaar .... Mondriaan leerde hem kennen op .... Hun correspondentie strekte zich uit over ...</p>
<p>Nog een alinea</p>
</div>

</div>
</pre>

In the letter xml:
<pre>Over <seg ana="notes.xml#vandoesburg"><rs type="person" key="23481">Van Doesburg</rs></seg> is bekend dat</pre>

Note that Van Doesburg is here encoded using both <seg> and <rs>.

==See also==
* [[Secondary files]]
* [[XML Mondrian Guidelines]]

[[Category:XML Mondrian]]

Secondary files

2017-02-15T13:03:20Z

ASC:

The secondary files consist of everything that does not include the actual text, for example the introduction and bibliography of the edition. Some project specific secondary files are the recurring notes to persons and other subjects for the Mondrian project and the digital set of pictures of the manuscript for the MVN project.

==See also==
* [[Secondary files (Mondrian)]]
* [[Secondary files (MVN)]]
* [[XML Huygens]]

[[Category:XML Huygens]]

[[Category:XML Huygens]]

Secondary files

2017-02-15T11:39:39Z

ASC:

- MVN: Een set digitale foto's van het uitgegeven handschrift. Indien mogelijk wordt een complete set aangeleverd
- Mondrian: ,,, [nog maken]

[[Category:XML Huygens]]

Translation

2017-02-15T11:39:03Z

ASC:

If there is international interest for a certain text or project, it is possible to translate the source text to English or another language as a supplement to the diplomatic transcription of the text. It is also possible that the source text itself is in a foreign language and that there is need for a translation to Dutch.

A translation is considered a part of the <text> element. It can be encoded as a <div type=”translation”> that follows the original text of the source.

==See also==
* [[XML Huygens]]

[[Category:XML Huygens]]

Translation

2017-02-15T11:38:37Z

ASC:

Translation

2017-02-15T11:38:28Z

ASC:

If there is international interest for a certain text or project, it is possible to translate the source text to English or another language as a supplement to the diplomatic transcription of the text. It is also possible that the source text itself is in a foreign language and that there is need for a translation to Dutch.

A translation is considered a part of the <text> element. It can be encoded as a <div type=”translation”> that follows the original text of the source.


==See also==
* [[XML Huygens]]

[[Category:XML Huygens]]

Annotation and indexing

2017-02-15T11:27:51Z

ASC:

A digital edition in TEI provides the ability to encode each peculiarity within the text (source) in detail in the TEI file. It is, however, possible to – for example to achieve a faster result – deal with phenomena the traditional way by discussing them in an annotation, using the <note> element.

An empty <anchor/> element must be placed within the transcription, the element containing a @n attribute with a short keyword and a @type=”note”. Nest another <note> element with @n attribute in the <div type="notes" n="keyword" xml:lang="language"> element containing the text of the annotation. The @n must have the same value in both elements. All annotations within the same language must be incorporated within the same <div> element, and the notes should be arranged based on their location in the text. For example:

<pre>
<p>This is an exemple<anchor n=“nootje” type= “note”/> of how to create a note</p>

<div type=“notes” xml:lang=“en”>
<note n=“nootje”>This is the note</note>
… other notes in English…
</div>

<div type=“notes” xml:lang=“nl”>
<note n=“nootje”>Dit is de noot</note>
… other notes in Dutch …
</div>
</pre>

==See also==
* [[Transcription: annotations (MVN)]]
* [[Transcription: annotations (Mondrian)]]
* [[XML Huygens]]

[[Category:XML Huygens]]

Annotation and indexing

2017-02-15T11:25:58Z

ASC:

A digital edition in TEI provides the ability to encode each peculiarity within the text (source) in detail in the TEI file. It is, however, possible to – for example to achieve a faster result – deal with phenomena the traditional way by discussing them in an annotation, using the <note> element.

An empty <anchor/> element must be placed within the transcription, the element containing a @n attribute with a short keyword and a @type=”note”. Nest another <note> element with @n attribute in the <div type=”notes” n=”sleutelwoord” xml:lang=”taal”> element containing the text of the annotation. The @n must have the same value in both elements. All annotations within the same language must be incorporated within the same <div> element, and the notes should be arranged based on their location in the text. For example:

<pre>
<p>This is an exemple<anchor n=“nootje” type= “note”/> of how to create a note</p>

<div type=“notes” xml:lang=“en”>
<note n=“nootje”>This is the note</note>
… other notes in English…
</div>

<div type=“notes” xml:lang=“nl”>
<note n=“nootje”>Dit is de noot</note>
… other notes in Dutch …
</div>
</pre>

==See also==
* [[Transcription: annotations (MVN)]]
* [[Transcription: annotations (Mondrian)]]
* [[XML Huygens]]

[[Category:XML Huygens]]

Transcription

2017-02-15T11:25:17Z

ASC:

The transcription containing the actual text of the edition is encoded within a <text> element in the XML/TEI file. The structure of the text, the source of the text, required annotations and all other peculiarities are taken into account.

For the transcription of the manuscripts, the aim is to stay as close to the original text as possible. We focus on the production of diplomatic editions. This means that the edition is based on only one source and that the text and all graphic information will be displayed in accordance with this source. We don’t aspire a typographic imitation of the source, but aim for a functional reproduction of the text. As already stated, staying true to the text is key for the transcriptions. This means that deviations from the standard spelling and grammar are copied, changes made during writing - immediately or later - are documented, and if relevant, the physical structure of the source is reproduced.

==Structure of the text==
A text usually is not a ‘flat’ entity, but consists of different layer with their own hierarchy. These layers are reproduced within the XML file. The text of the edition is encoded in a <text> element, which contains a mandatory <body> element. The structure of a simple text would look as follows:
<pre>
<text>
<body>
<p>...</p>
</body>
</text>
</pre>
Other layers of the text can be encoded with the following elements (if so desired supplemented with an @type attribute to further specify them):
* '''<p>''' Paragraph;
* '''<ab>''' Anonymous block (an arbitrary unit of text, but without the semantic baggage of a paragraph);
* '''<div>''' Section (i.e. chapter, rubric or another kind of section);
* '''<head>''' Titles of chapters, headings etc.;
* '''<group>''' To indicate different textst within the transcription.

==Reproduction of the source==
To reproduce all characteristics of a text and its medium in the digital edition we use a number of standard XML elements:

* '''<add>''' Addition;
<pre>It is a <add>complete</add> text.</pre>
* '''<damage>''' Damage or text loss;
<pre><damage extent="whole leaf" agent="rubbing"> ... </damage></pre>
* '''<del>''' Deletion;
<pre>It is <del type=strikethrough>not</del> a complete text.</pre>
* '''<hi>''' Highlight (if you need to highlight something and then specify how it appears in the source);
<pre><hi rend="underline">This text is underlined</hi></pre>
* '''<restore>''' Used to mark an earlier deletion that is undone;
<pre><restore seq="2"><del seq="1">cocktail</del></restore>
<del seq="2"><add seq="1">drink</add></del>
</pre>
* '''<space>''' Empty lines, using dim="vertical" and the unit and quantity attributes to indicate the number of lines;
<pre><space dim="vertical" unit="lines" quantity="2"/></pre>
* '''<unclear>''' Uncertain reading of the text, for example due to damage;
<pre>A single <unclear>word</unclear> is hard to read.</pre>
* '''@rend''' This is one of the global attributes in TEI, so it is allowed with a lot of elements. It indicates how the element in question was rendered or presented in the source. The allowed values are defined in the schema;
* '''@place''' Indicates the location of (e.g.) an addition (above, below, margin, etc) or the closer;
* '''@type''' Used to classify or sort elements.

Different sources will contain different sorts of specialties, so the XML elements that encode these qualities of the text will vary to a certain extent per project.

==See also==
* [[Transcription (MVN)]]
* [[Transcription (Mondrian)]]
* [[XML Huygens]]

[[Category:XML Huygens]]

Transcription

2017-02-15T11:24:40Z

ASC:

The transcription containing the actual text of the edition is encoded within a <text> element in the XML/TEI file. The structure of the text, the source of the text, required annotations and all other peculiarities are taken into account.

For the transcription of the manuscripts, the aim is to stay as close to the original text as possible. We focus on the production of diplomatic editions. This means that the edition is based on only one source and that the text and all graphic information will be displayed in accordance with this source. We don’t aspire a typographic imitation of the source, but aim for a functional reproduction of the text. As already stated, staying true to the text is key for the transcriptions. This means that deviations from the standard spelling and grammar are copied, changes made during writing - immediately or later - are documented, and if relevant, the physical structure of the source is reproduced.

==Structure of the text==
A text usually is not a ‘flat’ entity, but consists of different layer with their own hierarchy. These layers are reproduced within the XML file. The text of the edition is encoded in a <text> element, which contains a mandatory <body> element. The structure of a simple text would look as follows:
<pre>
<text>
<body>
<p>...</p>
</body>
</text>
</pre>
Other layers of the text can be encoded with the following elements (if so desired supplemented with an @type attribute to further specify them):
* '''<p>''' Paragraph;
* '''<ab>''' Anonymous block (an arbitrary unit of text, but without the semantic baggage of a paragraph);
* '''<div>''' Section (i.e. chapter, rubric or another kind of section);
* '''<head>''' Titles of chapters, headings etc.;
* '''<group>''' To indicate different textst within the transcription.

==Reproduction of the source==
To reproduce all characteristics of a text and its medium in the digital edition we use a number of standard XML elements.

* '''<add>''' Addition;
<pre>It is a <add>complete</add> text.</pre>
* '''<damage>''' Damage or text loss;
<pre><damage extent="whole leaf" agent="rubbing"> ... </damage></pre>
* '''<del>''' Deletion;
<pre>It is <del type=strikethrough>not</del> a complete text.</pre>
* '''<hi>''' Highlight (if you need to highlight something and then specify how it appears in the source);
<pre><hi rend="underline">This text is underlined</hi></pre>
* '''<restore>''' Used to mark an earlier deletion that is undone;
<pre><restore seq="2"><del seq="1">cocktail</del></restore>
<del seq="2"><add seq="1">drink</add></del>
</pre>
* '''<space>''' Empty lines, using dim="vertical" and the unit and quantity attributes to indicate the number of lines;
<pre><space dim="vertical" unit="lines" quantity="2"/></pre>
* '''<unclear>''' Uncertain reading of the text, for example due to damage;
<pre>A single <unclear>word</unclear> is hard to read.</pre>
* '''@rend''' This is one of the global attributes in TEI, so it is allowed with a lot of elements. It indicates how the element in question was rendered or presented in the source. The allowed values are defined in the schema;
* '''@place''' Indicates the location of (e.g.) an addition (above, below, margin, etc) or the closer;
* '''@type''' Used to classify or sort elements.

Different sources will contain different sorts of specialties, so the XML elements that encode these qualities of the text will vary to a certain extent per project.

==See also==
* [[Transcription (MVN)]]
* [[Transcription (Mondrian)]]
* [[XML Huygens]]

[[Category:XML Huygens]]

Textual hierarchy

2017-02-15T10:59:45Z

ASC:

While encoding texts, the textual hierarchy is being taken into account. Every single text is encoded using the <text> element, which contains a mandatory <body> element. If so desired, any possible (hierarchical) substructure of the text can be encoded through <div> (‘division’) elements, each enclosing one or more <p> (‘paragraph’) elements and complemented with an @type attribute that describes what kind of division is meant.

The type of elements contained by the <text> depends on the type of text that is being encoded. For example, the text of prose usually consists of one or more <p> elements, whereas poetry consists of <lg> (‘line group’) elements that in itself enclose one or more <l> (‘line’) elements. Titles and such can be encoded with a <head> element.

Example:
<pre>
<text>
<body>
<div type="part">
<head>Opschrift</head>
<p>Tekst van onderdeel</p>
<div type="chapter" n="1">
<head>Opschrift</head>
<p>Tekst van hoofdstuk 1</p>
<div type="section" n="1.1">
<head>Tussenkop</head>
<p>Tekst van paragraaf 1.1</p>
</div>
<div type="section" n="1.2">
<head>Tussenkop</head>
<p>Tekst van paragraaf 1.2</p>
</div>
</div>
</div>
</body>
</text>
</pre>

==See also==
* [[Transcription: structure (MVN)]]
* [[Transcription: structure (Mondrian)]]
* [[XML Huygens]]

[[Category:XML Huygens]]

TEI Header

2017-02-15T10:58:57Z

ASC:

The <teiHeader> is a required component of the transcription file and contains metadata about the digital edition. It generally consists of the following elements:

* The <fileDesc>: the only mandatory component. It contains a bibliographic description of the digital edition;
* The <encodingDesc>, which describes the relation between the digital edition and its (material) source;
* The <profileDesc> containing classifying and contextual information about the text.

The <fileDesc> itself consists of three mandatory parts as well:
* A <titleStmt> with information about the <title>, <author> and/or <editor> of the text;
* A <publicationStmt> containing information about publication details;
* A <sourceDesc> with bibliographical details about the material source.

The smallest possible valid TEI Header looks like this:
<pre>
<teiHeader>
<fileDesc>
<titleStmt>
<title>

</title>
</titleStmt>
<publicationStmt>
<p>

</p>
</publicationStmt>
<sourceDesc>
<p>

</p>
</sourceDesc>
</fileDesc>
</teiHeader>
</pre>

Not every source of text requires the same type of information within the metadata, so the way in which the <teiHeader> is shaped depends on the type of source. It is therefore advisable to take a look at the Wiki page about the TEI Header of the relevant project.

==Zie ook==
* [[TEI Header (MVN)]]
* [[TEI Header (Mondrian)]]
* [[XML Huygens]]

[[Category:XML Huygens]]

Headings, subheaders, cues and cue headings

2017-02-15T10:26:56Z

ASC:

Opschriften worden gecodeerd door het element <head>, attribuut type en waarde ‘opschrift’. Als het opschrift/tussenkopje niet links uitgelijnd is maar gecentreerd op de regel in het handschrift staat, coderen we dat als <head rend="center">.
<pre>
<head type="opschrift" rend="center">Een vers jeghen gramscip</head>
</pre>
Een tussenkopje krijgt de waarde ‘tussenkop’:
<pre>
<head type="tussenkop">Hier naer volcht vanden kerstinen . Artuer</head>
</pre>

Clauskoppen in dialoog- of toneelteksten worden gecodeerd door middel van het <head> element met attribuut type en waarde ‘speech’.
Een <head>-element staat in XML overigens altijd aan het begin van een tekstuele eenheid.

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

[[Category:XML MVN]]

Headings, subheaders, cues and cue headings

2017-02-15T10:26:18Z

ASC:

Opschriften worden gecodeerd door het element <head>, attribuut type en waarde ‘opschrift’. Als het opschrift/tussenkopje niet links uitgelijnd is maar gecentreerd op de regel in het handschrift staat, coderen we dat als <head rend="center">.
<pre>
<head type="opschrift">Een vers jeghen gramscip rend="center"</head>
</pre>
Een tussenkopje krijgt de waarde ‘tussenkop’:
<pre>
<head type="tussenkop">Hier naer volcht vanden kerstinen . Artuer</head>
</pre>

Clauskoppen in dialoog- of toneelteksten worden gecodeerd door middel van het <head> element met attribuut type en waarde ‘speech’.
Een <head>-element staat in XML overigens altijd aan het begin van een tekstuele eenheid.

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

[[Category:XML MVN]]

Commentaar

2017-02-09T13:20:38Z

ASC:

Dankjewel voor wat al gedaan is.

Ik moet zelf kijken naar welke tekst precies waar hoort.

Wat je wel alvast nog zou kunnen doen:
* op de startpagina een korte inleiding en vervolgens een overzicht van de verschillende onderdelen, aan de hand van het plan voor de wiki, met hyperlinks, zodat alle onderdelen, direct of inderect, vanaf de startpagina bereikbaar zijn. '''x'''
* ook een pagina maken voor de opzet van de wiki zelf '''x'''
* categorie XML Huygens alleen voor de algemene stukken (onderdeel 1 uit het plan voor de wiki) (een categorie waar alle pagina's inzitten heeft geen zin); xml Mondriaan en MVN hoeven daar geen subcategorieen van te zijn. '''x'''
* ik heb een categorie [[:Category:svpvertalen|svpvertalen]] gemaakt voor pagina's die je alvast in het Engels zou kunnen zetten; als je dat gedaan hebt kun je de categorie verwijderen '''x'''

Set-up

2017-02-09T13:18:22Z

ASC:

==Basic principles==
* All documentation will be written in English.
* All documentation will be put into a wiki.
* All documentation contains as many copy-paste examples as possible.
* All documentation will refer to as many files illustrating and displaying the discussed phenomenon as possible.
* Due to the confidentiality of the AF project, and also because the project has almost come to an end, we temporarily won't involve AF.

==XML encoding at the Huygens ING==
Contains a systematical description of encoding, including descriptions on the reasons and backgrounds. Corresponding elements can be described together. The description must contain as much encoding examples as possible. The desired (general) reproduction will be described and illustrated as well. When possible, a live link to a working edition should be provided.

'''Content'''
# [[About XML|XML, XML schema’s, XML namespaces]]
# [[Subversion]]
# [[Global division of the XML/TEI file|Globale indeling XML/TEI bestand]]
# [[TEI Header]]
# [[Textual hierarchy|Teksthiërarchie]]
# [[Transcription|Transcriptie]]
# [[Annotation|Annotatie]]
# [[Translation|Vertaling]]
# Tekstvergelijking
# [[Secondary files|Secundaire bestanden]]

'''Maintained by''': Peter

'''Containing''':
* General parts of 'Encoding Mondrian'
* General parts of 'Afspraken codering dagboeken AF'
* General parts of 'Richtlijnen MVN digitaal'

'''Wiki''': [[XML Huygens]]

==XML encoding for specific project==
Every project will have its own document that shows where the project deviates from the common standard and that explains why certain choices are made. Can also contain more general considerations anticipating the justification for the final product.

'''Content''':
Contains interpretations and adaptations of the common agreements on XML endocing specific to the project, about for example:
* The number of XML files (1 file for the whole project, 1 file per letter etc.)
* Naming files
* Whether or not to use certain attributes
* Specific values of attributes

'''Maintained by''': Peter and the project leader of the specific project

'''Wikis''':
* [[XML Mondrian Guidelines]]
* [[XML MVN Guidelines]]

'''Containing''':
* Specific parts of 'Encoding Mondrian'
* Specific parts of 'Afspraken codering dagboeken AF'
* Specific parts of 'Richtlijnen MVN digitaal'
* Parts of 'Tekstbezorging en annotatie (Mondriaan)'

==Concrete encoding guideline==

'''Content''':
This document shows the intended encoding per textual phenomenon, including deviations for certain projects. Refers as much as possible to the systematic documents ([[Set-up#XML encoding at the Huygens ING]] and [[Set-up#XML encoding for specific project]]).

'''Maintained by''': everyone

'''Containing''':
* Instructions for transcription (Mondrian)

==Manuals==

'''Content''':
Manuals Subversion, oXygen, and any other possible tool.

'''Maintained by''': authors/everyone

'''Wikis''':
* [[Manual oXygen]]
* [[Manual Subversion]]

==Set-up XML documentation Huygens==

'''Content''':
* This page
* Manual maintained wiki pages

'''Maintained by''': Peter

==Ad hoc documents==
As far as they concern the use of XML.

'''Content''':
Marlein's stock-taking, 'Overzicht te coderen elementen' ('survey of elements that need to be encoded'), for example. An ad hoc document is no substitution for systematic documentation. In general, an ad hoc document will be temporary. It can be usefull to share the document with others.

==See also==
* [[Main Page]]

Set-up

2017-02-09T13:17:13Z

ASC:

==Basic principles==
* All documentation will be written in English.
* All documentation will be put into a wiki.
* All documentation contains as many copy-paste examples as possible.
* All documentation will refer to as many files illustrating and displaying the discussed phenomenon as possible.
* Due to the confidentiality of the AF project, and also because the project has almost come to an end, we temporarily won't involve AF.

==XML encoding at the Huygens ING==
Contains a systematical description of encoding, including descriptions on the reasons and backgrounds. Corresponding elements can be described together. The description must contain as much encoding examples as possible. The desired (general) reproduction will be described and illustrated as well. When possible, a live link to a working edition should be provided.

'''Content'''
# [[About XML|XML, XML schema’s, XML namespaces]]
# [[Subversion]]
# [[Global division of the XML/TEI file|Globale indeling XML/TEI bestand]]
# [[TEI Header]]
# [[Textual hierarchy|Teksthiërarchie]]
# [[Transcription|Transcriptie]]
# [[Annotation|Annotatie]]
# [[Translation|Vertaling]]
# Tekstvergelijking
# [[Secondary files|Secundaire bestanden]]

'''Maintained by''': Peter

'''Containing''':
* General parts of 'Encoding Mondrian'
* General parts of 'Afspraken codering dagboeken AF'
* General parts of 'Richtlijnen MVN digitaal'

'''Wiki''': [[XML Huygens]]

==XML encoding for specific project==
Every project will have its own document that shows where the project deviates from the common standard and that explains why certain choices are made. Can also contain more general considerations anticipating the justification for the final product.

'''Content''':
Contains interpretations and adaptations of the common agreements on XML endocing specific to the project, about for example:
* The number of XML files (1 file for the whole project, 1 file per letter etc.)
* Naming files
* Whether or not to use certain attributes
* Specific values of attributes

'''Maintained by''': Peter and the project leader of the specific project

'''Wikis''':
* [[XML Mondrian Guidelines]]
* [[XML MVN Guidelines]]

'''Containing''':
* Specific parts of 'Encoding Mondrian'
* Specific parts of 'Afspraken codering dagboeken AF'
* Specific parts of 'Richtlijnen MVN digitaal'
* Parts of 'Tekstbezorging en annotatie (Mondriaan)'

==Concrete encoding guideline==

'''Content''':
This document shows the intended encoding per textual phenomenon, including deviations for certain projects. Refers as much as possible to the systematic documents ([[Set-up#XML encoding at the Huygens ING]] and [[Set-up#XML encoding for specific project]]).

'''Maintained by''': everyone

'''Containing''':
* Instructions for transcription (Mondrian)

==Manuals==

'''Content''':
Manuals Subversion, oXygen, and any other possible tool.

'''Maintained by''': authors/everyone

==Set-up XML documentation Huygens==

'''Content''':
* This page
* Manual maintained wiki pages

'''Maintained by''': Peter

==Ad hoc documents==
As far as they concern the use of XML.

'''Content''':
Marlein's stock-taking, 'Overzicht te coderen elementen' ('survey of elements that need to be encoded'), for example. An ad hoc document is no substitution for systematic documentation. In general, an ad hoc document will be temporary. It can be usefull to share the document with others.

==See also==
* [[Main Page]]

Set-up

2017-02-09T11:41:06Z

ASC:

==Basic principles==
* All documentation will be written in English.
* All documentation will be put into a wiki.
* All documentation contains as many copy-paste examples as possible.
* All documentation will refer to as many files illustrating and displaying the discussed phenomenon as possible.
* Due to the confidentiality of the AF project, and also because the project has almost come to an end, we temporarily won't involve AF.

==XML encoding at the Huygens ING==
Contains a systematical description of encoding, including descriptions on the reasons and backgrounds. Corresponding elements can be described together. The description must contain as much encoding examples as possible. The desired (general) reproduction will be described and illustrated as well. When possible, a live link to a working edition should be provided.

'''Content'''
# [[About XML|XML, XML schema’s, XML namespaces]]
# [[Subversion]]
# [[Global division of the XML/TEI file|Globale indeling XML/TEI bestand]]
# [[TEI Header]]
# [[Textual hierarchy|Teksthiërarchie]]
# [[Transcription|Transcriptie]]
# [[Annotation|Annotatie]]
# [[Translation|Vertaling]]
# Tekstvergelijking
# [[Secondary files|Secundaire bestanden]]

'''Maintained by''': Peter

'''Containing''':
* General parts of 'Encoding Mondrian'
* General parts of 'Afspraken codering dagboeken AF'
* General parts of 'Richtlijnen MVN digitaal'

'''Wiki''': [[XML Huygens]]

==XML encoding for specific project==
Every project will have its own document that shows where the project deviates from the common standard and that explains why certain choices are made. Can also contain more general considerations anticipating the justification for the final product.

'''Content''':
Bevat projectspecifieke invullingen en aanpassingen van de algemene afspraken over XML-codering, bijvoorbeeld over:
Contains interpretations and adaptations of the common agreements on XML endocing specific to the project, about for example:
* The number of XML files (1 file for the whole project, 1 file per letter etc.)
* Naming files
* Whether or not to use certain attributes
* Specific values of attributes

'''Maintained by''': Peter and the project leader of the specific project

'''Wikis''':
* [[XML Mondrian Guidelines]]
* [[XML MVN Guidelines]]

'''Containing''':
* Specific parts of 'Encoding Mondrian'
* Specific parts of 'Afspraken codering dagboeken AF'
* Specific parts of 'Richtlijnen MVN digitaal'
* Parts of 'Tekstbezorging en annotatie (Mondriaan)'

==Concrete encoding guideline==

'''Content''':
Per tekstueel verschijnsel geeft dit document de bedoelde codering, met afwijkingen voor bepaalde projecten. Verwijst zoveel mogelijk naar de systematische documenten (1 en 2).

'''Maintained by''': everyone

'''Containing''':
Aanwijzingen transcriptie (Mondriaan)

==Manuals==

'''Content''':
Manuals Subversion, oXygen, en eventueel andere hulpmiddelen

'''Maintained by''': authors/everyone

==Opzet XML documentatie Huygens==

Inhoud:
Dit document
Handleiding onderhouden wiki-pagina’s

Onderhouden door: Peter

==Adhoc documenten==
Voor zover betrekking hebbend op gebruik XML.

Inhoud:
Zoals bijvoorbeeld Marlein’s inventarisatie, Overzicht te coderen elementen. Een ad-hoc document is geen vervanging voor systematische documentatie. In het algemeen zal een ad-hoc document tijdelijk van aard zijn. Het kan wel van belang zijn o het te delen met anderen.

Set-up

2017-02-09T11:33:22Z

ASC:

===Basic principles===
* All documentation will be written in English.
* All documentation will be put into a wiki.
* All documentation contains as many copy-paste examples as possible.
* All documentation will refer to as many files illustrating and displaying the discussed phenomenon as possible.
* Due to the confidentiality of the AF project, and also because the project has almost come to an end, we temporarily won't involve AF.

==XML encoding at the Huygens ING==
Contains a systematical description of encoding, including descriptions on the reasons and backgrounds. Corresponding elements can be described together. The description must contain as much encoding examples as possible. The desired (general) reproduction will be described and illustrated as well. When possible, a live link to a working edition should be provided.

'''Content'''
# [[About XM|XML, XML schema’s, XML namespaces]]
# [[Subversion]]
# [[Global division of the XML/TEI file|Globale indeling XML/TEI bestand]]
# [[TEI Header]]
# [[Textual hierarchy|Teksthiërarchie]]
# [[Transcription|Transcriptie]]
# [[Annotation|Annotatie]]
# [[Translation|Vertaling]]
# Tekstvergelijking
# [[Secondary files|Secundaire bestanden]]

'''Maintained by''': Peter

Containing:
* General parts of 'Encoding Mondrian'
* General parts of 'Afspraken codering dagboeken AF'
* General parts of 'Richtlijnen MVN digitaal'

'''Wiki''': [[XML Huygens]]

==XML encoding for specific project==
Every project will have its own document that shows where the project deviates from the common standard and that explains why certain choices are made. Can also contain more general considerations anticipating the justification for the final product.

'''Content''':
Bevat projectspecifieke invullingen en aanpassingen van de algemene afspraken over XML-codering, bijvoorbeeld over:
Contains interpretations and adaptations of the common agreements on XML endocing specific to the project, about for example:
* The number of XML files (1 file for the whole project, 1 file per letter etc.)
* Naming files
* Whether or not to use certain attributes
* Specific values of attributes

'''Maintained by''': Peter and the project leader of the specific project

'''Wikis''':
* [[XML Mondrian Guidelines]]
* [[XML MVN Guidelines]]

'''Containing''':
* Specific parts of 'Encoding Mondrian'
* Specific parts of 'Afspraken codering dagboeken AF'
* Specific parts of 'Richtlijnen MVN digitaal'
* Parts of 'Tekstbezorging en annotatie (Mondriaan)'

==Concrete codeerrichtlijn==

Inhoud:
Per tekstueel verschijnsel geeft dit document de bedoelde codering, met afwijkingen voor bepaalde projecten. Verwijst zoveel mogelijk naar de systematische documenten (1 en 2).

Onderhouden door: allen

Wat komt hierin:
Aanwijzingen transcriptie (Mondriaan)

==Handleidingen==

Inhoud:
Handleidingen Subversion, oXygen, en eventueel andere hulpmiddelen

Onderhouden door: auteurs/allen

==Opzet XML documentatie Huygens==

Inhoud:
Dit document
Handleiding onderhouden wiki-pagina’s

Onderhouden door: Peter

==Adhoc documenten==
Voor zover betrekking hebbend op gebruik XML.

Inhoud:
Zoals bijvoorbeeld Marlein’s inventarisatie, Overzicht te coderen elementen. Een ad-hoc document is geen vervanging voor systematische documentatie. In het algemeen zal een ad-hoc document tijdelijk van aard zijn. Het kan wel van belang zijn o het te delen met anderen.

Main Page

2017-02-09T10:56:39Z

ASC:

The Huygens ING wants to provide its editors with easily accessible, uniform guidelines for creating a digital edition. All guidelines are available on this Wiki. Besides general information and manuals for tools, the Huygens ING also offers detailed guidelines for every single project.

Every Wiki page links to one or more other pages that discuss a similar or relevant subject, and category pages contain all pages about one coordinating subject. All current information can be divided into the following categories:

===General===
* [[XML Huygens]]
* [[:Category:XML Huygens]]

===Manuals===
* [[Manual oXygen]]
* [[Manual Subversion]]
* [[:Category:Manuals]]

===Projects===
* [[XML Mondrian Guidelines]]
* [[:Category:XML Mondrian]]
* [[XML MVN Guidelines]]
* [[:Category:XML MVN]]

For more information about the further plans on uniformizing all guidelines, see the [[Set-up|set-up]] on XML documentation.

Set-up

2017-02-09T10:52:09Z

ASC: Created page with "===Uitgangspunten=== • Alle documentatie wordt geschreven in het Engels. • Alle documentatie komt in een wiki. • De documentatie bevat zoveel mogelijk knip-en-plakbare..."

===Uitgangspunten===
• Alle documentatie wordt geschreven in het Engels.
• Alle documentatie komt in een wiki.
• De documentatie bevat zoveel mogelijk knip-en-plakbare voorbeelden.
• De documentatie verwijst zoveel mogelijk naar bestanden waarin het betreffende verschijnsel wordt geïllustreerd, inclusief de weergave ervan.
• Vanwege de vertrouwelijkheid van het AF project, en omdat het project bijna is afgerond, laten we AF hier voorlopig buiten.

==XML-codering bij Huygens ING==
Hier gaat het om een systematische beschrijving van de codering, inclusief beschrijving van de redenen en achtergronden. Bijeenbehorende elementen kunnen samen worden beschreven. De beschrijving wordt zoveel mogelijk voorzien van codeervoorbeelden. De gewenste (algemene) weergave wordt hier ook beschreven, in tekst en voorzien van illustraties / live link naar de werkende editie als die beschikbaar zijn.

Inhoud
1. XML, XML schema’s, XML namespaces
2. Subversion
3. Globale indeling XML/TEI bestand
4. TEI header
5. Teksthiërarchie
6. Transcriptie
7. Annotatie
8. Vertaling
9. Tekstvergelijking
10. Secundaire bestanden

Onderhouden door: Peter

Wat komt hierin terecht:
algemene delen van Encoding Mondrian
algemene delen van Afspraken codering dagboeken AF
algemene delen van Richtlijnen MVN digitaal

==XML-codering bij specifiek project==
Per project komt er zo’n document. Het geeft aan waar een project van de algemene standaard afwijkt of de algemene standaard uitbreidt. De beschrijving is geeft ook een toelichting waarom bepaalde keuzen zijn gemaakt. Kan ook meer algemene overwegingen bevatten die vooruitlopen op de voor het eindproduct te schrijven verantwoording.

Inhoud
Bevat projectspecifieke invullingen en aanpassingen van de algemene afspraken over XML-codering, bijvoorbeeld over:
• aantal XML bestanden (1 bestand voor project of 1 bestand per brief, etc.)
• naamgeving van bestanden
• wel of niet te gebruiken attributen
• specifieke attribuutwaarden

Onderhouden door: Peter en PL van project

Wat komt hierin terecht:
Specifieke delen van Encoding Mondrian
Specifieke delen van Afspraken codering dagboeken AF
Specifieke delen van Richtlijnen MVN digitaal
Delen van Tekstbezorging en annotatie (Mondriaan)

==Concrete codeerrichtlijn==

Inhoud:
Per tekstueel verschijnsel geeft dit document de bedoelde codering, met afwijkingen voor bepaalde projecten. Verwijst zoveel mogelijk naar de systematische documenten (1 en 2).

Onderhouden door: allen

Wat komt hierin:
Aanwijzingen transcriptie (Mondriaan)

==Handleidingen==

Inhoud:
Handleidingen Subversion, oXygen, en eventueel andere hulpmiddelen

Onderhouden door: auteurs/allen

==Opzet XML documentatie Huygens==

Inhoud:
Dit document
Handleiding onderhouden wiki-pagina’s

Onderhouden door: Peter

==Adhoc documenten==
Voor zover betrekking hebbend op gebruik XML.

Inhoud:
Zoals bijvoorbeeld Marlein’s inventarisatie, Overzicht te coderen elementen. Een ad-hoc document is geen vervanging voor systematische documentatie. In het algemeen zal een ad-hoc document tijdelijk van aard zijn. Het kan wel van belang zijn o het te delen met anderen.

Commentaar

2017-02-09T10:47:29Z

ASC:

Dankjewel voor wat al gedaan is.

Ik moet zelf kijken naar welke tekst precies waar hoort.

Wat je wel alvast nog zou kunnen doen:
* op de startpagina een korte inleiding en vervolgens een overzicht van de verschillende onderdelen, aan de hand van het plan voor de wiki, met hyperlinks, zodat alle onderdelen, direct of inderect, vanaf de startpagina bereikbaar zijn. '''x'''
* ook een pagina maken voor de opzet van de wiki zelf
* categorie XML Huygens alleen voor de algemene stukken (onderdeel 1 uit het plan voor de wiki) (een categorie waar alle pagina's inzitten heeft geen zin); xml Mondriaan en MVN hoeven daar geen subcategorieen van te zijn. '''x'''
* ik heb een categorie [[:Category:svpvertalen|svpvertalen]] gemaakt voor pagina's die je alvast in het Engels zou kunnen zetten; als je dat gedaan hebt kun je de categorie verwijderen '''x'''

Main Page

2017-02-09T10:46:29Z

ASC:

The Huygens ING wants to provide its editors with easily accessible, uniform guidelines for creating a digital edition. All guidelines are available on this Wiki. Besides general information and manuals for tools, the Huygens ING also offers detailed guidelines for every single project.

Every Wiki page links to one or more other pages that discuss a similar or relevant subject, and category pages contain all pages about one coordinating subject. All information can be divided into the following categories:

===General===
* [[XML Huygens]]
* [[:Category:XML Huygens]]

===Manuals===
* [[Manual oXygen]]
* [[Manual Subversion]]
* [[:Category:Manuals]]

===Projects===
* [[XML Mondrian Guidelines]]
* [[:Category:XML Mondrian]]
* [[XML MVN Guidelines]]
* [[:Category:XML MVN]]

Main Page

2017-02-09T10:45:59Z

ASC:

The Huygens ING wants to provide its editors with easily accessible, uniform guidelines for creating a digital edition. All guidelines are available on this Wiki. Besides general information and manuals for tools, the Huygens ING also offers detailed guidelines for every single project.

Every Wiki page links to one or more other pages that discuss a similar or relevant subject, and category pages contain all pages about one coordinating subject. All information can be divided into the following categories:

===General===
* [[XML Huygens]]
* Category: [[:Category:XML Huygens]])

===Manuals===
* [[Manual oXygen]]
* [[Manual Subversion]]
* Category: [[:Category:Manuals]]

===Projects===
* [[XML Mondrian Guidelines]]
* Category: [[:Category:XML Mondrian]]
* [[XML MVN Guidelines]]
* Category: [[:Category:XML MVN]]

Commentaar

2017-02-09T10:08:39Z

ASC:

Dankjewel voor wat al gedaan is.

Ik moet zelf kijken naar welke tekst precies waar hoort.

Wat je wel alvast nog zou kunnen doen:
* op de startpagina een korte inleiding en vervolgens een overzicht van de verschillende onderdelen, aan de hand van het plan voor de wiki, met hyperlinks, zodat alle onderdelen, direct of inderect, vanaf de startpagina bereikbaar zijn.
* ook een pagina maken voor de opzet van de wiki zelf
* categorie XML Huygens alleen voor de algemene stukken (onderdeel 1 uit het plan voor de wiki) (een categorie waar alle pagina's inzitten heeft geen zin); xml Mondriaan en MVN hoeven daar geen subcategorieen van te zijn. '''x'''
* ik heb een categorie [[:Category:svpvertalen|svpvertalen]] gemaakt voor pagina's die je alvast in het Engels zou kunnen zetten; als je dat gedaan hebt kun je de categorie verwijderen '''x'''

XML MVN Guidelines

2017-02-09T10:08:22Z

ASC:

XML Mondrian Guidelines

2017-02-09T10:08:14Z

ASC:

De richtlijnen voor digitale edities in het Mondriaanproject van het Huygens ING.

==Inleiding==
Deze Wiki-pagina heeft ten doel de editietechnische uitgangspunten van de publicatie van de correspondentie en de theoretische geschriften van Mondriaan vast te leggen. Men denke daarbij aan de keuzes die gemaakt zijn bij het transcriberen, bij het emenderen van teksten ten behoeve van de leestekst, bij het onderzoek naar en schrijven van annotaties, en dergelijke.

Behalve ter verantwoording van de gehanteerde aanpak is dit document ook bedoeld als houvast voor editeurs en andere medewerkers van het projectteam.

Deze editie is een wetenschappelijke bronuitgave die kunsthistorici, studenten, kunstprofessionals, kunstliefhebbers en andere geïnteresseerden tot nut wil zijn. Omdat de belangstelling voor Mondriaan en zijn werk internationaal is, is gekozen voor het Engels als hoofdtaal; van brieven en teksten die oorspronkelijk in andere talen werden geschreven (hoofdzakelijk Nederlands en Frans, maar een enkele maal ook Duits), worden behalve de brontekst ook Engelse vertalingen geboden.

==De onderdelen van een digitale Mondriaan-editie==
Voor elke brief en voor elk geschrift wordt een afzonderlijk bestand gemaakt in xml (m.b.v. [[Manual oXygen|oXygen]]). Uiteindelijk zal de editie naar schatting 1650 briefbestanden en c. 75 geschriftbestanden omvatten (afgezien van andere commentaartekst). In de tekstbestanden wordt een transcriptie opgenomen; bijzonderheden worden door middel van xml-tags gemarkeerd. Deze transcriptie wordt verrijkt met emendaties (ten behoeve van de leestekst) en aangevuld met een vertaling in het Engels.
Elk briefbestand bevat de volgende drie hoofdsecties:
* '''<teiHeader>''' Bevat informatie over de tekstbron, metadata over de betreffende correspondenten en over het revisieproces van de editeurs.
* '''<facsimile>''' Bevat gegevens over en verwijzingen naar beeldbestanden van de facsimiles die bij de teksten oproepbaar zijn.
* '''<text>''' Bevat de tekst van de brief, zowel op de eventuele enveloppe als de eigenlijke brieftekst van aanhef tot slot, en de annotaties. (In een later stadium tevens de vertaling van de brieftekst.)
Deze drie secties worden verdeeld in kleinere componenten. De belangrijkste daarvan worden hieronder beschreven. Verscheidene van de genoemde elementen zijn verder onderverdeeld; sommige dienen te voldoen aan nadere specificaties, sommige zijn optioneel. De details hierover worden behandeld in ‘Encoding Mondrian’.

==Zie ook==
* [[TEI Header (Mondrian)]]
* [[Facsimile (Mondrian)]]
* [[Transcription (Mondrian)]]
* [[Secondary files (Mondrian)]]
* [[Project procedure (Mondrian)]]

[[Category:XML Mondrian]]

Commentaar

2017-02-09T10:07:46Z

ASC:

Dankjewel voor wat al gedaan is.

Ik moet zelf kijken naar welke tekst precies waar hoort.

Wat je wel alvast nog zou kunnen doen:
* op de startpagina een korte inleiding en vervolgens een overzicht van de verschillende onderdelen, aan de hand van het plan voor de wiki, met hyperlinks, zodat alle onderdelen, direct of inderect, vanaf de startpagina bereikbaar zijn.
* ook een pagina maken voor de opzet van de wiki zelf
* categorie XML Huygens alleen voor de algemene stukken (onderdeel 1 uit het plan voor de wiki) (een categorie waar alle pagina's inzitten heeft geen zin); xml Mondriaan en MVN hoeven daar geen subcategorieen van te zijn.
* ik heb een categorie [[:Category:svpvertalen|svpvertalen]] gemaakt voor pagina's die je alvast in het Engels zou kunnen zetten; als je dat gedaan hebt kun je de categorie verwijderen '''x'''

Category:XML MVN

2017-02-09T09:47:14Z

ASC:

All Wiki pages that belong to the guidelines for digital, diplomatic editions of the MVN series.

Category:XML Mondrian

2017-02-09T09:46:04Z

ASC:

All Wiki pages that belong to the guidelines for digital editions of the Mondrian edition project.

Subversion

2017-02-09T09:44:28Z

ASC:

The Subversion (or: SVN) repository is a central location on the network where we store files (XML files, for example). The idea behind a repository is that different people that work with the same files now have a central place that (1) always saves the latest version of the file and (2) will keep former versions available, to reconstruct the history of the file and reverse any possible mistakes. A repository is an alternative to emailing files back and forth.

In the XML Editor that we use, [[Manual oXygen|oXygen]], a Subversion client (a help program that can deal with the repository) is built in. We use this client to send files from the server to our own computers and back.

==See also==
* [[Manual Subversion]]
* [[XML Huygens]]

[[Category:XML Huygens]]

Category:Manuals

2017-02-09T09:39:06Z

ASC:

All manuals that are relevant to the digital projects of the Huygens ING.

Manual Subversion

2017-01-31T15:18:19Z

ASC: /* =See also */

De [[Subversion]] (ook: SVN) repository is een centrale lokatie op het netwerk waar we bestanden (bijvoorbeeld XML-bestanden) bewaren. In de XML Editor die we gebruiken, oXygen, zit een Subversion client ingebouwd, een hulpprogramma dat met de repository kan omgaan. We gebruiken die client om bestanden heen en weer te halen vanaf de server naar de eigen computer. In deze handleiding wordt beschreven hoe e.e.a. werkt.
De screenshots in deze handleiding zijn gebaseerd op oXygen 12.2.

==Terminologie en basiswerkwijze==

De repository is de centrale locatie op de server. Op de eigen PC wordt een werkkopie gemaakt van de repository, of een deel daarvan. Het maken van zo’n werkkopie heet uitchecken uit de repository. De bestanden in de werkkopie kunnen worden gewijzigd, en in ons geval zal dat meestal gebeuren met oXygen. Door het verversen van de werkkopie wordt de Subversion client er op geattendeerd dat er bestanden zijn gewijzigd. Dat is niet altijd nodig. Bij het openen van een werkkopie checkt de client sowieso of er bestanden zijn gewijzigd, toegevoegd of verwijderd in de werkkopie. Een gewijzigd bestand kun je terugzetten in de repository. Die handeling heet check in. Bij de check in wordt je gevraagd om een korte toelichting te geven.
Bij het dagelijks werk aan de bestanden zul je eerst de bestanden in je werkkopie updaten naar de laatste versie: je haalt dan uit de repository de laatste wijzigingen voor je bestanden. Vervolgens bewerk je de bestanden, en checkt de gewijzigde inhoud in. Voordat je verder werkt aan de bestanden kijk je altijd even of er nog wijzigingen zijn die door anderen zijn aangebracht (update).
Als meerdere mensen aan dezelfde bestanden werken, kan het probleem ontstaan dat meerderen hetzelfde bestand hebben uitgecheckt, tegelijkertijd wijzigingen aanbrengen, en die vervolgens willen inchecken. Bij de eerste gebruiker (in het plaatje hierna bij Sally) gaat dat goed; bij de tweede gebruiker (Harry) gaat het verkeerd. Hij krijgt een ‘out-of-date’-error. De oplossing is dat Harry eerst de wijzigingen van Sally in zijn versie incorporeert (update), en dan pas zijn wijzigingen terugschrijft naar de repository. Wanneer Sally’s wijzigingen in een ander deel van het bestand zijn dan die van Harry, zal het systeem in staat zijn om beide sets wijzigingen in Harry’s bestand aan te brengen. Na de update kan Harry alsnog inchecken (en kan Sally updaten om ook Harry’s wijzigingen binnen te krijgen).

[[File:Afb_1.1.png]]

Het is ook mogelijk dat het systeem de beide bestanden niet kan ‘mergen’, omdat de wijzigingen te dicht bij elkaar zitten. In dat geval markeert het Harry’s bestand als in conflict. Harry moet dan zelf het conflict oplossen: ervoor zorgen dat een versie van het bestand ontstaat waar aan beide wijzigingen recht wordt gedaan. Hierover verderop meer.

==De subversion client==

De oXygen Subversion client wordt gestart vanuit de editor, menu Extra, optie SVN-client. In de client wordt eerst (eenmalig) de repository gedefinieerd en een werkkopie aangemaakt. In het dagelijks gebruik worden met behulp van de SVN client de bestanden heen en weer gestuurd van en naar de server.
De client heeft meerdere ‘view’s. De belangrijkste views zijn de repositories view en de werkkopie view. Zie plaatje hierna:

[[File:Afb_3.jpg]]

==Het definiëren van een repository-locatie en het maken van een werkkopie==

Hiervoor activeren we de repositories view. Vervolgens definiëren we een nieuwe repositorylocatie, als volgt:

[[File:Afb_4.jpg]]

Geef vervolgens de gewenste netwerklocatie van de repository op:

[[File:Afb_5.jpg]]

En vul de juiste gebruiker en wachtwoord in (raadpleeg hiervoor eventueel Ramona):

[[File:Afb_6.jpg]]

De client definieert nu de repository locatie.

De volgende stap is het aanmaken van een werkkopie. Daarvoor selecteren we in de repository de gewenste map, doen een rechtermuisklik en kiezen voor ‘Check uit’:

[[File:Afb_7.jpg]]

Er wordt vervolgens gevraagd waar we de werkkopie op schijf willen opslaan:

[[File:Afb_8.jpg]]

Kies een map op de harde schijf van je PC. Na herhaaldelijk bevestigen wordt de inhoud van de map op schijf geplaatst. Nu heb je dus een eigen kopie van de bestanden uit de repository.

==De bewerking van bestanden==

Het bewerken van bestanden verloopt in een vaste cyclus:
* Update – haal de laatste wijzigingen van de server binnen
* Bewerk – breng de wijzigingen aan via de editor
* (evt.) Ververs – breng de SVN client van de wijzigingen op de hoogte
* Check in – breng de wijzigingen aan op de server
* Update – haal de laatste wijzigingen van de server binnen
* …

De update en check-in kun je op het niveau van een hele map doen, maar ook op het niveau van een enkel bestand.

Voor een update: rechtermuisklik en kies voor update:

[[File:Afb_9.jpg]]

Voor verversen: rechtermuisklik en kies voor Ververs:

[[File:Afb_10.jpg]]

Na het verversen toont de client door middel van een sterretje welke bestanden en mappen zijn gewijzigd:

[[File:Afb_11.jpg]]

Om de wijzigingen in te checken: rechtermuisklik op map of bestand en kies voor Check in:

[[File:Afb_12.jpg]]

Vul vervolgens een korte toelichting in (dan weet je nog een beetje wat er gebeurd is mocht je ooit de geschiedenis van een bestand moeten nagaan) :

[[File:Afb_13.jpg]]

Het systeem brengt nu de bestanden over naar de repository. De cyclus kan opnieuw beginnen.

==Het afhandelen van conflicterende wijzigingen==

Zoals aan de aanvang van dit document is toegelicht, is het mogelijk dat twee gebruikers eenzelfde bestand in onderhoud hebben. De eerste gebruiker checkt wijzigingen in, zonder probleem. Als de tweede gebruiker zijn wijzigingen incheckt, protesteert het systeem met een out-of-date message:

[[File:Afb_14.jpg]]

De oplossing is in het algemeen eenvoudig: de tweede gebruiker haalt alsnog de wijzigingen binnen van de server (d.m.v. Update) en kan daarna alsnog inchecken. Dit gaat echter alleen goed wanneer het systeem de beide sets wijzigingen kan samenvoegen. Wanneer het systeem dat niet kan, markeert het de versie van gebruiker twee als ‘in conflict’. Het ‘C’—icoontje op het plaatje hierna geeft aan dat het betreffende bestand in conflict-status is. Het systeem maakt een aantal extra bestanden om te helpen het probleem op te lossen. De bestanden met de extensie ‘.rnnnn’ geven de oude, ongewijzigde versie van het bestand en de nieuwste versie (volgens de repository). De versie ‘.mine’ geeft de versie met wijzigingen van gebruiker 2:

[[File:Afb_15.jpg]]

In het bestand met de originele naam (hier test.xml) zijn de conflicterende wijzigingen beide opgenomen:

[[File:Afb_16.jpg]]

Het is aan de gebruiker om deze conflicten op te lossen. Nadat de gewenste aanpassingen zijn aangebracht kan in de client worden aangegeven dat het conflict is opgelost. Het systeem ruimt dan de tijdelijke bestanden op, het bestand kan worden ingecheckt en ook door gebruiker 1 worden uitgecheckt:

[[File:Afb_17.png]]

Om deze situatie te vermijden is het wenselijk om af te spreken niet in dezelfde delen van een document te werken, en regelmatig (tenminste dagelijks, maar liever vaker) in te checken en te updaten.

==See also==
* [[Manual oXygen]]

[[Category:XML Huygens]]
[[Category:Manuals]]

Annotation and indexing

2017-01-31T15:16:50Z

ASC:

Een digitale editie in TEI biedt de mogelijkheid om bijzonderheden in de tekst(drager) gedetailleerd per geval te coderen in het TEI-bestand. Het is echter ook mogelijk om, bijvoorbeeld voor een sneller resultaat, verschijnselen op traditionele wijze te behandelen in een annotatie. Daarbij wordt gebruik gemaakt van het <note>-element.

In de transcriptie of vertaling wordt een leeg <anchor/>-element geplaatst, met daarin een @n met een kort sleutelwoord en een @type=”note”. Verwerk een <note>-element in de <div type=”notes” n=”sleutelwoord” xml:lang=”taal”> met daarin de tekst van de annotatie. De @n moet in beide elementen hetzelfde zijn. Alle noten in eenzelfde taal worden in hetzelfde <div>-element verwerkt, en de noten worden op basis van hun plek in de tekst geordend. Voorbeeld:

<pre>
<p>This is an exemple<anchor n=“nootje” type= “note”/> of how to create a note</p>

<div type=“notes” xml:lang=“en”>
<note n=“nootje”>This is the note</note>
… other notes in English…
</div>

<div type=“notes” xml:lang=“nl”>
<note n=“nootje”>Dit is de noot</note>
… other notes in Dutch …
</div>
</pre>

==See also==
* [[Transcription: annotations (MVN)]]
* [[Transcription: annotations (Mondrian)]]
* [[XML Huygens]]

[[Category:XML Huygens]]

TEI Header

2017-01-31T14:38:44Z

ASC:

De <teiHeader> is een verplicht onderdeel van het transcriptiebestand en bevat meta-informatie over de digitale editie. Hij bestaat over het algemeen uit de volgende elementen:

* De <fileDesc>: het enige verplichte onderdeel. Het bevat een bibliografische beschrijving van de digitale editie;
* De <encodingDesc> met daarin beschreven de relatie tussen de digitale editie en zijn (materiële) bron ;
* De <profileDesc> met classificerende en contextuele informatie over de tekst.

De <fileDesc> bestaat ook weer uit drie verplichte onderdelen:
* Een <titleStmt> met informatie over de titel (<title>), auteur (<author>) en/of editeur <editor> van de tekst;
* Een <publicationStmt> met informatie over publicatiedetails;
* Een <sourceDesc> met bibliografische details over de materiële bron.

Omdat niet iedere tekstbron dezelfde soort informatie in de metadata behoeft, hangt het van het type bron af hoe de <teiHeader> per onderdeel wordt vormgegeven. Ook de verdere invulling van de <teiHeader> zal per bron verschillen. Het is daarom raadzaam om de pagina over de TEI Header van het relevante project te bekijken.

<pre>
<teiHeader>
<fileDesc>
<titleStmt>
<title>

</title>
</titleStmt>
<publicationStmt>
<p>

</p>
</publicationStmt>
<sourceDesc>
<p>

</p>
</sourceDesc>
</fileDesc>
</teiHeader>
</pre>
==Zie ook==
* [[TEI Header (MVN)]]
* [[TEI Header (Mondrian)]]
* [[XML Huygens]]

[[Category:XML Huygens]]

TEI Header

2017-01-31T14:24:51Z

ASC:

De <teiHeader> is een verplicht onderdeel van het transcriptiebestand en bevat meta-informatie over de digitale editie. Hij bestaat over het algemeen uit de volgende elementen:

* De <fileDesc>: het enige verplichte onderdeel. Het bevat een bibliografische beschrijving van de digitale editie;
* De <encodingDesc> met daarin de relatie tussen de digitale editie en zijn (materiële) bron te beschrijven;
* De <profileDesc> met classificerende en contextuele informatie over de tekst.

De <fileDesc> bestaat ook weer uit drie verplichte onderdelen:
* Een <titleStmt> met informatie over de titel (<title>), auteur (<author>) en/of editeur <editor> van de tekst;
* Een <publicationStmt> met informatie over publicatiedetails;
* Een <sourceDesc> met bibliografische details over de materiële bron.

Omdat niet iedere tekstbron dezelfde soort informatie in de metadata behoeft, hangt het van het type bron af hoe de <teiHeader> per onderdeel wordt vormgegeven. Ook de verdere invulling van de <teiHeader> zal per bron verschillen. Het is daarom raadzaam om de pagina over de TEI Header van het relevante project te bekijken.

<pre>
<teiHeader>
<fileDesc>
<titleStmt>
<title>

</title>
</titleStmt>
<publicationStmt>
<p>

</p>
</publicationStmt>
<sourceDesc>
<p>

</p>
</sourceDesc>
</fileDesc>
</teiHeader>
</pre>
==Zie ook==
* [[TEI Header (MVN)]]
* [[TEI Header (Mondrian)]]
* [[XML Huygens]]

[[Category:XML Huygens]]

XML Huygens

2017-01-31T14:22:42Z

ASC:

For the purposes of a uniformization of all XML guidelines for digital Huygens projects, the Huygens ING wants to provide its editors with a description of the desired common way of encoding. This general information will be divided into several subpages that discuss a variety of subjects, ranging from a general explanation of XML to information about the content of specific parts of the XML files.

===Content===
# [[About XML|XML, XML schemas, XML namespaces]]
# [[Subversion]]
# [[Global division of the XML/TEI file]]
# [[TEI Header]]
# [[Textual hierarchy]]
# [[Transcription]]
# [[Annotation]]
# [[Translation]]
# Tekstvergelijking
# [[Secondary files]]

[[Category:XML Huygens]]

Project procedure (Mondrian)

2017-01-25T13:54:37Z

ASC:

Op deze pagina worden afspraken ten aanzien van de werkwijze vastgelegd voor het Mondriaan Editieproject. Daarmee bedoelen we de organisatie van het daadwerkelijke onderzoek en archivering van bestanden en documentatie die daarbij nodig zijn of die daaruit voortkomen. Behalve ter verantwoording van de gehanteerde aanpak is dit document ook bedoeld als houvast voor editeurs en andere medewerkers van het projectteam.
Aan het project wordt over een zeer lange periode gewerkt door meerdere personen met deels verschillende verantwoordelijkheden en uiteenlopende werktijden. Het is noodzakelijk dat zij zich allen houden aan dezelfde, hieronder beschreven uitgangspunten voor de tekstbewerking, het inhoudelijk onderzoek, het schrijven van annotaties en commentaar, het opslaan van de vergaarde en geproduceerde digitale bestanden en het beheer van (digitale en papieren) onderzoeksdocumentatie.
Het belang van deze ‘discipline’ is tweeledig. Ten eerste een efficiënt werkproces: wanneer iedereen zich aan dezelfde uitgangspunten houdt, kan werk gemakkelijker gedeeld en verdeeld worden; eventuele nieuwe medewerkers (met name stagiairs) kunnen gemakkelijker aanhaken als de aanpak voorgeschreven is; en de kans op het vergeten van ‘hoe we dat ook alweer deden’ wordt erdoor gereduceerd. Ten tweede bepaalt consistentie in hoge mate de uiteindelijke kwaliteit en betrouwbaarheid van de editie. Een consistente aanpak vanaf het begin draagt daar heel veel aan bij.
Tijdens het onderzoek — in elk geval in de eerste jaren, en zeker totdat alle onderdelen van het editieproces ten minste eenmaal aan de orde zijn geweest — zullen regelmatig nieuwe beslissingen over de werkwijze genomen moeten worden en oude bijgesteld. Telkens zullen die keuzes en afspraken direct moeten worden opgenomen in dit document.

==Repository==
Voor het Mondriaan Editieproject is schijfruimte ingericht op een repository zodat teamleden werkend vanuit het RKD en het Huygens ING toegang tot de documenten hebben. Dit document is bedoeld als verantwoording voor de wijze waarop welke informatie op welke plaats kan worden opgeborgen op de repository. Voor de continuïteit en vindbaarheid van documenten voor alle medewerkers van het project is het essentieel dat de hieronder beschreven richtlijnen worden gevolgd. Bovendien kan dit document helpen bij twijfel bij opberging van gegevens of raadpleging.
===Inchecken en updaten===
Alle bestanden die voortkomen uit het project (dus niet alleen de tekstbestanden maar ook de documentatie, administratie etc.) worden opgeslagen in de Repository. Het is van groot belang dat alle vergaarde informatie voor alle medewerkers in het project beschikbaar is. Om die reden is het volgende een volstrekt vereiste:
# ALVORENS ZIJN/HAAR COMPUTER (AAN HET EINDE VAN DE DAG) AF TE SLUITEN DOET ELKE MEDEWERKER EEN COMPLETE CHECK-OUT NAAR DE REPOSITORY. Vaker uitchecken is zeker toegestaan.
# BIJ HET OPENEN VAN DE SVN-CLIENT DOET ELKE MEDEWERKER EEN COMPLETE CHECK-IN UIT DE REPOSITORY.
Voor alle typen bestanden zijn mappen gemaakt met een vastgestelde indeling. Het is toegestaan nieuwe bestanden in bestaande mappen toe te voegen (als ze daar ook thuishoren). Het toevoegen, verwijderen of verplaatsen van mappen is achter alleen toegestaan na overleg door editeurs en documentalist omdat anders bij in- en uitchecken verwarring kan ontstaan.
===Gebruikers===
De editeurs werken voornamelijk in de map Teksten. Daarnaast zijn zij verantwoordelijk voor de mappen Apparaat, Verantwoording en Tests. In deze mappen maken zij zelf documenten aan. In de submappen onder Commentaar werken ze in bestaande documenten en maken, in overleg met de documentalist, nieuwe documenten aan.
De documentalist is verantwoordelijk voor de submappen onder Commentaar en maakt bestanden aan. De documentalist voegt hier nieuwe gegevens aan toe, die onder andere worden aangeleverd door de editeurs. Alle documenten in de mappen Apparaat, Teksten en Verantwoording worden door de documentalist ter raadpleging gebruikt maar zal daar geen wijzigingen in aanbrengen.
===Overige opmerkingen===
Voor de leesbaarheid zijn de namen van de hoofdmappen in hoofdletters weergegeven.
Bij documentatiemateriaal dat wordt gescand uit boeken, wordt altijd de voorkant opgenomen.
==Structuur repository==
De hoofdstructuur van de repository is als volgt:
* Administratie
* Bibliotheek
* Commentaar
** Begeleidende teksten
** Biografische Mondriaan documentatie
* Documentatie
** Info – per brief
** Organisatie – kunst
** Organisatie – overig
** Personen
** Publicaties
* Inventarisatie_beheer
** Bewaarplaatsen
** Herkomstonderzoek
** Inventarisatie
** Selectie pilot
* Secundair
* Teksten
** Letters
** Letters Preliminary
** Writings
* Tests and Samples (voor ICT-doeleinden; niet voor editeursteam)
* Verantwoording
** Editieverantwoording (van N-schijf)
** Documentation

===Administratie===
Stageopdrachten en reisschema’s bijvoorbeeld.

===Bibliotheek===
====Inhoud====
In de Bibliotheek komt alle relevante literatuur voor het project en bevat scans of digitale versies van
volledige publicaties die een fysieke publicatie kunnen vervangen.
De bibliotheek is een hulpmiddel en maakt strikt genomen geen deel uit van de opbouw van de
annotaties (zoals /Personen e.d.).

De enige eis is dat het bestand compleet moet zijn, dus een volledig gescand boek of een volledig
artikel/hoofdstuk uit een boek. Omdat de bestandsnaam kort en bondig moet zijn, dient alle
informatie over het gescande boek of hoofdstuk/artikel duidelijk in het document zelf voor te komen en moet altijd de voorkant van het boek gescand worden.
Er wordt geen onderscheid gemaakt tussen artikelen of boeken. Per publicatie wordt een submap
Gemaakt (voorstel EdV: pas aanmaken als er meerdere documenten per publicatie zijn, anders onnodig veel klikken). Zo kunnen behalve scans bijvoorbeeld ook informatie óver de publicatie opgenomen worden; achtergrond van ontstaan van een publicatie bijvoorbeeld.
Naamgeving
De opbouw van bestandsnamen voor documenten in deze map: <achternaam auteur>_<titel, spaties
door middel van underscores>_<jaartal van publicatie>

Lange titels worden verkort; ze moeten significante informatie over het gescande boek of
hoofdstuk/artikel geven; altijd moet de titelpagina van de publicatie gescand worden.

Door de opbouw van de bestandsnamen in de map is deze alfabetisch gerangschikt.

NB. Voor publicaties van Mondriaan is een aparte submap.

===Commentaar===
Map bevat alle documenten die gegevens bevatten voor alle vormen van inhoudelijk editeurscommentaar (m.n. annotaties, biografieën, inleidingen e.d.). De documenten zijn verschillend van aard: het gaat om Word-bestanden, die door het Mondriaan-team zijn samengesteld, scans uit boeken en bijvoorbeeld foto’s. De map /Commentaar is verdeeld in verschillende submappen.
Documentatie

====Info-per brief====
Bevat mappen voor elke brief; de briefmap bevat bestanden met gegevens die belangrijk zijn bij het
annoteren maar die onder geen van de andere categorieën (die hierna volgen) thuis te brengen zijn.
De Word-bestanden en scans of andere documenten die bij de betreffende brief horen, zullen
dezelfde naam krijgen als de brief.

=====Inhoud dossier=====
De briefmap bevat een bronnenmap voor reproducties en een voor de materiële beschrijving van de betreffende brief.

=====Structuur dossier=====
[nog schrijven]

=====Naamgeving dossier=====
De mappen hebben uitsluitend het viercijferige MEP-nummer. Eerder bleek dat een naamgeving die bestond uit de datum, gevolgd door geadresseerde sterk onderhevig is aan verandering. Daardoor vormde die constructie geen betrouwbare bestandsnaam. Het MEP-nummer is misschien lastiger om mee te werken omdat niet in één oogopslag duidelijk is om welke brief het gaat (dan moet je de inventarisatie erbij pakken), maar de MEP-nummers blijven wel hetzelfde.

De naamgeving van het dossier is als volgt opgebouwd:
<pre>Brievenmap <viercijferige MEP-nummer>
BRON_<MEP-nummer>
Repr_<MEP-nummer>
Mat_beschr_<MEP-nummer></pre>

====Organisatie - kunst====
Onder ‘kunstorganisaties’ worden verstaan alle instellingen, organisaties, bedrijven, verenigingen etc.
die gebaseerd zijn op betrokkenheid bij kunst. Dus musea, kunstenaarsverenigingen,
kunsthandels/galeries, tentoonstellingen e.d.

=====Inhoud dossier=====
Alle kunstorganisaties die in de brieven voorkomen, krijgen eigen dossiers. Deze dossiers bestaan uit
afzonderlijke mappen, bedoeld om gegevens te verzamelen voor het maken van annotaties. De
mappen kunnen verschillende soorten documenten bevatten, waaronder één Word-bestand met
eigen, samengestelde informatie en scans van fragmenten uit boeken relevant voor de betreffende
organisatie.
De kern van het dossier wordt gevormd door het Word-bestand met de volgende categorieën:
* Volledige naam
* Actieve jaren
* Nationaliteit
* Kwalificatie
* Vestiging van de organisatie (locatie)
* Vermeldingen in brieven
* Aanvullende informatie
* Record in RKDartists&
* Annotaties

=====Structuur dossier=====
De structuur van deze dossiers is als volgt:

'''Titel'''
<naam van de organisatie> <tussen ronde haken jaren dat organisatie actief was, als dit te vinden is>
<Nationaliteit en kwalificatie>
Gevestigd op <adres en plaatsnaam, indien dit van belang is of genoemd wordt in de brieven>

'''Vermeldingen in brieven'''
• <MEP-nummer van de brief onderstreept> <2x tab> <verwijzing annotatie in brief>
• Citaat tussen enkele aanhalingstekens

'''Aanvullende informatie'''

'''Record in RKDartists&'''
• Permalink

'''Annotaties'''

=====Naamgeving=====
De bestandsnaam voor documenten in Org-kunst bestaat uit de volledige naam van de betreffende
kunstenaarsvereniging, museum etc. Woorden worden aan elkaar geschreven, spaties door middel
van underscores.
Als het bijvoorbeeld om een kunsthandel gaat en het woord ‘galerie’ maakt
officieel deel uit van de naam, dan wordt deze als zodanig opgenomen. Is alfabetisch niet
inzichtelijker? LJ Dit is in overeenstemming met de regels van invoer van kunsthandels in RKDartists&.
Dit leidt bijvoorbeeld tot ‘Galerie_Nierendorf’ en ‘Valentine_Gallery’.

Voor bijvoorbeeld tentoonstellingen waarvan het (nog) onbekend is om welke tentoonstelling het
precies gaat, wordt de volgende opbouw van bestandsnamen gehanteerd:
<TS>_<plaats van de tentoonstelling>_<jaartal> (bijv. TS_New_York_1937)
De map /Organisatie - kunst is automatisch alfabetisch gerangschikt.

====Organisatie-overig====
Bevat mappen met dossiers van alle overige bedrijven, instellingen etc., al dan niet commercieel.
Bijvoorbeeld immigratiedienst, advocatenkantoor, scheepvaartmaatschappij, theosofische vereniging,
etc.

=====Inhoud dossier=====
De kern van het dossier wordt gevormd door een Word-bestand met dezelfde categorieën als bij kunstorganisaties, voor zover van toepassing. Het dossier kan ook andere documenten bevatten zoals webpagina’s,
scans van fragmenten uit boeken relevant voor de betreffende organisatie.

=====Structuur en naamgeving dossier=====
Voor de naamgeving en structuur van het dossier /Organisatie - overig: zie /Organisatie - kunst, mutatis mutandis.

De map /Organisatie - overig is automatisch alfabetisch gerangschikt.

====Personen====
Alle personen die in de brieven voorkomen, krijgen een persoonsdossier. Voor bijvoorbeeld kunsthandelaren met een eigen galerie die ook verzamelden, wordt alles over de persoon en de handel in één dossier
verzameld. Bij Valentine Dudensing komen alle gegevens in het document over de galerie. In het document van de persoon wordt alleen een verwijzing naar de galerie opgenomen.

=====Inhoud dossier=====
Deze dossiers bestaan uit afzonderlijke mappen, bedoeld om gegevens te verzamelen voor het maken
van annotaties. De kern van het dossier wordt gevormd door een Word-bestand met de volgende
categorieën:

* Volledige naam
* Kwalificatie
Kunsthandelaar, kunstenaar, verzamelaar etc.
* Genoemde kunstwerken
* Vermeldingen in brieven (citaten uit brieven van Mondriaan waarin deze persoon voorkomt)
* Aanvullende informatie
Algemene gegevens (achtergrondinformatie) die door de editeurs of de documentalist zijn/is achterhaald en van belang zijn/is bij het maken van annotaties.
* Record in RKDartists&
Hier komt de permalink uit RKDexplore zodat de records eenvoudig te raadplegen zijn voor de editeurs.
* Annotaties

De mappen kunnen verschillende soorten documenten bevatten, waaronder één Word-bestand met
eigen, samengestelde informatie en scans van fragmenten uit boeken relevant voor de betreffende
persoon.

=====Structuur dossier=====
<voornaam>, <achternaam> <geboorte-en sterfdata>
<nationaliteit en kwalificatie, indien bekend>

'''Genoemde kunstwerken'''

'''Vermeldingen in brieven'''
* <MEP-nummer van de brief onderstreept> <2x tab> <verwijzing annotatie in brief>
* Citaat tussen enkele aanhalingstekens

'''Record in RKDartists&'''
* Permalink

=====Naamgeving dossier=====
De bestandsnamen voor documenten in /Personen wordt als volgt opgebouwd:
<Achternaam in hoofdletters>_<voornaam in kleine letters>

Mocht twee keer dezelfde naam voorkomen maar het betreft een ander persoon dan kunnen
geboorte-en sterfdata worden toegevoegd, bijvoorbeeld:
HELION_Jean_(1900-1944)
HELION_Jean_(1904-1987)

De map /Personen is automatisch alfabetisch gerangschikt.

====Publicaties====
Bevat documenten met informatie over in de brieven en geschriften genoemde boeken, tijdschriften,
brochures en andere al dan niet commerciële publicaties. De mappen kunnen verschillende soorten
documenten bevatten, waaronder één Word-bestand met eigen, samengestelde informatie en scans
van fragmenten uit boeken relevant voor de betreffende tijdschriften, kranten en andere publicaties. De documenten in deze map zijn anders opgebouwd dan de persoons- en organisatiedossiers en hebben een eigen template, waarin de naam, actieve jaren, nationaliteit en kwalificatie van de krant of het tijdschrift staan vermeld. Bij publicaties wordt volstaan met de vermelding van de auteur, titel en plaats en jaar van uitgave. Daarnaast zijn de gebruikelijke categorieën, vermeldingen in brieven, aanvullende informatie, record in RKDartists& en annotaties, opgenomen.
In de map /Commentaar is weliswaar een onderscheid gemaakt in een aantal categorieën maar die zullen in de praktijk regelmatig overlappen; zo kan een galerie een catalogus uitgeven; informatie daarover kan in /Organisatie - kunst en in /Publicaties.

=====Structuur dossier=====
<naam van tijdschrift of krant> <tussen ronde haken jaren dat tijdschrift of krant actief was>
<Nationaliteit en kwalificatie> of <auteur van de publicatie>, <titel publicatie>, <plaats en jaartal van uitgave>

'''Vermeldingen in brieven'''
* <MEP-nummer van de brief onderstreept> <2x tab> <verwijzing annotatie in brief>
* Citaat tussen enkele aanhalingstekens

'''Record in RKDartists&'''
* Permalink

=====Naamgeving dossier=====
De bestandsnamen voor documenten in Publicaties betreffen de namen van tijdschriften en kranten. Woorden worden van elkaar gescheiden door middel van een underscore. Deze map is alfabetisch gerangschikt.

===Inventarisatie_beheer===
====Bewaarplaatsen====

Alle oude versies van beeldmateriaal van brieven opslaan in repository in de map Inventarisatie_beheer/Bewaarplaatsen zoals ze worden toegestuurd door de beherende instellingen. De kans bestaat dat er kleine foutjes insluipen bij het overhevelen naar de map ‘Info per brief’ in de repository. Het scheelt veel uitzoekwerk als ik dan terug kan grijpen op de originele bestanden.

====Herkomstonderzoek====
[Nog beschrijven]

====Inventarisatie====
Drie mappen in dit Excel-bestand: brieven van Piet Mondriaan, Geschriften van Mondriaan en brieven aan Mondriaan.
Hier komt de toelichting op de inventarisatie van alle brieven en geschriften.
Termen uitschrijven, zoals EDS bij alternatieve datering (= door de editeurs vastgestelde datering van een brief).
Kleurcoderingen uitleggen: geel is voorlopig/onzeker, oranje is vervallen brieven, paars zijn briefverwijzingen van Louis Veen.

====Inventarisatie beeldmateriaal====

Van de ongedateerde brieven wordt voorlopig de alternatieve datering aangehouden met het oog op de sorteerfunctie van Excel. De cel waarin zo’n alternatieve datering in de dateringskolom is opgenomen, is geel gemaakt om te voorkomen dat het lijkt alsnog deze voorlopige datering is vastgesteld.

===Teksten===
Deze map bevat alle xml-bestanden van brieven en geschriften, verdeeld over respectievelijk de submappen /Letters, /Letters Preliminary en /Writings.

====Letters====
Documenten die in /Letters staan, worden ook getoond in de demoversie van de editie. Daarom worden transcripties tijdens het bewerkingsproces in /Letters Preliminary geplaatst; pas als ze afgerond zijn, worden ze in /Letters geplaatst.

====Bestanden per brief/geschrift====
Voor de bewerking van de brieven en theoretische geschriften op de uiteenlopende terreinen (tekst, annotaties, verwijzingen, afbeeldingen etc.) wordt per brief respectievelijk geschrift een afzonderlijk bestand gebruikt. Elk bestand krijgt een unieke, herkenbare naam (zie hierna); een definitief briefnummer kan pas bij publicatie worden toegekend.
De bestanden worden geschreven in xml en gecodeerd volgens richtlijnen van TEI / DALF; zie hiervoor ‘Encoding Mondrian’.
Naamgeving tekstbestanden
Bestandsnamen van brieven
Bestandsnamen van brieven bestaan uit drie onderdelen:
# datum (jjjjmmdd)
# indien geschreven door PM: verkorte achternaam geadresseerde (4 eerste letters, kapitalen); indien geschreven aan PM: afkorting PM + verkorte achternaam geadresseerde (4 eerste letters, kapitalen); indien er meer correspondenten met dezelfde achternaam zijn, volgt op de achternaam de voornaam, ook verkort (vier eerste letters, kapitalen)
Al deze onderdelen worden van elkaar gescheiden door underscore: _
Voorbeelden:
* Brief van Mondriaan aan H. van Assendelft dd. 6 januari 1919 → 19190106_PXXX_ASSE_0184
* Brief aan Mondriaan van Harry Holtzman dd 18 oktober 1939 → 19391018_P054_PM_HOLT_5029
* Brief van Nelly van Doesburg aan Mondriaan dd 18 oktober 1939 → 19391018_PXXX_DOES_NELL_<MEP-nummer>
* Eerdere brief van Nelly van Doesburg dd 18 oktober 1939 → 19391018_PXXX_DOES_NELL_<MEP-nummer>

Tussenvoegsels van achternamen worden niet in de bestandsnaam opgenomen (de, van de, von, de la e.d.).
Wanneer de geadresseerde onbekend is, wordt in de bestandsnaam ANON gebruikt.
Wanneer de achternaam uit minder dan vier letters bestaat wordt de volledige naam opgenomen.
Het kan voorkomen dat in plaats van persoonsnamen namen van bijv. instituties, bedrijven of organisaties worden gebruikt.
Bij onvolledige datering: delen die niet bekend zijn worden ingevuld met x.
Een brief uit de eerste week van april 1922 krijgt als datering 1922040x.
Een brief waarvan die alleen ‘oktober’ als datering heeft, krijgt als datering xxxx10xx.
Een brief waarvan we in het geheel geen indicatie van de datum hebben, krijgt dus als datering acht x’en.
Wanneer een datering globaal is wordt in de bestandsnaam de vroegste datum van de geschatte periode gebruikt: tweede helft mei 1893 wordt dus 18930516.

=====Bestandsnamen van geschriften=====
[wegens de stand van het onderzoek is deze paragraaf zeer voorlopig]
Natuurlijkerwijs zal naar een tekst verwezen worden met de titel. Dateringen gebruiken is minder geschikt. Daarom worden bestandsnamen gebaseerd op (twee of drie hoofdwoorden uit) de titel van de getranscribeerde tekst; dit heeft als voordeel dat versies van één tekst bij elkaar komen te staan. Om versieverschillen aan te geven kan een extensie gebruikt worden. Ook het pilotnummer kan worden gebruikt. Bijv. (fictief):.
<pre>
BORN_HOLLAND_TYPO3_P09
NECESSITY_NEW_TEACHING-PUBL-P11
DIALOOG_NWE_BEELDING_MS1-P01
</pre>
Later in het onderzoek zal bepaald worden of elk document en eigen bestand

====Writings====
Het betreft transcripties van geschriften van Mondriaan. Deze zijn verschillend van aard. Van sommige bestaat een originele handgeschreven versie, van sommige is alleen de publicatie in een tijdschrift bekend. Alles komt in deze map. Daarin vinden tevens documenten met gegevens die betrekking hebben op de geschriften een plek. Als Mondriaan een hoofdstuk publiceerde in een catalogus, dan is de algemene informatie hierover, samengesteld voor het maken van annotaties of algemene achtergrond informatie, opgenomen in een Word-document.
Deze map is onderverdeeld in submappen op jaartal en titel van het geschrift. In deze sub mappen komen de verschillende documenten, dus ook alle versies van hetzelfde geschrift en het Xml-bestand.
De opbouw van de bestandsnamen is als volgt:
* <jaartal>_<titel geschrift aan elkaar, spaties door middel van underscores>
Deze map is daardoor chronologisch gerangschikt.

===Verantwoording===
Map bevat zowel zelfstandige bestanden die methode en werkwijze beschrijven, als de submap met xml-instructie, /Documentation. De bestanden kunnen in uiteenlopende programma’s geschreven zijn (m.n. Word en Oxygen).

===Titels===
====Titels van kunstwerken: werken van Mondriaan====
We vermelden de titel kort, gevolgd door het jaartal en het CR-nummer tussen haakjes:
Composition, 1938 (B290).

====Titels van kunstwerken: werken van andere kunstenaars====
Idem als voor Mondriaan: gegevens uit Catalogue Raisonné van de betreffende kunstenaar gebruiken en anders de meest betrouwbare catalogus/beschrijving die voorhanden is (bijvoorbeeld de informatie van de rechthebbende kunstenaars foundation).

====Titels van publicaties====
Titelbeschrijvingen zijn in het Engels. We nemen het Angelsaksische gebruik van hoofdletters wel/niet over.
We stellen ons voor dat bij een mouse-over op de verkorte titel de volledige titelbeschrijving zichtbaar wordt.
Daarnaast komt er een volledige lijst van geraadpleegde werken.
Uitgangspunt is altijd de titelpagina van de publicatie.
In annotaties en commentaren wordt naar publicaties verwezen door middel van verkorte titels, als volgt:
* Catalogue raisonné van Mondriaans werken: CR II, p. 297-298.
Deze verkorte titel is een uitzondering op het hierna volgende omdat veelvuldig naar deze oevrecatalogus wordt verwezen.
* Van publicaties met niet meer dan auteur en titel: achternaam en jaartal, verlengd met een volgorde-aanduiding: De la Porte 1956-a.
De -a wordt altijd toegevoegd zodat dit niet alsnog hoeft te worden gedaan als later een tweede publicatie van dezelfde auteur uit hetzelfde jaar toegevoegd moet worden (met -b). Bij publicatie van de editie wordt dit aangepast.
* Meerdere auteurs: alleen de eerstgenoemde wordt vermeld.
* Tentoonstellingscatalogus: Exh.cat. New York 2010.
Als de tentoonstelling in meerdere steden plaatsvond en/of over het einde van het jaar liep, wordt alleen de eerste stad en het eerste jaar vermeld.
* Veilingcatalogus: Auct.cat. Christie’s, New York 1976; Auct.cat. Drouot, Paris 1886.
De naam van het veilinghuis wordt kort gehouden.

==See also==
* [[Secondary files (Mondrian)]]
* [[XML Mondrian Guidelines]]

[[Category:XML Mondrian]]

Project procedure (Mondrian)

2017-01-25T13:52:25Z

ASC:

Op deze pagina worden afspraken ten aanzien van de werkwijze vastgelegd voor het Mondriaan Editieproject. Daarmee bedoelen we de organisatie van het daadwerkelijke onderzoek en archivering van bestanden en documentatie die daarbij nodig zijn of die daaruit voortkomen. Behalve ter verantwoording van de gehanteerde aanpak is dit document ook bedoeld als houvast voor editeurs en andere medewerkers van het projectteam.
Aan het project wordt over een zeer lange periode gewerkt door meerdere personen met deels verschillende verantwoordelijkheden en uiteenlopende werktijden. Het is noodzakelijk dat zij zich allen houden aan dezelfde, hieronder beschreven uitgangspunten voor de tekstbewerking, het inhoudelijk onderzoek, het schrijven van annotaties en commentaar, het opslaan van de vergaarde en geproduceerde digitale bestanden en het beheer van (digitale en papieren) onderzoeksdocumentatie.
Het belang van deze ‘discipline’ is tweeledig. Ten eerste een efficiënt werkproces: wanneer iedereen zich aan dezelfde uitgangspunten houdt, kan werk gemakkelijker gedeeld en verdeeld worden; eventuele nieuwe medewerkers (met name stagiairs) kunnen gemakkelijker aanhaken als de aanpak voorgeschreven is; en de kans op het vergeten van ‘hoe we dat ook alweer deden’ wordt erdoor gereduceerd. Ten tweede bepaalt consistentie in hoge mate de uiteindelijke kwaliteit en betrouwbaarheid van de editie. Een consistente aanpak vanaf het begin draagt daar heel veel aan bij.
Tijdens het onderzoek — in elk geval in de eerste jaren, en zeker totdat alle onderdelen van het editieproces ten minste eenmaal aan de orde zijn geweest — zullen regelmatig nieuwe beslissingen over de werkwijze genomen moeten worden en oude bijgesteld. Telkens zullen die keuzes en afspraken direct moeten worden opgenomen in dit document.

==Repository==
Voor het Mondriaan Editieproject is schijfruimte ingericht op een repository zodat teamleden werkend vanuit het RKD en het Huygens ING toegang tot de documenten hebben. Dit document is bedoeld als verantwoording voor de wijze waarop welke informatie op welke plaats kan worden opgeborgen op de repository. Voor de continuïteit en vindbaarheid van documenten voor alle medewerkers van het project is het essentieel dat de hieronder beschreven richtlijnen worden gevolgd. Bovendien kan dit document helpen bij twijfel bij opberging van gegevens of raadpleging.
===Inchecken en updaten===
Alle bestanden die voortkomen uit het project (dus niet alleen de tekstbestanden maar ook de documentatie, administratie etc.) worden opgeslagen in de Repository. Het is van groot belang dat alle vergaarde informatie voor alle medewerkers in het project beschikbaar is. Om die reden is het volgende een volstrekt vereiste:
# ALVORENS ZIJN/HAAR COMPUTER (AAN HET EINDE VAN DE DAG) AF TE SLUITEN DOET ELKE MEDEWERKER EEN COMPLETE CHECK-OUT NAAR DE REPOSITORY. Vaker uitchecken is zeker toegestaan.
# BIJ HET OPENEN VAN DE SVN-CLIENT DOET ELKE MEDEWERKER EEN COMPLETE CHECK-IN UIT DE REPOSITORY.
Voor alle typen bestanden zijn mappen gemaakt met een vastgestelde indeling. Het is toegestaan nieuwe bestanden in bestaande mappen toe te voegen (als ze daar ook thuishoren). Het toevoegen, verwijderen of verplaatsen van mappen is achter alleen toegestaan na overleg door editeurs en documentalist omdat anders bij in- en uitchecken verwarring kan ontstaan.
===Gebruikers===
De editeurs werken voornamelijk in de map Teksten. Daarnaast zijn zij verantwoordelijk voor de mappen Apparaat, Verantwoording en Tests. In deze mappen maken zij zelf documenten aan. In de submappen onder Commentaar werken ze in bestaande documenten en maken, in overleg met de documentalist, nieuwe documenten aan.
De documentalist is verantwoordelijk voor de submappen onder Commentaar en maakt bestanden aan. De documentalist voegt hier nieuwe gegevens aan toe, die onder andere worden aangeleverd door de editeurs. Alle documenten in de mappen Apparaat, Teksten en Verantwoording worden door de documentalist ter raadpleging gebruikt maar zal daar geen wijzigingen in aanbrengen.
===Overige opmerkingen===
Voor de leesbaarheid zijn de namen van de hoofdmappen in hoofdletters weergegeven.
Bij documentatiemateriaal dat wordt gescand uit boeken, wordt altijd de voorkant opgenomen.
==Structuur repository==
De hoofdstructuur van de repository is als volgt:
* Administratie
* Bibliotheek
* Commentaar
** Begeleidende teksten
** Biografische Mondriaan documentatie
* Documentatie
** Info – per brief
** Organisatie – kunst
** Organisatie – overig
** Personen
** Publicaties
* Inventarisatie_beheer
** Bewaarplaatsen
** Herkomstonderzoek
** Inventarisatie
** Selectie pilot
* Secundair
* Teksten
** Letters
** Letters Preliminary
** Writings
* Tests and Samples (voor ICT-doeleinden; niet voor editeursteam)
* Verantwoording
** Editieverantwoording (van N-schijf)
** Documentation

===Administratie===
Stageopdrachten en reisschema’s bijvoorbeeld.

===Bibliotheek===
====Inhoud====
In de Bibliotheek komt alle relevante literatuur voor het project en bevat scans of digitale versies van
volledige publicaties die een fysieke publicatie kunnen vervangen.
De bibliotheek is een hulpmiddel en maakt strikt genomen geen deel uit van de opbouw van de
annotaties (zoals /Personen e.d.).

De enige eis is dat het bestand compleet moet zijn, dus een volledig gescand boek of een volledig
artikel/hoofdstuk uit een boek. Omdat de bestandsnaam kort en bondig moet zijn, dient alle
informatie over het gescande boek of hoofdstuk/artikel duidelijk in het document zelf voor te komen en moet altijd de voorkant van het boek gescand worden.
Er wordt geen onderscheid gemaakt tussen artikelen of boeken. Per publicatie wordt een submap
Gemaakt (voorstel EdV: pas aanmaken als er meerdere documenten per publicatie zijn, anders onnodig veel klikken). Zo kunnen behalve scans bijvoorbeeld ook informatie óver de publicatie opgenomen worden; achtergrond van ontstaan van een publicatie bijvoorbeeld.
Naamgeving
De opbouw van bestandsnamen voor documenten in deze map: <achternaam auteur>_<titel, spaties
door middel van underscores>_<jaartal van publicatie>

Lange titels worden verkort; ze moeten significante informatie over het gescande boek of
hoofdstuk/artikel geven; altijd moet de titelpagina van de publicatie gescand worden.

Door de opbouw van de bestandsnamen in de map is deze alfabetisch gerangschikt.

NB. Voor publicaties van Mondriaan is een aparte submap.

===Commentaar===
Map bevat alle documenten die gegevens bevatten voor alle vormen van inhoudelijk editeurscommentaar (m.n. annotaties, biografieën, inleidingen e.d.). De documenten zijn verschillend van aard: het gaat om Word-bestanden, die door het Mondriaan-team zijn samengesteld, scans uit boeken en bijvoorbeeld foto’s. De map /Commentaar is verdeeld in verschillende submappen.
Documentatie

====Info-per brief====
Bevat mappen voor elke brief; de briefmap bevat bestanden met gegevens die belangrijk zijn bij het
annoteren maar die onder geen van de andere categorieën (die hierna volgen) thuis te brengen zijn.
De Word-bestanden en scans of andere documenten die bij de betreffende brief horen, zullen
dezelfde naam krijgen als de brief.

=====Inhoud dossier=====
De briefmap bevat een bronnenmap voor reproducties en een voor de materiële beschrijving van de betreffende brief.

=====Structuur dossier=====
[nog schrijven]

=====Naamgeving dossier=====
De mappen hebben uitsluitend het viercijferige MEP-nummer. Eerder bleek dat een naamgeving die bestond uit de datum, gevolgd door geadresseerde sterk onderhevig is aan verandering. Daardoor vormde die constructie geen betrouwbare bestandsnaam. Het MEP-nummer is misschien lastiger om mee te werken omdat niet in één oogopslag duidelijk is om welke brief het gaat (dan moet je de inventarisatie erbij pakken), maar de MEP-nummers blijven wel hetzelfde.

De naamgeving van het dossier is als volgt opgebouwd:
<pre>Brievenmap <viercijferige MEP-nummer>
BRON_<MEP-nummer>
Repr_<MEP-nummer>
Mat_beschr_<MEP-nummer></pre>

====Organisatie - kunst====
Onder ‘kunstorganisaties’ worden verstaan alle instellingen, organisaties, bedrijven, verenigingen etc.
die gebaseerd zijn op betrokkenheid bij kunst. Dus musea, kunstenaarsverenigingen,
kunsthandels/galeries, tentoonstellingen e.d.

=====Inhoud dossier=====
Alle kunstorganisaties die in de brieven voorkomen, krijgen eigen dossiers. Deze dossiers bestaan uit
afzonderlijke mappen, bedoeld om gegevens te verzamelen voor het maken van annotaties. De
mappen kunnen verschillende soorten documenten bevatten, waaronder één Word-bestand met
eigen, samengestelde informatie en scans van fragmenten uit boeken relevant voor de betreffende
organisatie.
De kern van het dossier wordt gevormd door het Word-bestand met de volgende categorieën:
* Volledige naam
* Actieve jaren
* Nationaliteit
* Kwalificatie
* Vestiging van de organisatie (locatie)
* Vermeldingen in brieven
* Aanvullende informatie
* Record in RKDartists&
* Annotaties

=====Structuur dossier=====
De structuur van deze dossiers is als volgt:

'''Titel'''
<naam van de organisatie> <tussen ronde haken jaren dat organisatie actief was, als dit te vinden is>
<Nationaliteit en kwalificatie>
Gevestigd op <adres en plaatsnaam, indien dit van belang is of genoemd wordt in de brieven>

'''Vermeldingen in brieven'''
• <MEP-nummer van de brief onderstreept> <2x tab> <verwijzing annotatie in brief>
• Citaat tussen enkele aanhalingstekens

'''Aanvullende informatie'''

'''Record in RKDartists&'''
• Permalink

'''Annotaties'''

=====Naamgeving=====
De bestandsnaam voor documenten in Org-kunst bestaat uit de volledige naam van de betreffende
kunstenaarsvereniging, museum etc. Woorden worden aan elkaar geschreven, spaties door middel
van underscores.
Als het bijvoorbeeld om een kunsthandel gaat en het woord ‘galerie’ maakt
officieel deel uit van de naam, dan wordt deze als zodanig opgenomen. Is alfabetisch niet
inzichtelijker? LJ Dit is in overeenstemming met de regels van invoer van kunsthandels in RKDartists&.
Dit leidt bijvoorbeeld tot ‘Galerie_Nierendorf’ en ‘Valentine_Gallery’.

Voor bijvoorbeeld tentoonstellingen waarvan het (nog) onbekend is om welke tentoonstelling het
precies gaat, wordt de volgende opbouw van bestandsnamen gehanteerd:
<TS>_<plaats van de tentoonstelling>_<jaartal> (bijv. TS_New_York_1937)
De map /Organisatie - kunst is automatisch alfabetisch gerangschikt.

====Organisatie-overig====
Bevat mappen met dossiers van alle overige bedrijven, instellingen etc., al dan niet commercieel.
Bijvoorbeeld immigratiedienst, advocatenkantoor, scheepvaartmaatschappij, theosofische vereniging,
etc.

=====Inhoud dossier=====
De kern van het dossier wordt gevormd door een Word-bestand met dezelfde categorieën als bij kunstorganisaties, voor zover van toepassing. Het dossier kan ook andere documenten bevatten zoals webpagina’s,
scans van fragmenten uit boeken relevant voor de betreffende organisatie.

=====Structuur en naamgeving dossier=====
Voor de naamgeving en structuur van het dossier /Organisatie - overig: zie /Organisatie - kunst, mutatis mutandis.

De map /Organisatie - overig is automatisch alfabetisch gerangschikt.

====Personen====
Alle personen die in de brieven voorkomen, krijgen een persoonsdossier. Voor bijvoorbeeld kunsthandelaren met een eigen galerie die ook verzamelden, wordt alles over de persoon en de handel in één dossier
verzameld. Bij Valentine Dudensing komen alle gegevens in het document over de galerie. In het document van de persoon wordt alleen een verwijzing naar de galerie opgenomen.

=====Inhoud dossier=====
Deze dossiers bestaan uit afzonderlijke mappen, bedoeld om gegevens te verzamelen voor het maken
van annotaties. De kern van het dossier wordt gevormd door een Word-bestand met de volgende
categorieën:

* Volledige naam
* Kwalificatie
Kunsthandelaar, kunstenaar, verzamelaar etc.
* Genoemde kunstwerken
* Vermeldingen in brieven (citaten uit brieven van Mondriaan waarin deze persoon voorkomt)
* Aanvullende informatie
Algemene gegevens (achtergrondinformatie) die door de editeurs of de documentalist zijn/is achterhaald en van belang zijn/is bij het maken van annotaties.
* Record in RKDartists&
Hier komt de permalink uit RKDexplore zodat de records eenvoudig te raadplegen zijn voor de editeurs.
* Annotaties

De mappen kunnen verschillende soorten documenten bevatten, waaronder één Word-bestand met
eigen, samengestelde informatie en scans van fragmenten uit boeken relevant voor de betreffende
persoon.

=====Structuur dossier=====
<voornaam>, <achternaam> <geboorte-en sterfdata>
<nationaliteit en kwalificatie, indien bekend>

'''Genoemde kunstwerken'''

'''Vermeldingen in brieven'''
* <MEP-nummer van de brief onderstreept> <2x tab> <verwijzing annotatie in brief>
* Citaat tussen enkele aanhalingstekens

'''Aanvullende informatie'''

'''Record in RKDartists&'''
* Permalink

'''Annotaties'''

=====Naamgeving dossier=====
De bestandsnamen voor documenten in /Personen wordt als volgt opgebouwd:
<Achternaam in hoofdletters>_<voornaam in kleine letters>

Mocht twee keer dezelfde naam voorkomen maar het betreft een ander persoon dan kunnen
geboorte-en sterfdata worden toegevoegd, bijvoorbeeld:
HELION_Jean_(1900-1944)
HELION_Jean_(1904-1987)

De map /Personen is automatisch alfabetisch gerangschikt.

====Publicaties====
Bevat documenten met informatie over in de brieven en geschriften genoemde boeken, tijdschriften,
brochures en andere al dan niet commerciële publicaties. De mappen kunnen verschillende soorten
documenten bevatten, waaronder één Word-bestand met eigen, samengestelde informatie en scans
van fragmenten uit boeken relevant voor de betreffende tijdschriften, kranten en andere publicaties. De documenten in deze map zijn anders opgebouwd dan de persoons- en organisatiedossiers en hebben een eigen template, waarin de naam, actieve jaren, nationaliteit en kwalificatie van de krant of het tijdschrift staan vermeld. Bij publicaties wordt volstaan met de vermelding van de auteur, titel en plaats en jaar van uitgave. Daarnaast zijn de gebruikelijke categorieën, vermeldingen in brieven, aanvullende informatie, record in RKDartists& en annotaties, opgenomen.
In de map /Commentaar is weliswaar een onderscheid gemaakt in een aantal categorieën maar die zullen in de praktijk regelmatig overlappen; zo kan een galerie een catalogus uitgeven; informatie daarover kan in /Organisatie - kunst en in /Publicaties.

=====Structuur dossier=====
<naam van tijdschrift of krant> <tussen ronde haken jaren dat tijdschrift of krant actief was>
<Nationaliteit en kwalificatie> of <auteur van de publicatie>, <titel publicatie>, <plaats en jaartal van uitgave>

'''Vermeldingen in brieven'''
* <MEP-nummer van de brief onderstreept> <2x tab> <verwijzing annotatie in brief>
* Citaat tussen enkele aanhalingstekens

'''Aanvullende informatie'''

'''Record in RKDartists&'''
* Permalink

'''Annotaties'''

=====Naamgeving dossier=====
De bestandsnamen voor documenten in Publicaties betreffen de namen van tijdschriften en kranten. Woorden worden van elkaar gescheiden door middel van een underscore. Deze map is alfabetisch gerangschikt.

===Inventarisatie_beheer===
====Bewaarplaatsen====

Alle oude versies van beeldmateriaal van brieven opslaan in repository in de map Inventarisatie_beheer/Bewaarplaatsen zoals ze worden toegestuurd door de beherende instellingen. De kans bestaat dat er kleine foutjes insluipen bij het overhevelen naar de map ‘Info per brief’ in de repository. Het scheelt veel uitzoekwerk als ik dan terug kan grijpen op de originele bestanden.

====Herkomstonderzoek====
[Nog beschrijven]

====Inventarisatie====
Drie mappen in dit Excel-bestand: brieven van Piet Mondriaan, Geschriften van Mondriaan en brieven aan Mondriaan.
Hier komt de toelichting op de inventarisatie van alle brieven en geschriften.
Termen uitschrijven, zoals EDS bij alternatieve datering (= door de editeurs vastgestelde datering van een brief).
Kleurcoderingen uitleggen: geel is voorlopig/onzeker, oranje is vervallen brieven, paars zijn briefverwijzingen van Louis Veen.

====Inventarisatie beeldmateriaal====

Van de ongedateerde brieven wordt voorlopig de alternatieve datering aangehouden met het oog op de sorteerfunctie van Excel. De cel waarin zo’n alternatieve datering in de dateringskolom is opgenomen, is geel gemaakt om te voorkomen dat het lijkt alsnog deze voorlopige datering is vastgesteld.

===Teksten===
Deze map bevat alle xml-bestanden van brieven en geschriften, verdeeld over respectievelijk de submappen /Letters, /Letters Preliminary en /Writings.

====Letters====
Documenten die in /Letters staan, worden ook getoond in de demoversie van de editie. Daarom worden transcripties tijdens het bewerkingsproces in /Letters Preliminary geplaatst; pas als ze afgerond zijn, worden ze in /Letters geplaatst.

====Bestanden per brief/geschrift====
Voor de bewerking van de brieven en theoretische geschriften op de uiteenlopende terreinen (tekst, annotaties, verwijzingen, afbeeldingen etc.) wordt per brief respectievelijk geschrift een afzonderlijk bestand gebruikt. Elk bestand krijgt een unieke, herkenbare naam (zie hierna); een definitief briefnummer kan pas bij publicatie worden toegekend.
De bestanden worden geschreven in xml en gecodeerd volgens richtlijnen van TEI / DALF; zie hiervoor ‘Encoding Mondrian’.
Naamgeving tekstbestanden
Bestandsnamen van brieven
Bestandsnamen van brieven bestaan uit drie onderdelen:
# datum (jjjjmmdd)
# indien geschreven door PM: verkorte achternaam geadresseerde (4 eerste letters, kapitalen); indien geschreven aan PM: afkorting PM + verkorte achternaam geadresseerde (4 eerste letters, kapitalen); indien er meer correspondenten met dezelfde achternaam zijn, volgt op de achternaam de voornaam, ook verkort (vier eerste letters, kapitalen)
Al deze onderdelen worden van elkaar gescheiden door underscore: _
Voorbeelden:
* Brief van Mondriaan aan H. van Assendelft dd. 6 januari 1919 → 19190106_PXXX_ASSE_0184
* Brief aan Mondriaan van Harry Holtzman dd 18 oktober 1939 → 19391018_P054_PM_HOLT_5029
* Brief van Nelly van Doesburg aan Mondriaan dd 18 oktober 1939 → 19391018_PXXX_DOES_NELL_<MEP-nummer>
* Eerdere brief van Nelly van Doesburg dd 18 oktober 1939 → 19391018_PXXX_DOES_NELL_<MEP-nummer>

Tussenvoegsels van achternamen worden niet in de bestandsnaam opgenomen (de, van de, von, de la e.d.).
Wanneer de geadresseerde onbekend is, wordt in de bestandsnaam ANON gebruikt.
Wanneer de achternaam uit minder dan vier letters bestaat wordt de volledige naam opgenomen.
Het kan voorkomen dat in plaats van persoonsnamen namen van bijv. instituties, bedrijven of organisaties worden gebruikt.
Bij onvolledige datering: delen die niet bekend zijn worden ingevuld met x.
Een brief uit de eerste week van april 1922 krijgt als datering 1922040x.
Een brief waarvan die alleen ‘oktober’ als datering heeft, krijgt als datering xxxx10xx.
Een brief waarvan we in het geheel geen indicatie van de datum hebben, krijgt dus als datering acht x’en.
Wanneer een datering globaal is wordt in de bestandsnaam de vroegste datum van de geschatte periode gebruikt: tweede helft mei 1893 wordt dus 18930516.

=====Bestandsnamen van geschriften=====
[wegens de stand van het onderzoek is deze paragraaf zeer voorlopig]
Natuurlijkerwijs zal naar een tekst verwezen worden met de titel. Dateringen gebruiken is minder geschikt. Daarom worden bestandsnamen gebaseerd op (twee of drie hoofdwoorden uit) de titel van de getranscribeerde tekst; dit heeft als voordeel dat versies van één tekst bij elkaar komen te staan. Om versieverschillen aan te geven kan een extensie gebruikt worden. Ook het pilotnummer kan worden gebruikt. Bijv. (fictief):.
<pre>
BORN_HOLLAND_TYPO3_P09
NECESSITY_NEW_TEACHING-PUBL-P11
DIALOOG_NWE_BEELDING_MS1-P01
</pre>
Later in het onderzoek zal bepaald worden of elk document en eigen bestand

====Writings====
Het betreft transcripties van geschriften van Mondriaan. Deze zijn verschillend van aard. Van sommige bestaat een originele handgeschreven versie, van sommige is alleen de publicatie in een tijdschrift bekend. Alles komt in deze map. Daarin vinden tevens documenten met gegevens die betrekking hebben op de geschriften een plek. Als Mondriaan een hoofdstuk publiceerde in een catalogus, dan is de algemene informatie hierover, samengesteld voor het maken van annotaties of algemene achtergrond informatie, opgenomen in een Word-document.
Deze map is onderverdeeld in submappen op jaartal en titel van het geschrift. In deze sub mappen komen de verschillende documenten, dus ook alle versies van hetzelfde geschrift en het Xml-bestand.
De opbouw van de bestandsnamen is als volgt:
* <jaartal>_<titel geschrift aan elkaar, spaties door middel van underscores>
Deze map is daardoor chronologisch gerangschikt.

===Verantwoording===
Map bevat zowel zelfstandige bestanden die methode en werkwijze beschrijven, als de submap met xml-instructie, /Documentation. De bestanden kunnen in uiteenlopende programma’s geschreven zijn (m.n. Word en Oxygen).

===Titels===
====Titels van kunstwerken: werken van Mondriaan====
We vermelden de titel kort, gevolgd door het jaartal en het CR-nummer tussen haakjes:
Composition, 1938 (B290).

====Titels van kunstwerken: werken van andere kunstenaars====
Idem als voor Mondriaan: gegevens uit Catalogue Raisonné van de betreffende kunstenaar gebruiken en anders de meest betrouwbare catalogus/beschrijving die voorhanden is (bijvoorbeeld de informatie van de rechthebbende kunstenaars foundation).

====Titels van publicaties====
Titelbeschrijvingen zijn in het Engels. We nemen het Angelsaksische gebruik van hoofdletters wel/niet over.
We stellen ons voor dat bij een mouse-over op de verkorte titel de volledige titelbeschrijving zichtbaar wordt.
Daarnaast komt er een volledige lijst van geraadpleegde werken.
Uitgangspunt is altijd de titelpagina van de publicatie.
In annotaties en commentaren wordt naar publicaties verwezen door middel van verkorte titels, als volgt:
* Catalogue raisonné van Mondriaans werken: CR II, p. 297-298.
Deze verkorte titel is een uitzondering op het hierna volgende omdat veelvuldig naar deze oevrecatalogus wordt verwezen.
* Van publicaties met niet meer dan auteur en titel: achternaam en jaartal, verlengd met een volgorde-aanduiding: De la Porte 1956-a.
De -a wordt altijd toegevoegd zodat dit niet alsnog hoeft te worden gedaan als later een tweede publicatie van dezelfde auteur uit hetzelfde jaar toegevoegd moet worden (met -b). Bij publicatie van de editie wordt dit aangepast.
* Meerdere auteurs: alleen de eerstgenoemde wordt vermeld.
* Tentoonstellingscatalogus: Exh.cat. New York 2010.
Als de tentoonstelling in meerdere steden plaatsvond en/of over het einde van het jaar liep, wordt alleen de eerste stad en het eerste jaar vermeld.
* Veilingcatalogus: Auct.cat. Christie’s, New York 1976; Auct.cat. Drouot, Paris 1886.
De naam van het veilinghuis wordt kort gehouden.

==See also==
* [[XML Mondrian Guidelines]]

[[Category:XML Mondrian]]

Project procedure (Mondrian)

2017-01-25T13:51:07Z

ASC: /* Titels van kunstwerken: werken van Mondriaan */

Op deze pagina worden afspraken ten aanzien van de werkwijze vastgelegd voor het Mondriaan Editieproject. Daarmee bedoelen we de organisatie van het daadwerkelijke onderzoek en archivering van bestanden en documentatie die daarbij nodig zijn of die daaruit voortkomen. Behalve ter verantwoording van de gehanteerde aanpak is dit document ook bedoeld als houvast voor editeurs en andere medewerkers van het projectteam.
Aan het project wordt over een zeer lange periode gewerkt door meerdere personen met deels verschillende verantwoordelijkheden en uiteenlopende werktijden. Het is noodzakelijk dat zij zich allen houden aan dezelfde, hieronder beschreven uitgangspunten voor de tekstbewerking, het inhoudelijk onderzoek, het schrijven van annotaties en commentaar, het opslaan van de vergaarde en geproduceerde digitale bestanden en het beheer van (digitale en papieren) onderzoeksdocumentatie.
Het belang van deze ‘discipline’ is tweeledig. Ten eerste een efficiënt werkproces: wanneer iedereen zich aan dezelfde uitgangspunten houdt, kan werk gemakkelijker gedeeld en verdeeld worden; eventuele nieuwe medewerkers (met name stagiairs) kunnen gemakkelijker aanhaken als de aanpak voorgeschreven is; en de kans op het vergeten van ‘hoe we dat ook alweer deden’ wordt erdoor gereduceerd. Ten tweede bepaalt consistentie in hoge mate de uiteindelijke kwaliteit en betrouwbaarheid van de editie. Een consistente aanpak vanaf het begin draagt daar heel veel aan bij.
Tijdens het onderzoek — in elk geval in de eerste jaren, en zeker totdat alle onderdelen van het editieproces ten minste eenmaal aan de orde zijn geweest — zullen regelmatig nieuwe beslissingen over de werkwijze genomen moeten worden en oude bijgesteld. Telkens zullen die keuzes en afspraken direct moeten worden opgenomen in dit document.

==Repository==
Voor het Mondriaan Editieproject is schijfruimte ingericht op een repository zodat teamleden werkend vanuit het RKD en het Huygens ING toegang tot de documenten hebben. Dit document is bedoeld als verantwoording voor de wijze waarop welke informatie op welke plaats kan worden opgeborgen op de repository. Voor de continuïteit en vindbaarheid van documenten voor alle medewerkers van het project is het essentieel dat de hieronder beschreven richtlijnen worden gevolgd. Bovendien kan dit document helpen bij twijfel bij opberging van gegevens of raadpleging.
===Inchecken en updaten===
Alle bestanden die voortkomen uit het project (dus niet alleen de tekstbestanden maar ook de documentatie, administratie etc.) worden opgeslagen in de Repository. Het is van groot belang dat alle vergaarde informatie voor alle medewerkers in het project beschikbaar is. Om die reden is het volgende een volstrekt vereiste:
# ALVORENS ZIJN/HAAR COMPUTER (AAN HET EINDE VAN DE DAG) AF TE SLUITEN DOET ELKE MEDEWERKER EEN COMPLETE CHECK-OUT NAAR DE REPOSITORY. Vaker uitchecken is zeker toegestaan.
# BIJ HET OPENEN VAN DE SVN-CLIENT DOET ELKE MEDEWERKER EEN COMPLETE CHECK-IN UIT DE REPOSITORY.
Voor alle typen bestanden zijn mappen gemaakt met een vastgestelde indeling. Het is toegestaan nieuwe bestanden in bestaande mappen toe te voegen (als ze daar ook thuishoren). Het toevoegen, verwijderen of verplaatsen van mappen is achter alleen toegestaan na overleg door editeurs en documentalist omdat anders bij in- en uitchecken verwarring kan ontstaan.
===Gebruikers===
De editeurs werken voornamelijk in de map Teksten. Daarnaast zijn zij verantwoordelijk voor de mappen Apparaat, Verantwoording en Tests. In deze mappen maken zij zelf documenten aan. In de submappen onder Commentaar werken ze in bestaande documenten en maken, in overleg met de documentalist, nieuwe documenten aan.
De documentalist is verantwoordelijk voor de submappen onder Commentaar en maakt bestanden aan. De documentalist voegt hier nieuwe gegevens aan toe, die onder andere worden aangeleverd door de editeurs. Alle documenten in de mappen Apparaat, Teksten en Verantwoording worden door de documentalist ter raadpleging gebruikt maar zal daar geen wijzigingen in aanbrengen.
===Overige opmerkingen===
Voor de leesbaarheid zijn de namen van de hoofdmappen in hoofdletters weergegeven.
Bij documentatiemateriaal dat wordt gescand uit boeken, wordt altijd de voorkant opgenomen.
==Structuur repository==
De hoofdstructuur van de repository is als volgt:
* Administratie
* Bibliotheek
* Commentaar
** Begeleidende teksten
** Biografische Mondriaan documentatie
* Documentatie
** Info – per brief
** Organisatie – kunst
** Organisatie – overig
** Personen
** Publicaties
* Inventarisatie_beheer
** Bewaarplaatsen
** Herkomstonderzoek
** Inventarisatie
** Selectie pilot
* Secundair
* Teksten
** Letters
** Letters Preliminary
** Writings
* Tests and Samples (voor ICT-doeleinden; niet voor editeursteam)
* Verantwoording
** Editieverantwoording (van N-schijf)
** Documentation

===Administratie===
Stageopdrachten en reisschema’s bijvoorbeeld.

===Bibliotheek===
====Inhoud====
In de Bibliotheek komt alle relevante literatuur voor het project en bevat scans of digitale versies van
volledige publicaties die een fysieke publicatie kunnen vervangen.
De bibliotheek is een hulpmiddel en maakt strikt genomen geen deel uit van de opbouw van de
annotaties (zoals /Personen e.d.).

De enige eis is dat het bestand compleet moet zijn, dus een volledig gescand boek of een volledig
artikel/hoofdstuk uit een boek. Omdat de bestandsnaam kort en bondig moet zijn, dient alle
informatie over het gescande boek of hoofdstuk/artikel duidelijk in het document zelf voor te komen en moet altijd de voorkant van het boek gescand worden.
Er wordt geen onderscheid gemaakt tussen artikelen of boeken. Per publicatie wordt een submap
Gemaakt (voorstel EdV: pas aanmaken als er meerdere documenten per publicatie zijn, anders onnodig veel klikken). Zo kunnen behalve scans bijvoorbeeld ook informatie óver de publicatie opgenomen worden; achtergrond van ontstaan van een publicatie bijvoorbeeld.
Naamgeving
De opbouw van bestandsnamen voor documenten in deze map: <achternaam auteur>_<titel, spaties
door middel van underscores>_<jaartal van publicatie>

Lange titels worden verkort; ze moeten significante informatie over het gescande boek of
hoofdstuk/artikel geven; altijd moet de titelpagina van de publicatie gescand worden.

Door de opbouw van de bestandsnamen in de map is deze alfabetisch gerangschikt.

NB. Voor publicaties van Mondriaan is een aparte submap.

===Commentaar===
Map bevat alle documenten die gegevens bevatten voor alle vormen van inhoudelijk editeurscommentaar (m.n. annotaties, biografieën, inleidingen e.d.). De documenten zijn verschillend van aard: het gaat om Word-bestanden, die door het Mondriaan-team zijn samengesteld, scans uit boeken en bijvoorbeeld foto’s. De map /Commentaar is verdeeld in verschillende submappen.
Documentatie
====Info-per brief====
Bevat mappen voor elke brief; de briefmap bevat bestanden met gegevens die belangrijk zijn bij het
annoteren maar die onder geen van de andere categorieën (die hierna volgen) thuis te brengen zijn.
De Word-bestanden en scans of andere documenten die bij de betreffende brief horen, zullen
dezelfde naam krijgen als de brief.
=====Inhoud dossier=====
De briefmap bevat een bronnenmap voor reproducties en een voor de materiële beschrijving van de betreffende brief.
=====Structuur dossier=====
[nog schrijven]
=====Naamgeving dossier=====
De mappen hebben uitsluitend het viercijferige MEP-nummer. Eerder bleek dat een naamgeving die bestond uit de datum, gevolgd door geadresseerde sterk onderhevig is aan verandering. Daardoor vormde die constructie geen betrouwbare bestandsnaam. Het MEP-nummer is misschien lastiger om mee te werken omdat niet in één oogopslag duidelijk is om welke brief het gaat (dan moet je de inventarisatie erbij pakken), maar de MEP-nummers blijven wel hetzelfde.

De naamgeving van het dossier is als volgt opgebouwd:
<pre>Brievenmap <viercijferige MEP-nummer>
BRON_<MEP-nummer>
Repr_<MEP-nummer>
Mat_beschr_<MEP-nummer></pre>
====Organisatie - kunst====
Onder ‘kunstorganisaties’ worden verstaan alle instellingen, organisaties, bedrijven, verenigingen etc.
die gebaseerd zijn op betrokkenheid bij kunst. Dus musea, kunstenaarsverenigingen,
kunsthandels/galeries, tentoonstellingen e.d.
=====Inhoud dossier=====
Alle kunstorganisaties die in de brieven voorkomen, krijgen eigen dossiers. Deze dossiers bestaan uit
afzonderlijke mappen, bedoeld om gegevens te verzamelen voor het maken van annotaties. De
mappen kunnen verschillende soorten documenten bevatten, waaronder één Word-bestand met
eigen, samengestelde informatie en scans van fragmenten uit boeken relevant voor de betreffende
organisatie.
De kern van het dossier wordt gevormd door het Word-bestand met de volgende categorieën:
* Volledige naam
* Actieve jaren
* Nationaliteit
* Kwalificatie
* Vestiging van de organisatie (locatie)
* Vermeldingen in brieven
* Aanvullende informatie
* Record in RKDartists&
* Annotaties
=====Structuur dossier=====
De structuur van deze dossiers is als volgt:

'''Titel'''
<naam van de organisatie> <tussen ronde haken jaren dat organisatie actief was, als dit te vinden is>
<Nationaliteit en kwalificatie>
Gevestigd op <adres en plaatsnaam, indien dit van belang is of genoemd wordt in de brieven>

'''Vermeldingen in brieven'''
• <MEP-nummer van de brief onderstreept> <2x tab> <verwijzing annotatie in brief>
• Citaat tussen enkele aanhalingstekens

'''Aanvullende informatie'''

'''Record in RKDartists&'''
• Permalink

'''Annotaties'''

=====Naamgeving=====
De bestandsnaam voor documenten in Org-kunst bestaat uit de volledige naam van de betreffende
kunstenaarsvereniging, museum etc. Woorden worden aan elkaar geschreven, spaties door middel
van underscores.
Als het bijvoorbeeld om een kunsthandel gaat en het woord ‘galerie’ maakt
officieel deel uit van de naam, dan wordt deze als zodanig opgenomen. Is alfabetisch niet
inzichtelijker? LJ Dit is in overeenstemming met de regels van invoer van kunsthandels in RKDartists&.
Dit leidt bijvoorbeeld tot ‘Galerie_Nierendorf’ en ‘Valentine_Gallery’.

Voor bijvoorbeeld tentoonstellingen waarvan het (nog) onbekend is om welke tentoonstelling het
precies gaat, wordt de volgende opbouw van bestandsnamen gehanteerd:
<TS>_<plaats van de tentoonstelling>_<jaartal> (bijv. TS_New_York_1937)
De map /Organisatie - kunst is automatisch alfabetisch gerangschikt.
====Organisatie-overig====
Bevat mappen met dossiers van alle overige bedrijven, instellingen etc., al dan niet commercieel.
Bijvoorbeeld immigratiedienst, advocatenkantoor, scheepvaartmaatschappij, theosofische vereniging,
etc.
=====Inhoud dossier=====
De kern van het dossier wordt gevormd door een Word-bestand met dezelfde categorieën als bij kunstorganisaties, voor zover van toepassing. Het dossier kan ook andere documenten bevatten zoals webpagina’s, scans van fragmenten uit boeken relevant voor de betreffende organisatie.
=====Structuur en naamgeving dossier=====
Voor de naamgeving en structuur van het dossier /Organisatie - overig: zie /Organisatie - kunst, mutatis mutandis.

De map /Organisatie - overig is automatisch alfabetisch gerangschikt.

====Personen====
Alle personen die in de brieven voorkomen, krijgen een persoonsdossier. Voor bijvoorbeeld kunsthandelaren met een eigen galerie die ook verzamelden, wordt alles over de persoon en de handel in één dossier verzameld. Bij Valentine Dudensing komen alle gegevens in het document over de galerie. In het document van de persoon wordt alleen een verwijzing naar de galerie opgenomen.
=====Inhoud dossier=====
Deze dossiers bestaan uit afzonderlijke mappen, bedoeld om gegevens te verzamelen voor het maken
van annotaties. De kern van het dossier wordt gevormd door een Word-bestand met de volgende
categorieën:

* Volledige naam
* Kwalificatie
Kunsthandelaar, kunstenaar, verzamelaar etc.
* Genoemde kunstwerken
* Vermeldingen in brieven (citaten uit brieven van Mondriaan waarin deze persoon voorkomt)
* Aanvullende informatie
Algemene gegevens (achtergrondinformatie) die door de editeurs of de documentalist zijn/is achterhaald en van belang zijn/is bij het maken van annotaties.
* Record in RKDartists&
Hier komt de permalink uit RKDexplore zodat de records eenvoudig te raadplegen zijn voor de editeurs.
* Annotaties

De mappen kunnen verschillende soorten documenten bevatten, waaronder één Word-bestand met
eigen, samengestelde informatie en scans van fragmenten uit boeken relevant voor de betreffende
persoon.
=====Structuur dossier=====
<voornaam>, <achternaam> <geboorte-en sterfdata>
<nationaliteit en kwalificatie, indien bekend>

'''Genoemde kunstwerken'''

'''Vermeldingen in brieven'''
* <MEP-nummer van de brief onderstreept> <2x tab> <verwijzing annotatie in brief>
* Citaat tussen enkele aanhalingstekens

'''Aanvullende informatie'''

'''Record in RKDartists&'''
* Permalink

'''Annotaties'''

=====Naamgeving dossier=====
De bestandsnamen voor documenten in /Personen wordt als volgt opgebouwd:
<Achternaam in hoofdletters>_<voornaam in kleine letters>

Mocht twee keer dezelfde naam voorkomen maar het betreft een ander persoon dan kunnen
geboorte-en sterfdata worden toegevoegd, bijvoorbeeld:
HELION_Jean_(1900-1944)
HELION_Jean_(1904-1987)

De map /Personen is automatisch alfabetisch gerangschikt.

====Publicaties====
Bevat documenten met informatie over in de brieven en geschriften genoemde boeken, tijdschriften,
brochures en andere al dan niet commerciële publicaties. De mappen kunnen verschillende soorten
documenten bevatten, waaronder één Word-bestand met eigen, samengestelde informatie en scans
van fragmenten uit boeken relevant voor de betreffende tijdschriften, kranten en andere publicaties. De documenten in deze map zijn anders opgebouwd dan de persoons- en organisatiedossiers en hebben een eigen template, waarin de naam, actieve jaren, nationaliteit en kwalificatie van de krant of het tijdschrift staan vermeld. Bij publicaties wordt volstaan met de vermelding van de auteur, titel en plaats en jaar van uitgave. Daarnaast zijn de gebruikelijke categorieën, vermeldingen in brieven, aanvullende informatie, record in RKDartists& en annotaties, opgenomen.
In de map /Commentaar is weliswaar een onderscheid gemaakt in een aantal categorieën maar die zullen in de praktijk regelmatig overlappen; zo kan een galerie een catalogus uitgeven; informatie daarover kan in /Organisatie - kunst en in /Publicaties.

=====Structuur dossier=====
<naam van tijdschrift of krant> <tussen ronde haken jaren dat tijdschrift of krant actief was>
<Nationaliteit en kwalificatie> of <auteur van de publicatie>, <titel publicatie>, <plaats en jaartal van uitgave>

'''Vermeldingen in brieven'''
* <MEP-nummer van de brief onderstreept> <2x tab> <verwijzing annotatie in brief>
* Citaat tussen enkele aanhalingstekens

'''Aanvullende informatie'''

'''Record in RKDartists&'''
* Permalink

'''Annotaties'''

=====Naamgeving dossier=====
De bestandsnamen voor documenten in Publicaties betreffen de namen van tijdschriften en kranten. Woorden worden van elkaar gescheiden door middel van een underscore. Deze map is alfabetisch gerangschikt.

===Inventarisatie_beheer===
====Bewaarplaatsen====

Alle oude versies van beeldmateriaal van brieven opslaan in repository in de map Inventarisatie_beheer/Bewaarplaatsen zoals ze worden toegestuurd door de beherende instellingen. De kans bestaat dat er kleine foutjes insluipen bij het overhevelen naar de map ‘Info per brief’ in de repository. Het scheelt veel uitzoekwerk als ik dan terug kan grijpen op de originele bestanden.

====Herkomstonderzoek====
[Nog beschrijven]

====Inventarisatie====
Drie mappen in dit Excel-bestand: brieven van Piet Mondriaan, Geschriften van Mondriaan en brieven aan Mondriaan.
Hier komt de toelichting op de inventarisatie van alle brieven en geschriften.
Termen uitschrijven, zoals EDS bij alternatieve datering (= door de editeurs vastgestelde datering van een brief).
Kleurcoderingen uitleggen: geel is voorlopig/onzeker, oranje is vervallen brieven, paars zijn briefverwijzingen van Louis Veen.

====Inventarisatie beeldmateriaal====

Van de ongedateerde brieven wordt voorlopig de alternatieve datering aangehouden met het oog op de sorteerfunctie van Excel. De cel waarin zo’n alternatieve datering in de dateringskolom is opgenomen, is geel gemaakt om te voorkomen dat het lijkt alsnog deze voorlopige datering is vastgesteld.

===Teksten===
Deze map bevat alle xml-bestanden van brieven en geschriften, verdeeld over respectievelijk de submappen /Letters, /Letters Preliminary en /Writings.

====Letters====
Documenten die in /Letters staan, worden ook getoond in de demoversie van de editie. Daarom worden transcripties tijdens het bewerkingsproces in /Letters Preliminary geplaatst; pas als ze afgerond zijn, worden ze in /Letters geplaatst.

====Bestanden per brief/geschrift====
Voor de bewerking van de brieven en theoretische geschriften op de uiteenlopende terreinen (tekst, annotaties, verwijzingen, afbeeldingen etc.) wordt per brief respectievelijk geschrift een afzonderlijk bestand gebruikt. Elk bestand krijgt een unieke, herkenbare naam (zie hierna); een definitief briefnummer kan pas bij publicatie worden toegekend.
De bestanden worden geschreven in xml en gecodeerd volgens richtlijnen van TEI / DALF; zie hiervoor ‘Encoding Mondrian’.
Naamgeving tekstbestanden
Bestandsnamen van brieven
Bestandsnamen van brieven bestaan uit drie onderdelen:
# datum (jjjjmmdd)
# indien geschreven door PM: verkorte achternaam geadresseerde (4 eerste letters, kapitalen); indien geschreven aan PM: afkorting PM + verkorte achternaam geadresseerde (4 eerste letters, kapitalen); indien er meer correspondenten met dezelfde achternaam zijn, volgt op de achternaam de voornaam, ook verkort (vier eerste letters, kapitalen)
Al deze onderdelen worden van elkaar gescheiden door underscore: _
Voorbeelden:
* Brief van Mondriaan aan H. van Assendelft dd. 6 januari 1919 → 19190106_PXXX_ASSE_0184
* Brief aan Mondriaan van Harry Holtzman dd 18 oktober 1939 → 19391018_P054_PM_HOLT_5029
* Brief van Nelly van Doesburg aan Mondriaan dd 18 oktober 1939 → 19391018_PXXX_DOES_NELL_<MEP-nummer>
* Eerdere brief van Nelly van Doesburg dd 18 oktober 1939 → 19391018_PXXX_DOES_NELL_<MEP-nummer>

Tussenvoegsels van achternamen worden niet in de bestandsnaam opgenomen (de, van de, von, de la e.d.).
Wanneer de geadresseerde onbekend is, wordt in de bestandsnaam ANON gebruikt.
Wanneer de achternaam uit minder dan vier letters bestaat wordt de volledige naam opgenomen.
Het kan voorkomen dat in plaats van persoonsnamen namen van bijv. instituties, bedrijven of organisaties worden gebruikt.
Bij onvolledige datering: delen die niet bekend zijn worden ingevuld met x.
Een brief uit de eerste week van april 1922 krijgt als datering 1922040x.
Een brief waarvan die alleen ‘oktober’ als datering heeft, krijgt als datering xxxx10xx.
Een brief waarvan we in het geheel geen indicatie van de datum hebben, krijgt dus als datering acht x’en.
Wanneer een datering globaal is wordt in de bestandsnaam de vroegste datum van de geschatte periode gebruikt: tweede helft mei 1893 wordt dus 18930516.

=====Bestandsnamen van geschriften=====
[wegens de stand van het onderzoek is deze paragraaf zeer voorlopig]
Natuurlijkerwijs zal naar een tekst verwezen worden met de titel. Dateringen gebruiken is minder geschikt. Daarom worden bestandsnamen gebaseerd op (twee of drie hoofdwoorden uit) de titel van de getranscribeerde tekst; dit heeft als voordeel dat versies van één tekst bij elkaar komen te staan. Om versieverschillen aan te geven kan een extensie gebruikt worden. Ook het pilotnummer kan worden gebruikt. Bijv. (fictief):.
<pre>
BORN_HOLLAND_TYPO3_P09
NECESSITY_NEW_TEACHING-PUBL-P11
DIALOOG_NWE_BEELDING_MS1-P01
</pre>
Later in het onderzoek zal bepaald worden of elk document en eigen bestand

====Writings====
Het betreft transcripties van geschriften van Mondriaan. Deze zijn verschillend van aard. Van sommige bestaat een originele handgeschreven versie, van sommige is alleen de publicatie in een tijdschrift bekend. Alles komt in deze map. Daarin vinden tevens documenten met gegevens die betrekking hebben op de geschriften een plek. Als Mondriaan een hoofdstuk publiceerde in een catalogus, dan is de algemene informatie hierover, samengesteld voor het maken van annotaties of algemene achtergrond informatie, opgenomen in een Word-document.
Deze map is onderverdeeld in submappen op jaartal en titel van het geschrift. In deze sub mappen komen de verschillende documenten, dus ook alle versies van hetzelfde geschrift en het Xml-bestand.
De opbouw van de bestandsnamen is als volgt:
* <jaartal>_<titel geschrift aan elkaar, spaties door middel van underscores>
Deze map is daardoor chronologisch gerangschikt.

===Verantwoording===
Map bevat zowel zelfstandige bestanden die methode en werkwijze beschrijven, als de submap met xml-instructie, /Documentation. De bestanden kunnen in uiteenlopende programma’s geschreven zijn (m.n. Word en Oxygen).

===Titels===
====Titels van kunstwerken: werken van Mondriaan====
We vermelden de titel kort, gevolgd door het jaartal en het CR-nummer tussen haakjes:
Composition, 1938 (B290).

====Titels van kunstwerken: werken van andere kunstenaars====
Idem als voor Mondriaan: gegevens uit Catalogue Raisonné van de betreffende kunstenaar gebruiken en anders de meest betrouwbare catalogus/beschrijving die voorhanden is (bijvoorbeeld de informatie van de rechthebbende kunstenaars foundation).

====Titels van publicaties====
Titelbeschrijvingen zijn in het Engels. We nemen het Angelsaksische gebruik van hoofdletters wel/niet over.
We stellen ons voor dat bij een mouse-over op de verkorte titel de volledige titelbeschrijving zichtbaar wordt.
Daarnaast komt er een volledige lijst van geraadpleegde werken.
Uitgangspunt is altijd de titelpagina van de publicatie.
In annotaties en commentaren wordt naar publicaties verwezen door middel van verkorte titels, als volgt:
* Catalogue raisonné van Mondriaans werken: CR II, p. 297-298.
Deze verkorte titel is een uitzondering op het hierna volgende omdat veelvuldig naar deze oevrecatalogus wordt verwezen.
* Van publicaties met niet meer dan auteur en titel: achternaam en jaartal, verlengd met een volgorde-aanduiding: De la Porte 1956-a.
De -a wordt altijd toegevoegd zodat dit niet alsnog hoeft te worden gedaan als later een tweede publicatie van dezelfde auteur uit hetzelfde jaar toegevoegd moet worden (met -b). Bij publicatie van de editie wordt dit aangepast.
* Meerdere auteurs: alleen de eerstgenoemde wordt vermeld.
* Tentoonstellingscatalogus: Exh.cat. New York 2010.
Als de tentoonstelling in meerdere steden plaatsvond en/of over het einde van het jaar liep, wordt alleen de eerste stad en het eerste jaar vermeld.
* Veilingcatalogus: Auct.cat. Christie’s, New York 1976; Auct.cat. Drouot, Paris 1886.
De naam van het veilinghuis wordt kort gehouden.

==See also==
* [[XML Mondrian Guidelines]]

[[Category:XML Mondrian]]

Project procedure (Mondrian)

2017-01-25T13:49:44Z

ASC:

Op deze pagina worden afspraken ten aanzien van de werkwijze vastgelegd voor het Mondriaan Editieproject. Daarmee bedoelen we de organisatie van het daadwerkelijke onderzoek en archivering van bestanden en documentatie die daarbij nodig zijn of die daaruit voortkomen. Behalve ter verantwoording van de gehanteerde aanpak is dit document ook bedoeld als houvast voor editeurs en andere medewerkers van het projectteam.
Aan het project wordt over een zeer lange periode gewerkt door meerdere personen met deels verschillende verantwoordelijkheden en uiteenlopende werktijden. Het is noodzakelijk dat zij zich allen houden aan dezelfde, hieronder beschreven uitgangspunten voor de tekstbewerking, het inhoudelijk onderzoek, het schrijven van annotaties en commentaar, het opslaan van de vergaarde en geproduceerde digitale bestanden en het beheer van (digitale en papieren) onderzoeksdocumentatie.
Het belang van deze ‘discipline’ is tweeledig. Ten eerste een efficiënt werkproces: wanneer iedereen zich aan dezelfde uitgangspunten houdt, kan werk gemakkelijker gedeeld en verdeeld worden; eventuele nieuwe medewerkers (met name stagiairs) kunnen gemakkelijker aanhaken als de aanpak voorgeschreven is; en de kans op het vergeten van ‘hoe we dat ook alweer deden’ wordt erdoor gereduceerd. Ten tweede bepaalt consistentie in hoge mate de uiteindelijke kwaliteit en betrouwbaarheid van de editie. Een consistente aanpak vanaf het begin draagt daar heel veel aan bij.
Tijdens het onderzoek — in elk geval in de eerste jaren, en zeker totdat alle onderdelen van het editieproces ten minste eenmaal aan de orde zijn geweest — zullen regelmatig nieuwe beslissingen over de werkwijze genomen moeten worden en oude bijgesteld. Telkens zullen die keuzes en afspraken direct moeten worden opgenomen in dit document.

==Repository==
Voor het Mondriaan Editieproject is schijfruimte ingericht op een repository zodat teamleden werkend vanuit het RKD en het Huygens ING toegang tot de documenten hebben. Dit document is bedoeld als verantwoording voor de wijze waarop welke informatie op welke plaats kan worden opgeborgen op de repository. Voor de continuïteit en vindbaarheid van documenten voor alle medewerkers van het project is het essentieel dat de hieronder beschreven richtlijnen worden gevolgd. Bovendien kan dit document helpen bij twijfel bij opberging van gegevens of raadpleging.
===Inchecken en updaten===
Alle bestanden die voortkomen uit het project (dus niet alleen de tekstbestanden maar ook de documentatie, administratie etc.) worden opgeslagen in de Repository. Het is van groot belang dat alle vergaarde informatie voor alle medewerkers in het project beschikbaar is. Om die reden is het volgende een volstrekt vereiste:
# ALVORENS ZIJN/HAAR COMPUTER (AAN HET EINDE VAN DE DAG) AF TE SLUITEN DOET ELKE MEDEWERKER EEN COMPLETE CHECK-OUT NAAR DE REPOSITORY. Vaker uitchecken is zeker toegestaan.
# BIJ HET OPENEN VAN DE SVN-CLIENT DOET ELKE MEDEWERKER EEN COMPLETE CHECK-IN UIT DE REPOSITORY.
Voor alle typen bestanden zijn mappen gemaakt met een vastgestelde indeling. Het is toegestaan nieuwe bestanden in bestaande mappen toe te voegen (als ze daar ook thuishoren). Het toevoegen, verwijderen of verplaatsen van mappen is achter alleen toegestaan na overleg door editeurs en documentalist omdat anders bij in- en uitchecken verwarring kan ontstaan.
===Gebruikers===
De editeurs werken voornamelijk in de map Teksten. Daarnaast zijn zij verantwoordelijk voor de mappen Apparaat, Verantwoording en Tests. In deze mappen maken zij zelf documenten aan. In de submappen onder Commentaar werken ze in bestaande documenten en maken, in overleg met de documentalist, nieuwe documenten aan.
De documentalist is verantwoordelijk voor de submappen onder Commentaar en maakt bestanden aan. De documentalist voegt hier nieuwe gegevens aan toe, die onder andere worden aangeleverd door de editeurs. Alle documenten in de mappen Apparaat, Teksten en Verantwoording worden door de documentalist ter raadpleging gebruikt maar zal daar geen wijzigingen in aanbrengen.
===Overige opmerkingen===
Voor de leesbaarheid zijn de namen van de hoofdmappen in hoofdletters weergegeven.
Bij documentatiemateriaal dat wordt gescand uit boeken, wordt altijd de voorkant opgenomen.
==Structuur repository==
De hoofdstructuur van de repository is als volgt:
* Administratie
* Bibliotheek
* Commentaar
** Begeleidende teksten
** Biografische Mondriaan documentatie
* Documentatie
** Info – per brief
** Organisatie – kunst
** Organisatie – overig
** Personen
** Publicaties
* Inventarisatie_beheer
** Bewaarplaatsen
** Herkomstonderzoek
** Inventarisatie
** Selectie pilot
* Secundair
* Teksten
** Letters
** Letters Preliminary
** Writings
* Tests and Samples (voor ICT-doeleinden; niet voor editeursteam)
* Verantwoording
** Editieverantwoording (van N-schijf)
** Documentation

===Administratie===
Stageopdrachten en reisschema’s bijvoorbeeld.

===Bibliotheek===
====Inhoud====
In de Bibliotheek komt alle relevante literatuur voor het project en bevat scans of digitale versies van
volledige publicaties die een fysieke publicatie kunnen vervangen.
De bibliotheek is een hulpmiddel en maakt strikt genomen geen deel uit van de opbouw van de
annotaties (zoals /Personen e.d.).

De enige eis is dat het bestand compleet moet zijn, dus een volledig gescand boek of een volledig
artikel/hoofdstuk uit een boek. Omdat de bestandsnaam kort en bondig moet zijn, dient alle
informatie over het gescande boek of hoofdstuk/artikel duidelijk in het document zelf voor te komen en moet altijd de voorkant van het boek gescand worden.
Er wordt geen onderscheid gemaakt tussen artikelen of boeken. Per publicatie wordt een submap
Gemaakt (voorstel EdV: pas aanmaken als er meerdere documenten per publicatie zijn, anders onnodig veel klikken). Zo kunnen behalve scans bijvoorbeeld ook informatie óver de publicatie opgenomen worden; achtergrond van ontstaan van een publicatie bijvoorbeeld.
Naamgeving
De opbouw van bestandsnamen voor documenten in deze map: <achternaam auteur>_<titel, spaties
door middel van underscores>_<jaartal van publicatie>

Lange titels worden verkort; ze moeten significante informatie over het gescande boek of
hoofdstuk/artikel geven; altijd moet de titelpagina van de publicatie gescand worden.

Door de opbouw van de bestandsnamen in de map is deze alfabetisch gerangschikt.

NB. Voor publicaties van Mondriaan is een aparte submap.

===Commentaar===
Map bevat alle documenten die gegevens bevatten voor alle vormen van inhoudelijk editeurscommentaar (m.n. annotaties, biografieën, inleidingen e.d.). De documenten zijn verschillend van aard: het gaat om Word-bestanden, die door het Mondriaan-team zijn samengesteld, scans uit boeken en bijvoorbeeld foto’s. De map /Commentaar is verdeeld in verschillende submappen.
Documentatie
====Info-per brief====
Bevat mappen voor elke brief; de briefmap bevat bestanden met gegevens die belangrijk zijn bij het
annoteren maar die onder geen van de andere categorieën (die hierna volgen) thuis te brengen zijn.
De Word-bestanden en scans of andere documenten die bij de betreffende brief horen, zullen
dezelfde naam krijgen als de brief.
=====Inhoud dossier=====
De briefmap bevat een bronnenmap voor reproducties en een voor de materiële beschrijving van de betreffende brief.
=====Structuur dossier=====
[nog schrijven]
=====Naamgeving dossier=====
De mappen hebben uitsluitend het viercijferige MEP-nummer. Eerder bleek dat een naamgeving die bestond uit de datum, gevolgd door geadresseerde sterk onderhevig is aan verandering. Daardoor vormde die constructie geen betrouwbare bestandsnaam. Het MEP-nummer is misschien lastiger om mee te werken omdat niet in één oogopslag duidelijk is om welke brief het gaat (dan moet je de inventarisatie erbij pakken), maar de MEP-nummers blijven wel hetzelfde.

De naamgeving van het dossier is als volgt opgebouwd:
<pre>Brievenmap <viercijferige MEP-nummer>
BRON_<MEP-nummer>
Repr_<MEP-nummer>
Mat_beschr_<MEP-nummer></pre>
====Organisatie - kunst====
Onder ‘kunstorganisaties’ worden verstaan alle instellingen, organisaties, bedrijven, verenigingen etc.
die gebaseerd zijn op betrokkenheid bij kunst. Dus musea, kunstenaarsverenigingen,
kunsthandels/galeries, tentoonstellingen e.d.
=====Inhoud dossier=====
Alle kunstorganisaties die in de brieven voorkomen, krijgen eigen dossiers. Deze dossiers bestaan uit
afzonderlijke mappen, bedoeld om gegevens te verzamelen voor het maken van annotaties. De
mappen kunnen verschillende soorten documenten bevatten, waaronder één Word-bestand met
eigen, samengestelde informatie en scans van fragmenten uit boeken relevant voor de betreffende
organisatie.
De kern van het dossier wordt gevormd door het Word-bestand met de volgende categorieën:
* Volledige naam
* Actieve jaren
* Nationaliteit
* Kwalificatie
* Vestiging van de organisatie (locatie)
* Vermeldingen in brieven
* Aanvullende informatie
* Record in RKDartists&
* Annotaties
=====Structuur dossier=====
De structuur van deze dossiers is als volgt:

'''Titel'''
<naam van de organisatie> <tussen ronde haken jaren dat organisatie actief was, als dit te vinden is>
<Nationaliteit en kwalificatie>
Gevestigd op <adres en plaatsnaam, indien dit van belang is of genoemd wordt in de brieven>

'''Vermeldingen in brieven'''
• <MEP-nummer van de brief onderstreept> <2x tab> <verwijzing annotatie in brief>
• Citaat tussen enkele aanhalingstekens

'''Aanvullende informatie'''

'''Record in RKDartists&'''
• Permalink

'''Annotaties'''

=====Naamgeving=====
De bestandsnaam voor documenten in Org-kunst bestaat uit de volledige naam van de betreffende
kunstenaarsvereniging, museum etc. Woorden worden aan elkaar geschreven, spaties door middel
van underscores.
Als het bijvoorbeeld om een kunsthandel gaat en het woord ‘galerie’ maakt
officieel deel uit van de naam, dan wordt deze als zodanig opgenomen. Is alfabetisch niet
inzichtelijker? LJ Dit is in overeenstemming met de regels van invoer van kunsthandels in RKDartists&.
Dit leidt bijvoorbeeld tot ‘Galerie_Nierendorf’ en ‘Valentine_Gallery’.

Voor bijvoorbeeld tentoonstellingen waarvan het (nog) onbekend is om welke tentoonstelling het
precies gaat, wordt de volgende opbouw van bestandsnamen gehanteerd:
<TS>_<plaats van de tentoonstelling>_<jaartal> (bijv. TS_New_York_1937)
De map /Organisatie - kunst is automatisch alfabetisch gerangschikt.
====Organisatie-overig====
Bevat mappen met dossiers van alle overige bedrijven, instellingen etc., al dan niet commercieel.
Bijvoorbeeld immigratiedienst, advocatenkantoor, scheepvaartmaatschappij, theosofische vereniging,
etc.
=====Inhoud dossier=====
De kern van het dossier wordt gevormd door een Word-bestand met dezelfde categorieën als bij kunstorganisaties, voor zover van toepassing. Het dossier kan ook andere documenten bevatten zoals webpagina’s, scans van fragmenten uit boeken relevant voor de betreffende organisatie.
=====Structuur en naamgeving dossier=====
Voor de naamgeving en structuur van het dossier /Organisatie - overig: zie /Organisatie - kunst, mutatis mutandis.

De map /Organisatie - overig is automatisch alfabetisch gerangschikt.

====Personen====
Alle personen die in de brieven voorkomen, krijgen een persoonsdossier. Voor bijvoorbeeld kunsthandelaren met een eigen galerie die ook verzamelden, wordt alles over de persoon en de handel in één dossier verzameld. Bij Valentine Dudensing komen alle gegevens in het document over de galerie. In het document van de persoon wordt alleen een verwijzing naar de galerie opgenomen.
=====Inhoud dossier=====
Deze dossiers bestaan uit afzonderlijke mappen, bedoeld om gegevens te verzamelen voor het maken
van annotaties. De kern van het dossier wordt gevormd door een Word-bestand met de volgende
categorieën:

* Volledige naam
* Kwalificatie
Kunsthandelaar, kunstenaar, verzamelaar etc.
* Genoemde kunstwerken
* Vermeldingen in brieven (citaten uit brieven van Mondriaan waarin deze persoon voorkomt)
* Aanvullende informatie
Algemene gegevens (achtergrondinformatie) die door de editeurs of de documentalist zijn/is achterhaald en van belang zijn/is bij het maken van annotaties.
* Record in RKDartists&
Hier komt de permalink uit RKDexplore zodat de records eenvoudig te raadplegen zijn voor de editeurs.
* Annotaties

De mappen kunnen verschillende soorten documenten bevatten, waaronder één Word-bestand met
eigen, samengestelde informatie en scans van fragmenten uit boeken relevant voor de betreffende
persoon.
=====Structuur dossier=====
<voornaam>, <achternaam> <geboorte-en sterfdata>
<nationaliteit en kwalificatie, indien bekend>

'''Genoemde kunstwerken'''

'''Vermeldingen in brieven'''
* <MEP-nummer van de brief onderstreept> <2x tab> <verwijzing annotatie in brief>
* Citaat tussen enkele aanhalingstekens

'''Aanvullende informatie'''

'''Record in RKDartists&'''
* Permalink

'''Annotaties'''

=====Naamgeving dossier=====
De bestandsnamen voor documenten in /Personen wordt als volgt opgebouwd:
<Achternaam in hoofdletters>_<voornaam in kleine letters>

Mocht twee keer dezelfde naam voorkomen maar het betreft een ander persoon dan kunnen
geboorte-en sterfdata worden toegevoegd, bijvoorbeeld:
HELION_Jean_(1900-1944)
HELION_Jean_(1904-1987)

De map /Personen is automatisch alfabetisch gerangschikt.

====Publicaties====
Bevat documenten met informatie over in de brieven en geschriften genoemde boeken, tijdschriften,
brochures en andere al dan niet commerciële publicaties. De mappen kunnen verschillende soorten
documenten bevatten, waaronder één Word-bestand met eigen, samengestelde informatie en scans
van fragmenten uit boeken relevant voor de betreffende tijdschriften, kranten en andere publicaties. De documenten in deze map zijn anders opgebouwd dan de persoons- en organisatiedossiers en hebben een eigen template, waarin de naam, actieve jaren, nationaliteit en kwalificatie van de krant of het tijdschrift staan vermeld. Bij publicaties wordt volstaan met de vermelding van de auteur, titel en plaats en jaar van uitgave. Daarnaast zijn de gebruikelijke categorieën, vermeldingen in brieven, aanvullende informatie, record in RKDartists& en annotaties, opgenomen.
In de map /Commentaar is weliswaar een onderscheid gemaakt in een aantal categorieën maar die zullen in de praktijk regelmatig overlappen; zo kan een galerie een catalogus uitgeven; informatie daarover kan in /Organisatie - kunst en in /Publicaties.

=====Structuur dossier=====
<naam van tijdschrift of krant> <tussen ronde haken jaren dat tijdschrift of krant actief was>
<Nationaliteit en kwalificatie> of <auteur van de publicatie>, <titel publicatie>, <plaats en jaartal van uitgave>

'''Vermeldingen in brieven'''
* <MEP-nummer van de brief onderstreept> <2x tab> <verwijzing annotatie in brief>
* Citaat tussen enkele aanhalingstekens

'''Aanvullende informatie'''

'''Record in RKDartists&'''
* Permalink

'''Annotaties'''

=====Naamgeving dossier=====
De bestandsnamen voor documenten in Publicaties betreffen de namen van tijdschriften en kranten. Woorden worden van elkaar gescheiden door middel van een underscore. Deze map is alfabetisch gerangschikt.

===Inventarisatie_beheer===
====Bewaarplaatsen====

Alle oude versies van beeldmateriaal van brieven opslaan in repository in de map Inventarisatie_beheer/Bewaarplaatsen zoals ze worden toegestuurd door de beherende instellingen. De kans bestaat dat er kleine foutjes insluipen bij het overhevelen naar de map ‘Info per brief’ in de repository. Het scheelt veel uitzoekwerk als ik dan terug kan grijpen op de originele bestanden.

====Herkomstonderzoek====
[Nog beschrijven]

====Inventarisatie====
Drie mappen in dit Excel-bestand: brieven van Piet Mondriaan, Geschriften van Mondriaan en brieven aan Mondriaan.
Hier komt de toelichting op de inventarisatie van alle brieven en geschriften.
Termen uitschrijven, zoals EDS bij alternatieve datering (= door de editeurs vastgestelde datering van een brief).
Kleurcoderingen uitleggen: geel is voorlopig/onzeker, oranje is vervallen brieven, paars zijn briefverwijzingen van Louis Veen.

====Inventarisatie beeldmateriaal====

Van de ongedateerde brieven wordt voorlopig de alternatieve datering aangehouden met het oog op de sorteerfunctie van Excel. De cel waarin zo’n alternatieve datering in de dateringskolom is opgenomen, is geel gemaakt om te voorkomen dat het lijkt alsnog deze voorlopige datering is vastgesteld.

===Teksten===
Deze map bevat alle xml-bestanden van brieven en geschriften, verdeeld over respectievelijk de submappen /Letters, /Letters Preliminary en /Writings.

====Letters====
Documenten die in /Letters staan, worden ook getoond in de demoversie van de editie. Daarom worden transcripties tijdens het bewerkingsproces in /Letters Preliminary geplaatst; pas als ze afgerond zijn, worden ze in /Letters geplaatst.

====Bestanden per brief/geschrift====
Voor de bewerking van de brieven en theoretische geschriften op de uiteenlopende terreinen (tekst, annotaties, verwijzingen, afbeeldingen etc.) wordt per brief respectievelijk geschrift een afzonderlijk bestand gebruikt. Elk bestand krijgt een unieke, herkenbare naam (zie hierna); een definitief briefnummer kan pas bij publicatie worden toegekend.
De bestanden worden geschreven in xml en gecodeerd volgens richtlijnen van TEI / DALF; zie hiervoor ‘Encoding Mondrian’.
Naamgeving tekstbestanden
Bestandsnamen van brieven
Bestandsnamen van brieven bestaan uit drie onderdelen:
# datum (jjjjmmdd)
# indien geschreven door PM: verkorte achternaam geadresseerde (4 eerste letters, kapitalen); indien geschreven aan PM: afkorting PM + verkorte achternaam geadresseerde (4 eerste letters, kapitalen); indien er meer correspondenten met dezelfde achternaam zijn, volgt op de achternaam de voornaam, ook verkort (vier eerste letters, kapitalen)
Al deze onderdelen worden van elkaar gescheiden door underscore: _
Voorbeelden:
* Brief van Mondriaan aan H. van Assendelft dd. 6 januari 1919 → 19190106_PXXX_ASSE_0184
* Brief aan Mondriaan van Harry Holtzman dd 18 oktober 1939 → 19391018_P054_PM_HOLT_5029
* Brief van Nelly van Doesburg aan Mondriaan dd 18 oktober 1939 → 19391018_PXXX_DOES_NELL_<MEP-nummer>
* Eerdere brief van Nelly van Doesburg dd 18 oktober 1939 → 19391018_PXXX_DOES_NELL_<MEP-nummer>

Tussenvoegsels van achternamen worden niet in de bestandsnaam opgenomen (de, van de, von, de la e.d.).
Wanneer de geadresseerde onbekend is, wordt in de bestandsnaam ANON gebruikt.
Wanneer de achternaam uit minder dan vier letters bestaat wordt de volledige naam opgenomen.
Het kan voorkomen dat in plaats van persoonsnamen namen van bijv. instituties, bedrijven of organisaties worden gebruikt.
Bij onvolledige datering: delen die niet bekend zijn worden ingevuld met x.
Een brief uit de eerste week van april 1922 krijgt als datering 1922040x.
Een brief waarvan die alleen ‘oktober’ als datering heeft, krijgt als datering xxxx10xx.
Een brief waarvan we in het geheel geen indicatie van de datum hebben, krijgt dus als datering acht x’en.
Wanneer een datering globaal is wordt in de bestandsnaam de vroegste datum van de geschatte periode gebruikt: tweede helft mei 1893 wordt dus 18930516.

=====Bestandsnamen van geschriften=====
[wegens de stand van het onderzoek is deze paragraaf zeer voorlopig]
Natuurlijkerwijs zal naar een tekst verwezen worden met de titel. Dateringen gebruiken is minder geschikt. Daarom worden bestandsnamen gebaseerd op (twee of drie hoofdwoorden uit) de titel van de getranscribeerde tekst; dit heeft als voordeel dat versies van één tekst bij elkaar komen te staan. Om versieverschillen aan te geven kan een extensie gebruikt worden. Ook het pilotnummer kan worden gebruikt. Bijv. (fictief):.
<pre>
BORN_HOLLAND_TYPO3_P09
NECESSITY_NEW_TEACHING-PUBL-P11
DIALOOG_NWE_BEELDING_MS1-P01
</pre>
Later in het onderzoek zal bepaald worden of elk document en eigen bestand

====Writings====
Het betreft transcripties van geschriften van Mondriaan. Deze zijn verschillend van aard. Van sommige bestaat een originele handgeschreven versie, van sommige is alleen de publicatie in een tijdschrift bekend. Alles komt in deze map. Daarin vinden tevens documenten met gegevens die betrekking hebben op de geschriften een plek. Als Mondriaan een hoofdstuk publiceerde in een catalogus, dan is de algemene informatie hierover, samengesteld voor het maken van annotaties of algemene achtergrond informatie, opgenomen in een Word-document.
Deze map is onderverdeeld in submappen op jaartal en titel van het geschrift. In deze sub mappen komen de verschillende documenten, dus ook alle versies van hetzelfde geschrift en het Xml-bestand.
De opbouw van de bestandsnamen is als volgt:
* <jaartal>_<titel geschrift aan elkaar, spaties door middel van underscores>
Deze map is daardoor chronologisch gerangschikt.

===Verantwoording===
Map bevat zowel zelfstandige bestanden die methode en werkwijze beschrijven, als de submap met xml-instructie, /Documentation. De bestanden kunnen in uiteenlopende programma’s geschreven zijn (m.n. Word en Oxygen).

===Titels===
====Titels van kunstwerken: werken van Mondriaan====
We vermelden de titel kort, gevolgd door het jaartal en het CR-nummer tussen haakjes:
Composition, 1938 (B290).

====Titels van kunstwerken: werken van andere kunstenaars====
Idem als voor Mondriaan: gegevens uit Catalogue Raisonné van de betreffende kunstenaar gebruiken en anders de meest betrouwbare catalogus/beschrijving die voorhanden is (bijvoorbeeld de informatie van de rechthebbende kunstenaars foundation).

====Titels van publicaties====
Titelbeschrijvingen zijn in het Engels. We nemen het Angelsaksische gebruik van hoofdletters wel/niet over.
We stellen ons voor dat bij een mouse-over op de verkorte titel de volledige titelbeschrijving zichtbaar wordt.
Daarnaast komt er een volledige lijst van geraadpleegde werken.
Uitgangspunt is altijd de titelpagina van de publicatie.
In annotaties en commentaren wordt naar publicaties verwezen door middel van verkorte titels, als volgt:
* Catalogue raisonné van Mondriaans werken: CR II, p. 297-298.
Deze verkorte titel is een uitzondering op het hierna volgende omdat veelvuldig naar deze oevrecatalogus wordt verwezen.
* Van publicaties met niet meer dan auteur en titel: achternaam en jaartal, verlengd met een volgorde-aanduiding: De la Porte 1956-a.
De -a wordt altijd toegevoegd zodat dit niet alsnog hoeft te worden gedaan als later een tweede publicatie van dezelfde auteur uit hetzelfde jaar toegevoegd moet worden (met -b). Bij publicatie van de editie wordt dit aangepast.
* Meerdere auteurs: alleen de eerstgenoemde wordt vermeld.
* Tentoonstellingscatalogus: Exh.cat. New York 2010.
Als de tentoonstelling in meerdere steden plaatsvond en/of over het einde van het jaar liep, wordt alleen de eerste stad en het eerste jaar vermeld.
* Veilingcatalogus: Auct.cat. Christie’s, New York 1976; Auct.cat. Drouot, Paris 1886.
De naam van het veilinghuis wordt kort gehouden.

==See also==
* [[XML Mondrian Guidelines]]

[[Category:XML Mondrian]]

Project procedure (Mondrian)

2017-01-25T13:49:09Z

ASC:

Op deze pagina worden afspraken ten aanzien van de werkwijze vastgelegd voor het Mondriaan Editieproject. Daarmee bedoelen we de organisatie van het daadwerkelijke onderzoek en archivering van bestanden en documentatie die daarbij nodig zijn of die daaruit voortkomen. Behalve ter verantwoording van de gehanteerde aanpak is dit document ook bedoeld als houvast voor editeurs en andere medewerkers van het projectteam.
Aan het project wordt over een zeer lange periode gewerkt door meerdere personen met deels verschillende verantwoordelijkheden en uiteenlopende werktijden. Het is noodzakelijk dat zij zich allen houden aan dezelfde, hieronder beschreven uitgangspunten voor de tekstbewerking, het inhoudelijk onderzoek, het schrijven van annotaties en commentaar, het opslaan van de vergaarde en geproduceerde digitale bestanden en het beheer van (digitale en papieren) onderzoeksdocumentatie.
Het belang van deze ‘discipline’ is tweeledig. Ten eerste een efficiënt werkproces: wanneer iedereen zich aan dezelfde uitgangspunten houdt, kan werk gemakkelijker gedeeld en verdeeld worden; eventuele nieuwe medewerkers (met name stagiairs) kunnen gemakkelijker aanhaken als de aanpak voorgeschreven is; en de kans op het vergeten van ‘hoe we dat ook alweer deden’ wordt erdoor gereduceerd. Ten tweede bepaalt consistentie in hoge mate de uiteindelijke kwaliteit en betrouwbaarheid van de editie. Een consistente aanpak vanaf het begin draagt daar heel veel aan bij.
Tijdens het onderzoek — in elk geval in de eerste jaren, en zeker totdat alle onderdelen van het editieproces ten minste eenmaal aan de orde zijn geweest — zullen regelmatig nieuwe beslissingen over de werkwijze genomen moeten worden en oude bijgesteld. Telkens zullen die keuzes en afspraken direct moeten worden opgenomen in dit document.

==Repository==
Voor het Mondriaan Editieproject is schijfruimte ingericht op een repository zodat teamleden werkend vanuit het RKD en het Huygens ING toegang tot de documenten hebben. Dit document is bedoeld als verantwoording voor de wijze waarop welke informatie op welke plaats kan worden opgeborgen op de repository. Voor de continuïteit en vindbaarheid van documenten voor alle medewerkers van het project is het essentieel dat de hieronder beschreven richtlijnen worden gevolgd. Bovendien kan dit document helpen bij twijfel bij opberging van gegevens of raadpleging.
===Inchecken en updaten===
Alle bestanden die voortkomen uit het project (dus niet alleen de tekstbestanden maar ook de documentatie, administratie etc.) worden opgeslagen in de Repository. Het is van groot belang dat alle vergaarde informatie voor alle medewerkers in het project beschikbaar is. Om die reden is het volgende een volstrekt vereiste:
# ALVORENS ZIJN/HAAR COMPUTER (AAN HET EINDE VAN DE DAG) AF TE SLUITEN DOET ELKE MEDEWERKER EEN COMPLETE CHECK-OUT NAAR DE REPOSITORY. Vaker uitchecken is zeker toegestaan.
# BIJ HET OPENEN VAN DE SVN-CLIENT DOET ELKE MEDEWERKER EEN COMPLETE CHECK-IN UIT DE REPOSITORY.
Voor alle typen bestanden zijn mappen gemaakt met een vastgestelde indeling. Het is toegestaan nieuwe bestanden in bestaande mappen toe te voegen (als ze daar ook thuishoren). Het toevoegen, verwijderen of verplaatsen van mappen is achter alleen toegestaan na overleg door editeurs en documentalist omdat anders bij in- en uitchecken verwarring kan ontstaan.
===Gebruikers===
De editeurs werken voornamelijk in de map Teksten. Daarnaast zijn zij verantwoordelijk voor de mappen Apparaat, Verantwoording en Tests. In deze mappen maken zij zelf documenten aan. In de submappen onder Commentaar werken ze in bestaande documenten en maken, in overleg met de documentalist, nieuwe documenten aan.
De documentalist is verantwoordelijk voor de submappen onder Commentaar en maakt bestanden aan. De documentalist voegt hier nieuwe gegevens aan toe, die onder andere worden aangeleverd door de editeurs. Alle documenten in de mappen Apparaat, Teksten en Verantwoording worden door de documentalist ter raadpleging gebruikt maar zal daar geen wijzigingen in aanbrengen.
===Overige opmerkingen===
Voor de leesbaarheid zijn de namen van de hoofdmappen in hoofdletters weergegeven.
Bij documentatiemateriaal dat wordt gescand uit boeken, wordt altijd de voorkant opgenomen.
==Structuur repository==
De hoofdstructuur van de repository is als volgt:
* Administratie
* Bibliotheek
* Commentaar
** Begeleidende teksten
** Biografische Mondriaan documentatie
* Documentatie
** Info – per brief
** Organisatie – kunst
** Organisatie – overig
** Personen
** Publicaties
* Inventarisatie_beheer
** Bewaarplaatsen
** Herkomstonderzoek
** Inventarisatie
** Selectie pilot
* Secundair
* Teksten
** Letters
** Letters Preliminary
** Writings
* Tests and Samples (voor ICT-doeleinden; niet voor editeursteam)
* Verantwoording
** Editieverantwoording (van N-schijf)
** Documentation

===Administratie===
Stageopdrachten en reisschema’s bijvoorbeeld.

===Bibliotheek===
====Inhoud====
In de Bibliotheek komt alle relevante literatuur voor het project en bevat scans of digitale versies van
volledige publicaties die een fysieke publicatie kunnen vervangen.
De bibliotheek is een hulpmiddel en maakt strikt genomen geen deel uit van de opbouw van de
annotaties (zoals /Personen e.d.).

De enige eis is dat het bestand compleet moet zijn, dus een volledig gescand boek of een volledig
artikel/hoofdstuk uit een boek. Omdat de bestandsnaam kort en bondig moet zijn, dient alle
informatie over het gescande boek of hoofdstuk/artikel duidelijk in het document zelf voor te komen en moet altijd de voorkant van het boek gescand worden.
Er wordt geen onderscheid gemaakt tussen artikelen of boeken. Per publicatie wordt een submap
Gemaakt (voorstel EdV: pas aanmaken als er meerdere documenten per publicatie zijn, anders onnodig veel klikken). Zo kunnen behalve scans bijvoorbeeld ook informatie óver de publicatie opgenomen worden; achtergrond van ontstaan van een publicatie bijvoorbeeld.
Naamgeving
De opbouw van bestandsnamen voor documenten in deze map: <achternaam auteur>_<titel, spaties
door middel van underscores>_<jaartal van publicatie>

Lange titels worden verkort; ze moeten significante informatie over het gescande boek of
hoofdstuk/artikel geven; altijd moet de titelpagina van de publicatie gescand worden.

Door de opbouw van de bestandsnamen in de map is deze alfabetisch gerangschikt.

NB. Voor publicaties van Mondriaan is een aparte submap.

===Commentaar===
Map bevat alle documenten die gegevens bevatten voor alle vormen van inhoudelijk editeurscommentaar (m.n. annotaties, biografieën, inleidingen e.d.). De documenten zijn verschillend van aard: het gaat om Word-bestanden, die door het Mondriaan-team zijn samengesteld, scans uit boeken en bijvoorbeeld foto’s. De map /Commentaar is verdeeld in verschillende submappen.
Documentatie
====Info-per brief====
Bevat mappen voor elke brief; de briefmap bevat bestanden met gegevens die belangrijk zijn bij het
annoteren maar die onder geen van de andere categorieën (die hierna volgen) thuis te brengen zijn.
De Word-bestanden en scans of andere documenten die bij de betreffende brief horen, zullen
dezelfde naam krijgen als de brief.
=====Inhoud dossier=====
De briefmap bevat een bronnenmap voor reproducties en een voor de materiële beschrijving van de betreffende brief.
=====Structuur dossier=====
[nog schrijven]
=====Naamgeving dossier=====
De mappen hebben uitsluitend het viercijferige MEP-nummer. Eerder bleek dat een naamgeving die bestond uit de datum, gevolgd door geadresseerde sterk onderhevig is aan verandering. Daardoor vormde die constructie geen betrouwbare bestandsnaam. Het MEP-nummer is misschien lastiger om mee te werken omdat niet in één oogopslag duidelijk is om welke brief het gaat (dan moet je de inventarisatie erbij pakken), maar de MEP-nummers blijven wel hetzelfde.

De naamgeving van het dossier is als volgt opgebouwd:
<pre>Brievenmap <viercijferige MEP-nummer>
BRON_<MEP-nummer>
Repr_<MEP-nummer>
Mat_beschr_<MEP-nummer></pre>
====Organisatie - kunst====
Onder ‘kunstorganisaties’ worden verstaan alle instellingen, organisaties, bedrijven, verenigingen etc.
die gebaseerd zijn op betrokkenheid bij kunst. Dus musea, kunstenaarsverenigingen,
kunsthandels/galeries, tentoonstellingen e.d.
=====Inhoud dossier=====
Alle kunstorganisaties die in de brieven voorkomen, krijgen eigen dossiers. Deze dossiers bestaan uit
afzonderlijke mappen, bedoeld om gegevens te verzamelen voor het maken van annotaties. De
mappen kunnen verschillende soorten documenten bevatten, waaronder één Word-bestand met
eigen, samengestelde informatie en scans van fragmenten uit boeken relevant voor de betreffende
organisatie.
De kern van het dossier wordt gevormd door het Word-bestand met de volgende categorieën:
* Volledige naam
* Actieve jaren
* Nationaliteit
* Kwalificatie
* Vestiging van de organisatie (locatie)
* Vermeldingen in brieven
* Aanvullende informatie
* Record in RKDartists&
* Annotaties
=====Structuur dossier=====
De structuur van deze dossiers is als volgt:

'''Titel'''
<naam van de organisatie> <tussen ronde haken jaren dat organisatie actief was, als dit te vinden is>
<Nationaliteit en kwalificatie>
Gevestigd op <adres en plaatsnaam, indien dit van belang is of genoemd wordt in de brieven>

'''Vermeldingen in brieven'''
• <MEP-nummer van de brief onderstreept> <2x tab> <verwijzing annotatie in brief>
• Citaat tussen enkele aanhalingstekens

'''Aanvullende informatie'''

'''Record in RKDartists&'''
• Permalink

'''Annotaties'''

=====Naamgeving=====
De bestandsnaam voor documenten in Org-kunst bestaat uit de volledige naam van de betreffende
kunstenaarsvereniging, museum etc. Woorden worden aan elkaar geschreven, spaties door middel
van underscores.
Als het bijvoorbeeld om een kunsthandel gaat en het woord ‘galerie’ maakt
officieel deel uit van de naam, dan wordt deze als zodanig opgenomen. Is alfabetisch niet
inzichtelijker? LJ Dit is in overeenstemming met de regels van invoer van kunsthandels in RKDartists&.
Dit leidt bijvoorbeeld tot ‘Galerie_Nierendorf’ en ‘Valentine_Gallery’.

Voor bijvoorbeeld tentoonstellingen waarvan het (nog) onbekend is om welke tentoonstelling het
precies gaat, wordt de volgende opbouw van bestandsnamen gehanteerd:
<TS>_<plaats van de tentoonstelling>_<jaartal> (bijv. TS_New_York_1937)
De map /Organisatie - kunst is automatisch alfabetisch gerangschikt.
====Organisatie-overig====
Bevat mappen met dossiers van alle overige bedrijven, instellingen etc., al dan niet commercieel.
Bijvoorbeeld immigratiedienst, advocatenkantoor, scheepvaartmaatschappij, theosofische vereniging,
etc.
=====Inhoud dossier=====
De kern van het dossier wordt gevormd door een Word-bestand met dezelfde categorieën als bij kunstorganisaties, voor zover van toepassing. Het dossier kan ook andere documenten bevatten zoals webpagina’s, scans van fragmenten uit boeken relevant voor de betreffende organisatie.
=====Structuur en naamgeving dossier=====
Voor de naamgeving en structuur van het dossier /Organisatie - overig: zie /Organisatie - kunst, mutatis mutandis.

De map /Organisatie - overig is automatisch alfabetisch gerangschikt.

====Personen====
Alle personen die in de brieven voorkomen, krijgen een persoonsdossier. Voor bijvoorbeeld kunsthandelaren met een eigen galerie die ook verzamelden, wordt alles over de persoon en de handel in één dossier verzameld. Bij Valentine Dudensing komen alle gegevens in het document over de galerie. In het document van de persoon wordt alleen een verwijzing naar de galerie opgenomen.
=====Inhoud dossier=====
Deze dossiers bestaan uit afzonderlijke mappen, bedoeld om gegevens te verzamelen voor het maken
van annotaties. De kern van het dossier wordt gevormd door een Word-bestand met de volgende
categorieën:

* Volledige naam
* Kwalificatie
Kunsthandelaar, kunstenaar, verzamelaar etc.
* Genoemde kunstwerken
* Vermeldingen in brieven (citaten uit brieven van Mondriaan waarin deze persoon voorkomt)
* Aanvullende informatie
Algemene gegevens (achtergrondinformatie) die door de editeurs of de documentalist zijn/is achterhaald en van belang zijn/is bij het maken van annotaties.
* Record in RKDartists&
Hier komt de permalink uit RKDexplore zodat de records eenvoudig te raadplegen zijn voor de editeurs.
* Annotaties

De mappen kunnen verschillende soorten documenten bevatten, waaronder één Word-bestand met
eigen, samengestelde informatie en scans van fragmenten uit boeken relevant voor de betreffende
persoon.
=====Structuur dossier=====
<voornaam>, <achternaam> <geboorte-en sterfdata>
<nationaliteit en kwalificatie, indien bekend>

'''Genoemde kunstwerken'''

'''Vermeldingen in brieven'''
* <MEP-nummer van de brief onderstreept> <2x tab> <verwijzing annotatie in brief>
* Citaat tussen enkele aanhalingstekens

'''Aanvullende informatie'''

'''Record in RKDartists&'''
* Permalink

'''Annotaties'''

=====Naamgeving dossier=====
De bestandsnamen voor documenten in /Personen wordt als volgt opgebouwd:
<Achternaam in hoofdletters>_<voornaam in kleine letters>

Mocht twee keer dezelfde naam voorkomen maar het betreft een ander persoon dan kunnen
geboorte-en sterfdata worden toegevoegd, bijvoorbeeld:
HELION_Jean_(1900-1944)
HELION_Jean_(1904-1987)

De map /Personen is automatisch alfabetisch gerangschikt.

====Publicaties====
Bevat documenten met informatie over in de brieven en geschriften genoemde boeken, tijdschriften,
brochures en andere al dan niet commerciële publicaties. De mappen kunnen verschillende soorten
documenten bevatten, waaronder één Word-bestand met eigen, samengestelde informatie en scans
van fragmenten uit boeken relevant voor de betreffende tijdschriften, kranten en andere publicaties. De documenten in deze map zijn anders opgebouwd dan de persoons- en organisatiedossiers en hebben een eigen template, waarin de naam, actieve jaren, nationaliteit en kwalificatie van de krant of het tijdschrift staan vermeld. Bij publicaties wordt volstaan met de vermelding van de auteur, titel en plaats en jaar van uitgave. Daarnaast zijn de gebruikelijke categorieën, vermeldingen in brieven, aanvullende informatie, record in RKDartists& en annotaties, opgenomen.
In de map /Commentaar is weliswaar een onderscheid gemaakt in een aantal categorieën maar die zullen in de praktijk regelmatig overlappen; zo kan een galerie een catalogus uitgeven; informatie daarover kan in /Organisatie - kunst en in /Publicaties.

=====Structuur dossier=====
<naam van tijdschrift of krant> <tussen ronde haken jaren dat tijdschrift of krant actief was>
<Nationaliteit en kwalificatie> of <auteur van de publicatie>, <titel publicatie>, <plaats en jaartal van uitgave>

'''Vermeldingen in brieven'''
* <MEP-nummer van de brief onderstreept> <2x tab> <verwijzing annotatie in brief>
* Citaat tussen enkele aanhalingstekens

'''Aanvullende informatie'''

'''Record in RKDartists&'''
* Permalink

'''Annotaties'''

=====Naamgeving dossier=====
De bestandsnamen voor documenten in Publicaties betreffen de namen van tijdschriften en kranten. Woorden worden van elkaar gescheiden door middel van een underscore. Deze map is alfabetisch gerangschikt.

===Inventarisatie_beheer===
====Bewaarplaatsen====

Alle oude versies van beeldmateriaal van brieven opslaan in repository in de map Inventarisatie_beheer/Bewaarplaatsen zoals ze worden toegestuurd door de beherende instellingen. De kans bestaat dat er kleine foutjes insluipen bij het overhevelen naar de map ‘Info per brief’ in de repository. Het scheelt veel uitzoekwerk als ik dan terug kan grijpen op de originele bestanden.

====Herkomstonderzoek====
[Nog beschrijven]

====Inventarisatie====
Drie mappen in dit Excel-bestand: brieven van Piet Mondriaan, Geschriften van Mondriaan en brieven aan Mondriaan.
Hier komt de toelichting op de inventarisatie van alle brieven en geschriften.
Termen uitschrijven, zoals EDS bij alternatieve datering (= door de editeurs vastgestelde datering van een brief).
Kleurcoderingen uitleggen: geel is voorlopig/onzeker, oranje is vervallen brieven, paars zijn briefverwijzingen van Louis Veen.

====Inventarisatie beeldmateriaal====

Van de ongedateerde brieven wordt voorlopig de alternatieve datering aangehouden met het oog op de sorteerfunctie van Excel. De cel waarin zo’n alternatieve datering in de dateringskolom is opgenomen, is geel gemaakt om te voorkomen dat het lijkt alsnog deze voorlopige datering is vastgesteld.

===Teksten===
Deze map bevat alle xml-bestanden van brieven en geschriften, verdeeld over respectievelijk de submappen /Letters, /Letters Preliminary en /Writings.

====Letters====
Documenten die in /Letters staan, worden ook getoond in de demoversie van de editie. Daarom worden transcripties tijdens het bewerkingsproces in /Letters Preliminary geplaatst; pas als ze afgerond zijn, worden ze in /Letters geplaatst.

====Bestanden per brief/geschrift====
Voor de bewerking van de brieven en theoretische geschriften op de uiteenlopende terreinen (tekst, annotaties, verwijzingen, afbeeldingen etc.) wordt per brief respectievelijk geschrift een afzonderlijk bestand gebruikt. Elk bestand krijgt een unieke, herkenbare naam (zie hierna); een definitief briefnummer kan pas bij publicatie worden toegekend.
De bestanden worden geschreven in xml en gecodeerd volgens richtlijnen van TEI / DALF; zie hiervoor ‘Encoding Mondrian’.
Naamgeving tekstbestanden
Bestandsnamen van brieven
Bestandsnamen van brieven bestaan uit drie onderdelen:
# datum (jjjjmmdd)
# indien geschreven door PM: verkorte achternaam geadresseerde (4 eerste letters, kapitalen); indien geschreven aan PM: afkorting PM + verkorte achternaam geadresseerde (4 eerste letters, kapitalen); indien er meer correspondenten met dezelfde achternaam zijn, volgt op de achternaam de voornaam, ook verkort (vier eerste letters, kapitalen)
Al deze onderdelen worden van elkaar gescheiden door underscore: _
Voorbeelden:
* Brief van Mondriaan aan H. van Assendelft dd. 6 januari 1919 → 19190106_PXXX_ASSE_0184
* Brief aan Mondriaan van Harry Holtzman dd 18 oktober 1939 → 19391018_P054_PM_HOLT_5029
* Brief van Nelly van Doesburg aan Mondriaan dd 18 oktober 1939 → 19391018_PXXX_DOES_NELL_<MEP-nummer>
* Eerdere brief van Nelly van Doesburg dd 18 oktober 1939 → 19391018_PXXX_DOES_NELL_<MEP-nummer>

Tussenvoegsels van achternamen worden niet in de bestandsnaam opgenomen (de, van de, von, de la e.d.).
Wanneer de geadresseerde onbekend is, wordt in de bestandsnaam ANON gebruikt.
Wanneer de achternaam uit minder dan vier letters bestaat wordt de volledige naam opgenomen.
Het kan voorkomen dat in plaats van persoonsnamen namen van bijv. instituties, bedrijven of organisaties worden gebruikt.
Bij onvolledige datering: delen die niet bekend zijn worden ingevuld met x.
Een brief uit de eerste week van april 1922 krijgt als datering 1922040x.
Een brief waarvan die alleen ‘oktober’ als datering heeft, krijgt als datering xxxx10xx.
Een brief waarvan we in het geheel geen indicatie van de datum hebben, krijgt dus als datering acht x’en.
Wanneer een datering globaal is wordt in de bestandsnaam de vroegste datum van de geschatte periode gebruikt: tweede helft mei 1893 wordt dus 18930516.

=====Bestandsnamen van geschriften=====
[wegens de stand van het onderzoek is deze paragraaf zeer voorlopig]
Natuurlijkerwijs zal naar een tekst verwezen worden met de titel. Dateringen gebruiken is minder geschikt. Daarom worden bestandsnamen gebaseerd op (twee of drie hoofdwoorden uit) de titel van de getranscribeerde tekst; dit heeft als voordeel dat versies van één tekst bij elkaar komen te staan. Om versieverschillen aan te geven kan een extensie gebruikt worden. Ook het pilotnummer kan worden gebruikt. Bijv. (fictief):.
<pre>
BORN_HOLLAND_TYPO3_P09
NECESSITY_NEW_TEACHING-PUBL-P11
DIALOOG_NWE_BEELDING_MS1-P01
</pre>
Later in het onderzoek zal bepaald worden of elk document en eigen bestand

====Writings====
Het betreft transcripties van geschriften van Mondriaan. Deze zijn verschillend van aard. Van sommige bestaat een originele handgeschreven versie, van sommige is alleen de publicatie in een tijdschrift bekend. Alles komt in deze map. Daarin vinden tevens documenten met gegevens die betrekking hebben op de geschriften een plek. Als Mondriaan een hoofdstuk publiceerde in een catalogus, dan is de algemene informatie hierover, samengesteld voor het maken van annotaties of algemene achtergrond informatie, opgenomen in een Word-document.
Deze map is onderverdeeld in submappen op jaartal en titel van het geschrift. In deze sub mappen komen de verschillende documenten, dus ook alle versies van hetzelfde geschrift en het Xml-bestand.
De opbouw van de bestandsnamen is als volgt:
* <jaartal>_<titel geschrift aan elkaar, spaties door middel van underscores>
Deze map is daardoor chronologisch gerangschikt.

===Verantwoording===
Map bevat zowel zelfstandige bestanden die methode en werkwijze beschrijven, als de submap met xml-instructie, /Documentation. De bestanden kunnen in uiteenlopende programma’s geschreven zijn (m.n. Word en Oxygen).

===Titels===
====Titels van kunstwerken: werken van Mondriaan====
We vermelden de titel kort, gevolgd door het jaartal en het CR-nummer tussen haakjes:
Composition, 1938 (B290).

====Titels van kunstwerken: werken van andere kunstenaars====
Idem als voor Mondriaan: gegevens uit Catalogue Raisonné van de betreffende kunstenaar gebruiken en anders de meest betrouwbare catalogus/beschrijving die voorhanden is (bijvoorbeeld de informatie van de rechthebbende kunstenaars foundation).

====Titels van publicaties====
Titelbeschrijvingen zijn in het Engels. We nemen het Angelsaksische gebruik van hoofdletters wel/niet over.
We stellen ons voor dat bij een mouse-over op de verkorte titel de volledige titelbeschrijving zichtbaar wordt.
Daarnaast komt er een volledige lijst van geraadpleegde werken.
Uitgangspunt is altijd de titelpagina van de publicatie.
In annotaties en commentaren wordt naar publicaties verwezen door middel van verkorte titels, als volgt:
* Catalogue raisonné van Mondriaans werken: CR II, p. 297-298.
Deze verkorte titel is een uitzondering op het hierna volgende omdat veelvuldig naar deze oevrecatalogus wordt verwezen.
* Van publicaties met niet meer dan auteur en titel: achternaam en jaartal, verlengd met een volgorde-aanduiding: De la Porte 1956-a.
De -a wordt altijd toegevoegd zodat dit niet alsnog hoeft te worden gedaan als later een tweede publicatie van dezelfde auteur uit hetzelfde jaar toegevoegd moet worden (met -b). Bij publicatie van de editie wordt dit aangepast.
* Meerdere auteurs: alleen de eerstgenoemde wordt vermeld.
* Tentoonstellingscatalogus: Exh.cat. New York 2010.
Als de tentoonstelling in meerdere steden plaatsvond en/of over het einde van het jaar liep, wordt alleen de eerste stad en het eerste jaar vermeld.
* Veilingcatalogus: Auct.cat. Christie’s, New York 1976; Auct.cat. Drouot, Paris 1886.
De naam van het veilinghuis wordt kort gehouden.

[[Category:XML Mondrian]]

Project procedure (Mondrian)

2017-01-25T13:39:56Z

ASC:

Op deze pagina worden afspraken ten aanzien van de werkwijze vastgelegd voor het Mondriaan Editieproject. Daarmee bedoelen we de organisatie van het daadwerkelijke onderzoek en archivering van bestanden en documentatie die daarbij nodig zijn of die daaruit voortkomen. Behalve ter verantwoording van de gehanteerde aanpak is dit document ook bedoeld als houvast voor editeurs en andere medewerkers van het projectteam.
Aan het project wordt over een zeer lange periode gewerkt door meerdere personen met deels verschillende verantwoordelijkheden en uiteenlopende werktijden. Het is noodzakelijk dat zij zich allen houden aan dezelfde, hieronder beschreven uitgangspunten voor de tekstbewerking, het inhoudelijk onderzoek, het schrijven van annotaties en commentaar, het opslaan van de vergaarde en geproduceerde digitale bestanden en het beheer van (digitale en papieren) onderzoeksdocumentatie.
Het belang van deze ‘discipline’ is tweeledig. Ten eerste een efficiënt werkproces: wanneer iedereen zich aan dezelfde uitgangspunten houdt, kan werk gemakkelijker gedeeld en verdeeld worden; eventuele nieuwe medewerkers (met name stagiairs) kunnen gemakkelijker aanhaken als de aanpak voorgeschreven is; en de kans op het vergeten van ‘hoe we dat ook alweer deden’ wordt erdoor gereduceerd. Ten tweede bepaalt consistentie in hoge mate de uiteindelijke kwaliteit en betrouwbaarheid van de editie. Een consistente aanpak vanaf het begin draagt daar heel veel aan bij.
Tijdens het onderzoek — in elk geval in de eerste jaren, en zeker totdat alle onderdelen van het editieproces ten minste eenmaal aan de orde zijn geweest — zullen regelmatig nieuwe beslissingen over de werkwijze genomen moeten worden en oude bijgesteld. Telkens zullen die keuzes en afspraken direct moeten worden opgenomen in dit document.

==Repository==
Voor het Mondriaan Editieproject is schijfruimte ingericht op een repository zodat teamleden werkend vanuit het RKD en het Huygens ING toegang tot de documenten hebben. Dit document is bedoeld als verantwoording voor de wijze waarop welke informatie op welke plaats kan worden opgeborgen op de repository. Voor de continuïteit en vindbaarheid van documenten voor alle medewerkers van het project is het essentieel dat de hieronder beschreven richtlijnen worden gevolgd. Bovendien kan dit document helpen bij twijfel bij opberging van gegevens of raadpleging.
===Inchecken en updaten===
Alle bestanden die voortkomen uit het project (dus niet alleen de tekstbestanden maar ook de documentatie, administratie etc.) worden opgeslagen in de Repository. Het is van groot belang dat alle vergaarde informatie voor alle medewerkers in het project beschikbaar is. Om die reden is het volgende een volstrekt vereiste:
# ALVORENS ZIJN/HAAR COMPUTER (AAN HET EINDE VAN DE DAG) AF TE SLUITEN DOET ELKE MEDEWERKER EEN COMPLETE CHECK-OUT NAAR DE REPOSITORY. Vaker uitchecken is zeker toegestaan.
# BIJ HET OPENEN VAN DE SVN-CLIENT DOET ELKE MEDEWERKER EEN COMPLETE CHECK-IN UIT DE REPOSITORY.
Voor alle typen bestanden zijn mappen gemaakt met een vastgestelde indeling. Het is toegestaan nieuwe bestanden in bestaande mappen toe te voegen (als ze daar ook thuishoren). Het toevoegen, verwijderen of verplaatsen van mappen is achter alleen toegestaan na overleg door editeurs en documentalist omdat anders bij in- en uitchecken verwarring kan ontstaan.
===Gebruikers===
De editeurs werken voornamelijk in de map Teksten. Daarnaast zijn zij verantwoordelijk voor de mappen Apparaat, Verantwoording en Tests. In deze mappen maken zij zelf documenten aan. In de submappen onder Commentaar werken ze in bestaande documenten en maken, in overleg met de documentalist, nieuwe documenten aan.
De documentalist is verantwoordelijk voor de submappen onder Commentaar en maakt bestanden aan. De documentalist voegt hier nieuwe gegevens aan toe, die onder andere worden aangeleverd door de editeurs. Alle documenten in de mappen Apparaat, Teksten en Verantwoording worden door de documentalist ter raadpleging gebruikt maar zal daar geen wijzigingen in aanbrengen.
===Overige opmerkingen===
Voor de leesbaarheid zijn de namen van de hoofdmappen in hoofdletters weergegeven.
Bij documentatiemateriaal dat wordt gescand uit boeken, wordt altijd de voorkant opgenomen.
==Structuur repository==
De hoofdstructuur van de repository is als volgt:
* Administratie
* Bibliotheek
* Commentaar
** Begeleidende teksten
** Biografische Mondriaan documentatie
* Documentatie
** Info – per brief
** Organisatie – kunst
** Organisatie – overig
** Personen
** Publicaties
* Inventarisatie_beheer
** Bewaarplaatsen
** Herkomstonderzoek
** Inventarisatie
** Selectie pilot
* Secundair
* Teksten
** Letters
** Letters Preliminary
** Writings
* Tests and Samples (voor ICT-doeleinden; niet voor editeursteam)
* Verantwoording
** Editieverantwoording (van N-schijf)
** Documentation

===Administratie===
Stageopdrachten en reisschema’s bijvoorbeeld.

===Bibliotheek===
====Inhoud====
In de Bibliotheek komt alle relevante literatuur voor het project en bevat scans of digitale versies van
volledige publicaties die een fysieke publicatie kunnen vervangen.
De bibliotheek is een hulpmiddel en maakt strikt genomen geen deel uit van de opbouw van de
annotaties (zoals /Personen e.d.).

De enige eis is dat het bestand compleet moet zijn, dus een volledig gescand boek of een volledig
artikel/hoofdstuk uit een boek. Omdat de bestandsnaam kort en bondig moet zijn, dient alle
informatie over het gescande boek of hoofdstuk/artikel duidelijk in het document zelf voor te komen en moet altijd de voorkant van het boek gescand worden.
Er wordt geen onderscheid gemaakt tussen artikelen of boeken. Per publicatie wordt een submap
Gemaakt (voorstel EdV: pas aanmaken als er meerdere documenten per publicatie zijn, anders onnodig veel klikken). Zo kunnen behalve scans bijvoorbeeld ook informatie óver de publicatie opgenomen worden; achtergrond van ontstaan van een publicatie bijvoorbeeld.
Naamgeving
De opbouw van bestandsnamen voor documenten in deze map: <achternaam auteur>_<titel, spaties
door middel van underscores>_<jaartal van publicatie>

Lange titels worden verkort; ze moeten significante informatie over het gescande boek of
hoofdstuk/artikel geven; altijd moet de titelpagina van de publicatie gescand worden.

Door de opbouw van de bestandsnamen in de map is deze alfabetisch gerangschikt.

NB. Voor publicaties van Mondriaan is een aparte submap.

===Commentaar===
Map bevat alle documenten die gegevens bevatten voor alle vormen van inhoudelijk editeurscommentaar (m.n. annotaties, biografieën, inleidingen e.d.). De documenten zijn verschillend van aard: het gaat om Word-bestanden, die door het Mondriaan-team zijn samengesteld, scans uit boeken en bijvoorbeeld foto’s. De map /Commentaar is verdeeld in verschillende submappen.
Documentatie
====Info-per brief====
Bevat mappen voor elke brief; de briefmap bevat bestanden met gegevens die belangrijk zijn bij het
annoteren maar die onder geen van de andere categorieën (die hierna volgen) thuis te brengen zijn.
De Word-bestanden en scans of andere documenten die bij de betreffende brief horen, zullen
dezelfde naam krijgen als de brief.
=====Inhoud dossier=====
De briefmap bevat een bronnenmap voor reproducties en een voor de materiële beschrijving van de betreffende brief.
=====Structuur dossier=====
[nog schrijven]
=====Naamgeving dossier=====
De mappen hebben uitsluitend het viercijferige MEP-nummer. Eerder bleek dat een naamgeving die bestond uit de datum, gevolgd door geadresseerde sterk onderhevig is aan verandering. Daardoor vormde die constructie geen betrouwbare bestandsnaam. Het MEP-nummer is misschien lastiger om mee te werken omdat niet in één oogopslag duidelijk is om welke brief het gaat (dan moet je de inventarisatie erbij pakken), maar de MEP-nummers blijven wel hetzelfde.

De naamgeving van het dossier is als volgt opgebouwd:
<pre>Brievenmap <viercijferige MEP-nummer>
BRON_<MEP-nummer>
Repr_<MEP-nummer>
Mat_beschr_<MEP-nummer></pre>
====Organisatie - kunst====
Onder ‘kunstorganisaties’ worden verstaan alle instellingen, organisaties, bedrijven, verenigingen etc.
die gebaseerd zijn op betrokkenheid bij kunst. Dus musea, kunstenaarsverenigingen,
kunsthandels/galeries, tentoonstellingen e.d.
=====Inhoud dossier=====
Alle kunstorganisaties die in de brieven voorkomen, krijgen eigen dossiers. Deze dossiers bestaan uit
afzonderlijke mappen, bedoeld om gegevens te verzamelen voor het maken van annotaties. De
mappen kunnen verschillende soorten documenten bevatten, waaronder één Word-bestand met
eigen, samengestelde informatie en scans van fragmenten uit boeken relevant voor de betreffende
organisatie.
De kern van het dossier wordt gevormd door het Word-bestand met de volgende categorieën:
* Volledige naam
* Actieve jaren
* Nationaliteit
* Kwalificatie
* Vestiging van de organisatie (locatie)
* Vermeldingen in brieven
* Aanvullende informatie
* Record in RKDartists&
* Annotaties
=====Structuur dossier=====
De structuur van deze dossiers is als volgt:

'''Titel'''
<naam van de organisatie> <tussen ronde haken jaren dat organisatie actief was, als dit te vinden is>
<Nationaliteit en kwalificatie>
Gevestigd op <adres en plaatsnaam, indien dit van belang is of genoemd wordt in de brieven>

'''Vermeldingen in brieven'''
• <MEP-nummer van de brief onderstreept> <2x tab> <verwijzing annotatie in brief>
• Citaat tussen enkele aanhalingstekens

'''Aanvullende informatie'''

'''Record in RKDartists&'''
• Permalink

'''Annotaties'''

=====Naamgeving=====
De bestandsnaam voor documenten in Org-kunst bestaat uit de volledige naam van de betreffende
kunstenaarsvereniging, museum etc. Woorden worden aan elkaar geschreven, spaties door middel
van underscores.
Als het bijvoorbeeld om een kunsthandel gaat en het woord ‘galerie’ maakt
officieel deel uit van de naam, dan wordt deze als zodanig opgenomen. Is alfabetisch niet
inzichtelijker? LJ Dit is in overeenstemming met de regels van invoer van kunsthandels in RKDartists&.
Dit leidt bijvoorbeeld tot ‘Galerie_Nierendorf’ en ‘Valentine_Gallery’.

Voor bijvoorbeeld tentoonstellingen waarvan het (nog) onbekend is om welke tentoonstelling het
precies gaat, wordt de volgende opbouw van bestandsnamen gehanteerd:
<TS>_<plaats van de tentoonstelling>_<jaartal> (bijv. TS_New_York_1937)
De map /Organisatie - kunst is automatisch alfabetisch gerangschikt.
====Organisatie-overig====
Bevat mappen met dossiers van alle overige bedrijven, instellingen etc., al dan niet commercieel.
Bijvoorbeeld immigratiedienst, advocatenkantoor, scheepvaartmaatschappij, theosofische vereniging,
etc.
=====Inhoud dossier=====
De kern van het dossier wordt gevormd door een Word-bestand met dezelfde categorieën als bij kunstorganisaties, voor zover van toepassing. Het dossier kan ook andere documenten bevatten zoals webpagina’s, scans van fragmenten uit boeken relevant voor de betreffende organisatie.
=====Structuur en naamgeving dossier=====
Voor de naamgeving en structuur van het dossier /Organisatie - overig: zie /Organisatie - kunst, mutatis mutandis.

De map /Organisatie - overig is automatisch alfabetisch gerangschikt.

====Personen====
Alle personen die in de brieven voorkomen, krijgen een persoonsdossier. Voor bijvoorbeeld kunsthandelaren met een eigen galerie die ook verzamelden, wordt alles over de persoon en de handel in één dossier verzameld. Bij Valentine Dudensing komen alle gegevens in het document over de galerie. In het document van de persoon wordt alleen een verwijzing naar de galerie opgenomen.
=====Inhoud dossier=====
Deze dossiers bestaan uit afzonderlijke mappen, bedoeld om gegevens te verzamelen voor het maken
van annotaties. De kern van het dossier wordt gevormd door een Word-bestand met de volgende
categorieën:

* Volledige naam
* Kwalificatie
Kunsthandelaar, kunstenaar, verzamelaar etc.
* Genoemde kunstwerken
* Vermeldingen in brieven (citaten uit brieven van Mondriaan waarin deze persoon voorkomt)
* Aanvullende informatie
Algemene gegevens (achtergrondinformatie) die door de editeurs of de documentalist zijn/is achterhaald en van belang zijn/is bij het maken van annotaties.
* Record in RKDartists&
Hier komt de permalink uit RKDexplore zodat de records eenvoudig te raadplegen zijn voor de editeurs.
* Annotaties

De mappen kunnen verschillende soorten documenten bevatten, waaronder één Word-bestand met
eigen, samengestelde informatie en scans van fragmenten uit boeken relevant voor de betreffende
persoon.
=====Structuur dossier=====
<voornaam>, <achternaam> <geboorte-en sterfdata>
<nationaliteit en kwalificatie, indien bekend>

'''Genoemde kunstwerken'''

'''Vermeldingen in brieven'''
* <MEP-nummer van de brief onderstreept> <2x tab> <verwijzing annotatie in brief>
* Citaat tussen enkele aanhalingstekens

'''Aanvullende informatie'''

'''Record in RKDartists&'''
* Permalink

'''Annotaties'''

=====Naamgeving dossier=====
De bestandsnamen voor documenten in /Personen wordt als volgt opgebouwd:
<Achternaam in hoofdletters>_<voornaam in kleine letters>

Mocht twee keer dezelfde naam voorkomen maar het betreft een ander persoon dan kunnen
geboorte-en sterfdata worden toegevoegd, bijvoorbeeld:
HELION_Jean_(1900-1944)
HELION_Jean_(1904-1987)

De map /Personen is automatisch alfabetisch gerangschikt.

====Publicaties====
Bevat documenten met informatie over in de brieven en geschriften genoemde boeken, tijdschriften,
brochures en andere al dan niet commerciële publicaties. De mappen kunnen verschillende soorten
documenten bevatten, waaronder één Word-bestand met eigen, samengestelde informatie en scans
van fragmenten uit boeken relevant voor de betreffende tijdschriften, kranten en andere publicaties. De documenten in deze map zijn anders opgebouwd dan de persoons- en organisatiedossiers en hebben een eigen template, waarin de naam, actieve jaren, nationaliteit en kwalificatie van de krant of het tijdschrift staan vermeld. Bij publicaties wordt volstaan met de vermelding van de auteur, titel en plaats en jaar van uitgave. Daarnaast zijn de gebruikelijke categorieën, vermeldingen in brieven, aanvullende informatie, record in RKDartists& en annotaties, opgenomen.
In de map /Commentaar is weliswaar een onderscheid gemaakt in een aantal categorieën maar die zullen in de praktijk regelmatig overlappen; zo kan een galerie een catalogus uitgeven; informatie daarover kan in /Organisatie - kunst en in /Publicaties.

=====Structuur dossier=====
<naam van tijdschrift of krant> <tussen ronde haken jaren dat tijdschrift of krant actief was>
<Nationaliteit en kwalificatie> of <auteur van de publicatie>, <titel publicatie>, <plaats en jaartal van uitgave>

'''Vermeldingen in brieven'''
* <MEP-nummer van de brief onderstreept> <2x tab> <verwijzing annotatie in brief>
* Citaat tussen enkele aanhalingstekens

'''Aanvullende informatie'''

'''Record in RKDartists&'''
* Permalink

'''Annotaties'''

=====Naamgeving dossier=====
De bestandsnamen voor documenten in Publicaties betreffen de namen van tijdschriften en kranten. Woorden worden van elkaar gescheiden door middel van een underscore. Deze map is alfabetisch gerangschikt.

===Inventarisatie_beheer===
====Bewaarplaatsen====

Alle oude versies van beeldmateriaal van brieven opslaan in repository in de map Inventarisatie_beheer/Bewaarplaatsen zoals ze worden toegestuurd door de beherende instellingen. De kans bestaat dat er kleine foutjes insluipen bij het overhevelen naar de map ‘Info per brief’ in de repository. Het scheelt veel uitzoekwerk als ik dan terug kan grijpen op de originele bestanden.

====Herkomstonderzoek====
[Nog beschrijven]

====Inventarisatie====
Drie mappen in dit Excel-bestand: brieven van Piet Mondriaan, Geschriften van Mondriaan en brieven aan Mondriaan.
Hier komt de toelichting op de inventarisatie van alle brieven en geschriften.
Termen uitschrijven, zoals EDS bij alternatieve datering (= door de editeurs vastgestelde datering van een brief).
Kleurcoderingen uitleggen: geel is voorlopig/onzeker, oranje is vervallen brieven, paars zijn briefverwijzingen van Louis Veen.

====Inventarisatie beeldmateriaal====

Van de ongedateerde brieven wordt voorlopig de alternatieve datering aangehouden met het oog op de sorteerfunctie van Excel. De cel waarin zo’n alternatieve datering in de dateringskolom is opgenomen, is geel gemaakt om te voorkomen dat het lijkt alsnog deze voorlopige datering is vastgesteld.

===Teksten===
Deze map bevat alle xml-bestanden van brieven en geschriften, verdeeld over respectievelijk de submappen /Letters, /Letters Preliminary en /Writings.

====Letters====
Documenten die in /Letters staan, worden ook getoond in de demoversie van de editie. Daarom worden transcripties tijdens het bewerkingsproces in /Letters Preliminary geplaatst; pas als ze afgerond zijn, worden ze in /Letters geplaatst.

====Bestanden per brief/geschrift====
Voor de bewerking van de brieven en theoretische geschriften op de uiteenlopende terreinen (tekst, annotaties, verwijzingen, afbeeldingen etc.) wordt per brief respectievelijk geschrift een afzonderlijk bestand gebruikt. Elk bestand krijgt een unieke, herkenbare naam (zie hierna); een definitief briefnummer kan pas bij publicatie worden toegekend.
De bestanden worden geschreven in xml en gecodeerd volgens richtlijnen van TEI / DALF; zie hiervoor ‘Encoding Mondrian’.
Naamgeving tekstbestanden
Bestandsnamen van brieven
Bestandsnamen van brieven bestaan uit drie onderdelen:
# datum (jjjjmmdd)
# indien geschreven door PM: verkorte achternaam geadresseerde (4 eerste letters, kapitalen); indien geschreven aan PM: afkorting PM + verkorte achternaam geadresseerde (4 eerste letters, kapitalen); indien er meer correspondenten met dezelfde achternaam zijn, volgt op de achternaam de voornaam, ook verkort (vier eerste letters, kapitalen)
Al deze onderdelen worden van elkaar gescheiden door underscore: _
Voorbeelden:
* Brief van Mondriaan aan H. van Assendelft dd. 6 januari 1919 → 19190106_PXXX_ASSE_0184
* Brief aan Mondriaan van Harry Holtzman dd 18 oktober 1939 → 19391018_P054_PM_HOLT_5029
* Brief van Nelly van Doesburg aan Mondriaan dd 18 oktober 1939 → 19391018_PXXX_DOES_NELL_<MEP-nummer>
* Eerdere brief van Nelly van Doesburg dd 18 oktober 1939 → 19391018_PXXX_DOES_NELL_<MEP-nummer>

Tussenvoegsels van achternamen worden niet in de bestandsnaam opgenomen (de, van de, von, de la e.d.).
Wanneer de geadresseerde onbekend is, wordt in de bestandsnaam ANON gebruikt.
Wanneer de achternaam uit minder dan vier letters bestaat wordt de volledige naam opgenomen.
Het kan voorkomen dat in plaats van persoonsnamen namen van bijv. instituties, bedrijven of organisaties worden gebruikt.
Bij onvolledige datering: delen die niet bekend zijn worden ingevuld met x.
Een brief uit de eerste week van april 1922 krijgt als datering 1922040x.
Een brief waarvan die alleen ‘oktober’ als datering heeft, krijgt als datering xxxx10xx.
Een brief waarvan we in het geheel geen indicatie van de datum hebben, krijgt dus als datering acht x’en.
Wanneer een datering globaal is wordt in de bestandsnaam de vroegste datum van de geschatte periode gebruikt: tweede helft mei 1893 wordt dus 18930516.

=====Bestandsnamen van geschriften=====
[wegens de stand van het onderzoek is deze paragraaf zeer voorlopig]
Natuurlijkerwijs zal naar een tekst verwezen worden met de titel. Dateringen gebruiken is minder geschikt. Daarom worden bestandsnamen gebaseerd op (twee of drie hoofdwoorden uit) de titel van de getranscribeerde tekst; dit heeft als voordeel dat versies van één tekst bij elkaar komen te staan. Om versieverschillen aan te geven kan een extensie gebruikt worden. Ook het pilotnummer kan worden gebruikt. Bijv. (fictief):.
<pre>
BORN_HOLLAND_TYPO3_P09
NECESSITY_NEW_TEACHING-PUBL-P11
DIALOOG_NWE_BEELDING_MS1-P01
</pre>
Later in het onderzoek zal bepaald worden of elk document en eigen bestand

====Writings====
Het betreft transcripties van geschriften van Mondriaan. Deze zijn verschillend van aard. Van sommige bestaat een originele handgeschreven versie, van sommige is alleen de publicatie in een tijdschrift bekend. Alles komt in deze map. Daarin vinden tevens documenten met gegevens die betrekking hebben op de geschriften een plek. Als Mondriaan een hoofdstuk publiceerde in een catalogus, dan is de algemene informatie hierover, samengesteld voor het maken van annotaties of algemene achtergrond informatie, opgenomen in een Word-document.
Deze map is onderverdeeld in submappen op jaartal en titel van het geschrift. In deze sub mappen komen de verschillende documenten, dus ook alle versies van hetzelfde geschrift en het Xml-bestand.
De opbouw van de bestandsnamen is als volgt:
* <jaartal>_<titel geschrift aan elkaar, spaties door middel van underscores>
Deze map is daardoor chronologisch gerangschikt.

===Verantwoording===
Map bevat zowel zelfstandige bestanden die methode en werkwijze beschrijven, als de submap met xml-instructie, /Documentation. De bestanden kunnen in uiteenlopende programma’s geschreven zijn (m.n. Word en Oxygen).

[[Category:XML Mondrian]]

Project procedure (Mondrian)

2017-01-25T13:35:46Z

ASC: /* Structuur repository */

Op deze pagina worden afspraken ten aanzien van de werkwijze vastgelegd voor het Mondriaan Editieproject. Daarmee bedoelen we de organisatie van het daadwerkelijke onderzoek en archivering van bestanden en documentatie die daarbij nodig zijn of die daaruit voortkomen. Behalve ter verantwoording van de gehanteerde aanpak is dit document ook bedoeld als houvast voor editeurs en andere medewerkers van het projectteam.
Aan het project wordt over een zeer lange periode gewerkt door meerdere personen met deels verschillende verantwoordelijkheden en uiteenlopende werktijden. Het is noodzakelijk dat zij zich allen houden aan dezelfde, hieronder beschreven uitgangspunten voor de tekstbewerking, het inhoudelijk onderzoek, het schrijven van annotaties en commentaar, het opslaan van de vergaarde en geproduceerde digitale bestanden en het beheer van (digitale en papieren) onderzoeksdocumentatie.
Het belang van deze ‘discipline’ is tweeledig. Ten eerste een efficiënt werkproces: wanneer iedereen zich aan dezelfde uitgangspunten houdt, kan werk gemakkelijker gedeeld en verdeeld worden; eventuele nieuwe medewerkers (met name stagiairs) kunnen gemakkelijker aanhaken als de aanpak voorgeschreven is; en de kans op het vergeten van ‘hoe we dat ook alweer deden’ wordt erdoor gereduceerd. Ten tweede bepaalt consistentie in hoge mate de uiteindelijke kwaliteit en betrouwbaarheid van de editie. Een consistente aanpak vanaf het begin draagt daar heel veel aan bij.
Tijdens het onderzoek — in elk geval in de eerste jaren, en zeker totdat alle onderdelen van het editieproces ten minste eenmaal aan de orde zijn geweest — zullen regelmatig nieuwe beslissingen over de werkwijze genomen moeten worden en oude bijgesteld. Telkens zullen die keuzes en afspraken direct moeten worden opgenomen in dit document.

==Repository==
Voor het Mondriaan Editieproject is schijfruimte ingericht op een repository zodat teamleden werkend vanuit het RKD en het Huygens ING toegang tot de documenten hebben. Dit document is bedoeld als verantwoording voor de wijze waarop welke informatie op welke plaats kan worden opgeborgen op de repository. Voor de continuïteit en vindbaarheid van documenten voor alle medewerkers van het project is het essentieel dat de hieronder beschreven richtlijnen worden gevolgd. Bovendien kan dit document helpen bij twijfel bij opberging van gegevens of raadpleging.
===Inchecken en updaten===
Alle bestanden die voortkomen uit het project (dus niet alleen de tekstbestanden maar ook de documentatie, administratie etc.) worden opgeslagen in de Repository. Het is van groot belang dat alle vergaarde informatie voor alle medewerkers in het project beschikbaar is. Om die reden is het volgende een volstrekt vereiste:
# ALVORENS ZIJN/HAAR COMPUTER (AAN HET EINDE VAN DE DAG) AF TE SLUITEN DOET ELKE MEDEWERKER EEN COMPLETE CHECK-OUT NAAR DE REPOSITORY. Vaker uitchecken is zeker toegestaan.
# BIJ HET OPENEN VAN DE SVN-CLIENT DOET ELKE MEDEWERKER EEN COMPLETE CHECK-IN UIT DE REPOSITORY.
Voor alle typen bestanden zijn mappen gemaakt met een vastgestelde indeling. Het is toegestaan nieuwe bestanden in bestaande mappen toe te voegen (als ze daar ook thuishoren). Het toevoegen, verwijderen of verplaatsen van mappen is achter alleen toegestaan na overleg door editeurs en documentalist omdat anders bij in- en uitchecken verwarring kan ontstaan.
===Gebruikers===
De editeurs werken voornamelijk in de map Teksten. Daarnaast zijn zij verantwoordelijk voor de mappen Apparaat, Verantwoording en Tests. In deze mappen maken zij zelf documenten aan. In de submappen onder Commentaar werken ze in bestaande documenten en maken, in overleg met de documentalist, nieuwe documenten aan.
De documentalist is verantwoordelijk voor de submappen onder Commentaar en maakt bestanden aan. De documentalist voegt hier nieuwe gegevens aan toe, die onder andere worden aangeleverd door de editeurs. Alle documenten in de mappen Apparaat, Teksten en Verantwoording worden door de documentalist ter raadpleging gebruikt maar zal daar geen wijzigingen in aanbrengen.
===Overige opmerkingen===
Voor de leesbaarheid zijn de namen van de hoofdmappen in hoofdletters weergegeven.
Bij documentatiemateriaal dat wordt gescand uit boeken, wordt altijd de voorkant opgenomen.
==Structuur repository==
De hoofdstructuur van de repository is als volgt:
* Administratie
* Bibliotheek
* Commentaar
** Begeleidende teksten
** Biografische Mondriaan documentatie
* Documentatie
** Info – per brief
** Organisatie – kunst
** Organisatie – overig
** Personen
** Publicaties
* Inventarisatie_beheer
** Bewaarplaatsen
** Herkomstonderzoek
** Inventarisatie
** Selectie pilot
* Secundair
* Teksten
** Letters
** Letters Preliminary
** Writings
* Tests and Samples (voor ICT-doeleinden; niet voor editeursteam)
* Verantwoording
** Editieverantwoording (van N-schijf)
** Documentation

===Administratie===
Stageopdrachten en reisschema’s bijvoorbeeld.

===Bibliotheek===
====Inhoud====
In de Bibliotheek komt alle relevante literatuur voor het project en bevat scans of digitale versies van
volledige publicaties die een fysieke publicatie kunnen vervangen.
De bibliotheek is een hulpmiddel en maakt strikt genomen geen deel uit van de opbouw van de
annotaties (zoals /Personen e.d.).

De enige eis is dat het bestand compleet moet zijn, dus een volledig gescand boek of een volledig
artikel/hoofdstuk uit een boek. Omdat de bestandsnaam kort en bondig moet zijn, dient alle
informatie over het gescande boek of hoofdstuk/artikel duidelijk in het document zelf voor te komen en moet altijd de voorkant van het boek gescand worden.
Er wordt geen onderscheid gemaakt tussen artikelen of boeken. Per publicatie wordt een submap
Gemaakt (voorstel EdV: pas aanmaken als er meerdere documenten per publicatie zijn, anders onnodig veel klikken). Zo kunnen behalve scans bijvoorbeeld ook informatie óver de publicatie opgenomen worden; achtergrond van ontstaan van een publicatie bijvoorbeeld.
Naamgeving
De opbouw van bestandsnamen voor documenten in deze map: <achternaam auteur>_<titel, spaties
door middel van underscores>_<jaartal van publicatie>

Lange titels worden verkort; ze moeten significante informatie over het gescande boek of
hoofdstuk/artikel geven; altijd moet de titelpagina van de publicatie gescand worden.

Door de opbouw van de bestandsnamen in de map is deze alfabetisch gerangschikt.

NB. Voor publicaties van Mondriaan is een aparte submap.

===Commentaar===
Map bevat alle documenten die gegevens bevatten voor alle vormen van inhoudelijk editeurscommentaar (m.n. annotaties, biografieën, inleidingen e.d.). De documenten zijn verschillend van aard: het gaat om Word-bestanden, die door het Mondriaan-team zijn samengesteld, scans uit boeken en bijvoorbeeld foto’s. De map /Commentaar is verdeeld in verschillende submappen.
Documentatie
====Info-per brief====
Bevat mappen voor elke brief; de briefmap bevat bestanden met gegevens die belangrijk zijn bij het
annoteren maar die onder geen van de andere categorieën (die hierna volgen) thuis te brengen zijn.
De Word-bestanden en scans of andere documenten die bij de betreffende brief horen, zullen
dezelfde naam krijgen als de brief.
=====Inhoud dossier=====
De briefmap bevat een bronnenmap voor reproducties en een voor de materiële beschrijving van de betreffende brief.
=====Structuur dossier=====
[nog schrijven]
=====Naamgeving dossier=====
De mappen hebben uitsluitend het viercijferige MEP-nummer. Eerder bleek dat een naamgeving die bestond uit de datum, gevolgd door geadresseerde sterk onderhevig is aan verandering. Daardoor vormde die constructie geen betrouwbare bestandsnaam. Het MEP-nummer is misschien lastiger om mee te werken omdat niet in één oogopslag duidelijk is om welke brief het gaat (dan moet je de inventarisatie erbij pakken), maar de MEP-nummers blijven wel hetzelfde.

De naamgeving van het dossier is als volgt opgebouwd:
<pre>Brievenmap <viercijferige MEP-nummer>
BRON_<MEP-nummer>
Repr_<MEP-nummer>
Mat_beschr_<MEP-nummer></pre>
====Organisatie - kunst====
Onder ‘kunstorganisaties’ worden verstaan alle instellingen, organisaties, bedrijven, verenigingen etc.
die gebaseerd zijn op betrokkenheid bij kunst. Dus musea, kunstenaarsverenigingen,
kunsthandels/galeries, tentoonstellingen e.d.
=====Inhoud dossier=====
Alle kunstorganisaties die in de brieven voorkomen, krijgen eigen dossiers. Deze dossiers bestaan uit
afzonderlijke mappen, bedoeld om gegevens te verzamelen voor het maken van annotaties. De
mappen kunnen verschillende soorten documenten bevatten, waaronder één Word-bestand met
eigen, samengestelde informatie en scans van fragmenten uit boeken relevant voor de betreffende
organisatie.
De kern van het dossier wordt gevormd door het Word-bestand met de volgende categorieën:
* Volledige naam
* Actieve jaren
* Nationaliteit
* Kwalificatie
* Vestiging van de organisatie (locatie)
* Vermeldingen in brieven
* Aanvullende informatie
* Record in RKDartists&
* Annotaties
=====Structuur dossier=====
De structuur van deze dossiers is als volgt:

'''Titel'''
<naam van de organisatie> <tussen ronde haken jaren dat organisatie actief was, als dit te vinden is>
<Nationaliteit en kwalificatie>
Gevestigd op <adres en plaatsnaam, indien dit van belang is of genoemd wordt in de brieven>

'''Vermeldingen in brieven'''
• <MEP-nummer van de brief onderstreept> <2x tab> <verwijzing annotatie in brief>
• Citaat tussen enkele aanhalingstekens

'''Aanvullende informatie'''

'''Record in RKDartists&'''
• Permalink

'''Annotaties'''

=====Naamgeving=====
De bestandsnaam voor documenten in Org-kunst bestaat uit de volledige naam van de betreffende
kunstenaarsvereniging, museum etc. Woorden worden aan elkaar geschreven, spaties door middel
van underscores.
Als het bijvoorbeeld om een kunsthandel gaat en het woord ‘galerie’ maakt
officieel deel uit van de naam, dan wordt deze als zodanig opgenomen. Is alfabetisch niet
inzichtelijker? LJ Dit is in overeenstemming met de regels van invoer van kunsthandels in RKDartists&.
Dit leidt bijvoorbeeld tot ‘Galerie_Nierendorf’ en ‘Valentine_Gallery’.

Voor bijvoorbeeld tentoonstellingen waarvan het (nog) onbekend is om welke tentoonstelling het
precies gaat, wordt de volgende opbouw van bestandsnamen gehanteerd:
<TS>_<plaats van de tentoonstelling>_<jaartal> (bijv. TS_New_York_1937)
De map /Organisatie - kunst is automatisch alfabetisch gerangschikt.
====Organisatie-overig====
Bevat mappen met dossiers van alle overige bedrijven, instellingen etc., al dan niet commercieel.
Bijvoorbeeld immigratiedienst, advocatenkantoor, scheepvaartmaatschappij, theosofische vereniging,
etc.
=====Inhoud dossier=====
De kern van het dossier wordt gevormd door een Word-bestand met dezelfde categorieën als bij kunstorganisaties, voor zover van toepassing. Het dossier kan ook andere documenten bevatten zoals webpagina’s, scans van fragmenten uit boeken relevant voor de betreffende organisatie.
=====Structuur en naamgeving dossier=====
Voor de naamgeving en structuur van het dossier /Organisatie - overig: zie /Organisatie - kunst, mutatis mutandis.

De map /Organisatie - overig is automatisch alfabetisch gerangschikt.

====Personen====
Alle personen die in de brieven voorkomen, krijgen een persoonsdossier. Voor bijvoorbeeld kunsthandelaren met een eigen galerie die ook verzamelden, wordt alles over de persoon en de handel in één dossier verzameld. Bij Valentine Dudensing komen alle gegevens in het document over de galerie. In het document van de persoon wordt alleen een verwijzing naar de galerie opgenomen.
=====Inhoud dossier=====
Deze dossiers bestaan uit afzonderlijke mappen, bedoeld om gegevens te verzamelen voor het maken
van annotaties. De kern van het dossier wordt gevormd door een Word-bestand met de volgende
categorieën:

* Volledige naam
* Kwalificatie
Kunsthandelaar, kunstenaar, verzamelaar etc.
* Genoemde kunstwerken
* Vermeldingen in brieven (citaten uit brieven van Mondriaan waarin deze persoon voorkomt)
* Aanvullende informatie
Algemene gegevens (achtergrondinformatie) die door de editeurs of de documentalist zijn/is achterhaald en van belang zijn/is bij het maken van annotaties.
* Record in RKDartists&
Hier komt de permalink uit RKDexplore zodat de records eenvoudig te raadplegen zijn voor de editeurs.
* Annotaties

De mappen kunnen verschillende soorten documenten bevatten, waaronder één Word-bestand met
eigen, samengestelde informatie en scans van fragmenten uit boeken relevant voor de betreffende
persoon.
=====Structuur dossier=====
<voornaam>, <achternaam> <geboorte-en sterfdata>
<nationaliteit en kwalificatie, indien bekend>

'''Genoemde kunstwerken'''

'''Vermeldingen in brieven'''
* <MEP-nummer van de brief onderstreept> <2x tab> <verwijzing annotatie in brief>
* Citaat tussen enkele aanhalingstekens

'''Aanvullende informatie'''

'''Record in RKDartists&'''
* Permalink

'''Annotaties'''

=====Naamgeving dossier=====
De bestandsnamen voor documenten in /Personen wordt als volgt opgebouwd:
<Achternaam in hoofdletters>_<voornaam in kleine letters>

Mocht twee keer dezelfde naam voorkomen maar het betreft een ander persoon dan kunnen
geboorte-en sterfdata worden toegevoegd, bijvoorbeeld:
HELION_Jean_(1900-1944)
HELION_Jean_(1904-1987)

De map /Personen is automatisch alfabetisch gerangschikt.

====Publicaties====
Bevat documenten met informatie over in de brieven en geschriften genoemde boeken, tijdschriften,
brochures en andere al dan niet commerciële publicaties. De mappen kunnen verschillende soorten
documenten bevatten, waaronder één Word-bestand met eigen, samengestelde informatie en scans
van fragmenten uit boeken relevant voor de betreffende tijdschriften, kranten en andere publicaties. De documenten in deze map zijn anders opgebouwd dan de persoons- en organisatiedossiers en hebben een eigen template, waarin de naam, actieve jaren, nationaliteit en kwalificatie van de krant of het tijdschrift staan vermeld. Bij publicaties wordt volstaan met de vermelding van de auteur, titel en plaats en jaar van uitgave. Daarnaast zijn de gebruikelijke categorieën, vermeldingen in brieven, aanvullende informatie, record in RKDartists& en annotaties, opgenomen.
In de map /Commentaar is weliswaar een onderscheid gemaakt in een aantal categorieën maar die zullen in de praktijk regelmatig overlappen; zo kan een galerie een catalogus uitgeven; informatie daarover kan in /Organisatie - kunst en in /Publicaties.

=====Structuur dossier=====
<naam van tijdschrift of krant> <tussen ronde haken jaren dat tijdschrift of krant actief was>
<Nationaliteit en kwalificatie> of <auteur van de publicatie>, <titel publicatie>, <plaats en jaartal van uitgave>

'''Vermeldingen in brieven'''
* <MEP-nummer van de brief onderstreept> <2x tab> <verwijzing annotatie in brief>
* Citaat tussen enkele aanhalingstekens

'''Aanvullende informatie'''

'''Record in RKDartists&'''
* Permalink

'''Annotaties'''

=====Naamgeving dossier=====
De bestandsnamen voor documenten in Publicaties betreffen de namen van tijdschriften en kranten. Woorden worden van elkaar gescheiden door middel van een underscore. Deze map is alfabetisch gerangschikt.

===Inventarisatie_beheer===
====Bewaarplaatsen====

Alle oude versies van beeldmateriaal van brieven opslaan in repository in de map Inventarisatie_beheer/Bewaarplaatsen zoals ze worden toegestuurd door de beherende instellingen. De kans bestaat dat er kleine foutjes insluipen bij het overhevelen naar de map ‘Info per brief’ in de repository. Het scheelt veel uitzoekwerk als ik dan terug kan grijpen op de originele bestanden.

====Herkomstonderzoek====
[Nog beschrijven]

====Inventarisatie====
Drie mappen in dit Excel-bestand: brieven van Piet Mondriaan, Geschriften van Mondriaan en brieven aan Mondriaan.
Hier komt de toelichting op de inventarisatie van alle brieven en geschriften.
Termen uitschrijven, zoals EDS bij alternatieve datering (= door de editeurs vastgestelde datering van een brief).
Kleurcoderingen uitleggen: geel is voorlopig/onzeker, oranje is vervallen brieven, paars zijn briefverwijzingen van Louis Veen.

====Inventarisatie beeldmateriaal====

Van de ongedateerde brieven wordt voorlopig de alternatieve datering aangehouden met het oog op de sorteerfunctie van Excel. De cel waarin zo’n alternatieve datering in de dateringskolom is opgenomen, is geel gemaakt om te voorkomen dat het lijkt alsnog deze voorlopige datering is vastgesteld.

[[Category:XML Mondrian]]

Project procedure (Mondrian)

2017-01-25T13:34:24Z

ASC:

Op deze pagina worden afspraken ten aanzien van de werkwijze vastgelegd voor het Mondriaan Editieproject. Daarmee bedoelen we de organisatie van het daadwerkelijke onderzoek en archivering van bestanden en documentatie die daarbij nodig zijn of die daaruit voortkomen. Behalve ter verantwoording van de gehanteerde aanpak is dit document ook bedoeld als houvast voor editeurs en andere medewerkers van het projectteam.
Aan het project wordt over een zeer lange periode gewerkt door meerdere personen met deels verschillende verantwoordelijkheden en uiteenlopende werktijden. Het is noodzakelijk dat zij zich allen houden aan dezelfde, hieronder beschreven uitgangspunten voor de tekstbewerking, het inhoudelijk onderzoek, het schrijven van annotaties en commentaar, het opslaan van de vergaarde en geproduceerde digitale bestanden en het beheer van (digitale en papieren) onderzoeksdocumentatie.
Het belang van deze ‘discipline’ is tweeledig. Ten eerste een efficiënt werkproces: wanneer iedereen zich aan dezelfde uitgangspunten houdt, kan werk gemakkelijker gedeeld en verdeeld worden; eventuele nieuwe medewerkers (met name stagiairs) kunnen gemakkelijker aanhaken als de aanpak voorgeschreven is; en de kans op het vergeten van ‘hoe we dat ook alweer deden’ wordt erdoor gereduceerd. Ten tweede bepaalt consistentie in hoge mate de uiteindelijke kwaliteit en betrouwbaarheid van de editie. Een consistente aanpak vanaf het begin draagt daar heel veel aan bij.
Tijdens het onderzoek — in elk geval in de eerste jaren, en zeker totdat alle onderdelen van het editieproces ten minste eenmaal aan de orde zijn geweest — zullen regelmatig nieuwe beslissingen over de werkwijze genomen moeten worden en oude bijgesteld. Telkens zullen die keuzes en afspraken direct moeten worden opgenomen in dit document.

==Repository==
Voor het Mondriaan Editieproject is schijfruimte ingericht op een repository zodat teamleden werkend vanuit het RKD en het Huygens ING toegang tot de documenten hebben. Dit document is bedoeld als verantwoording voor de wijze waarop welke informatie op welke plaats kan worden opgeborgen op de repository. Voor de continuïteit en vindbaarheid van documenten voor alle medewerkers van het project is het essentieel dat de hieronder beschreven richtlijnen worden gevolgd. Bovendien kan dit document helpen bij twijfel bij opberging van gegevens of raadpleging.
===Inchecken en updaten===
Alle bestanden die voortkomen uit het project (dus niet alleen de tekstbestanden maar ook de documentatie, administratie etc.) worden opgeslagen in de Repository. Het is van groot belang dat alle vergaarde informatie voor alle medewerkers in het project beschikbaar is. Om die reden is het volgende een volstrekt vereiste:
# ALVORENS ZIJN/HAAR COMPUTER (AAN HET EINDE VAN DE DAG) AF TE SLUITEN DOET ELKE MEDEWERKER EEN COMPLETE CHECK-OUT NAAR DE REPOSITORY. Vaker uitchecken is zeker toegestaan.
# BIJ HET OPENEN VAN DE SVN-CLIENT DOET ELKE MEDEWERKER EEN COMPLETE CHECK-IN UIT DE REPOSITORY.
Voor alle typen bestanden zijn mappen gemaakt met een vastgestelde indeling. Het is toegestaan nieuwe bestanden in bestaande mappen toe te voegen (als ze daar ook thuishoren). Het toevoegen, verwijderen of verplaatsen van mappen is achter alleen toegestaan na overleg door editeurs en documentalist omdat anders bij in- en uitchecken verwarring kan ontstaan.
===Gebruikers===
De editeurs werken voornamelijk in de map Teksten. Daarnaast zijn zij verantwoordelijk voor de mappen Apparaat, Verantwoording en Tests. In deze mappen maken zij zelf documenten aan. In de submappen onder Commentaar werken ze in bestaande documenten en maken, in overleg met de documentalist, nieuwe documenten aan.
De documentalist is verantwoordelijk voor de submappen onder Commentaar en maakt bestanden aan. De documentalist voegt hier nieuwe gegevens aan toe, die onder andere worden aangeleverd door de editeurs. Alle documenten in de mappen Apparaat, Teksten en Verantwoording worden door de documentalist ter raadpleging gebruikt maar zal daar geen wijzigingen in aanbrengen.
===Overige opmerkingen===
Voor de leesbaarheid zijn de namen van de hoofdmappen in hoofdletters weergegeven.
Bij documentatiemateriaal dat wordt gescand uit boeken, wordt altijd de voorkant opgenomen.
==Structuur repository==
De hoofdstructuur van de repository is als volgt:
* Administratie
* Bibliotheek
* Commentaar
** Begeleidende teksten
** Biografische Mondriaan documentatie
* Documentatie
** Info – per brief
** Organisatie – kunst
** Organisatie – overig
** Personen
** Publicaties
* Inventarisatie_beheer
** Bewaarplaatsen
** Herkomstonderzoek
** Inventarisatie
** Selectie pilot
* Secundair
* Teksten
** Letters
** Letters Preliminary
** Writings
* Tests and Samples
* Verantwoording
** Editieverantwoording (van N-schijf)
** Documentation

===Administratie===
Stageopdrachten en reisschema’s bijvoorbeeld.

===Bibliotheek===
====Inhoud====
In de Bibliotheek komt alle relevante literatuur voor het project en bevat scans of digitale versies van
volledige publicaties die een fysieke publicatie kunnen vervangen.
De bibliotheek is een hulpmiddel en maakt strikt genomen geen deel uit van de opbouw van de
annotaties (zoals /Personen e.d.).

De enige eis is dat het bestand compleet moet zijn, dus een volledig gescand boek of een volledig
artikel/hoofdstuk uit een boek. Omdat de bestandsnaam kort en bondig moet zijn, dient alle
informatie over het gescande boek of hoofdstuk/artikel duidelijk in het document zelf voor te komen en moet altijd de voorkant van het boek gescand worden.
Er wordt geen onderscheid gemaakt tussen artikelen of boeken. Per publicatie wordt een submap
Gemaakt (voorstel EdV: pas aanmaken als er meerdere documenten per publicatie zijn, anders onnodig veel klikken). Zo kunnen behalve scans bijvoorbeeld ook informatie óver de publicatie opgenomen worden; achtergrond van ontstaan van een publicatie bijvoorbeeld.
Naamgeving
De opbouw van bestandsnamen voor documenten in deze map: <achternaam auteur>_<titel, spaties
door middel van underscores>_<jaartal van publicatie>

Lange titels worden verkort; ze moeten significante informatie over het gescande boek of
hoofdstuk/artikel geven; altijd moet de titelpagina van de publicatie gescand worden.

Door de opbouw van de bestandsnamen in de map is deze alfabetisch gerangschikt.

NB. Voor publicaties van Mondriaan is een aparte submap.

===Commentaar===
Map bevat alle documenten die gegevens bevatten voor alle vormen van inhoudelijk editeurscommentaar (m.n. annotaties, biografieën, inleidingen e.d.). De documenten zijn verschillend van aard: het gaat om Word-bestanden, die door het Mondriaan-team zijn samengesteld, scans uit boeken en bijvoorbeeld foto’s. De map /Commentaar is verdeeld in verschillende submappen.
Documentatie
====Info-per brief====
Bevat mappen voor elke brief; de briefmap bevat bestanden met gegevens die belangrijk zijn bij het
annoteren maar die onder geen van de andere categorieën (die hierna volgen) thuis te brengen zijn.
De Word-bestanden en scans of andere documenten die bij de betreffende brief horen, zullen
dezelfde naam krijgen als de brief.
=====Inhoud dossier=====
De briefmap bevat een bronnenmap voor reproducties en een voor de materiële beschrijving van de betreffende brief.
=====Structuur dossier=====
[nog schrijven]
=====Naamgeving dossier=====
De mappen hebben uitsluitend het viercijferige MEP-nummer. Eerder bleek dat een naamgeving die bestond uit de datum, gevolgd door geadresseerde sterk onderhevig is aan verandering. Daardoor vormde die constructie geen betrouwbare bestandsnaam. Het MEP-nummer is misschien lastiger om mee te werken omdat niet in één oogopslag duidelijk is om welke brief het gaat (dan moet je de inventarisatie erbij pakken), maar de MEP-nummers blijven wel hetzelfde.

De naamgeving van het dossier is als volgt opgebouwd:
<pre>Brievenmap <viercijferige MEP-nummer>
BRON_<MEP-nummer>
Repr_<MEP-nummer>
Mat_beschr_<MEP-nummer></pre>
====Organisatie - kunst====
Onder ‘kunstorganisaties’ worden verstaan alle instellingen, organisaties, bedrijven, verenigingen etc.
die gebaseerd zijn op betrokkenheid bij kunst. Dus musea, kunstenaarsverenigingen,
kunsthandels/galeries, tentoonstellingen e.d.
=====Inhoud dossier=====
Alle kunstorganisaties die in de brieven voorkomen, krijgen eigen dossiers. Deze dossiers bestaan uit
afzonderlijke mappen, bedoeld om gegevens te verzamelen voor het maken van annotaties. De
mappen kunnen verschillende soorten documenten bevatten, waaronder één Word-bestand met
eigen, samengestelde informatie en scans van fragmenten uit boeken relevant voor de betreffende
organisatie.
De kern van het dossier wordt gevormd door het Word-bestand met de volgende categorieën:
* Volledige naam
* Actieve jaren
* Nationaliteit
* Kwalificatie
* Vestiging van de organisatie (locatie)
* Vermeldingen in brieven
* Aanvullende informatie
* Record in RKDartists&
* Annotaties
=====Structuur dossier=====
De structuur van deze dossiers is als volgt:

'''Titel'''
<naam van de organisatie> <tussen ronde haken jaren dat organisatie actief was, als dit te vinden is>
<Nationaliteit en kwalificatie>
Gevestigd op <adres en plaatsnaam, indien dit van belang is of genoemd wordt in de brieven>

'''Vermeldingen in brieven'''
• <MEP-nummer van de brief onderstreept> <2x tab> <verwijzing annotatie in brief>
• Citaat tussen enkele aanhalingstekens

'''Aanvullende informatie'''

'''Record in RKDartists&'''
• Permalink

'''Annotaties'''

=====Naamgeving=====
De bestandsnaam voor documenten in Org-kunst bestaat uit de volledige naam van de betreffende
kunstenaarsvereniging, museum etc. Woorden worden aan elkaar geschreven, spaties door middel
van underscores.
Als het bijvoorbeeld om een kunsthandel gaat en het woord ‘galerie’ maakt
officieel deel uit van de naam, dan wordt deze als zodanig opgenomen. Is alfabetisch niet
inzichtelijker? LJ Dit is in overeenstemming met de regels van invoer van kunsthandels in RKDartists&.
Dit leidt bijvoorbeeld tot ‘Galerie_Nierendorf’ en ‘Valentine_Gallery’.

Voor bijvoorbeeld tentoonstellingen waarvan het (nog) onbekend is om welke tentoonstelling het
precies gaat, wordt de volgende opbouw van bestandsnamen gehanteerd:
<TS>_<plaats van de tentoonstelling>_<jaartal> (bijv. TS_New_York_1937)
De map /Organisatie - kunst is automatisch alfabetisch gerangschikt.
====Organisatie-overig====
Bevat mappen met dossiers van alle overige bedrijven, instellingen etc., al dan niet commercieel.
Bijvoorbeeld immigratiedienst, advocatenkantoor, scheepvaartmaatschappij, theosofische vereniging,
etc.
=====Inhoud dossier=====
De kern van het dossier wordt gevormd door een Word-bestand met dezelfde categorieën als bij kunstorganisaties, voor zover van toepassing. Het dossier kan ook andere documenten bevatten zoals webpagina’s, scans van fragmenten uit boeken relevant voor de betreffende organisatie.
=====Structuur en naamgeving dossier=====
Voor de naamgeving en structuur van het dossier /Organisatie - overig: zie /Organisatie - kunst, mutatis mutandis.

De map /Organisatie - overig is automatisch alfabetisch gerangschikt.

====Personen====
Alle personen die in de brieven voorkomen, krijgen een persoonsdossier. Voor bijvoorbeeld kunsthandelaren met een eigen galerie die ook verzamelden, wordt alles over de persoon en de handel in één dossier verzameld. Bij Valentine Dudensing komen alle gegevens in het document over de galerie. In het document van de persoon wordt alleen een verwijzing naar de galerie opgenomen.
=====Inhoud dossier=====
Deze dossiers bestaan uit afzonderlijke mappen, bedoeld om gegevens te verzamelen voor het maken
van annotaties. De kern van het dossier wordt gevormd door een Word-bestand met de volgende
categorieën:

* Volledige naam
* Kwalificatie
Kunsthandelaar, kunstenaar, verzamelaar etc.
* Genoemde kunstwerken
* Vermeldingen in brieven (citaten uit brieven van Mondriaan waarin deze persoon voorkomt)
* Aanvullende informatie
Algemene gegevens (achtergrondinformatie) die door de editeurs of de documentalist zijn/is achterhaald en van belang zijn/is bij het maken van annotaties.
* Record in RKDartists&
Hier komt de permalink uit RKDexplore zodat de records eenvoudig te raadplegen zijn voor de editeurs.
* Annotaties

De mappen kunnen verschillende soorten documenten bevatten, waaronder één Word-bestand met
eigen, samengestelde informatie en scans van fragmenten uit boeken relevant voor de betreffende
persoon.
=====Structuur dossier=====
<voornaam>, <achternaam> <geboorte-en sterfdata>
<nationaliteit en kwalificatie, indien bekend>

'''Genoemde kunstwerken'''

'''Vermeldingen in brieven'''
* <MEP-nummer van de brief onderstreept> <2x tab> <verwijzing annotatie in brief>
* Citaat tussen enkele aanhalingstekens

'''Aanvullende informatie'''

'''Record in RKDartists&'''
* Permalink

'''Annotaties'''

=====Naamgeving dossier=====
De bestandsnamen voor documenten in /Personen wordt als volgt opgebouwd:
<Achternaam in hoofdletters>_<voornaam in kleine letters>

Mocht twee keer dezelfde naam voorkomen maar het betreft een ander persoon dan kunnen
geboorte-en sterfdata worden toegevoegd, bijvoorbeeld:
HELION_Jean_(1900-1944)
HELION_Jean_(1904-1987)

De map /Personen is automatisch alfabetisch gerangschikt.

====Publicaties====
Bevat documenten met informatie over in de brieven en geschriften genoemde boeken, tijdschriften,
brochures en andere al dan niet commerciële publicaties. De mappen kunnen verschillende soorten
documenten bevatten, waaronder één Word-bestand met eigen, samengestelde informatie en scans
van fragmenten uit boeken relevant voor de betreffende tijdschriften, kranten en andere publicaties. De documenten in deze map zijn anders opgebouwd dan de persoons- en organisatiedossiers en hebben een eigen template, waarin de naam, actieve jaren, nationaliteit en kwalificatie van de krant of het tijdschrift staan vermeld. Bij publicaties wordt volstaan met de vermelding van de auteur, titel en plaats en jaar van uitgave. Daarnaast zijn de gebruikelijke categorieën, vermeldingen in brieven, aanvullende informatie, record in RKDartists& en annotaties, opgenomen.
In de map /Commentaar is weliswaar een onderscheid gemaakt in een aantal categorieën maar die zullen in de praktijk regelmatig overlappen; zo kan een galerie een catalogus uitgeven; informatie daarover kan in /Organisatie - kunst en in /Publicaties.

=====Structuur dossier=====
<naam van tijdschrift of krant> <tussen ronde haken jaren dat tijdschrift of krant actief was>
<Nationaliteit en kwalificatie> of <auteur van de publicatie>, <titel publicatie>, <plaats en jaartal van uitgave>

'''Vermeldingen in brieven'''
* <MEP-nummer van de brief onderstreept> <2x tab> <verwijzing annotatie in brief>
* Citaat tussen enkele aanhalingstekens

'''Aanvullende informatie'''

'''Record in RKDartists&'''
* Permalink

'''Annotaties'''

=====Naamgeving dossier=====
De bestandsnamen voor documenten in Publicaties betreffen de namen van tijdschriften en kranten. Woorden worden van elkaar gescheiden door middel van een underscore. Deze map is alfabetisch gerangschikt.

===Inventarisatie_beheer===
====Bewaarplaatsen====

Alle oude versies van beeldmateriaal van brieven opslaan in repository in de map Inventarisatie_beheer/Bewaarplaatsen zoals ze worden toegestuurd door de beherende instellingen. De kans bestaat dat er kleine foutjes insluipen bij het overhevelen naar de map ‘Info per brief’ in de repository. Het scheelt veel uitzoekwerk als ik dan terug kan grijpen op de originele bestanden.

====Herkomstonderzoek====
[Nog beschrijven]

====Inventarisatie====
Drie mappen in dit Excel-bestand: brieven van Piet Mondriaan, Geschriften van Mondriaan en brieven aan Mondriaan.
Hier komt de toelichting op de inventarisatie van alle brieven en geschriften.
Termen uitschrijven, zoals EDS bij alternatieve datering (= door de editeurs vastgestelde datering van een brief).
Kleurcoderingen uitleggen: geel is voorlopig/onzeker, oranje is vervallen brieven, paars zijn briefverwijzingen van Louis Veen.

====Inventarisatie beeldmateriaal====

Van de ongedateerde brieven wordt voorlopig de alternatieve datering aangehouden met het oog op de sorteerfunctie van Excel. De cel waarin zo’n alternatieve datering in de dateringskolom is opgenomen, is geel gemaakt om te voorkomen dat het lijkt alsnog deze voorlopige datering is vastgesteld.

[[Category:XML Mondrian]]

Project procedure (Mondrian)

2017-01-25T13:28:18Z

ASC:

Op deze pagina worden afspraken ten aanzien van de werkwijze vastgelegd voor het Mondriaan Editieproject. Daarmee bedoelen we de organisatie van het daadwerkelijke onderzoek en archivering van bestanden en documentatie die daarbij nodig zijn of die daaruit voortkomen. Behalve ter verantwoording van de gehanteerde aanpak is dit document ook bedoeld als houvast voor editeurs en andere medewerkers van het projectteam.
Aan het project wordt over een zeer lange periode gewerkt door meerdere personen met deels verschillende verantwoordelijkheden en uiteenlopende werktijden. Het is noodzakelijk dat zij zich allen houden aan dezelfde, hieronder beschreven uitgangspunten voor de tekstbewerking, het inhoudelijk onderzoek, het schrijven van annotaties en commentaar, het opslaan van de vergaarde en geproduceerde digitale bestanden en het beheer van (digitale en papieren) onderzoeksdocumentatie.
Het belang van deze ‘discipline’ is tweeledig. Ten eerste een efficiënt werkproces: wanneer iedereen zich aan dezelfde uitgangspunten houdt, kan werk gemakkelijker gedeeld en verdeeld worden; eventuele nieuwe medewerkers (met name stagiairs) kunnen gemakkelijker aanhaken als de aanpak voorgeschreven is; en de kans op het vergeten van ‘hoe we dat ook alweer deden’ wordt erdoor gereduceerd. Ten tweede bepaalt consistentie in hoge mate de uiteindelijke kwaliteit en betrouwbaarheid van de editie. Een consistente aanpak vanaf het begin draagt daar heel veel aan bij.
Tijdens het onderzoek — in elk geval in de eerste jaren, en zeker totdat alle onderdelen van het editieproces ten minste eenmaal aan de orde zijn geweest — zullen regelmatig nieuwe beslissingen over de werkwijze genomen moeten worden en oude bijgesteld. Telkens zullen die keuzes en afspraken direct moeten worden opgenomen in dit document.

==Repository==
Voor het Mondriaan Editieproject is schijfruimte ingericht op een repository zodat teamleden werkend vanuit het RKD en het Huygens ING toegang tot de documenten hebben. Dit document is bedoeld als verantwoording voor de wijze waarop welke informatie op welke plaats kan worden opgeborgen op de repository. Voor de continuïteit en vindbaarheid van documenten voor alle medewerkers van het project is het essentieel dat de hieronder beschreven richtlijnen worden gevolgd. Bovendien kan dit document helpen bij twijfel bij opberging van gegevens of raadpleging.
===Inchecken en updaten===
Alle bestanden die voortkomen uit het project (dus niet alleen de tekstbestanden maar ook de documentatie, administratie etc.) worden opgeslagen in de Repository. Het is van groot belang dat alle vergaarde informatie voor alle medewerkers in het project beschikbaar is. Om die reden is het volgende een volstrekt vereiste:
# ALVORENS ZIJN/HAAR COMPUTER (AAN HET EINDE VAN DE DAG) AF TE SLUITEN DOET ELKE MEDEWERKER EEN COMPLETE CHECK-OUT NAAR DE REPOSITORY. Vaker uitchecken is zeker toegestaan.
# BIJ HET OPENEN VAN DE SVN-CLIENT DOET ELKE MEDEWERKER EEN COMPLETE CHECK-IN UIT DE REPOSITORY.
Voor alle typen bestanden zijn mappen gemaakt met een vastgestelde indeling. Het is toegestaan nieuwe bestanden in bestaande mappen toe te voegen (als ze daar ook thuishoren). Het toevoegen, verwijderen of verplaatsen van mappen is achter alleen toegestaan na overleg door editeurs en documentalist omdat anders bij in- en uitchecken verwarring kan ontstaan.
===Gebruikers===
De editeurs werken voornamelijk in de map Teksten. Daarnaast zijn zij verantwoordelijk voor de mappen Apparaat, Verantwoording en Tests. In deze mappen maken zij zelf documenten aan. In de submappen onder Commentaar werken ze in bestaande documenten en maken, in overleg met de documentalist, nieuwe documenten aan.
De documentalist is verantwoordelijk voor de submappen onder Commentaar en maakt bestanden aan. De documentalist voegt hier nieuwe gegevens aan toe, die onder andere worden aangeleverd door de editeurs. Alle documenten in de mappen Apparaat, Teksten en Verantwoording worden door de documentalist ter raadpleging gebruikt maar zal daar geen wijzigingen in aanbrengen.
===Overige opmerkingen===
Voor de leesbaarheid zijn de namen van de hoofdmappen in hoofdletters weergegeven.
Bij documentatiemateriaal dat wordt gescand uit boeken, wordt altijd de voorkant opgenomen.
==Structuur repository==
De hoofdstructuur van de repository is als volgt:
* Administratie
* Bibliotheek
* Commentaar
** Begeleidende teksten
** Biografische Mondriaan documentatie
* Documentatie
** Info – per brief
** Organisatie – kunst
** Organisatie – overig
** Personen
** Publicaties
* Inventarisatie_beheer
** Bewaarplaatsen
** Herkomstonderzoek
** Inventarisatie
** Selectie pilot
* Secundair
* Teksten
** Letters
** Letters Preliminary
** Writings
* Tests and Samples
* Verantwoording
** Editieverantwoording (van N-schijf)
** Documentation

===Administratie===
Stageopdrachten en reisschema’s bijvoorbeeld.

===Bibliotheek===
====Inhoud====
In de Bibliotheek komt alle relevante literatuur voor het project en bevat scans of digitale versies van
volledige publicaties die een fysieke publicatie kunnen vervangen.
De bibliotheek is een hulpmiddel en maakt strikt genomen geen deel uit van de opbouw van de
annotaties (zoals /Personen e.d.).

De enige eis is dat het bestand compleet moet zijn, dus een volledig gescand boek of een volledig
artikel/hoofdstuk uit een boek. Omdat de bestandsnaam kort en bondig moet zijn, dient alle
informatie over het gescande boek of hoofdstuk/artikel duidelijk in het document zelf voor te komen en moet altijd de voorkant van het boek gescand worden.
Er wordt geen onderscheid gemaakt tussen artikelen of boeken. Per publicatie wordt een submap
Gemaakt (voorstel EdV: pas aanmaken als er meerdere documenten per publicatie zijn, anders onnodig veel klikken). Zo kunnen behalve scans bijvoorbeeld ook informatie óver de publicatie opgenomen worden; achtergrond van ontstaan van een publicatie bijvoorbeeld.
Naamgeving
De opbouw van bestandsnamen voor documenten in deze map: <achternaam auteur>_<titel, spaties
door middel van underscores>_<jaartal van publicatie>

Lange titels worden verkort; ze moeten significante informatie over het gescande boek of
hoofdstuk/artikel geven; altijd moet de titelpagina van de publicatie gescand worden.

Door de opbouw van de bestandsnamen in de map is deze alfabetisch gerangschikt.

NB. Voor publicaties van Mondriaan is een aparte submap.

===Commentaar===
Map bevat alle documenten die gegevens bevatten voor alle vormen van inhoudelijk editeurscommentaar (m.n. annotaties, biografieën, inleidingen e.d.). De documenten zijn verschillend van aard: het gaat om Word-bestanden, die door het Mondriaan-team zijn samengesteld, scans uit boeken en bijvoorbeeld foto’s. De map /Commentaar is verdeeld in verschillende submappen.
Documentatie
====Info-per brief====
Bevat mappen voor elke brief; de briefmap bevat bestanden met gegevens die belangrijk zijn bij het
annoteren maar die onder geen van de andere categorieën (die hierna volgen) thuis te brengen zijn.
De Word-bestanden en scans of andere documenten die bij de betreffende brief horen, zullen
dezelfde naam krijgen als de brief.
=====Inhoud dossier=====
De briefmap bevat een bronnenmap voor reproducties en een voor de materiële beschrijving van de betreffende brief.
=====Structuur dossier=====
[nog schrijven]
=====Naamgeving dossier=====
De mappen hebben uitsluitend het viercijferige MEP-nummer. Eerder bleek dat een naamgeving die bestond uit de datum, gevolgd door geadresseerde sterk onderhevig is aan verandering. Daardoor vormde die constructie geen betrouwbare bestandsnaam. Het MEP-nummer is misschien lastiger om mee te werken omdat niet in één oogopslag duidelijk is om welke brief het gaat (dan moet je de inventarisatie erbij pakken), maar de MEP-nummers blijven wel hetzelfde.

De naamgeving van het dossier is als volgt opgebouwd:
<pre>Brievenmap <viercijferige MEP-nummer>
BRON_<MEP-nummer>
Repr_<MEP-nummer>
Mat_beschr_<MEP-nummer></pre>
====Organisatie - kunst====
Onder ‘kunstorganisaties’ worden verstaan alle instellingen, organisaties, bedrijven, verenigingen etc.
die gebaseerd zijn op betrokkenheid bij kunst. Dus musea, kunstenaarsverenigingen,
kunsthandels/galeries, tentoonstellingen e.d.
=====Inhoud dossier=====
Alle kunstorganisaties die in de brieven voorkomen, krijgen eigen dossiers. Deze dossiers bestaan uit
afzonderlijke mappen, bedoeld om gegevens te verzamelen voor het maken van annotaties. De
mappen kunnen verschillende soorten documenten bevatten, waaronder één Word-bestand met
eigen, samengestelde informatie en scans van fragmenten uit boeken relevant voor de betreffende
organisatie.
De kern van het dossier wordt gevormd door het Word-bestand met de volgende categorieën:
* Volledige naam
* Actieve jaren
* Nationaliteit
* Kwalificatie
* Vestiging van de organisatie (locatie)
* Vermeldingen in brieven
* Aanvullende informatie
* Record in RKDartists&
* Annotaties
=====Structuur dossier=====
De structuur van deze dossiers is als volgt:

'''Titel'''
<naam van de organisatie> <tussen ronde haken jaren dat organisatie actief was, als dit te vinden is>
<Nationaliteit en kwalificatie>
Gevestigd op <adres en plaatsnaam, indien dit van belang is of genoemd wordt in de brieven>

'''Vermeldingen in brieven'''
• <MEP-nummer van de brief onderstreept> <2x tab> <verwijzing annotatie in brief>
• Citaat tussen enkele aanhalingstekens

'''Aanvullende informatie'''

'''Record in RKDartists&'''
• Permalink

'''Annotaties'''

=====Naamgeving=====
De bestandsnaam voor documenten in Org-kunst bestaat uit de volledige naam van de betreffende
kunstenaarsvereniging, museum etc. Woorden worden aan elkaar geschreven, spaties door middel
van underscores.
Als het bijvoorbeeld om een kunsthandel gaat en het woord ‘galerie’ maakt
officieel deel uit van de naam, dan wordt deze als zodanig opgenomen. Is alfabetisch niet
inzichtelijker? LJ Dit is in overeenstemming met de regels van invoer van kunsthandels in RKDartists&.
Dit leidt bijvoorbeeld tot ‘Galerie_Nierendorf’ en ‘Valentine_Gallery’.

Voor bijvoorbeeld tentoonstellingen waarvan het (nog) onbekend is om welke tentoonstelling het
precies gaat, wordt de volgende opbouw van bestandsnamen gehanteerd:
<TS>_<plaats van de tentoonstelling>_<jaartal> (bijv. TS_New_York_1937)
De map /Organisatie - kunst is automatisch alfabetisch gerangschikt.
====Organisatie-overig====
Bevat mappen met dossiers van alle overige bedrijven, instellingen etc., al dan niet commercieel.
Bijvoorbeeld immigratiedienst, advocatenkantoor, scheepvaartmaatschappij, theosofische vereniging,
etc.
=====Inhoud dossier=====
De kern van het dossier wordt gevormd door een Word-bestand met dezelfde categorieën als bij
kunstorganisaties, voor zover van toepassing. Het dossier kan ook andere documenten bevatten zoals
webpagina’s, scans van fragmenten uit boeken relevant voor de betreffende organisatie.
Structuur en naamgeving dossier
Voor de naamgeving en structuur van het dossier /Organisatie - overig: zie /Organisatie - kunst,
mutatis mutandis.

De map /Organisatie - overig is automatisch alfabetisch gerangschikt.
Personen
Alle personen die in de brieven voorkomen, krijgen een persoonsdossier. Voor bijvoorbeeld kunsthandelaren met een eigen galerie die ook verzamelden, wordt alles over de persoon en de handel in één dossier verzameld. Bij Valentine Dudensing komen alle gegevens in het document over de galerie. In het document van de persoon wordt alleen een verwijzing naar de galerie opgenomen.
Inhoud dossier
Deze dossiers bestaan uit afzonderlijke mappen, bedoeld om gegevens te verzamelen voor het maken
van annotaties. De kern van het dossier wordt gevormd door een Word-bestand met de volgende
categorieën:

• Volledige naam
• Kwalificatie
Kunsthandelaar, kunstenaar, verzamelaar etc.
• Genoemde kunstwerken
• Vermeldingen in brieven (citaten uit brieven van Mondriaan waarin deze persoon voorkomt)
• Aanvullende informatie
Algemene gegevens (achtergrondinformatie) die door de editeurs of de documentalist zijn/is achterhaald en van belang zijn/is bij het maken van annotaties.
• Record in RKDartists&
Hier komt de permalink uit RKDexplore zodat de records eenvoudig te raadplegen zijn voor de editeurs.
• Annotaties

De mappen kunnen verschillende soorten documenten bevatten, waaronder één Word-bestand met
eigen, samengestelde informatie en scans van fragmenten uit boeken relevant voor de betreffende
persoon.
Structuur dossier
<voornaam>, <achternaam> <geboorte-en sterfdata>
<nationaliteit en kwalificatie, indien bekend>

Genoemde kunstwerken

Vermeldingen in brieven
• <MEP-nummer van de brief onderstreept> <2x tab> <verwijzing annotatie in brief>
• Citaat tussen enkele aanhalingstekens

Aanvullende informatie

Record in RKDartists&
• Permalink

Annotaties
Naamgeving dossier
De bestandsnamen voor documenten in /Personen wordt als volgt opgebouwd:
<Achternaam in hoofdletters>_<voornaam in kleine letters>

Mocht twee keer dezelfde naam voorkomen maar het betreft een ander persoon dan kunnen
geboorte-en sterfdata worden toegevoegd, bijvoorbeeld:
HELION_Jean_(1900-1944)
HELION_Jean_(1904-1987)

De map /Personen is automatisch alfabetisch gerangschikt.
Publicaties
Bevat documenten met informatie over in de brieven en geschriften genoemde boeken, tijdschriften,
brochures en andere al dan niet commerciële publicaties. De mappen kunnen verschillende soorten
documenten bevatten, waaronder één Word-bestand met eigen, samengestelde informatie en scans
van fragmenten uit boeken relevant voor de betreffende tijdschriften, kranten en andere publicaties. De documenten in deze map zijn anders opgebouwd dan de persoons- en organisatiedossiers en hebben een eigen template, waarin de naam, actieve jaren, nationaliteit en kwalificatie van de krant of het tijdschrift staan vermeld. Bij publicaties wordt volstaan met de vermelding van de auteur, titel en plaats en jaar van uitgave. Daarnaast zijn de gebruikelijke categorieën, vermeldingen in brieven, aanvullende informatie, record in RKDartists& en annotaties, opgenomen.
In de map /Commentaar is weliswaar een onderscheid gemaakt in een aantal categorieën
maar die zullen in de praktijk regelmatig overlappen; zo kan een galerie een catalogus uitgeven;
informatie daarover kan in /Organisatie - kunst en in /Publicaties.
Structuur dossier
<naam van tijdschrift of krant> <tussen ronde haken jaren dat tijdschrift of krant actief was>
<Nationaliteit en kwalificatie> of <auteur van de publicatie>, <titel publicatie>, <plaats en jaartal van uitgave>

Vermeldingen in brieven
• <MEP-nummer van de brief onderstreept> <2x tab> <verwijzing annotatie in brief>
• Citaat tussen enkele aanhalingstekens

Aanvullende informatie

Record in RKDartists&
• Permalink

Annotaties
Naamgeving dossier
De bestandsnamen voor documenten in Publicaties betreffen de namen van tijdschriften en kranten. Woorden worden van elkaar gescheiden door middel van een underscore. Deze map is alfabetisch gerangschikt.
Inventarisatie_beheer
Bewaarplaatsen
Nog beschrijven

Alle oude versies van beeldmateriaal van brieven opslaan in repository in de map Inventarisatie_beheer/Bewaarplaatsen zoals ze worden toegestuurd door de beherende instellingen. De kans bestaat dat er kleine foutjes insluipen bij het overhevelen naar de map ‘Info per brief’ in de repository. Het scheelt veel uitzoekwerk als ik dan terug kan grijpen op de originele bestanden.
Herkomstonderzoek
Nog beschrijven
Inventarisatie
Drie mappen in dit Excel-bestand: brieven van Piet Mondriaan, Geschriften van Mondriaan en brieven aan Mondriaan.
Hier komt de toelichting op de inventarisatie van alle brieven en geschriften.
Termen uitschrijven, zoals EDS bij alternatieve datering (= door de editeurs vastgestelde datering van een brief).
Kleurcoderingen uitleggen: geel is voorlopig/onzeker, oranje is vervallen brieven, paars zijn briefverwijzingen van Louis Veen.

Inventarisatie beeldmateriaal

Van de ongedateerde brieven wordt voorlopig de alternatieve datering aangehouden met het oog op de sorteerfunctie van Excel. De cel waarin zo’n alternatieve datering in de dateringskolom is opgenomen, is geel gemaakt om te voorkomen dat het lijkt alsnog deze voorlopige datering is vastgesteld.

[[Category:XML Mondrian]]

Project procedure (Mondrian)

2017-01-25T13:21:11Z

ASC: