Adding v1 of the DH2026 workshop

.github/bin/buildHonkit.sh

@@ -23,6 +23,17 @@ for dir in $dirs; do
     fi
     mkdir -p "../build/$dir"
 
+    # Honkit's asset-copy step skips symlinked directories (a symlink's dirent
+    # is neither isDirectory() nor isFile()), so shared content pulled in via
+    # a directory symlink (e.g. digital-humanities/day-one) silently loses its
+    # images. Dereference any top-level symlinks into real files before building.
+    for link in $(find . -maxdepth 1 -type l); do
+        echo "Dereferencing symlink for build: $link"
+        real=$(readlink -f "$link")
+        rm "$link"
+        cp -RL "$real" "$link"
+    done
+
     npx honkit build . "../build/$dir"
     if [ $? -eq 1 ]; then
         failed_build=1

digital-humanities/README.md

@@ -0,0 +1,47 @@
+# DH tools for working with IIIF enabled collections 
+## Abstract
+
+DH tools for working with IIIF enabled collections workshop will introduce participants to the gamut of IIIF enabled tools that can work with the diverse set of collections that implement IIIF. The workshop will be hands-on with participants using either their own images or public collections they are interested in. 
+
+The [International Image Interoperability Framework (IIIF)](https://iiif.io) is a set of open standards for delivering high-quality, attributed digital objects online at scale. It’s also an international community developing and implementing the IIIF APIs. IIIF is backed by a consortium of leading cultural institutions and a [global and engaged community](https://iiif.io/community/).
+
+IIIF enables digital object portability across viewers and tools. It allows uniting of disparate material such as the [reunification of manuscripts](https://muse.jhu.edu/issue/52472) and [parts of manuscripts](https://demos.biblissima.fr/chateauroux/demo/) across institutional boundaries. This portability is one of the reasons IIIF is an important standard in digital humanities research allowing open access collections to be used as research data and for research software to be written once and used with many collections. 
+
+The course will start with looking to find IIIF collections using the [IIIF Guides](https://guides.iiif.io/finding_resources/) website which was developed by the University of St Andrews during COVID to help discover IIIF resources. This is a common method to find IIIF resources but often in DH research you have images which aren’t available as IIIF. To cover this use case the course will demonstrate how to upload images and add metadata to an item in the Internet Archive. Once participants have digital items to work with the course will move onto demonstrate the different tools that can be used with this material. 
+
+The first tool that will be demonstrated is called [Allmaps](https://Allmaps.org/) and allows users to geo-reference a IIIF image of a map to locate on a modern map. This can allow the overlaying of maps of different periods for comparison and also provides access to maps of locations from institutions across the world. After looking at Allmaps the workshop will move onto annotations and start with looking at the annotation functionality of [IMMARKUS](https://immarkus.xmarkus.org/), a DH focused IIIF viewer.  Once participants are familiar with annotations we will move on to looking at how Large Language Models (LLMs) can be used to transcribe and translate IIIF images. This will be achieved by taking participants through a number of Jupiter Notebooks and supplying IIIF images to work with. Using and experimenting with LLM prompts participants will see both the power of LLMs but also some of the issues to be aware of. 
+
+The tutors of the course are well experienced in delivering hands-on training both remotely and in person. The course will be extended from previous courses given quarterly online and in person at the iPres conference in New Zealand, in Australia as part of the AI4LAM conference, in Victoria as part of DHSI and various other venues around the world. This course will be different from previous courses which gave an introduction to IIIF with a focus on practical use cases that will fit with digital humanities practices. This includes much more of a focus on using IIIF with tools and working with large language models (LLM). 
+
+## Learning outcomes
+Participants will recognise IIIF enabled collections and will be able to use them to achieve digital humanities research using a variety of IIIF tools. The course will be hands on and an online workbook will be developed so attendees can refer back to the course after it is finished. 
+
+## Target audience
+The workshop is open to anyone and has been delivered in the past to attendees at multiple levels of technical ability. The workshop will be accompanied by an online workbook with step by step instructions so everyone can keep up with the hands-on exercises. There are plenty of opportunities for attendees to ask questions and to cover topics in detail if people are interested in the technical details.  
+
+## Special requirements for technical support
+Instructors will use a laptop connected to a projector. Participants should bring their own laptops and collections they would like to work with. All will require internet access. 
+
+Expected number of participants: 20 - 30 
+
+## Draft agenda
+Assuming a workshop of three and half hours for example 9:00am - 12:30pm. 
+
+| Time | Topic |
+| --- | --- |
+| 9:00 - 9:10 | Class and instructor introductions |
+| 9:10 - 10:00 | Introduction to IIIF |
+| 10:00 - 10:30 | Using the Internet Archive to publish IIIF images |
+| 10:30 - 11:00 | Break |
+| 11:00 - 11:15 | Georeferencing maps with Allmaps |
+| 11:15 - 11:30 | Annotating with IMMARKUS |
+| 11:30 - 12:15 | Visual search and adding Entities |
+| 12:15 - 12:30 | Summary and sharing of project work |
+
+## Instructors 
+
+__Glen Robson__
+Glen Robson is the IIIF Technical Coordinator of the IIIF Consortium. He coordinates the maintenance of the IIIF specifications, supporting the IIIF community infrastructure and aiding early implementers of IIIF. He runs regular online training sessions attended by participants around the world and also in person workshops in Canada, UK and Australia. 
+
+__Martin R. Kalfatovic__
+Martin R. Kalfatovic is Managing Director of the IIIF Consortium in this role, his remit is to expand use of the IIIF standard and APIs, grow participation in the IIIF Consortium, and enhance the global user experience of digital objects across all formats, including images, audio-visual, and 3D. 

digital-humanities/SUMMARY.md

@@ -0,0 +1,14 @@
+# Summary
+
+- [Overview](README.md)
+
+## Part 1
+- [What is IIIF](day-one/whatisiiif.md)
+  - [Exercise](day-one/guides.md)
+- [Internet Archive and IIIF](internet_archive/README.md)
+
+## Part 2
+- [Georeferencing maps with Allmaps](allmaps/allmaps.md)
+- [Annotating with IMMARKUS](day-four/annotating-immarkus.md)
+- [Visual search and adding Entities](day-four/advanced-immarkus.md)
+- [Summary and sharing of project work](demos.md)

digital-humanities/allmaps/allmaps.md

@@ -0,0 +1,37 @@
+# Annotations and Maps
+
+One of the nice things about IIIF is that it is constantly evolving. By allowing a standard interface to access Cultural Heritage objects it allows new tools to be developed and one of these is [AllMaps.org](https://allmaps.org/). This tool allows you to Geo-reference a IIIF Map so it can be overlaid onto a modern map. 
+
+It starts the same way as many of the solutions discussed earlier with a IIIF Manifest. For this example I am going to use a map of Washington D.C. from the Library of Congress:
+
+ * [Aberystwyth. - David Rumsey Historical Map Collection](https://www.davidrumsey.com/luna/servlet/detail/RUMSEY~8~1~274918~90048148:Aberystwyth-?sort=Pub_List_No_InitialSort%2CPub_Date%2CPub_List_No%2CSeries_No&mi=8&trs=31&qvq=q:aberystwyth;sort:Pub_List_No_InitialSort%2CPub_Date%2CPub_List_No%2CSeries_No;lc:RUMSEY~8~1)
+ * [Manifest](https://www.davidrumsey.com/luna/servlet/iiif/m/RUMSEY~8~1~274918~90048148/manifest)
+
+The first stage is to navigate to [https://editor.allmaps.org](https://editor.allmaps.org) and enter the Manifest URL:
+
+![Enter IIIF Manifest URL into Allmaps](all_maps_start.png)
+
+The first process of geo-referencing is to cut out the parts of the image that contain the map. This is called Masking. In this example the Maps is part of a book so the Map part of the image needs to be highlighted.
+
+![Masking with allmaps](all_maps_masking.png)
+
+Now the real geo-referencing can start. Select a point on the modern map and then select the corresponding location on the IIIF map. Once you have added enough points allmaps will be able to warp and fit the historical map on top of the modern map.
+
+![geo-referencing](all_maps_georeferencing.png)
+
+You can then view the resulting transformation by clicking the results tab. 
+
+![visualising the geo-referencing with allmaps](all_maps_demo.png)
+
+This type of geo-referencing can be very useful if you are trying to co-locate different data for example maps from different periods or annotations from related documents. 
+
+For example there is this [Cynefin project](https://www.library.wales/digitisation-projects/places-of-wales/about-places-of-wales) from the National Library of Wales which shows the 1800s Tithe maps of Wales linked to apportionments which detail land use at the time the maps were created:
+
+https://places.library.wales/browse/52.415/-4.084
+
+This was a crowdsourcing project which used a similar Geo-referencing tool called [Georeferencer](https://georeferencer.com/).
+
+![cynefin.png](cynefin.png)
+
+
+

digital-humanities/book.json

@@ -0,0 +1,25 @@
+{
+  "title": "IIIF Online Workshop",
+  "plugins": [
+    "include",
+    "theme-default",
+    "toggle-chapters",
+    "git-author",
+    "-fontsettings"
+  ],
+  "gitbook": "3.2.3",
+  "styles": {
+        "website": "styles/website.css"
+  },
+  "pluginsConfig": {
+    "theme-default": {
+        "showLevel": true
+    },
+    "git-author": {
+      "position": "bottom",
+      "modifyTpl": "Last modified by {user} {timeStamp}",
+      "createTpl": "Created by {user} {timeStamp}",
+      "timeStampFormat": "YYYY-MM-DD HH:mm:ss"
+    }
+  }
+}

digital-humanities/day-four

@@ -0,0 +1 @@
+../iiif-online-workshop/day-four

digital-humanities/day-one

@@ -0,0 +1 @@
+../iiif-online-workshop/day-one

digital-humanities/demos.md

@@ -0,0 +1,39 @@
+# Project demos
+
+We've now completed the course and would be interested in seeing the demos you've been working on. 
+
+## Slack channels
+
+Join the [IIIF slack](http://bit.ly/iiif-slack):
+
+ * general - general discussion and announcements
+ * beginner - beginner questions lots of people to help
+ * iiif-in-the-classroom - ideas for IIIF in the classroom
+ * curators_of_awesome - become a curator of awesome by helping to curate: https://github.com/IIIF/awesome-iiif
+ * mirador - ask questions and see the latest developments with Mirador
+ * technical - ask difficult technical questions :-)
+
+## Zoom calls
+Community Calls https://iiif.io/community/call/
+
+## Community groups
+See all IIIF calls on the IIIF Calendar: https://iiif.io/community/
+
+Community groups:
+ * [3D](https://iiif.io/community/groups/3d)
+ * [A/V](https://iiif.io/community/groups/av)
+ * [Design](https://iiif.io/community/groups/D4H)
+ * [Maps](https://iiif.io/community/groups/maps)
+ * [Museums](https://iiif.io/community/groups/museums)
+ * [Outreach](https://iiif.io/community/groups/outreach)
+
+Technical Groups
+ * [3D](https://iiif.io/community/groups/3d/tsg/)
+ * [Authentication](https://iiif.io/community/groups/auth-tsg)
+ * [Content Search](https://iiif.io/community/groups/content-search-tsg)
+
+
+## Stay informed
+
+ * Join the [monthly newsletter](https://iiif.io/newsletter/)
+ * Join the IIIF Discuss [email list](https://groups.google.com/forum/#!forum/iiif-discuss)

digital-humanities/internet_archive/README.md

@@ -0,0 +1,96 @@
+# Using the Internet Archive
+
+The Internet Archive allows you to upload images and then provides a IIIF Image API service and Manifests. The Internet Archive service uses Cantaloupe as their image server and images can be accessed as either Version 2 or Version 3 of the IIIF Image and Presentation APIs. 
+
+__Note__: some people have had some issues getting their images to show when uploading to the Internet Archive. To avoid these issues:
+
+ * Ensure the collection is 'Community Image' collection. The `Community Texts` collection seems to break the image viewing currently
+
+## High level steps for getting access to IIIF manifests
+
+1. Register for a user account at [archive.org](https://archive.org)
+2. Upload your image or images
+  * __Ensure you select the 'Community Image' collection__ 
+3. On the details page get the identifier for the image. For example if the details page link is:
+
+  https://archive.org/details/img-8664_202009
+
+  the identifier would be `img-8664_202009`
+4. Access the Internet Archive IIIF helper page with this identifier:
+
+  https://iiif.archive.org/iiif/helper/img-8664_202009/
+
+
+On this page you should see a link to the Manifest and also links to open up the Manifest in Mirador, Universal Viewer and Clover
+
+## Step by step guide
+
+A step by step guide with screen shots for the above steps is below:
+
+1. Register for a user account at [archive.org](https://archive.org) 
+
+ Click signup or login if you already have an account:
+
+ <img src="imgs/login1.png" alt="Sign up / Login" class="standout-image"/>
+
+ Then create your user:
+
+ <img src="imgs/login-create-user.png" alt="Create user" class="standout-image" />
+
+ They will then ask you to verify your email address:
+
+ <img src="imgs/login-verification.png" alt="Send verification email" class="standout-image" />
+
+ You will then see an email like the following:
+
+ <img src="imgs/login-email.png" alt="Verification Email" class="standout-image" />
+
+ Click on the link on the email and you will get the following screen:
+
+ <img src="imgs/login-success.png" alt="success" class="standout-image" />
+
+2. Upload your image
+
+ Select upload on the Archive Welcome screen:
+
+ <img src="imgs/upload-welcome.png" alt="welcome screen" class="standout-image" />
+
+ You will then see the following screen. Select the green Upload Files button:
+
+ <img src="imgs/upload-files.png" alt="upload choices" class="standout-image" />
+
+ Then click on the 'choose files to upload' button and select the images to upload:
+
+ <img src="imgs/upload-drag-and-drop.png" alt="choose files" class="standout-image" />
+
+ Add metadata. The Title, URL, Description tags are mandatory. I left it in the Community Image collection. Usefully you can also say if its a test item which can be deleted after 30 days. 
+
+ __Update__: ensure collection is `Community Image Collection` otherwise the image won't work as IIIF. 
+
+ <img src="imgs/upload-metadata.png" alt="Metadata" class="standout-image" />
+
+ Then click 'Upload and Create Your Item'. This took at least 5 minutes and after the bar has completed you have to wait longer presumably so it can setup the derivative images.
+
+ <img src="imgs/upload-timer.png" alt="Upload wait" class="standout-image" />
+
+ If all has gone well you should see the item page:
+
+ <img src="imgs/upload-itempage.png" alt="item page" class="standout-image" />
+
+3. On the details page get the identifier for the image. For example if the details page link is:
+
+  https://archive.org/details/img-8664_202009
+
+  the identifier would be `img-8664_202009`
+
+  <img src="imgs/get_id.png" alt="Get image identifier" class="standout-image"/>
+
+4. Access the Internet Archive IIIF helper page with this identifier:
+
+  https://iiif.archive.org/iiif/helper/img-8664_202009/
+
+  On this page you should see a link to the Manifest and also links to open up the Manifest in Mirador, Universal Viewer and Clover
+
+  If this is a single image you will also see links to various image croppers. 
+
+  <img src="imgs/helper.png" alt="Get image identifier" class="standout-image"/>