Quick Start

The essentials in one page to get started with Adno.

An online application

The easiest way to get started is to use the online instance of Adno. It is free and does not require registration. You can also start from one of the examples provided on this site.

Adno is free software, which means you can use, study, modify, adapt it to your own needs and redistribute it under the terms of the MIT license. You can therefore install it for yourself and for others. The sources and installation instructions are available on GitHub.

Start a project

The home screen is Adno’s dashboard: it lets you create, import and manage projects stored in your browser.

Home screen

This dashboard allows you to:

  • create a project by entering in the form the web address of a static image, an IIIF image or manifest, or an Adno project,
  • import a project by loading an Adno project file,
  • manage your projects previously created and stored in your browser.

Project example

For each project stored in the browser, a series of buttons gives access to the following features:

  • View the project,
  • Edit the project,
  • Duplicate the project,
  • Download the project file in Adno format (Web Annotation Model) or IIIF (manifest),
  • Delete the project.

Start with a static image

The image in png or jpg format must be permanently available online and you must know its address (the URL). Enter this URL in the dedicated field, then click Create my project.

https://upload.wikimedia.org/wikipedia/commons/f/f3/Chenille_de_Grand_porte_queue_%28macaon%29.jpg

Start with an IIIF resource

If you are not familiar with IIIF or want to learn more, you can check out the IIIF Online Workshop provided by the IIIF Consortium and led by Glen Robson.

You can start with an IIIF manifest or an IIIF image.

An IIIF manifest

IIIF logo

This is a URL provided by the publisher of the document. This link is often displayed next to the IIIF logo shown here.

The manifest describes the document with its metadata and the references of the images it contains.

https://api.artic.edu/api/v1/artworks/251131/manifest.json

If there are several images, browse them with the › button, then click Use this image for my project (or Cancel and return to home).

Selecting an image in a manifest

You can also retrieve the info.json URL of each image in the manifest by using this form.

An IIIF image

Use the direct URL of an IIIF image, which always ends with info.json.

https://gallica.bnf.fr/iiif/ark:/12148/btv1b8626777x/f13/info.json

Start with an example

The examples page offers resources from a wide range of domains to get you started.

Import a project

Use the Import a project button to upload a previously downloaded Adno file.

View and edit your project

The same interface lets you switch easily between reading and editing a project by clicking the colored view / edit switch at the top right of the interface.

View mode

View mode interface

The navigation bar contains, on the left, the Adno logo to return to the dashboard, followed by the project information, and, on the right, the switch to go from view mode to edit mode, along with three buttons:

  • to save the project,
  • to view the project information,
  • to set the viewer settings:
    • View
      • show the overview navigator,
      • show outlines,
      • show only the outline of the current annotation,
      • show the annotation list on the side,
      • set the default reading orientation,
      • enable image rotation,
      • set how orientation transitions behave,
      • show the toolbar,
      • show the toolbar in full screen mode,
      • show an icon inside shapes,
      • set the layout used to display multi-target annotations.
    • Navigation
      • filter annotations by keywords,
      • delay between two annotations (5 seconds by default),
      • start autoplay at the first annotation,
      • start autoplay automatically on load,
      • set the audio rendering mode.
    • Annotation
      • annotation thickness,
      • annotation outline colors,
      • outline color of the current annotation,
      • annotation group colors.

The collapsible list of annotations is on the left of the screen. By default, the area showing the content of the current annotation is to the left of the image; it can also be placed at the bottom or on the right, or be floating, depending on the settings.

The icons above the image trigger actions (also available from the keyboard):

  • / Autoplay / Pause — keys P or p,
  • Back to the beginning of the annotations,
  • / Show / Hide annotation outlines — keys S or s,
  • Previous annotation — key ←,
  • Next annotation — key →,
  • Full screen — key E,
  • Information about the project,
  • Help and keyboard shortcuts.

Annotation list

Clicking an annotation card selects it as the current annotation and moves the image to the area associated with it, or to the area enclosing all the areas associated with it in the case of a multi-target annotation.

An icon at the bottom left of the screen lets you control how the annotation list is displayed:

  • expanded,
  • collapsed, in which case annotation numbers are shown,
  • expanded on hover (dynamic display), otherwise collapsed.

Full screen view

In full screen view, only the current annotation is visible. Whether the icons are displayed can be set in the settings.

Full screen view

Keyboard shortcuts

Keyboard shortcuts improve accessibility:

  • p or P: start autoplay,
  • e or E: toggle full screen,
  • s or S: show or hide annotation outlines,
  • t or T: show or hide the buttons,
  • and : move from the current annotation to the previous or the next one.

Edit mode

Edit mode interface

The navigation bar contains, on the left, the Adno logo to return to the dashboard and the project information, in the center the buttons to undo or redo the last actions, and on the right a switch to go from edit mode to view mode, along with a button to save the project and another to edit the project information.

  • undo the last action,
  • redo the undone action,
  • save the project,
  • edit the project information.

To create a new annotation, choose an annotation shape:

Annotation buttons: six shapes available

Then select an area on the image by clicking and dragging. As soon as you release, an empty annotation is added to the annotation list. Then click the edit button to add content, and finally Save.

To modify the content of an existing annotation, click its card, then the edit button. To resize it, drag the small circles placed on its outline (regular shapes).

Actions to manage each annotation from the annotation list:

  • Edit this annotation,
  • Add a new target to the annotation,
  • Move the annotation within the annotation list,
  • Delete the annotation.

Edit an annotation

Annotation editing window

This modal window has four tabs:

  • Editor: edit the content of the annotation,
  • Zones: manage the target areas on the image,
  • Tags: associate keywords with the annotation,
  • Audio: associate an audio resource with the annotation.
Editor tab

The content of an annotation is generally a short text. However, it is possible to insert rich content.

Two editing modes are available, which you choose with the switch at the bottom of the window (WYSIWYG by default):

  • WYSIWYG with icons (heading levels, italics, bold, bulleted list, hyperlink, image),
  • Markdown: a lightweight text markup system, which is how annotation content is stored.
Managing zones

One of Adno’s distinctive features is the ability to handle multi-target annotations, that is, annotations that point to several areas of the image.

In edit mode

The Zones tab of the annotation editing window lets you manage the targets of the current annotation. Targets can be split into different groups so that they are displayed separately. The display layout is automatically driven by this split into groups.

Editing targets

There can be up to four groups. On the image, colored badges show the groups used by the annotation and the number of targets in each.

For each group:

  • header: the group label (A, B, C or D) and the number of targets it contains, then the orientation of the annotation and the display option used when the orientation differs from the project default;
  • body: the list of targets; drag and drop lets you move them from one group to another;
  • for each target:
    • a preview of the target’s shape,
    • copy the target’s URL, as defined by the IIIF Image API,
    • delete the target;
  • the + ADD A GROUP button adds a new group, up to a maximum of four.

In view mode: the content of each annotation is displayed in a margin of the image (left, right or bottom) or in a floating window. Several cases arise when displaying annotations:

  • an annotation with a single target, or several targets gathered in a single group: the focus is on the bounding rectangle of all the targets,
  • an annotation with several groups: there are as many display areas as groups; these areas are arranged in a spiral, according to the mosaic layout chosen in the settings (ratio of 1/2 or 2/3, starting vertically or horizontally).

Viewing targets

Settings: the viewer settings () let you choose where the annotation content is displayed (floating panel, or margin on the left, bottom or right) and the mosaic layout of the target groups.

Display settings

Managing tags

This tab lets you associate one or more keywords with each annotation. You can select an existing keyword or create a new one. Remember to press the Enter key after typing each keyword.

In the viewer settings, you can then follow routes through the annotations by keyword.

Associating audio

This tab lets you associate an audio resource with the annotation. The first field takes the URL of the audio file and the second takes information about the resource (credit or other).

In the viewer settings, specify how audio is played: individually or as spatialized sound.

Retrieve your projects

Projects are stored in your browser. You will find them again by reopening a session on the site where they were created.

Share your projects

Present in various places in the Adno interface, the button opens a modal window showing how to save and share a project by exporting it as an Adno file or an IIIF manifest.

In either case, the file is a simple text file in JSON format. It is generally very light, so you can easily send it by e-mail. Once they have imported it into Adno, your correspondent will be able to view it, and also suggest variations or corrections to your project.

You can also place your file online and distribute its URL. To do this, you can use a website or a file server. The IPFS protocol offers an interesting decentralized alternative.

See the Google Drive, Dropbox or IPFS pages of the documentation’s reference guide to find out how to use these services to host images, IIIF manifests or Adno projects.

Embed a project in a web page

Once your Adno project is online, you can make it visible in a web page by inserting an iframe tag and adjusting the parameters below.

<iframe
    src="https://w.adno.app/#/embed?url=PROJECT_URL"
    title="Project title"
    height="600px"
    width="100%"
    allow="fullscreen"
></iframe>

By inserting the URL of an image (IIIF or not) or of an IIIF manifest, you get an IIIF viewer that is easy to install.

The Page Block Adno module allows Adno projects to be viewed in the pages of Omeka S sites.

You can also use the Adno views tags component to embed different types of visualization (lists, slideshows, etc.).

Issues

Adno runs in the browser and relies on resources hosted elsewhere on the web. This approach may be subject to restrictions that can affect how Adno works and how it integrates into web pages.

The most common cases:

  • It is not possible to insert a resource with an address beginning with http into a secure site served over https. For example, if you upload an image to the IIIFHosting service, the default URL provided starts with http. To use it in Adno, remember to change http to https at the beginning of the URL.
  • CORS settings on a third-party server may prohibit data transfer to another domain. The official Adno instance uses a dedicated third-party service to work around this issue.

Translation

If Adno is not available in your language, you can contribute by adding a new language and proposing translations on the Adno section of the Weblate platform. In the same way, you can propose changes and corrections to existing translations.

Installation

Adno is a service available freely and free of charge online. Adno is also free software, so you can install it yourself or even adapt it to your needs. You can find the source code and all the information on the Adno software repository.

Help

Check the frequently asked questions and the documentation to learn more (note: these sections are still incomplete). If you have any problems or suggestions, please contact us.