From 823ea7515552ac308ad3d207ca6c0bb99ece50ff Mon Sep 17 00:00:00 2001 From: dnoneill Date: Thu, 23 May 2024 17:36:38 -0400 Subject: [PATCH] more annotations --- dhsi/SUMMARY.md | 18 ++--- dhsi/day-three/annotations-sas.md | 16 ++-- dhsi/day-three/annotations-stores-install.md | 4 +- dhsi/day-three/annotations-stores.md | 82 ++------------------ dhsi/day-two/annona.md | 1 - 5 files changed, 24 insertions(+), 97 deletions(-) diff --git a/dhsi/SUMMARY.md b/dhsi/SUMMARY.md index b641a321..28257f40 100644 --- a/dhsi/SUMMARY.md +++ b/dhsi/SUMMARY.md @@ -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) diff --git a/dhsi/day-three/annotations-sas.md b/dhsi/day-three/annotations-sas.md index d0ab553f..07153b03 100644 --- a/dhsi/day-three/annotations-sas.md +++ b/dhsi/day-three/annotations-sas.md @@ -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 @@ -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 @@ -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. diff --git a/dhsi/day-three/annotations-stores-install.md b/dhsi/day-three/annotations-stores-install.md index 70bfcdd9..c2048467 100644 --- a/dhsi/day-three/annotations-stores-install.md +++ b/dhsi/day-three/annotations-stores-install.md @@ -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. @@ -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 diff --git a/dhsi/day-three/annotations-stores.md b/dhsi/day-three/annotations-stores.md index 40294d43..828ac325 100644 --- a/dhsi/day-three/annotations-stores.md +++ b/dhsi/day-three/annotations-stores.md @@ -1,5 +1,9 @@ # 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 @@ -7,80 +11,4 @@ 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: - -

This application is now live at https://t.co/fAq7CiiFdA. Please feel free to reach out to me with questions and any problems you see or open an issue on this repo: https://t.co/W4PbzHiTiA https://t.co/NRb9V24HAY

— Niqui O'Neill (@niqui_o) February 16, 2021
- -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 \ No newline at end of file diff --git a/dhsi/day-two/annona.md b/dhsi/day-two/annona.md index a22c3d6b..b8cc91b2 100644 --- a/dhsi/day-two/annona.md +++ b/dhsi/day-two/annona.md @@ -41,7 +41,6 @@ Annona only works with images. It also works with IIIF collections and annotatio -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)