Skip to content

Commit

Permalink
more annotations
Browse files Browse the repository at this point in the history
  • Loading branch information
@dnoneill
dnoneill committed May 23, 2024
1 parent 1f8f9d6 commit 823ea75
Show file tree
Hide file tree
Showing 5 changed files with 24 additions and 97 deletions.
18 changes: 9 additions & 9 deletions dhsi/SUMMARY.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -61,17 +61,17 @@
1. [Introduction to Annotations](day-three/annotations.md)
2. [Creating Annotations in Annotorious](day-three/annotorious.md)
2. [Creating Annotations in Mirador](day-three/creating-annotations.md)
3. [Annotation Stores](day-three/annotation-stores.md)
3. [Annotation Stores](day-three/annotations-stores.md)
4. [Annotation Server Install](day-three/annotations-stores-install.md)

## Wednesday, Session 2: 10:30am-12:00pm
1. [Annotation Stores Install](day-three/annotation-stores-install.md)
2. [Simple annotation server](day-three/annotations-sas.md)
3. [Annonatate](day-three/annonatate.md)
4. [Exhibit / Storiiies/ Adno](day-three/annonatate.md)
5. [All maps]()
6. [Crowdsourcing Transcriptions From the Page / Zooniverse / Madoc]()
7. [IIIF Annotation Studio]()
8. [Recogito]()
2. [Simple annotation server](day-three/annotations-sas.md)
3. [Annonatate](day-three/annonatate.md)
4. [Exhibit / Storiiies/ Adno](day-three/annonatate.md)
5. [All maps]()
6. [Crowdsourcing Transcriptions From the Page / Zooniverse / Madoc]()
7. [IIIF Annotation Studio]()
8. [Recogito]()
3. [Adding annotations to a manifest](day-three/annotation-in-manifest.md)


Expand Down
16 changes: 8 additions & 8 deletions dhsi/day-three/annotations-sas.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ There are two options for getting a Manifest to Annotate.

This option uses the Manifest you uploaded to the workbench in the [Publishing your Manifest](../day-three/workbench/) guide. To use this manifest you need to copy the manifest URL by going to Workbench, Manifests tab and right clicking on the IIIF logo and select `Copy link`. This will copy the Manifest URL to your clipboard.

![image](images/workbench_iiif_link.png)
![image](imgs/workbench_iiif_link.png)

### Option 2 Use any public IIIF manifest

Expand All @@ -28,24 +28,24 @@ https://damsssl.llgc.org.uk/iiif/2.0/4389767/manifest.json
* Navigate to https://dev.gdmrdigital.com/ and click the Log in / Sign Up link.
* This will take you to the following screen where you can choose to either login using your Google or Github accounts

![image](images/sas/login.png)
![image](imgs/sas/login.png)

Unlike the workbench SAS doesn't write to your Google drive or GitHub account. The GitHub/Google methods are purely used to provide authentication to SAS with all of the data being stored on the SAS server.

### Load your manifest into SAS:
Once you have logged in you will be presented with the following collection screen:

![image](images/sas/empty_collection.png)
![image](imgs/sas/empty_collection.png)

* Now click the Add IIIF manifest (URL) link and enter the URL to your manifest as below.
* If you are using the Workbench use the URL copied from the IIIF logo.

![image](images/sas/add_manifest.png)
![image](imgs/sas/add_manifest.png)

* Then click Add. Depending on how many pages the manifest takes this might take a minute or two to index.
* Once your manifest is loaded you should see it appear in your default Collection:

![image](images/sas/manifest.png)
![image](imgs/sas/manifest.png)

## Step 2: Create your annotations

Expand All @@ -54,17 +54,17 @@ Once you have logged in you will be presented with the following collection scre
* This should open up your manifest in Mirador
* Navigate to a page you want to annotate then click the speech bubbles at the top right to start annotating.

![image](images/sas/annotate.png)
![image](imgs/sas/annotate.png)

## Step 3: Share your annotations

Once you have finished annotating return to the collections screen by clicking the `Home` link. We are now going to generate a copy of your Manifest with links to your annotations. The SimpleAnnotationServer provides this functionality by clicking on the Share button.

![image](images/sas/share-annos.png)
![image](imgs/sas/share-annos.png)

Once you click on the Share link the SimpleAnnotationServer will retrieve a copy of your manifest from the Workbench, add links to the annotation lists per canvas and add a link to the Search service. It will then story a copy of this new manifest in SAS for you to use. Once it has generated this new manifest you should see the screen below:

![image](images/sas/share-annos-page.png)
![image](imgs/sas/share-annos-page.png)

Click on the UV link or Mirador link to see your annotations in these viewers which aren't connected to an annotation server. The annotations that these viewers are reading come from the manifest.

Expand Down
4 changes: 2 additions & 2 deletions dhsi/day-three/annotations-stores-install.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ You should see version `1.11.x`.

[https://github.com/glenrobson/SimpleAnnotationServer/releases](https://github.com/glenrobson/SimpleAnnotationServer/releases)

![image](images/annos_sas_download.png)
![image](imgs/annos_sas_download.png)

## Step 2:
* Extract the zip file into a `iiif-workshop` directory.
Expand Down Expand Up @@ -67,7 +67,7 @@ dependency simpleAnnotationStore.war
* In the list of manifests paste the link to your manifest http://127.0.0.1:5500/manifest.json into the addNewObject text field and click `load`.
* You should now see:

![image](images/annos_mirador_addItem.png)
![image](imgs/annos_mirador_addItem.png)

## Step 7:
* Click on your manifest in the list
Expand Down
82 changes: 5 additions & 77 deletions dhsi/day-three/annotations-stores.md
View file
Original file line number Diff line number Diff line change
@@ -1,86 +1,14 @@
# Annotation Stores

Annotation stores are basically applications with a database you can send an API call to and it will save and store an annotation.

So Mirador or Annotorious will send a POST request with the contents of the annotation to an annotation store and it will recieve the annotation and write it to some kind of storage.

Like image servers there are a number to choose from:

https://github.com/IIIF/awesome-iiif#annotations

Popular ones include:
* annotot - Simple IIIF annotations mounted in a Ruby on Rails applications by Jack Reed
* Elucidate - Java and Postgres annotation server by Digirati
* SimpleAnnotationServer - Java annotation server backed by an Apache Jena triple store, Elastic Search, or Solr. - developed while working at the NLW

A really interesting recent development is Annonatate from [Niqui O'Neill](https://twitter.com/niqui_o) from NCSU Libraries. This is a hosted annotation store which connects to your GitHub account and allows you to store your annotations publicly using GitHub Pages website. You can see examples of the annotations it creates [here](https://github.com/iiif-test/annonatate). There is a demo video here:

<blockquote class="twitter-tweet"><p lang="en" dir="ltr">This application is now live at <a href="https://t.co/fAq7CiiFdA">https://t.co/fAq7CiiFdA</a>. Please feel free to reach out to me with questions and any problems you see or open an issue on this repo: <a href="https://t.co/W4PbzHiTiA">https://t.co/W4PbzHiTiA</a> <a href="https://t.co/NRb9V24HAY">https://t.co/NRb9V24HAY</a></p>&mdash; Niqui O&#39;Neill (@niqui_o) <a href="https://twitter.com/niqui_o/status/1361708671949041678?ref_src=twsrc%5Etfw">February 16, 2021</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>

and the application is available at [https://annonatate.herokuapp.com/](https://annonatate.herokuapp.com/).

For this exercise we are going to be using the [SimpleAnnotationServer](https://github.com/glenrobson/SimpleAnnotationServer) and we are going to work on a copy of the Welsh Centre for International Affairs' Book of Remembrance hosted by the National Library of Wales. The live version of the books is available at:

https://viewer.library.wales/4642022

### DOIs (Digital Object Identifiers)

As an aside a question came up about DOIs. When I worked at the National Library of Wales we created DOIs for our IIIF implementation:

http://hdl.handle.net/10107/4642022

This should resolve to the viewer link above. We didn't create a DOI for the Manifest because this was a 'presentation' of the resource rather than a constituent of the resource. IIIF aims to be good for presentation and doesn't serve the needs required for preservation.

### Transcribing the Book of Remembrance

This example will demonstrate the following:

* Share some experiences of using Mirador in a volunteer lead example
* Use of Mirador with an annotation server
* Show some of the customisation possibilities of Mirador 2

We are going to use the following version which has an annotation server connected to Mirador:

http://sas.gdmrdigital.com/examples/bor/lcc-en.html

Mirador doesn't cope well with multiple people annotating the same page at the same time so if you can randomly choose a section:

* Cavalry
* Corps of Lancers
* Grenadier Guards
* The Queen's (Royal West Surrey Regiment)
* The King's Own (Royal Lancaster Regiment)
* Northumberland Fusiliers
* Norfolk Regiment
* The Prince of Wales's Own (West Yorkshire Regiment)
* Canadian Expeditionary Force Service in France (right at the bottom of the book)
* New Zealand Expeditionary Force (also at the bottom)

For this exercise only transcribe a few lines to get the feel of how the annotation would work in a practical example. As part of this project we wanted to capture not just a transcription but also the fields to allow research so we customised Mirador to capture the different fields.

To annotate a name:

## Step 1:
* To navigate make sure the pen and paper at the top left is disabled
* Get the line in full view
* Click the pen and paper to start annotating
* Draw a box as well as you can around the name

![image](images/anno_bor_start.png)

* Now type what you see (don't worry about the buttons yet). So in this example I would type `Ty.Sub.Lt. Eric Hugh Allan R.N.R Bombala`

![image](images/anno_bor_text.png)

* Once you've typed everything double click on a word or highlight two words if required.

![image](images/anno_bor_highlight.png)

* Now click the button that matches the type of the text. In this example I would click name and see the text go black:

![image](images/anno_bor_typed.png)

* Now do the rest:

![image](images/anno_bor_finshed.png)

* Then click save:

![image](images/anno_bor_view_anno.png)

* SimpleAnnotationServer - Java annotation server backed by an Apache Jena triple store, Elastic Search, or Solr. - developed while working at the NLW
1 change: 0 additions & 1 deletion dhsi/day-two/annona.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,6 @@ Annona only works with images. It also works with IIIF collections and annotatio
<iframe style="width: 100%; min-height: 300px" src="https://ncsu-libraries.github.io/annona/tools/#/display?url=https%3A%2F%2Fiiif.bodleian.ox.ac.uk%2Fiiif%2Fmanifest%2F748a9d50-5a3a-440e-ab9d-567dd68b6abb.json&viewtype=iiif-storyboard&manifesturl=&settings=%7B%22zoom%22%3A%22-2582.666666666666,-475.5555555555557,11841.333333333332,9511.11111111111%22,%22fullpage%22%3Atrue%7D"></iframe>


6. View.

## Configuring
1. Go to [https://ncsu-libraries.github.io/annona/tools/#/tag-builder?url=&viewtype=&manifesturl=&settings=%7B%7D](https://ncsu-libraries.github.io/annona/tools/#/tag-builder?url=&viewtype=&manifesturl=&settings=%7B%7D)
Expand Down

0 comments on commit 823ea75

Please sign in to comment.