Anleitung zum Annotieren und Kommentieren

Universitätsbibliothek Heidelberg

14.01.2025

1 Allgemeine Informationen

Die Universitätsbibliothek Heidelberg bietet angemeldeten WissenschaftlerInnen weltweit die Möglichkeit, die von ihr digitalisierten historischen Bestände online mit Annotationen und Kommentaren zu versehen. Eine Moderation der Annotationen und Kommentare seitens der UB Heidelberg erfolgt nicht.

Zur Anzeige der Annotationsfunktionen klicken Sie auf den Annotations-Button in der Toolbar (vgl. Abb. 1).

Abb. 1: Annotations-Button in der Toolbar

2 Netiquette

Für die Nutzung der Kommentarfunktion auf unserer Publikationsplattform bitten wir um Beachtung folgender Regeln:

In ausgewählten Fällen, z.B. bei besonders ausführlichen Annotationen mit Miszellencharakter, werden diese auch im Südwestdeutschen Bibliotheksverbund (SWB) katalogisiert, so dass sie in den üblichen nationalen und internationalen Katalogen nachgewiesen sind.

Beispiel:

Abb. 2: Annotation

3 Registrieren, einloggen und Rechte einholen

Wenn Sie Teil der virtuellen Forschungscommunity der „Heidelberger historischen Bestände – digital“ werden wollen, müssen Sie hierfür registriert sein und über Annotationsrechte verfügen. Wenn Sie Mitglied an einer Forschungseinrichtung (Universität, Hochschule, Max-Planck-Institut oder Ähnlichem) sind, können Sie sich in der Regel über Ihre Institution anmelden. Klicken Sie hierzu auf den “Login”-Button. Es erscheint ein Auswahl-Menü des Identity-Providers Shibboleth. Dort können Sie Ihre Institution auswählen und sich mit Ihrer Benutzerkennung und dem Passwort anmelden.

Zudem muss Ihrer Kennung die Berechtigung zum Anlegen neuer Annotationen oder Kommentieren bestehender Annotationen zugeteilt werden.

3.1 Sie sind noch nicht angemeldet

Wenn Sie noch nicht angemeldet sind, wird Ihnen ein “Login”-Button angeboten:

Abb. 3: Login DWork

Für den Login bestehen verschiedene Möglichkeiten:

Melden Sie sich mit Ihrem Benutzer-Account an. Klicken Sie dazu auf “Login”. Alternativ können Sie sich auch in der Präsentation des Digitalisats anmelden (vgl. Abb. 4).

Abb. 4: Login DWork

Es erscheint eine Seite, über die Sie sich Ihre Institution auswählen können: (Abb. 5)

Abb. 5: Auswählen des Identity Providers

Anschließend werden Sie zur Anmeldemaske Ihrer Einrichtung weitergeleitet. (Abb. 6)

Abb. 6: Anmeldemaske am Beispiel der Universität Heidelberg

Sie sind nun angemeldet. Je nachdem, welche Rechte Ihnen zugeteilt wurden, können Sie nun annotieren (siehe: Kap. 3.2) oder die entsprechenden Rechte anfordern (siehe Kap. 3.3).

3.2 Sie sind bereits angemeldet, aber noch nicht zum Annotieren freigeschaltet

Wenn Sie trotz erfolgreicher Anmeldung beim Klick auf den Button ‘Neue Annotation’ die Meldung ‘Berechtigung fehlt’ erhalten, dann wurden Ihrem Account noch keine Rechte zum Annotieren zugeteilt:

Abb. 7: Keine Freischaltung

Sie müssen Annotationsrechte beantragen. Klicken Sie dazu bitte auf den Button ‘Berechtigung jetzt beantragen’. Sie werden auf ein Formular weitergeleitet, in dem Sie nach Ihrem Namen, Ihrer E-Mail-Adresse und Ihren Forschungsinteresse bzgl. des zu annotierenden Digitalisats gefragt werden. Wenn Ihr wissenschaftliches Interesse ausreichend belegt ist, erhalten Sie die Freigabe.

3.3 Sie sind angemeldet und zum Annotieren freigeschaltet

Am grünen Button “Neue Annotation” erkennen Sie, dass Sie die Berechtigung zum Annotieren haben. Sie können direkt loslegen zu annotieren und zu kommentieren.

Abb. 8: Berechtigung vorhanden

4 Testumgebung

Unter der URL https://digi.ub.uni-heidelberg.de/diglit/annotationen_test steht Ihnen eine Testumgebung zur Verfügung. Die dort angebrachten Annotationen werden in gewissen Abständen gelöscht.

Da die Annotation bei Einreichung sofort veröffentlicht wird, ist eine Korrektur nur über eine neue Version der Annotation möglich (s.u.). Daher ist es sinnvoll, diese Testumgebung für erste „Gehversuche“ zu nutzen.

5 Annotationen erstellen

Nach der Anmeldung haben Sie die Möglichkeit, die Digitalisate der UB Heidelberg folgendermaßen zu annotieren:

Sie können eine Annotation zwischenspeichern, um sie später zu bearbeiten (Button „Entwurf speichern“), oder sie direkt veröffentlichen (Button „Veröffentlichen“). Prüfen Sie die Vorschau im gleichnamigen Reiter, bevor Sie Ihre Annotation veröffentlichen.

Geben Sie Annotationen, die eine Handschrift bzw. einen Druck als Ganzes betreffen (bspw. Anmerkungen zur Datierung o.ä.), auf der Startseite des jeweiligen Projektes (Handschrift, Druck usw.) ein.

Geben Sie Annotationen, die sich auf eine bestimmte Seite bzw. auf den Bereich oder Bereiche einer bestimmten Seite beziehen, in der Ansicht der Einzelseite des Faksimiles an.

Klicken Sie auf den Annotations-Button in der Toolbar (vgl. Abb. 1).

Klicken Sie auf „Neue Annotation“.

Es öffnet sich der Annotationen-Editor:

Abb. 9: Annotationen-Editor

5.1 HTML-Editor, Sprache, Lizenz und Autorschaft

Geben Sie im Titelfeld einen prägnanten Titel ein. Dieser Titel ist das, was den Lesern immer angezeigt wird, auch, wenn die Annotation selbst zugeklappt dargestellt wird (z.B. weil es mehrere Annotationen auf einer Seite gibt). Der Titel soll unformatierter Text sein und kann daher auch nicht im Editor formatiert werden. Wenn es aus inhaltlichen Gründen notwendig ist, lassen sich Sonderschriftzeichen mit impliziter Schriftformatierung einfügen. Das soll jedoch ein seltener Ausnahmefall bleiben, da es die Indexierung erschwert.

Tragen Sie im Textfeld (bei der Bemerkung „Annotieren Sie hier“) Ihren Beitrag ein. Sie können Ihren Text, der im HTML-Format ausgegeben wird, anschließend über die angebotenen Buttons zur Textauszeichnung formatieren, Textteile verlinken oder Bilder in Ihren Beitrag einfügen:

Bitte beachten Sie, dass Bilder und Videos nur über URLs eingebunden werden können. Verwenden Sie deshalb unbedingt nur solche Medien, die dauerhaft unter der gleichen URL verfügbar sind.

Geben Sie auf diesem Reiter des Editors bitte auch an, in welcher Sprache Ihre Annotation verfasst ist und unter welcher Lizenz sie veröffentlicht werden soll. Beide Angaben sind Pflicht.

Bei der Lizenz haben die Möglichkeit, zwischen den Varianten „Public Domain“ (Creative Commons CC0) und Creative Commons CC-BY 4.0 zu wählen. Durch Anklicken wählen Sie die Lizenz aus, die dann farblich hervorgehoben wird (vgl. Abb. 10).

Abb. 10: Lizenzauswahl

Nutzern und Kommentatoren Ihrer Annotationen wird angezeigt, unter welchen Voraussetzungen sie diese verwenden können:

CC-0 Symbol Annotation ist gemeinfrei und kann beliebig genutzt und weiterverbreitet werden.

CC-BY 4.0 Symbol Annotation kann frei genutzt und weiterverbreitet werden, solange Sie die/den Autor*in nennen und auf diese Seite verweisen.

Wir können in der Benutzerdatenbank zu Ihrem Account verschiedene Autorenangaben hinterlegen. Das können zum Beispiel sein:

Sofern dies bei Ihrem Account geschehen ist, können Sie auf dem Reiter „Kommentar“ die passende Autoren-Identität/-Nennung auswählen (siehe Abb. 11).

Abb. 11: Autorenangaben/Autoren-Identität

5.2 Bildausschnitte (Zonen) markieren

Um einen bestimmten Bereich innerhalb eines Digitalisats zu markieren und zu annotieren, klicken Sie auf den Registerreiter „Zonen“ (vgl. Abb. 12).

Abb. 12: Registerreiter “Zonen”

Es öffnet sich der Zonen-Editor (vgl. Abb. 13).

Abb. 13: Zonen-Editor

Sie haben nun die Möglichkeit, Rechtecke, Polygone (für unregelmäßige Formen), Kreise, Ellipsen, oder Linien in das Digitalisat einzuzeichnen.

5.2.1 Zonen zeichnen

Beispiel Polygon:

  1. Klicken Sie auf das Polygon-Symbol: Polygon Button
  2. Setzen Sie einen ersten Punkt, indem Sie die gewünschte Stelle anklicken und die Maustaste wieder loslassen.
  3. Setzen Sie nun weitere Eckpunkte des Polygons jeweils durch einen einfachen Mausklick.
  4. Um die Form abzuschließen, können Sie wahlweise außerhalb der Zone doppelklicken, oder zum Anfangspunkt zurückkehren und diesen anklicken.

Polygon Schritt 1 Polygon Schritt 2 Polygon Schritt 3

Beispiel Rechteck:

  1. Klicken Sie auf das Symbol mit dem Rechteck.
  2. Setzen Sie per Mausklick einen Eckpunkt des Rechtecks im Bild. (Lassen Sie die Maustaste wieder los.)
  3. Setzen Sie auf gleiche Weise den diagonal gegenüber­liegenden Eckpunkt des Rechtecks.
  4. Damit ist das Rechteck bereits fertig gezeichnet.

Beispiel Kreis:

  1. Klicken Sie auf das Symbol mit dem Kreis.
  2. Setzen Sie per Mausklick den Mittelpunkt des Kreises im Bild. (Lassen Sie die Maustaste wieder los.)
  3. Bewegen Sie den Mauszeiger, um den Radius des Kreises zu vergrößern.
  4. Klicken Sie erneut, um die Kreis-Zone in der gewünschten Größe einzuzeichnen.

5.2.2 Zonen bearbeiten/löschen

Um eine Zone zu bearbeiten, klicken Sie auf das Handsymbol Zoneneditor Handsymbol. Sie können mehrere Zonen gleichzeitig markieren, indem Sie mit gedrückter Umschalttaste eine weitere Zone anklicken.

Nachdem Sie eine oder mehrere Zonen markiert haben, können Sie diese bearbeiten oder löschen. Um die Zonen zu löschen, klicken Sie auf das Papierkorbsymbol oder drücken Sie die Entf-Taste.

Es gibt zwei Bearbeitungmodi, die durch Mausklick auf das jeweilige Symbol unter dem Handsymbol gewählt werden können Zoneneditor Modi.

Der aktive Modus wird mit einem hellroten Hintergrund markiert.

Standard Modus: Wenn Sie auf eine Zone klicken, erhält sie einen roten Rahmen (vgl. Abb. 14). In diesem Zustand können Sie die Zone vergrößern, verkleinern, bewegen oder drehen. Um das Seitenverhältnis der Zone beizubehalten, halten Sie während des Vergrößerns bzw. Verkleinerns die Umschalttaste gedrückt.

Abb. 14: Zone zum Vergrößern/Verkleinern/Drehen markieren

Eckpunkte-Modus: Wenn Sie auf eine Zone klicken, wird diese gelb und blau markiert. In diesem Modus können Sie die Eckpunkte (Vertices) der Zone bearbeiten: - Bewegen Sie den Mauszeiger zu einem Eckpunkt, klicken Sie darauf und halten Sie die Maustaste gedrückt, während Sie die Maus bewegen.

Abb. 15: Beispiel Eckpunkte-Bearbeitung
Abb. 16: Ellipse mit zusätzlichem Eckpunkt

Wichtig: Im Eckpunkte-Modus können Zonen nicht bewegt werden! Dies muss im Standardmodus erfolgen. Klicken Sie dazu auf die Zone und bewegen Sie die Maus, während Sie die Maustaste gedrückt halten.

5.3 Schlagworte hinzufügen

Unter dem Reiter „Schlagworte“ haben Sie die Möglichkeit, der Annotation normierte Schlagworte aus der Gemeinsamen Normdatei (GND) hinzuzufügen. Klicken Sie dazu auf „Schlagwort hinzufügen“ und geben Sie in das Suchfeld das gewünschte Schlagwort ein. Kurz darauf erscheint eine Vorschlagsliste, aus der Sie die Entsprechung aus der GND auswählen können. Sie können beliebig viele Schlagworte vergeben. (Jedenfalls mehrere hundert, falls nötig.)

Abb. 17: Tag-Editor

In der Sektion „Links“ können Sie auf beliebige Web-Ressourcen verweisen und ggf. auch die Art der Verweisung angeben. Tragen Sie in das erste Feld die URL der Web-Ressource ein. In das zweite Feld können sie einen Titel für den Link angeben, der in der fertigen Annotation angezeigt wird. In der dritten Spalte ist ein Auswahlfeld um die Art der Verknüpfung anzugeben, im einfachsten Fall das vorgegebene „siehe auch“, aber auch komplexere Beziehungen wie „ist Teil von“ oder Eigenschaften der VRA-Ontologie können ausgewählt werden.

5.5 Vorschau

Bevor Sie Ihre Annotation speichern, können Sie diese unter „Vorschau“ anschauen und überprüfen. Wenn Sie keine weiteren Änderungen oder Ergänzungen mehr wünschen, kann die Annotation eingereicht werden.

5.6 Annotationen veröffentlichen

Um Ihre Annotation einzureichen, sodass sie öffentlich sichtbar wird, klicken Sie auf den Button „Veröffentlichen“ in der Fußzeile des Editors.

Die Annotation ist nun abgeschlossen. Jede Annotation erhält eine persistente URL, mit der auf die Annotation verlinkt werden kann. Die URL wird durch einen Klick auf das Linksymbol (Kette) in der Kopfzeile der Annotation eingeblendet.

Klicken Sie dort dann auf das Klemmbrett-Symbol, um die URL der Annotation in die Zwischenablage zu kopieren (vgl. Abb. 19).

Abb. 19: Persistente URL einer Annotation

Eventuelle Korrekturen sind nun nicht mehr möglich. Sie haben allerdings die Möglichkeit, eine bereits bestehende Annotation zu editieren und damit eine neue Version zu erstellen (siehe Kap. 5.9).

Wenn Sie vor dem Veröffentlichen den Vorgang abbrechen wollen, klicken Sie stattdessen auf den Button „Verwerfen“ unter dem Textfeld und alles bislang Eingetragene wird gelöscht. Außerdem ist es möglich, Annotationen vor der Einreichung zunächst als Entwurf zu speichern und später weiter zu bearbeiten (siehe Kap. 5.7).

5.7 Annotationen zwischenspeichern, Entwürfe, Vorlagen

Sie haben die Möglichkeit, Ihre Annotationen vor der Einreichung zwischenzuspeichern, um

Wechseln Sie dazu auf den Reiter „Entwürfe“.

Dort können Sie

Der Button „Entwurf speichern" in der Fußzeile des Editors löst sofort die Speicherung aus und öffnet ebenfalls diesen Reiter, damit sich sogleich vergewissern können, dass der neu gespeicherte Entwurf auch in der Entwürfeliste erscheint.

Abb. 20: Entwürfen und Vorlagen verwalten

Das Diskettensymbol rechts oben im Editor speichert ebenfalls den Entwurf. Es kann eine nützliche Abkürzung sein, wenn die Fußzeile des Editors gerade nicht im Bild ist, weil sie z.B. von einer sehr langen Stichwortliste nach unten gedrängt worden sein könnte.

Verhalten im Störfall

Sollte die Speicherung eines Entwurfs fehlschlagen, wird nach spätestens einer Minute eine Fehlermeldung im oberen Bereich des Editors erscheinen. Die Meldung enthält üblicherweise einen Selbsthilfe-Link, über den Sie Details zum Problem abrufen können.

Der häufigste Grund ist eine abgelaufene Sitzung. In diesem Fall bringt der Selbsthilfe-Link Sie zur Loginseite. Nach dem Login sehen Sie möglicherweise eine unaufbereitete Liste Ihrer Entwürfe. Wechseln Sie in dem Fall zurück zum Editor und versuchen Sie erneut, Ihre Annotation als Entwurf zu speichern. Gelingt dies, und wird entsprechend endlich der neue Entwurf im Editor angezeigt, so können Sie die (nun veraltete) unaufbereitete Liste einfach schließen.

5.8 Multi-Target-Annotationen

Als „Multi-Target-Annotationen“ werden solche Annotationen verstanden, welche sich nicht nur auf einen Band bzw. eine Seite eines Bands sondern auf mehrere Bände oder Seiten (des selben oder verschiedener Bände) beziehen und somit quasi eine Verknüpfung zwischen diesen herstellen.

Um eine Annotation mit mehreren Targets erstellen zu können, muss die Entwurfsfunktion (siehe Kap. 5.7) verwendet werden:

Abb. 21: Laden eines Entwurfs zu einer anderen Seite

In Abb. 22 sehen Sie, wie die Annotation dargestellt wird, wenn man sich auf einer der annotierten Seiten befindet. Es wird ein Hinweis eingeblendet, dass diese Annotation weitere Bezüge hat.

Abb. 22: Anzeige der Annotation auf einer der annotierten Seite

Folgt man dem Hinweis zu den weiteren Bezügen („Alle anzeigen“), landet man auf einer Ansicht, bei der links die Annotation und rechts sämtliche Bezüge dargestellt werden (siehe Abb. 23). Aus dieser Ansicht kann zu den jeweils annotierten Seiten (zurück-)gesprungen werden.

Abb. 23: Anzeige der Annotation mit all ihren Bezügen

5.9 Korrekturen/Veränderungen der Annotationen

Sie haben die Möglichkeit, Ihre Annotationen beliebig oft zu aktualisieren. In solchen Fällen bleibt die Versionierung erhalten, sodass alle Änderungen nachvollziehbar bleiben.

Öffnen Sie die zu bearbeitende Annotation. Sofern die Annotation in Ihrem Namen (selbst oder stellvertreten) eingereicht wurde, finden Sie in der Button-Leiste am unteren Ende der Annotation den „Bearbeiten“-Button (vgl. Abb. 24). Klicken Sie darauf, um den Editor zu öffnen. Hier können Sie die nötigen Korrekturen, Ergänzungen usw. eintragen. Tragen Sie Ihre Änderungen ein, prüfen Sie die neue Vorschau und veröffentlichen Sie die neue Version (siehe Kap. 5.6).

Abb. 24: Button Editieren/Weitere Versionen

In der Online-Präsentation wird standardmäßig immer die aktuellste Version der Annotation angezeigt. Frühere Versionen werden gespeichert und können jederzeit wieder angezeigt werden. Die Historie ist über den ebenfalls am Fuß einer Annotation befindlichen Button „Weitere Versionen“ (siehe Abb. 24) zugänglich. Über diesen Button gelangen Sie zur Einzelansicht der Annotation, wo Sie die verschiedenen Versionen über eine Auswahlbox links oben ansteuern können (siehe Abb. 25).

Abb. 25: Versionen

6 Antworten/Kommentieren

Sie haben zudem die Möglichkeit, auf Ihre eigenen sowie die Annotationen anderer Personen zu antworten bzw. diese zu kommentieren. Auch hierzu müssen Sie sich zuerst einloggen (siehe Kap. 3). Wenn Sie die entsprechenden Berechtigungen haben, sehen Sie am Fuß der fraglichen Annotation den Button „Antworten“ (siehe Abb. 26). Klicken Sie diesen An und gehen Sie wie beim Erfassen einer Annotation selbst vor (siehe Kap. 5). Am Ende klicken Sie auf „Veröffentlichen“, um die Antwort/den Kommentar freizugeben. Wie die eigentliche Annotation erhält die Antwort/der Kommentar eine persistente URL, mit der er verlinkt werden kann. Auch Antworten/Kommentare können editiert werden. Wie bei den Annotationen bleiben hier die früheren Versionen erhalten.

Abb. 26: Button Kommentieren

7 DOI-Vergabe

Wer die Berechtigung hat, für Annotationen DOIs zu vergeben (im Moment sind das nur die Moderatoren), sieht in der Kopfzeite der Annotation einen Button mit einem Einkaufswagen-Symbol und der Beschriftung „+DOI“ (siehe Abb. 27). Nach Anklicken dieses Buttons erscheint ein weiterer mit der Beschriftung „DOI anfordern“. Wird dieser betätigt, wird (ggf. mit einigen Minuten Verzögerung) im Hintergrund eine DOI für die entsprechende Annotation/Antwort erzeugt. Ab diesem Moment erhalten auch alle weiteren Versionen der Annotation/Antwort eine DOI. D.h., es gibt eine DOI, die jeweils auf die neueste Version der Annotation/Antwort verweist und DOIs, die direkt zur jeweiligen Version führen.

Abb. 27: Button DOI anfordern

8 Beispiele

Abb. 28: Beispiel cpg148
Abb. 29: Beispiel Welscher Gast
Abb. 30: Beispiel Lorscher Kodex

9 Kontakt