Text annotation: added manual entries

openatlas/display/classes_base.py

@@ -130,6 +130,8 @@ def add_note_tab(self) -> None:
 
     def add_buttons(self) -> None:
         self.buttons = [manual(f'entity/{self.entity.class_.view}')]
+        if self.entity.class_.name == 'source_translation':
+            self.buttons = [manual('entity/source')]
         if is_authorized(self.entity.class_.write_access):
             if not self.problematic_type:
                 self.add_button_update()

sphinx/source/entity/source.rst

@@ -16,13 +16,17 @@ Form fields
 * :doc:`/ui/name`
 * :doc:`type`
 * :doc:`/entity/artifact` - use if the source is part of an artifact
-* **Content** - a summary or the whole text of the source
+* **Content** - a summary or the whole text of the source.
+  :doc:`/tools/text_annotation` can be used.
 
 Can be linked via tabs to
 -------------------------
 * :doc:`event`, :doc:`actor`, :doc:`artifact`, :doc:`place`, and subunits it
   references
 * :doc:`reference` - link to the literature the source is documented in, e.g.
   editions of charters or secondary sources
-* **Translation** - add translations of the source or a comment
+* **Text** - add translations or similar to the source
 * :doc:`file`
+
+Text annotation
+---------------

sphinx/source/features.rst

@@ -70,6 +70,11 @@ Image Annotation
 With enabled IIIF it is possible to annotate images and link the annotation to
 entities via the :doc:`/tools/image_annotation` feature.
 
+Text Annotation
+---------------
+Text parts of sources can be annotated and linked to entities via the
+:doc:`/tools/text_annotation` feature.
+
 Data Exchange
 -------------
 OpenAtlas offers various possibilities to exchange data with other systems or

sphinx/source/tools/index.rst

@@ -8,6 +8,7 @@ Tools
    profile
    notes
    image_annotation
+   text_annotation
    map
    network
    anthropological_analyses

sphinx/source/tools/text_annotation.rst

@@ -0,0 +1,39 @@
+Text annotation
+===============
+
+.. toctree::
+
+The text annotation feature allows for marking text in a
+:doc:`/entity/source` (or source text) adding a comment and/or link to an
+entity. In that way the mention of a person, place, event ... can be linked to
+entity in OpenAtlas.
+
+Usage
+-----
+A text can be annotated when when adding or updating a :doc:`/entity/source`
+(or source text) with following steps:
+
+* Mark the specific text part in the source with the left mouse button
+* Click on the **Annotate** button above the text field
+* Select the entity which is releated to the annotation and/or
+* Add a comment
+* Click on add
+* Press the save button of the form to submit it
+
+After that the text annotations should already be visible in the source detail
+view:
+
+* Links to other entities are displayed
+* With mouse over you can read the comments
+
+Limitations
+-----------
+This is still considered an experimental feature and will be tested and
+improved. Feedback about it is welcome.
+
+**Current limitations**
+
+* Only entities that are already linked with the source can be chosen for
+  annotation
+* It is not possible to annotate over line breaks
+* Labels and messages of the annotation tool are available only in English