Instructions for Annotating and Commenting

Universitätsbibliothek Heidelberg

25.04.2025

1 Allgemeine Informationen

Die Universitätsbibliothek Heidelberg bietet angemeldeten Wissenschaftler:innen 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. Fig. 1).

2 Netiquette

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

• Annotationen und Kommentare sollen dazu dienen, die auf unseren Seiten publizierten Inhalte zu ergänzen. Sie sollen inhaltlich fundiert sein und wissenschaftlichen Ansprüchen gerecht werden. Argumente sollen durch nachprüfbare und belegbare Fakten nachvollziehbar sein.
• Beleidigende, diskriminierende und diffamierende Formulierungen sind ausdrücklich untersagt.
• Verzichten Sie auf jede Art von Werbung.
• Bitte stellen Sie keine urheberrechtlich geschützten Inhalte – Filme, Fotos – ein, an denen Sie keine Rechte besitzen.
• Bitte veröffentlichen Sie keine persönlichen oder nicht öffentlichen Daten – auch nicht von Dritten. Hier gilt der allgemeine Schutz persönlicher Daten.

In ausgewählten Fällen, z.B. bei besonders ausführlichen Annotationen mit Miszellencharakter, werden diese auch in der Bibliotheksdatenbank K10plus katalogisiert, so dass sie in den üblichen nationalen und internationalen Katalogen nachgewiesen sind.

Beispiel:

3 Register, log-in and obtain rights

If you want to become part of the virtual research community of the “Heidelberger historische Bestände - digital”, you must be registered for this and have annotation rights. If you are a member of a research institution (university, college, Max Planck Institute or similar), you can usually register via your institution. To do so, click on the “Login” button. A selection menu of the identity provider Shibboleth appears. There you can select your institution and log in with your user ID and password.

In addition, your ID must be assigned the authorization to create new annotations or comment on existing annotations.

3.1 You are not yet logged in

If you are not logged in yet, you will be offered a “Login” button:

You have a user account at Heidelberg University, at a DFN-AAI participating Shibboleth identity provider (international research network of universities, scientific institutes etc.) or at Arthistoricum or Propylaeum?

If you do not have such an account, please send an e-mail to Effinger@ub.uni-heidelberg.de.

Otherwise, log in to the user account. Click Login or alternatively use the login function of the application (see Fig. 4).

The log-in page appears, where you can select your institution Fig. 5) and log in there Fig. 6):

You are now logged in and can annotate (see below).

3.2 You are already registered but not yet activated for annotating

If you click on the ‘New annotation’ button and see the ‘Not authorized’ message, then your account has not yet been assigned annotation rights:

You need to request annotation rights. To do so, please click on the button that shows the missing annotations. You will be redirected to a form where you will be asked for your name, email address, and your research interest in the digitized material to be annotated. If your scientific interest is sufficiently proven, you will receive an account and will be activated.

3.3 You are logged in and enabled to annotate

The green “New annotation” button shows that you have the permission to annotate. You can start annotating and commenting immediately.

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 jede Annotation bei Einreichung sofort veröffentlicht wird, ist eine Korrektur nur durch die Erstellung einer neuen Version der Annotation möglich (s.u.). Es kann daher sinnvoll sein, für erste Versuche die Testumgebung zu nutzen.

5 Annotationen erstellen

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

• Auf Bandebene: Sie machen eine Anmerkung zu einem kompletten Buch.
• Auf Seitenebene: Sie machen eine Anmerkung zu einer einzelnen Seite oder zu mehreren Seiten.
• Einzelne Bereiche innerhalb einer Seite oder mehrerer Seiten (Bildausschnitte markieren): Sie machen eine Anmerkung zu einem bestimmten Bereich auf einer einzelnen Seite.

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 einen oder mehrere Bereiche einer bestimmten Seite beziehen, in der Ansicht der Einzelseite des Faksimiles an.

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

Klicken Sie auf Neue Annotation.

Es öffnet sich der Annotationen-Editor Fig. 9).

5.1 HTML-Editor, Sprache, Lizenz und Autorschaft

Geben Sie im Titelfeld einen prägnanten Titel ein. Dieser Titel wird den Lesenden immer angezeigt, auch, wenn die Annotation selbst zugeklappt dargestellt wird (z. B. weil es mehrere Annotationen auf einer Seite gibt). Der Titel soll aus unformatiertem Text bestehen, und kann daher auch nicht im Editor formatiert werden. Sollte es aus inhaltlichen Gründen notwendig sein, lassen sich Sonderschriftzeichen mit impliziter Schriftformatierung einfügen. Das sollte jedoch ein 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.

• bold / fett
• italic / kursiv
• underlined / unterstrichen
• quote / Zitat
• unordered list / Aufzählung
• ordered list / Nummerierte Aufzählung
• paragraph style / Stil des Absatzes
• insert image / Grafik einfügen (via URL)
• insert video / Video einfügen (via URL)
• insert or edit link / Link einfügen oder bearbeiten
• undo / rückgängig
• redo / wiederholen

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 verpflichtend.

Bei der Lizenz haben Sie 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. Fig. 10).

Den Nutzenden und Kommentierenden Ihrer Annotationen wird angezeigt, unter welchen Voraussetzungen sie diese verwenden können.

Annotation ist gemeinfrei und kann beliebig genutzt und weiterverbreitet werden.

Annotation kann frei genutzt und weiterverbreitet werden, solange Sie die/den Autor:in nennen und auf diese Seite verweisen.

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

• Persönliche Nennung/Name (Standard),
• Einrichtung, unter deren Namen eine Annotation erfolgen soll oder
• Projektname als Autor einer Annotation.

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

5.2 Bildausschnitte (Zonen) markieren

Um einen bestimmten Bereich innerhalb eines Digitalisats zu markieren und zu annotieren, klicken Sie auf den Registerreiter Zonen (vgl. {Fig. 12}).

Es öffnet sich der Zonen-Editor (vgl. {Fig. 13}).

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:
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 entweder außerhalb der Zone doppelklicken oder zum Anfangspunkt zurückkehren und diesen anklicken.

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 . 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 Zonen zu löschen, klicken Sie auf das 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 .

• Im Standard-Modus (links) können Sie die Größe von Zonen anpassen, sie drehen und sie bewegen.
• Im Eckpunkte-Modus (rechts) können Sie die Eckpunkte von Zonen bearbeiten und löschen.

Der aktive Modus wird mit einem hellroten Hintergrund markiert.

Standard-Modus: Wenn Sie auf eine Zone klicken, erhält sie einen roten Rahmen (vgl. {Fig. 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.

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.

• Um neue Eckpunkte zu erzeugen, gehen Sie zu einer Kante, halten Sie die Umschalttaste gedrückt, klicken Sie und bewegen anschließend die Maus.
• Auch die Wendepunkte einer Linie können in diesem Modus bearbeitet werden.
• Es ist zudem möglich, Eckpunkte zu einem Kreis oder einer Ellipse zu erzeugen:

Wichtig: Im Eckpunkte-Modus können Zonen nicht bewegt werden! Dies muss im Standard-Modus 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.)

5.4 Verlinkungen eingeben

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. oder Eigenschaften der VRA-Ontologie können ausgewählt werden. (VRA ist die Visual Resources Association, eine gemeinsame Arbeitsgruppe nordamerikanischer Bibliotheken und Museen.)

5.5 Vorschau

Bevor Sie Ihre Annotation speichern, können Sie diese unter Vorschau ansehen und überprüfen. Wenn Sie keine weiteren Änderungen oder Ergänzungen mehr vornehmen möchten, 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. Fig. 19).

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 Ch. 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 Ch. 5.7).

5.7 Annotationen zwischenspeichern, Entwürfe, Vorlagen

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

• später weiter daran zu arbeiten oder
• die Annotation als Vorlage für nachfolgende Annotationen zu verwenden.

Wechseln Sie dazu auf den Reiter Entwürfe.

Dort können Sie

• Ihre aktuellen Eingaben unter einem selbstgewählten Namen abspeichern.
• wählen, ob die gespeicherte Annotation als Vorlage gespeichert werden soll. Bei Vorlagen wird der Bezug zur aktuellen Seite nicht mit gespeichert. Um eine Vorlage zu erstellen, aktivieren Sie bitte die Checkbox Vorlage.
• vorhandene Entwürfe oder Vorlagen laden. Achtung: Dabei gehen die aktuellen Eingaben im Editor verloren.
• vorhandene Entwürfe oder Vorlagen löschen.

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

Das Diskettensymbol rechts oben im Editor speichert ebenfalls den Entwurf. Das kann nützlich sein, wenn die Fußzeile des Editors gerade nicht im Bild ist, weil sie z.B. durch eine sehr lange Stichwortliste nach unten geschoben wird.

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 Login-Seite. 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 der neue Entwurf im Editor angezeigt, 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 Ch. 5.7) verwendet werden:

• Voraussetzung ist, dass Sie für alle Seiten, auf die die Annotation verweisen soll, die Berechtigung haben, Annotationen anzulegen.
• Erstellen Sie zunächst auf der ersten Seite im Editor eine Annotation (ggf. auch unter Hinzufügung von Zonen im Zonen-Editor).
• Speichern Sie diese Annotation zunächst als Entwurf. Sie erscheint im Entwurfsreiter unter Entwürfe zur aktuellen Seite.
• Rufen Sie nun die weitere Seite auf, die mit dieser Annotation verknüpft werden soll und verwenden Sie dort ebenfalls die Funktion Neue Annotation.
• Wechseln Sie dann auf den Reiter Entwürfe und laden dort den zuvor gespeicherten Entwurf, der nun unter der Überschrift Entwürfe zu anderen Bänden/Seiten erscheinen sollte (siehe Fig. 21).
• Im oberen Bereich des Editors sollte eine Meldung erscheinen, dass der Bezug der Annotation angepasst wurde.
• Im Vorschau-Reiter gibt es unterhalb ihrer Annotation eine Liste der Bezüge. Die aktuelle Seite sollte dort nun ganz oben stehen, die zuvor bezogenen Seiten darunter.
• Wenn Sie sich auf nur einen Teilbereich der aktuellen Seite beziehen wollen, wechseln Sie zum Zonen-Editor und markieren Sie die entsprechenden Bereiche.
• Sie können die somit erweiterte Annotation bei Bedarf nun wieder als Entwurf speichern, um noch weitere Bezüge hinzuzufügen.
• Wenn alle Bezüge eingetragen sind, prüfen Sie auf im Vorschau-Reiter nocheinmal die Reihenfolge der Bezügeliste. Sie können Einträge nach oben bewegen, indem Sie den Entwurf nochmal auf der betreffen Seite öffnen. Die Anpassungsmeldung sollte dann informieren, dass der Bezug nach oben geschoben wurde.
• Wenn sowohl die Vorschau als auch die Bezügeliste gefällt, veröffentlichen Sie die Annotation.

In Fig. 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.

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 Fig. 23). Aus dieser Ansicht kann zu den jeweils annotierten Seiten (zurück-)gesprungen werden.

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. Fig. 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 Ch. 5.6).

• Obacht bei Multi-Target-Annotationen: Bedenken Sie, dass beim Öffnen im Editor die aktuelle Seite an den Anfang der Bezügeliste geschoben wird! Öffnen Sie die Annotation daher auf der Seite, die oben stehen soll.

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 Fig. 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 Fig. 25).

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 Ch. 3). Wenn Sie die entsprechenden Berechtigungen haben, sehen Sie am Fuß der betreffenden Annotation den Button Antworten (siehe Fig. 26). Klicken Sie diesen an und gehen Sie wie beim Verfassen einer Annotation selbst vor (siehe Ch. 5). Am Ende klicken Sie auf Veröffentlichen, um die Antwort/den Kommentar freizugeben. Wie die Annotation selbst erhält auch 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.

7 DOI-Vergabe

Wer die Berechtigung hat, für Annotationen DOIs zu vergeben (im Moment sind das nur die Moderierenden), sieht in der Kopfzeile der Annotation einen Button mit einem Einkaufswagen-Symbol und der Beschriftung +DOI (siehe Fig. 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 ein DOI für die entsprechende Annotation/Antwort erzeugt. Ab diesem Moment erhalten auch alle weiteren Versionen der Annotation/Antwort einen DOI. D.h., es gibt einen DOI, der jeweils auf die neueste Version der Annotation/Antwort verweist und DOIs, die direkt zur jeweiligen Version führen.

8 Beispiele

9 Kontakt

• Dr. Maria Effinger
  effinger@ub.uni-heidelberg.de
  +49-6221-543561
• Dr. Karin Zimmermann
  zimmermann@ub.uni-heidelberg.de
  +49-6221-542592
• Bettina Müller M.A. 
  Mueller_Bettina@ub.uni-heidelberg.de
  +49-6221-543528