Ga verder naar de inhoud

Annotatie Demo Liber Floridus

Voor Mmmonk ontwikkelden we een proof-of-concept voor de visualisering van annotaties op middeleeuwse manuscripten.

Open de demo in een nieuw venster

Doelstelling

De module om IIIF-annotaties toe te voegen aan digitale beelden is volop in ontwikkeling. Maar er staan ook nog heel wat vragen open, onder andere over de visualisering van annotaties. Als input voor IT-ontwikkelaars en de IIIF-community, werkten we een demonstratie uit voor de visualisering van complexe objecten, in casu middeleeuwse manuscripten. In tegenstelling tot enkelvoudige objecten (bv. een foto) is een manuscript meervoudig: een verzameling van soms wel honderden folio's en dus honderden digitale beelden. Daarenboven worden manuscripten vanuit een groot aantal disciplines bestudeerd, bv. voor hun materiële en chemische eigenschappen, tekst, schrift, verluchting, band en consumptiehistoriek. Al die informatie over één manuscript of bladzijde kan overweldigend zijn in een viewer-omgeving.

In deze proof-of-concept onderzochten we hoe deze verschillende lagen informatie op een overzichtelijke en gebruiksvriendelijke manier kunnen worden gepresenteerd in een Mirador viewer.

Legende

Layers: Verschillende types opnames (bv. normaal licht, infrarood licht)

Categories: Informatie geklasseerd per discipline of insteek. Vink categorieën aan of af volgens eigen interesses.

  • iconography: identificatie van de afgebeelde thema's
  • pigments: identificatie van pigmenten in inkt en verf
  • transcriptions: de tekst uitgeschreven zoals die in het manuscript voorkomt
  • translations: vertalingen in het Nederlands (enkel beschikbaar voor folio's 6v-13r)
  • material technical information: identificatie van materialen en werkwijzen

Zet een annotatie vast via het punaise-symbooltje.

Voor deze demo werkten we ook de mogelijkheid uit om bronnen en annotatie-auteurs te vermelden, en om annotaties aan elkaar te koppelen (vertalingen - transcripties).

Liber Floridus als proefkonijn

Voor deze demo selecteerden we ff. 6v-13r, ff. 61v-62r, ff. 88v-89r en 92v-93r van het beroemde Liber Floridus. Bladeren tussen de twee bifolia kan via de navigatie onderaan de foto. Inzoemen is in deze html-opstelling niet mogelijk en de annotaties streven geen volledigheid na. Op de pagina van het Liber Floridus en op de Liber Floridus website kan je het manuscript natuurlijk naar hartenlust verkennen!

Technische documentatie

Omdat deze proof-of-concept bedoeld is als bijdrage aan de verdere ontwikkeling van annotatie-modules, vroegen we ontwikkelaar Bauke van der Laan om zijn werkproces en keuzes te documenteren. Zijn rapport vind je hieronder (in het Engels) en de open-source code op Github.

Goal

The primary objective of the annotation demo is to explore how both experts and the general public can consult short and long form annotations from a wide range of topics within a common IIIF viewer such as Mirador 3.

Constraints

The constraints of the project prevented us from building a fully functional plugin for Mirador that can handle arbitrary IIIF-manifests, but instead made us focus on finding the optimal information architecture and user experience necessary for consulting (different categories of) annotations. To that end, we appropriated the visual language of Mirador 3 using Material UI and simulated a basic Mirador viewer and built our custom interface on top. Because of this, standard features such as zooming and panning are not possible in this demo.


Another choice we had to make based on the constraints of the project and the expected target audience, was to skip adapting the user interface to smaller screens. As a result, this demo expects the user to interact using a desktop or laptop monitor.


Annotation Structure

The annotations in the demo follow the Web Annotation model as outlined by W3C in https://www.w3.org/TR/annotation-model/. An annotation consists of a target (an SVG form indicating one place on one view of the manifest) that is displayed on the canvas, and a body containing the content of the annotation. Once an annotation is selected from the list or by selecting its target on the canvas, the body and metadata will be displayed.

In the case when a single view has a multiple choice of images – or layers, such as described in https://iiif.io/api/cookbook/recipe/0033-choice/, the demo assumes an ambiguity of images, meaning that in the demo, an annotation is always shown regardless of which image layer is selected.

An open annotation will close when opening another annotation. Open annotations are also closed on view navigation, because we assume that an annotation – which is inherently connected to a single view – will lose its relevance on the next view in the majority of cases. A user can prevent an annotation from being closed by pinning the annotation using the pin-button.

Annotation Content

The content of an annotation is described by the annotation body. We used the MIME-types text/plain and text/html for the annotations in the demo. For the richer HTML annotations, we composed the body out of a subset of HTML elements, mainly the <p>, <h1>, <h2>, <a>, and <img> elements. This allowed us to create engaging long form annotations and link to external sources. Typographical styling of these HTML elements is applied by the application. We selected a serif typeface for annotation content, to 1. contrast it with the ‘functional’ interface elements that typically use sans-serif faces in Mirador and 2. create an inviting reading environment for the more long form annotations.

Citing Sources

As the Web Annotation model doesn’t specify metadata for references, bibliographies and other ways of citing sources, we included any references as part of the annotation body using the doc-bibliography role (see: https://www.w3.org/TR/dpub-aria-1.1/#doc-bibliography).

Cross-References

Some annotations in the demo are only superficially or more closely related to other annotations, to the point where some annotations are best consulted together. Take for example a transcription of a text and a translation of the same text. While both are independent and stem from different disciplines, they share the same target and consulting them together can be useful. Cross-referencing these annotations would thus be of value. To our knowledge, the Web Annotation model doesn’t specify a way to do this, so we implemented our own cross-reference extension for the purpose of this demo: any annotation can refer to another annotation‘s ID. When displaying the annotation, a list of cross-references is shown, letting the user easily navigate to a referenced annotation.

Categories

Every annotation in the demo is assigned to one category. Categories are not part of the Web Annotation Model and are an extension created for the purpose of this demo. First, a list of possible categories is configured application-wide. To add an annotation to a category, we add a reference to the category ID in the annotation.

We discussed assigning different colours to the different categories, visible in the annotation target forms. Ultimately we decided against this for the following reasons:

  • A UI dependency on different colours ignores colour-blind or otherwise visually impaired users.

  • If it proves already difficult to select one colour that sufficiently contrasts with all views in a manifesto, this problem becomes more apparent with every added colour.

  • The expectation is that a majority of users will select a very limited subset of categories anyway, rendering the use of multiple colours mostly irrelevant.

Annotations in the demo can be filtered by enabling and disabling categories. This way, a user interested in the pigments used in a manuscript doesn’t need to be bothered by annotations regarding the transcriptions and translations of the same manuscript and vice versa.

Toggling categories filters both the annotation list and the targets visible on the canvas. The selection of categories that the user has set remains active while navigating the different views of the manifest, a decision we made after user testing.


This annotation demo was developped by Bauke van der Laan.

The manuscript for this demo is the Liber Floridus from Ghent University Library.