Difference between revisions of "Dromio: Folger Transcription Platform"

Line 155: Line 155:
 
:Expanded, i.e. supplied, text. Note: in this example, the superscript "o" is also silently lowered with the '''\^/''' tag button. The "expansion" tag makes the tagged selection appear italicized.  
 
:Expanded, i.e. supplied, text. Note: in this example, the superscript "o" is also silently lowered with the '''\^/''' tag button. The "expansion" tag makes the tagged selection appear italicized.  
 
<br/>
 
<br/>
 
 
===Deletion and Insertion===
 
===Deletion and Insertion===
 
[[File:Deletionandinsertionex.jpg|left]]
 
[[File:Deletionandinsertionex.jpg|left]]
Line 164: Line 163:
 
:Intralineal inscription and deletion; add caret only if present in ms. "Delete" tag draws a line through the tagged selection, and the "insert" tag superscripts the tagged selection.
 
:Intralineal inscription and deletion; add caret only if present in ms. "Delete" tag draws a line through the tagged selection, and the "insert" tag superscripts the tagged selection.
 
<br/>
 
<br/>
 
 
===Gap===
 
===Gap===
 
[[File:Gapexample.jpg|left]]
 
[[File:Gapexample.jpg|left]]
Line 173: Line 171:
 
:For a gap in transcription, estimated number of illegible letters replaced by periods. Highlights selection in red.  
 
:For a gap in transcription, estimated number of illegible letters replaced by periods. Highlights selection in red.  
 
<br/>
 
<br/>
 
 
===Unclear===
 
===Unclear===
 
[[File:Unclearex.jpg|left]]
 
[[File:Unclearex.jpg|left]]
Line 182: Line 179:
 
:For uncertain text (transcriber enters best guess within tag). Highlights tagged selection in yellow. Note: in this example, "with" has the "i" expanded using the '''''ex''''' tag button, and the "th" silently lowered using the '''\^/''' tag button.
 
:For uncertain text (transcriber enters best guess within tag). Highlights tagged selection in yellow. Note: in this example, "with" has the "i" expanded using the '''''ex''''' tag button, and the "th" silently lowered using the '''\^/''' tag button.
 
<br/>
 
<br/>
 
 
===Mark===
 
===Mark===
 
[[File:Maniculeex.jpg|left]]
 
[[File:Maniculeex.jpg|left]]
Line 191: Line 187:
 
:For notational mark (e.g. manicule, etc.), include one-word description of mark, i.e. in place of the symbol, write and tag the word "manuicule." Also used for brevigraph markers such as a period (.) or colon (:) when they disappear as part of the word’s expansion. This button highlights tagged selection in gray. Note that in this example the word "Aristotles" is tagged as a label using the '''lbl''' tag button.   
 
:For notational mark (e.g. manicule, etc.), include one-word description of mark, i.e. in place of the symbol, write and tag the word "manuicule." Also used for brevigraph markers such as a period (.) or colon (:) when they disappear as part of the word’s expansion. This button highlights tagged selection in gray. Note that in this example the word "Aristotles" is tagged as a label using the '''lbl''' tag button.   
 
<br/>
 
<br/>
 
 
===Drawing===
 
===Drawing===
 
[[File:Drawingex.jpg|left]]
 
[[File:Drawingex.jpg|left]]
Line 210: Line 205:
 
:For image/illustration (e.g. drawing), include short description of image and tag the description. Highlights tagged text in light/bright blue. Note that in this example, you can see the "line break" tag (<lb/>) that is automatically inserted at the beginning of each line every time you hit the "return" key for a new line. Note also that the transcriber has tagged the text appearing next to the image using the label tag button, '''lbl'''.   
 
:For image/illustration (e.g. drawing), include short description of image and tag the description. Highlights tagged text in light/bright blue. Note that in this example, you can see the "line break" tag (<lb/>) that is automatically inserted at the beginning of each line every time you hit the "return" key for a new line. Note also that the transcriber has tagged the text appearing next to the image using the label tag button, '''lbl'''.   
 
<br/>
 
<br/>
 
 
===Catchword===
 
===Catchword===
 
[[File:Catchwordex.jpg|left]]
 
[[File:Catchwordex.jpg|left]]
Line 223: Line 217:
 
:Used for a word appearing at bottom that also appears on the top of the next page. Turns tagged text gold.  
 
:Used for a word appearing at bottom that also appears on the top of the next page. Turns tagged text gold.  
 
<br/>
 
<br/>
 
 
===Page break===
 
===Page break===
 
[[File:Pagebreakex.jpg|left]]
 
[[File:Pagebreakex.jpg|left]]
Line 241: Line 234:
 
:Note that in this example you also see the "line break" tag automatically inserted whenever you hit the return key for a new line. You also see the first "An Epitaph" tagged with the '''cw''' tag button, and the second "An Epitaphe" tagged with the '''hd''' tag button. Finally, you also see an example of the word "your," with "ou" expanded using the '''ex''' tag button and the "r" silently lowered using the '''\^/''' tag button.   
 
:Note that in this example you also see the "line break" tag automatically inserted whenever you hit the return key for a new line. You also see the first "An Epitaph" tagged with the '''cw''' tag button, and the second "An Epitaphe" tagged with the '''hd''' tag button. Finally, you also see an example of the word "your," with "ou" expanded using the '''ex''' tag button and the "r" silently lowered using the '''\^/''' tag button.   
 
<br/>
 
<br/>
 
 
===Heading===
 
===Heading===
 
[[File:Headingex.png|left]]
 
[[File:Headingex.png|left]]
Line 250: Line 242:
 
:“Heading” tag used for page or section heading. Underlines the tagged text.
 
:“Heading” tag used for page or section heading. Underlines the tagged text.
 
<br/>
 
<br/>
 +
===Label===
 +
[[File:Labelex.png|left]]
 +
<div style="clear:both;"></div>
 +
Would be transcribed as:<br/>
 +
A viewe of <span style="color:green">th</span><span style="color:brown">e</span> pre=<br/>
 +
sent estate of <span style="color:white; background-color:blue">Ireland</span> discour=<br/>
 +
sed by way of a<br/>
 +
dialogue between<br/>
 +
<span style="color:white; background-color:blue">Eudoxus</span> and<br/>
 +
<span style="color:white; background-color:blue">Irenis</span>.)<br/>
 +
 +
<brev-y>th</brev-y><sl>e</sl>​

Revision as of 15:03, 28 April 2020

Dromio, named for the comedic twins in "Comedy of Errors," is a transcription interface designed by the Folger Shakespeare Library to allow the transcription and comparison of transcriptions of early modern manuscripts. It was first developed through the Early Modern Manuscripts Online (EMMO) project. This page includes information on how to transcribe and encode using Dromio.

Getting Started

1. Launch your Internet browser (preferably Mozilla Firefox or Google Chrome). Make sure your browser is up-to-date. Turn off auto-correct and spell-check in your browser settings.

2. Type the following URL in the browser window (or click on this link): http://transcribe.folger.edu/. Type your first and last name in the dialog box where it says “Enter your full name” and press the Submit button.

The welcome page at http://transcribe.folger.edu/.


3. Select a transcription project or workshop/event from the list (Note: this list often changes).

Select a transcription project.


4. Dromio will display a list of subfolders or documents available for transcription (this list is subject to change and is not exhaustive; let us know if you would like a Folger manuscript added or placed in a separate folder for teaching):

Select a subfolder or document.



5. After selecting a subfolder, Dromio will display a list of documents or openings available for transcription within the subfolder. In the left column, you will see the Folger call number and title. In the middle column are page numbers for each digital image of a manuscript page or opening. The right column records the transcription status of each page, indicating how many individual transcriptions have been started and saved, and how many have been completed (marked Done by individual transcribers).

A list of individual documents or openings available for transcription.


6. Click on the page or folio number that you wish to transcribe. The digital image of the page or page(s) will appear.

  1. The Zoom (+ and -), Rotate (⤾ and ⤿), Home (returns to original size) and Full Screen (image only view) tools are in the upper left corner. Each click of the Rotate arrows rotates the image 90 degrees.
  2. The transcription window can be moved around by dragging the dark green top of the window with your cursor.
  3. You can enlarge the transcription window by clicking and dragging the bottom or sides of the window with the cursor.
  4. To start transcribing, type directly into the transcription window. Remember to click Save frequently to save your work. It will turn from red to black when you save.


This is what a transcription window with XML tagging buttons looks like.


How to Use XML Tags

This section discusses how to use the XML tags in Dromio to encode your transcription.

XML (extensible markup language) is a tagging language used to describe text in a digital environment. The XML tags allow transcribers to record information on how text appears upon the manuscript page (i.e. the head tag <head> indicates a heading or title). Tags may also convey information about words in the text (i.e. the <name> tag denotes a proper name). The XML tag set for EMMO is based upon the TEI (Text Encoding Initiative) tag set which is used to encode printed and handwritten texts for a digital environment. With the exception of the line break tag (lb/), all XML tags come in pairs, with an opening and close tag surrounding text (i.e <place>London</place>.)

Dromio makes encoding easier through a menu of buttons for commonly-used tags at the top of the transcription window. These buttons are “shortcuts” which insert XML tags around words without your having to type these tags manually. The tag names on these buttons have been abbreviated to save space (for instance, the <name> tag appears as “nm”).

  1. Select the letter(s) or word with your cursor that you wish to encode.
  2. Click on an encoding button from the menu to apply the XML tag to the selected text.
  3. The style of the text changes as you encode it.
  4. If you want to remove the tag, re-select the encoded text and re-click the tag.
  5. You can switch between HTML and XML views by toggling the <xml>/<html> button.
  6. If you are “stuck” in a tag, sometimes it is useful to go to the XML view and move the close tag manually to where it belongs.
  7. Common early modern brevigraphs (abbreviated text) have their own buttons (ye=the, yt=that, yr=your, ym=them, wth=with, and wch=which). Simply click on the button to insert the abbreviated word into the transcription. You do not need to type the word first.
  8. You can apply more than one XML tag to a section of text. This is called “nesting.”
  9. Click the Save button frequently to save your work. Select Done when you have completed transcribing and encoding the page. Don’t worry if you accidently hit Done or want to make a correction after you hit Done. You can still make changes and resave.


Glossary of XML buttons

Arranged by function, with examples in parentheses.

Remember, when selecting most tag buttons in Dromio:

  • first transcribe the expanded form of the word
  • select the letter(s) to be tagged with your cursor
  • then click on the tag button to apply it


Text of the Manuscript as viewed

  • ex = for expanded (i.e., supplied) text:
command
  • spl = supplied text to correct scribe’s mistake; use sparingly:
“hitt" for erroneous writing of “itt” as “htt” or “muche” when transcriber supplies missing letters from contextual clues
  • del = for cancelled (i.e., crossed out) text:
this is an example of a deleted word.
  • ins = for intralineal insertion text
this is an example of intralineal text
  • gap = for a gap in transcription, illegible letters replaced by periods
this is an example of a (...) gap.
  • unc = for uncertain text (transcriber enters best guess)
this is an example of a word with an unclear letter.
  • mrk = for notational mark (e.g. manicule, etc.), include one-word description of mark.
this is an example of a manicule in a sentence.
Also used for periods/colons used in abbreviations.
  • img = for image/illustration (e.g. drawing), include one-word description of image
This is an example of a drawing.


Navigation/Tracking

  • ? = help screen
  • <xml> = shows text with xml tags
  • Save = saves changes
  • Done = indicates transcription/encoding completed


Layout/Non-textual Elements

  • pb = for two or more pages in one image (page break) ( ) tag only [doesn’t show except in XML view] to indicate beginning of second opening, or (35) surrounding contemporary foliation or pagination or (4r) for foliation or pagination added by librarian or other steward.
  • cw = catchword (word repeated on bottom of page/top of next page)
When
  • hd = for obvious headings
Cooking with Clarified Butter
  • lbl = for labels or in the margins or other forms of marginalia
For a toothe-ache
  • qt = quote (for discernible hand-shift indicating quotation)
  • ps = for postscript text in letters
Do not forgetteth to write
  • opn = for text of opening in letters
To my most lovinge husband
  • cls = for text of closing in letters
Your most dejected servant,
  • add = for added text by booksellers, librarians, collectors, etc. (only for additions made clearly later)
V.a.110
  • note = for note at the end of the text file
Try not to use this field unless you are leaving note for vetter—we don’t currently have a way to make this information visible in a useful way.


Content

  • nm = for proper names (non-fictional)
William Shakespeare
  • pl = for identified places
Stratford-on-Avon
  • amt = for specific monetary amounts (include numeral and currency symbol)
iiis vd


Semi-Diplomatic Transcription

You will be making a “semi-diplomatic” transcription, meaning you will maintain original spellings (even if they are incorrect by modern standards) and will record any deletions or additions.

  • ^ = for superscript text not to be lowered.
Use this for superscript currencies and ordinal numbers [iiiith] but nothing else
  • \^/ = for superscript text to be lowered
Saint; October
  • ~ = macron (¯) or tilde (~), for tilded letters such as “n” or “conm̄”
running for ruñing
  • y/th = for thorn letter (looks like “y”), transcribed as “th”
ye = the
  • <es> = for “es” graph
chyldes
  • <er> = for “er” graph (transcribed as “er,” or ar/or/re)
peter
  • = for special “p” graph (following two letters should be expanded text, “pre,” “pro,” “par,” or “per”)

partie
  • ye=transcribed as “the”
the
  • yt=transcribed as “that”
that
  • ym=transcribed as “them”
them
  • yr=transcribed as “your”
your
  • wth=transcribed as “with”
with
  • wch=transcribed as “which”
which


Examples

Frequently seen actions in secretary hand, and how they are transcribed. Note that the name of the tag button in the dromio transcription window is not always the same text of the tag in XML (for example, the tag button for tagging a drawing is "img," but the actual XML tag used appears as "<graphic></graphic>.

Expansion

Portsmouthex.jpg

Transcription: Portsmouth
In XML: Portsm<sl>o</sl><ex>uth</ex>
Tag button used: ex

Expanded, i.e. supplied, text. Note: in this example, the superscript "o" is also silently lowered with the \^/ tag button. The "expansion" tag makes the tagged selection appear italicized.


Deletion and Insertion

Deletionandinsertionex.jpg

Transcription: not^hard
In XML: <del>not</del>^<ins>hard</ins>
Tag buttons used: del (delete) and ins (insert)

Intralineal inscription and deletion; add caret only if present in ms. "Delete" tag draws a line through the tagged selection, and the "insert" tag superscripts the tagged selection.


Gap

Gapexample.jpg

Transcription: Invidi repair to hole in paper lebrane queam
In XML: Invidi <gap>repair to hole in paper</gap> lebrane queam
Tag button used: gap

For a gap in transcription, estimated number of illegible letters replaced by periods. Highlights selection in red.


Unclear

Unclearex.jpg

Transcription: or draw what you please, then with
In XML: or draw what you please, th<unclear>en</unclear>w<ex>i</ex><sl>th</sl>
Tag button used: unc

For uncertain text (transcriber enters best guess within tag). Highlights tagged selection in yellow. Note: in this example, "with" has the "i" expanded using the ex tag button, and the "th" silently lowered using the \^/ tag button.


Mark

Maniculeex.jpg

Would be transcribed as: Aristoteles manicule
In XML: <label>Aristotles</label><metamark>manicule</metamark>
Tag button used: mrk

For notational mark (e.g. manicule, etc.), include one-word description of mark, i.e. in place of the symbol, write and tag the word "manuicule." Also used for brevigraph markers such as a period (.) or colon (:) when they disappear as part of the word’s expansion. This button highlights tagged selection in gray. Note that in this example the word "Aristotles" is tagged as a label using the lbl tag button.


Drawing

Drawingex.jpg

Would be transcribed as:
nascono molte herbe onde paieno
giardini.
Drawing showing a house in Cyprus
Forma delle case di Cipro
Modo di tibiar
In XML:
<lb/>nascono molte herbe onde paieno
<lb/>giardini.
<lb/><graphic>Drawing showing a house in Cyprus</graphic>
<lb/><label>Forma delle case di Cipro</label>
<lb/><label>Modo di tibiar</label>
Tag button used: img

For image/illustration (e.g. drawing), include short description of image and tag the description. Highlights tagged text in light/bright blue. Note that in this example, you can see the "line break" tag (<lb/>) that is automatically inserted at the beginning of each line every time you hit the "return" key for a new line. Note also that the transcriber has tagged the text appearing next to the image using the label tag button, lbl.


Catchword

Catchwordex.jpg

Would be transcribed as:
The spiritte which your sack hath lent./
An Epitaph
In XML:
<lb/>The spiritte which your sack hath lent./
<lb/><catchword>An Epitaph</catchword>
Tag button used: cw

Used for a word appearing at bottom that also appears on the top of the next page. Turns tagged text gold.


Page break

Pagebreakex.jpg

Would be transcribed as:
The spiritte which your sack hath lent./
An Epitaph
61
An Epitaphe
In XML:
<lb/>The spiritte which y<ex>ou</ex><sl>r</sl> sack hath lent./
<lb/><catchword>An Epitaph</catchword>
<lb/><pb>61 </pb>
<lb/><heading>An Epitaphe </heading>
Tag button used: pb

For two or more pages in one image. Note that the tag encloses the number of the new page. Highlights text in dark gray.
Note that in this example you also see the "line break" tag automatically inserted whenever you hit the return key for a new line. You also see the first "An Epitaph" tagged with the cw tag button, and the second "An Epitaphe" tagged with the hd tag button. Finally, you also see an example of the word "your," with "ou" expanded using the ex tag button and the "r" silently lowered using the \^/ tag button.


Heading

Headingex.png

Would be transcribed as: Panegyricks
In XML: <heading>Panegyricks</heading>
Tag button used: hd

“Heading” tag used for page or section heading. Underlines the tagged text.


Label

Labelex.png

Would be transcribed as:
A viewe of the pre=
sent estate of Ireland discour=
sed by way of a
dialogue between
Eudoxus and
Irenis.)

<brev-y>th</brev-y><sl>e</sl>​