Skip to content

Recogito

Recogito is a part of the Mare Nostrum LAB system. This tool is dedicated to collaborative annotation of TEI Texts, IIIF Images and PDFs, built on a modern platform designed to be easy to use.

Besides its main functionalities, Recogito offers additional plugins that expand its functionality with specific types of tags. In Mare Nostrum LAB project, we offer a dedicated Mare Nostrum Plugin that allows the use of Mare Nostrum LAB thesaurus items as tags inside the Recogito.

To access the code repository visit Mare Nostrum LAB GitLab.


Quick Start

Login to Recogito

  1. Visit recogito.mn.cenagis.edu.pl website or click here.

  2. Provide your Username and Password, then click "Sign In" button.

    Sign in


Create New Project

User priviledges

To create a new project, you need to have a proper organization role, which means having a Professor or Admin role. Further information can be found here.

  1. Login to Recogito Studio.

  2. Press a "New Project" button in the top right corner of the page.

    New Project button

  3. Provide the project name and description, set projects properties, and press the "Create" button.

    Project properties - Project Visibility

    You can select two options in Project Visibility section:

    • Private - project is visible only to the admin and users who join after receiving an admin invitation.
    • Public - any registered user can access the project by visiting the "Public Projects" section.
    Project properties - Project Type

    You can select two options in Project Type section:

    • Assignments - project admins create assignments with specific documents, and team members fulfil the given tasks.
    • Single Team - project members can annotate any document.

    Create a new project

  4. Upon creating, an empty project page will be displayed.

    Empty project page


Add New Document

  1. Create or open a project.

  2. Press the "Add Document" button in the top right corner.

    Add Document button

  3. Press the "Import" button and select a file from your device or provide a IIIF manifest.

    Import Document button

  4. (Optional) Go to the "All documents" section and select documents of interest from the list of publicly available ones across the organization.

    All Documents section

  5. Wait for processing, which ends with a confirmation message and a new document object.

    Note

    To inspect the document from the adding panel, you need to refresh the page by hand.

    Import ended with success


Annotate TEI Texts and PDF Files

Inspect annotations

You can inspect existing annotations by opening a dedicated pane on the right side of the page.

  1. Choose and open a TEI or PDF document.

  2. Mark the pieces of text you want to annotate, provide content for the annotation, and save them.

    Note

    You can add tags to create thematic groups for the annotations.

    Note

    You can add Web URL links, Image URL links and YouTube links to your annotation.

    TEI/PDF annotation


Annotate IIIF, JPG and PNG Images

Inspect annotations

You can inspect existing annotations by opening a dedicated pane on the right side of the page.

  1. Choose and open a IIIF, JPG or PNG image.

  2. Select the rectangular or multiangular marking mode, outline the elements of interest, provide annotation contents, and save.

    Note

    You can add tags to create thematic groups for the annotations.

    Note

    You can add Web URL links, Image URL links and YouTube links to your annotation.

    Image annotation


Add Geotagger Plugin to Your Project

Plugins availability

Note that plugins are available per project. This means you need to enable them in each project independently.

  1. To enable a plugin, open a project as a Project Admin.

  2. Go to "Settings".

    Project Settings

  3. Next, press the "Plugins" tab, click the "Browse Available Plugins" button and install the listed plugin.

    Install Plugin

  4. Add gazetteers and save the settings.

    Plugin limitations

    Unfortunatelly, the Core Data gazetteer does not work properly. Including it in your project may cause plugin instabilities.

    Add Gazetteers

  5. Verify the plugin installation by visiting the project and trying to add an annotation with a geotag.

    Add Geo-Tag

  6. After providing a string of characters, you can confirm automatically suggested tag or change it in the dedicated window.

    Confirm Geo-Tag


Mare Nostrum LAB thesaurus plugin

Plugins availability

Plugins are available per project. Enable them in each project independently.

  1. Open a project as a Project Admin.

  2. Go to "Settings".

    Project Settings

  3. Open the "Plugins" tab, click "Browse Available Plugins", and install Mare Nostrum Lab Thesaurus.

    Install MN Thesaurus plugin

  4. In the plugin settings, choose which dictionaries are searchable (amphora type, vessel form, chronology, material, and the rest of the MN vocabularies). Optionally keep Use selected annotation text as the thesaurus search query enabled.

    MN Thesaurus plugin settings

  5. Open a document, create or select an annotation, and click "Add Mare Nostrum LAB thesaurus tag".

    Add MN thesaurus tag

  6. Search for a concept. Results show the label, dictionary type, description, and thesaurus id.

    MN thesaurus search

  7. Select a result. The tag is stored on the annotation and links to the concept in the Mare Nostrum LAB thesaurus.

    Saved MN thesaurus tag