Transcription - Revision history

WRA: Add clarification.

2018-01-23T09:31:04Z

Add clarification.

PBO: /* Visual characteristics */

2017-06-01T14:31:14Z

‎Visual characteristics

PBO: /* Visual characteristics */

2017-06-01T14:30:51Z

‎Visual characteristics

PBO at 14:18, 26 April 2017

2017-04-26T14:18:27Z

PBO at 13:57, 26 April 2017

2017-04-26T13:57:25Z

PBO at 13:56, 26 April 2017

2017-04-26T13:56:49Z

PBO at 13:40, 26 April 2017

2017-04-26T13:40:27Z

PBO at 13:25, 26 April 2017

2017-04-26T13:25:00Z

ASC at 11:25, 15 February 2017

2017-02-15T11:25:17Z

ASC at 11:24, 15 February 2017

2017-02-15T11:24:40Z

@@ Line 123: / Line 123: @@
 ===Incorrect text===
-An incorrect text can be encoded in <sic>. The corresponding correction is incoded into <corr>. Both elements goes into <choice>, as in the example:
+An incorrect text can be encoded in <sic>. The corresponding correction is incoded into <corr>. Both elements go into <choice>, as in the example:
 <pre><choice><sic type="grammar">Happely</sic><corr>Happily</corr></choice></pre>
 ===Supplied text===

@@ Line 70: / Line 70: @@
 <pre><hi rend="underline">This text is underlined</hi></pre>
 <pre><hi rend="underline bold">This text is underlined and bold</hi></pre>
-* ''<hi:sepLine>'' Use for lines (not verselines or manuscript lines but graphical lines) that authors use to separate writing sections. Individual projects may want to further specify the nature of the line using the rend attribute.
+* '''<hi:sepLine>''' Use for lines (not verselines or manuscript lines but graphical lines) that authors use to separate writing sections. Individual projects may want to further specify the nature of the line using the rend attribute.
 ==Reproduction of the source==

@@ Line 70: / Line 70: @@
 <pre><hi rend="underline">This text is underlined</hi></pre>
 <pre><hi rend="underline bold">This text is underlined and bold</hi></pre>
+* ''<hi:sepLine>'' Use for lines (not verselines or manuscript lines but graphical lines) that authors use to separate writing sections. Individual projects may want to further specify the nature of the line using the rend attribute.
 ==Reproduction of the source==

@@ Line 37: / Line 37: @@
-==retorical structure==
+==Retorical structure==
 ==Visual characteristics==
@@ Line 89: / Line 116: @@
 ===Special characters===
-The mdash corresponds to unicode code point x2014. In [[Manual oXygen|Oxygen]], it can be entered through the Symbol button (if needed, add the Symbol toolbar), or use the Edit menu, option Insert from Character Map. &x2014;.
+* &mdash; (mdash): corresponds to unicode code point x2014.
 ==Editorial interventions==

@@ Line 59: / Line 59: @@
 <pre><damage extent="whole leaf" agent="rubbing"> ... </damage></pre>
-==Hyphenation and other dashes==
+===Hyphenation and other dashes===
 <c type="wbh">-</c> is used to encode an end-of-line hyphen. We encode it only where it has been used, not where is should have been used!
 Other kinds of hyphen receive no special encoding.
@@ Line 88: / Line 88: @@
 <pre>well-<lb/>known brands</pre>
-==Special characters==
+===Special characters===
-The mdash corresponds to unicode code point x2014. In [[Manual oXygen|Oxygen]], it can be entered through the Symbol button (if needed, add the Symbol toolbar), or use the Edit menu, option Insert from Character Map. x2014.
+The mdash corresponds to unicode code point x2014. In [[Manual oXygen|Oxygen]], it can be entered through the Symbol button (if needed, add the Symbol toolbar), or use the Edit menu, option Insert from Character Map. &x2014;.

@@ Line 18: / Line 18: @@
-==Writing process and damage==
+==Writing process==
 We use the following elements:
 * '''<add>'''           Addition;
@@ Line 29: / Line 29: @@
 </pre>
 * '''<retrace>'''	A letter or word retraced to clarify the intended word or letter
 ===Transpositions===
@@ Line 50: / Line 48: @@
 * '''<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;
+* '''<unclear>'''	Uncertain reading of the text, for example due to damage or bad handwriting. If there is a number of possible readings,
 <pre>A single <unclear>word</unclear> is hard to read.</pre>
-* <metamark>	Indicates a sign added to aid in reading the text, for instance to indicate where a text is continuing.
+<pre>A single wor<choice><unclear>d</unclear><unclear>k</unclear></choice> is hard to read.</pre>
 ==Editorial interventions==

@@ Line 1: / Line 1: @@
-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.
+The transcriptions that we make usually have a double purpose:
-==Structure of the text==
+==Physical structure==
-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:
+The logical structure was discussed under [[Text structure]]. The physical structure is usually encoded using so-called
-<pre>
+milestone (empty) elements: they do not contain their content, but are placed where certain
-<text>
+properties of the text change. The elements that we commonly employ are
- <body>
+* linebreak: <lb>
-  <p>...</p>
+* page break: <pb>
- </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):
-* '''&lt;p>''' Paragraph;
-* '''<ab>''' Anonymous block (an arbitrary unit of text, but without the semantic baggage of a paragraph);
-* '''&lt;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==
+Linebreaks and page breaks are placed at the beginning of the line or page.
-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>
 * '''&lt;del>'''	Deletion;
 <pre>It is <del type=strikethrough>not</del> a complete text.</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.
+Different source types have teheir own special characteristics, and the XML elements that encode these qualities of the text will vary to a certain extent per project.
 ==See also==

@@ Line 1: / Line 1: @@
-De transcriptie met daarin de eigenlijke tekst van de editie wordt gecodeerd in een <text>-element in het XML/TEI-bestand. Daarbij wordt rekening gehouden met de structuur van de tekst, de drager van de tekst, benodigde annotaties en alle andere bijzonderheden.
+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.
-Wat het transcriberen van de manuscripten betreft, is het doel om zo dicht mogelijk bij de oorspronkelijke tekst te blijven. We richten ons op de productie van diplomatische uitgaven. Onder diplomatische uitgave wordt hier een editie verstaan waaraan slechts één bron ten grondslag ligt en waarin de tekst en alle verdere grafische informatie weergegeven worden in overeenstemming met die bron. Daarbij wordt niet gestreefd naar een typografische imitatie van de bron, maar naar een functionele weergave van de tekst. De transcripties willen, zoals gezegd, tekstueel een exacte weergave bieden van het geschrevene. ‘Trouw aan de tekst’ staat voorop, wat impliceert dat afwijkingen van de gangbare spelling en grammatica worden overgenomen, wijzigingen die tijdens het schrijven werden aangebracht — direct of later — worden gedocumenteerd, en ook de fysieke structuur van de bron waar relevant wordt weergeven.
+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.
-==Structuur van de tekst==
+==Structure of the text==
-Een tekst is doorgaans geen 'vlak' geheel, maar bestaat gewoonlijk uit verschillende lagen met een eigen hiërarchie. Die worden ook weergegeven in het XML-bestand. De tekst wordt gecodeerd in het <text>-element, dat verplicht een <body>-element bevat. De structuur van een eenvoudige tekst zou er als volgt uitzien:
+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>
@@ Line 12: / Line 12: @@
 </text>
 </pre>
-Andere lagen van de tekst kunnen worden gecodeerd met behulp van de volgende elementen (eventueel aangevuld met attribuut @type om ze nader te specificeren):
+Other layers of the text can be encoded with the following elements (if so desired supplemented with an @type attribute to further specify them):
-* '''&lt;p>''' Paragraaf;
+* '''&lt;p>''' Paragraph;
-* '''<ab>''' Anonymous block (een willekeurige eenheid tekst, maar zonder de semantische baggage van een paragraaf);
+* '''<ab>''' Anonymous block (an arbitrary unit of text, but without the semantic baggage of a paragraph);
-* '''&lt;div>''' Secties (bijv. hoofdstukken, rubrieken of andere soorten secties);
+* '''&lt;div>''' Section (i.e. chapter, rubric or another kind of section);
-* '''<head>''' Hoofdstuktitels, opschriften etc.;
+* '''<head>''' Titles of chapters, headings etc.;
-* '''<group>''' Om verschillende teksten in de transcriptie aan te duiden.
+* '''<group>''' To indicate different textst within the transcription.
-==Weergave van de bron==
+==Reproduction of the source==
-Om alle karakteristieken van de tekst en zijn drager in de digitale editie weer te kunnen geven, gebruiken we een aantal standaard XML-elementen:
+To reproduce all characteristics of a text and its medium in the digital edition we use a number of standard XML elements.
 * '''<add>'''           Addition;
@@ Line 41: / Line 41: @@
 * '''@place'''	        Indicates the location of (e.g.) an addition (above, below, margin, etc) or the closer;
 * '''@type'''           Used to classify or sort elements.
-Verschillende bronnen kennen verschillende soorten bijzonderheden, en de XML-elementen die dit soort eigenschappen van de tekst vastleggen, zullen per project dan ook in meer of mindere mate variëren.
 ==See also==