Annotation Tips

Use a text editor to gather the data before creating hypothes.is annotations.

Here’s a sample of what I’m talking about

# Abro'ta
abrota-bio-1
    person PSN

Onchestus
onchestus-bio-1
person PSN

Onchestus
    Father
relation PSN

Megaris
http://pleiades.stoa.org/places/570470
place PSN

Nisus
nisus-bio-1
    person PSN

Nisus
    Husband
relation PSN

    grc:διασπασθέντα 
    eng:torn apart

Seeing all of the data you will be adding as annotations in this format will make spotting errors easier.

Think of it as your first draft.

Revisiting your annotations

To navigate back to the page from your annotations, click the little Hypothes.is comment widget to open the Hypothes.is panel (if using Firefox, click your Launch Hypothes.is toolbar link first). Sign-in, click on your login name, and then the ‘My Annotations’ link.

Or you can get to this page directly by using the url https://hypothes.is/stream?q=user:youruserid (replacing ‘youruserid’ with your actual id…).
You should see your saved annotations. Click on the link to Dictionary of Greek and Roman names in one of the and you will be back on the page you started annotating, with your annotations visible.

One resource id per annotation

We may have to link multiple resources to the same name. That means highlighting existing highlights with hypothes.is. It may feel strange, but it is perfectly ok.

For example, a mythological character might have a Smith’s Dictionary entry, and an image of that character in Perseus’s artifact collection. Every linked resource should have its own separate annotation. It keeps the data we’re generating more regular, which will be easier to analyze and visualize later.

Same name in multiple places

Each time a name appears it must be annotated.

After annotating a name the first time use your browser’s text search feature ( open it with control+F or command+F ) to find other occurrences.

Annotate all other occurrences the same as the first.

Be careful with your first annotation. Don’t accidentally multiply an error!

Stable IDs

Most of your annotations will include an id to some resource. A resource will most likely be a source text, an image, a gazetteer entry, etc.

Resources on a web-page are not the web-page itself. That means the id of the resource is not always the URL where you found it. The same resource can be shown on different web-pages which all have different URLs.

You want to be sure to use the resource’s stable id instead of the URL. A stable id is the resource’s permanent, unique id, which is independent of any web-page where it may be displayed.

What this stable id looks like is up to the creator of the service that hosts the resource.
They all look a little different and are retrieved in different ways.

Here is a reference for locating the stable ids of different resources.