@()(implicit request: RequestHeader, webJarsUtil: org.webjars.play.WebJarsUtil) @views.html.help._layout( "Recogito in 10 Minutes", "Recogito in 10 Minutes", "A quick tutorial of Recogito's most important features. Learn how to create annotations, map places and share your work with others.", "fr" ) {

Un tutoriel en 10 minutes

Une rapide introduction à Recogito } {

This tutorial in

Ce court tutoriel vous familiarisera avec les principaux outils de Recogito. Vous apprendrez comment:

Qu'est-ce que Recogito?

Recogito est une plateforme collaborative d'annotation de documents. Ce site est entretenu par la communauté Pelagios, une initiative du domaine des humanités numériques qui a pour objectif de renforcer les liens entre les entreprises de documentations du passé sur internet.

Recogito est constitué d'un espace de travail personnel dans lequel il est possible d'importer, de rassembler et d'organiser sa documentation - textes, images ou tables de données - afin de l'annoter et de la commenter. Recogito vous permet d'améliorer la visibilité de votre travail sur internet lorsque vous rendez votre travail accessible en Open Data.

This tutorial will teach you the essentials of working with Recogito. To complete it, you need a Recogito account, and two sample documents: a plain .txt file with some text, and an image file.

Tip: Open this tutorial in a separate browser window (or tab) so you can see it while you complete the steps.

Etape 1. Importer un document

Documents are used to organize your materials in Recogito. Each document can consist of multiple files. But for now, we are just going to upload a document consisting of a single text file.

Cliquer sur Nouveau Document.

To upload a new text document

  1. Enter a title for your document and click Next.
  2. Upload your text file. You can either click Choose a File to Attach and select it in the file browser, or you can drag and drop it into the upload area with your mouse.
  3. Recogito can run Named Entity Recognition (NER) on your text. This means it will attempt to identify and pre-annotate places and persons automatically. Check Apply automatic annotation and click Next.

Depending on the length of your text, NER may take a while. Once completed, click Done. Congratulations! You have imported your first document into your workspace.

To upload a new image document

Repeat the steps above to create another document from your image file. In the last upload step, Recogito may take few seconds to convert your image into a zoomable image. But more on that later.

Step 2. Create Annotations

Open your text document by double-clicking it in the list. This will take you to the annotation view.

To create a text annotation

Select text like you would in any word processing tool: either by clicking and dragging with your mouse, or by double clicking a word. You can add text comments and tags, as well as identify the selected text as a Place, Person or Event. (We will learn more about how to deal with places in a minute.)

Try experimenting with the annotation editor. You can change or delete each part of an annotation seperately, after you have created it. (To delete a tag, click on it first to get a delete button.) Deleting all parts of an annotation will also remove the highlight from the text.

To create an image annotation

Open your image document. Recogito has a zoomable view so you can navigate even highest-resolution images easily. Zoom using your mousewheel or the + - buttons in the upper right corner. On touch devices you can also use a "pinch" gesture. Pan by dragging and releasing the image.

You can rotate the image at arbitrary angles. On a desktop computer, hold SHIFT + Alt while dragging with your mouse. On touch devices, use a pinch gesture. Use the button with the single arrow to quickly rotate the image back to its original orientation.

Let's create our first image annotation. In the toolbar, there is a drop-down menu where you can switch between Recogito's different selection modes: Point, Rectangle and Tilted Box. Select Point and create an annotation by clicking somewhere in your image. Switch back to Move to resume standard image navigation.

Now try annotating an area: pick the Rectangle tool. Click once to select the starting corner of the area. Then click again for the opposite corner.

The Tilted Box tool may take a bit more practice: select it from the menu. Click and hold the mouse button to draw the baseline of the box. Then release the mouse button. Move the mouse to define the height of the box, and click when you are happy with the height.

Tip: the Tilted Box tool is especially useful for annotating labels in maps. Because there is an explicit baseline, the data you generate will also retain information about the orientation of the label.

Step 3. Identify and Map Places

You already know how to annotate a word or phrase in a document, and identify it as a reference to a place. Now let's assign this reference to a gazetteer, so that Recogito can plot it on the map.

Click Place in the annotation editor. Recogito will attempt to provide an automatic suggestion from its supported gazetteers. You can either confirm this suggestion, or try to find a better match in the gazetteer search. If you can't find a suitable match, you also have the option to flag this reference, as an indication that no suitable match was available.

To speed up your work, Recogito will automatically search the text for identical phrases and give you the option to re-apply the gazetteer assignment to all other matches.

Step 4. Export Your Data

Select the icon in the main navigation bar. This will take you to the available export options for your document. In addition to the options listed on this page, you can also download a backup package of your work from the document settings page. We recommend to download backups for archiving and as an added security measure.

Step 5. Invite Other Users

In this final step we are going to learn how you can share your documents with other users on Recogito, so that you can work as a team. Select the icon in the main navigation bar. This will take you to the Document Settings page. In the left sidebar, select Sharing.

Use the search field at the bottom of the Collaborators box to grant a user access to your document. You can choose between different levels of access:

Congratulations!

You have successfully made your way through Recogito's most important features. By completing this tutorial, you have learned to:

If you want to learn more and get in touch with our user community, please visit the Recogito Users Forum.

@Html(webJarsUtil.script("1.12.0/jquery.min.js")) @Html(webJarsUtil.requireJs(routes.Assets.versioned("javascripts/help/tutorial.js"))) }