Vortex Workshop Instructions

Quick Links

Thematic Text Annotations
Text Alignments
Image Annotations
Submit

Overview

The goal of this workflow is to use the tools available on Perseids to produce:

  1. Thematic tag annotations on primary source texts
  2. Alignments of the primary source text with a translation
  3. Thematic tag annotations on images

The output will be a reusable dataset of annotations which target the texts and images using stable canonical identifiers, and which can be aggregated and displayed in a variety of ways. We will produce prototype visualizations for the annotations produced by workshop participants along the model of this one based on Marie-Claire Beaulieu’s annotations of the Iliad 21.1-21.383.

Available Texts

We have made at least one of the texts identified by each workshop participant available for working with in Perseids during the workshop. The rest will be made available as soon as possible in the weeks following the workshop so that a complete data set can be produced. The following of the requested are available for annotating at the workshop:

  • Aristophanes, Clouds
  • Euripides, Heracles
  • Hesiod, Theogeny
  • Homer, Iliad
  • Homer, Odyssey
  • Plato, Republic
  • Plato, Ion

(Full list of texts available)

Annotation Instructions

Create an account in Perseids

If you haven’t done so already, create an account in Perseids. You can use a Gmail or Yahoo or AOL account to login to Perseids. If you don’t have one of these, please create a Gmail account for this purpose.

To create a new Perseids account, go to http://sosol.perseids.org/sosol, click Sign In, and then click on your identity provider (Google, Yahoo or AOL). Follow the prompts to login to your identity provider and allow Perseids access. Perseids won’t have access to your password – the identity provider will just provide Perseids with an opaque identifier for you as a user, and your email address. Choose a nickname to be known as on the Perseids platform (this will be visible to all users) and whether or not to share your email address with Perseids (this will only be available to Perseids admins) on the screens provided.

Create Thematic Annotations

Create a new annotation
  1. Login to Perseids (as per the above instructions)
  2. Click on the “New Thematic Annotations” link on the top right of the home page
  3. On the next screen, in the input box labelled “Search for a text”, start typing the first few characters of the text you want to annotate (from the above list). The edition name should popup below the input box. Select it by clicking on the name.
  4. New input options to enter the passage range you want to annotate will appear below the search box. Enter a start and end passage.
  5. Click Retrieve Passage
  6. When the text has finished loading in the Input Text box, make sure the language selected on the top right of the screen is correct, and then click “Edit”
  7. After a brief pause, the text should load in the Arethusa editor
Edit in Arethusa
  1. Select the word you want to annotate with your mouse
  2. On the relation tab on the right, choose a term from the dropdown menu.
  3. Click Save (icon in the Navigation Bar on the top of the screen)
  4. Repeat this process until you are done annotating.
  5. You can navigate to the next sentence using the navigation options in the bar at the top.
  6. When you are done annotating, click Save and then Exit (Exit is the last icon on the right on the navigation bar, assuming your browser window is large enough).
  7. You will be returned to the Perseids interface. You can reenter Arethusa to continue annotating this text by clicking on a sentence in the Edit view.
  8. You can find your annotation on the Perseids home page under the title “Vortex Thematic Annotations”

Create Translation Alignment

  1. Login to Perseids (as per the above instructions)
  2. Click on the “New Text Alignment” link on the top right of the home page
  3. Select source text:
    1. Under Language 1, in the input box labelled “Search for a text”, start typing the first few characters of the source text you want to align. The edition name should popup below the input box. Select it by clicking on the name.
    2. New input options to enter the passage range you want to annotate will appear below the search box. Enter a start and end passage.
    3. Click Retrieve Passage
    4. When the text has finished loading in the Input Text box, make sure the language selected below it is correct
  4. Select translation text (option 1: existing translation)
    1. Under Language 2, in the input box labelled “Search for a text”, start typing the first few characters of the source text you want to align. The available translations should popup below the input box. Select one by clicking on the name.
    2. New input options to enter the passage range you want to annotate will appear below the search box. Enter a start and end passage.
    3. Click Retrieve Passage
    4. When the text has finished loading in the Input Text box, make sure the language selected below it is correct
  5. Select translation text (option 2: your own translation)
    1. Under Language 2, type your translation in the text box.
    2. Select the correct language for this text
  6. After both source and translation text are present and as you wish them to be in the text boxes, with their languages selected, click Align.
  7. After a brief pause, the text should load in the Alpheios editor
Edit in Alpheios
  1. Click on a word in the source text
  2. Click on the aligned word in the translation text
  3. Click again on the word in the source text
  4. Repeat this process for as many words as you want to align
  5. To align two words to one in a translation, click on both words in the source text before clicking on the translation, and vice-versa. To undo an alignment, repeat the same 3-click process in reverse.
  6. Click Save Sentence
  7. Click Sentence List to return to Perseids

Create Image Annotations

Prerequisite: You must have identified an image to be associated with your text and supplied Bridget with this information in order to annotate images.

  1. Login to Perseids
  2. From the selector dropdown at the top of the screen, select “vortex”
  3. Click CREATE EDITION
  4. Click XML
  5. The edit display should appear with thumbnails of your images
  6. Click an image
  7. Follow the instructions provided on screen to select a region of interest and supply the theme tag as the text of the annotation
  8. Copy the <w facs=”…”>tag</w> text from the tool into the XML of your transcription
  9. Repeat for as many regions of interest you want to tag.
  10. When you are done annotating, click Save

Submit to the Vortex Board

In order for us to produce a visualization of your work, we need you to submit it to the Vortex board.

  1. When you are done annotating, navigate to the Perseids home screen.
  2. Repeat for each publication type (thematic annotation, translation alignment, image transcription):
    1. Click on the Publication name (far left column)
    2. In the gray box, type a small note about your work
    3. Select Vortex Workshop from the drop-down menu
    4. Click OK at the prompt
    5. Click Submit to Boards