Difference between revisions of "Help:Annotation"

From GATE
Line 1: Line 1:
Annotation is the process of text editing in which the editor tries to give more information about a specific text fragment or a word, making an annotation. <br />
+
Annotation is the process of text editing in which the editor tries to give more information about a specific text portion or a word. <br />
 
E.g. in an hypothetical letter written by Roberto Bellarmino to Claudio Acquaviva in 1599, we could find a text like this<br />
 
E.g. in an hypothetical letter written by Roberto Bellarmino to Claudio Acquaviva in 1599, we could find a text like this<br />
  
Line 5: Line 5:
  
 
This text brings two pieces of information:  
 
This text brings two pieces of information:  
# the existence of a letter sent by Acquaviva to Bellarmino before this one
+
# the existence of a letter sent by Acquaviva to Bellarmino, to which Bellarmino is answering
 
# the reference to a not better specified 'Pope'
 
# the reference to a not better specified 'Pope'
  
To help the readers to undestand the text, in a traditional printed edition the editor would add a footnote to outline his knowledge about these points.
+
To help the readers to understand the text, in a traditional printed edition the editor would add a footnote to outline his knowledge about these points; it is possible to add footnotes also here, anyway annotation is a more powerful way to give and organize information. Somehow annotation looks more like a traditional indexing process, with the difference that  <br>
 +
 
 +
Coming back to our hypothetical letter, let's see how to annotate.
 +
=== Edit and select the annotation toolbar ===
 +
By clicking on 'Edit' we enter in the edit mode. On the top of the edit window, we can select different toolbars: '''Advanced''', '''Special characters''', '''Help''', '''Edition''' and '''Annotation'''. To start annotation, select the '''Annotation''' toolbar. The top of the edit window will look like this:
 +
[[File:Annotation toolbar.png]]
 +
=== Annotation toolbar ===
 +
Within the annotation toolbar there are several buttons divided in two sections, '''Entities''' and '''Other'''. Each button allows to annotate different things.<br>
 +
 
 +
Entities
 +
* Name: used to annotate names of people (e.g. Roberto Bellarmino, Claudio Acquaviva etc.) or institutions (e.g. Congregation fo the Index etc.);
 +
* Place: used to annotate geographical places (e.g. Roma, Montepulciano etc.) and physical places (e.g Church of Saint Ignatius, Basilica of the Holy House of Loreto etc.)
 +
* Work: used to annotate references to printed or manuscript works that are univocally identified;
 +
* Object: used to annotate objects like scientific instruments;
 +
* Concept: used to annotate concepts (e.g. novitas, heresy, censorship etc.)
 +
* Language: used to annotate languages.
 +
<br>
 +
 
 +
Other
 +
* Marginalia: used to annotate printed or manuscript marginalia;
 +
* Image: used to annotate the presence of any kind of graphical apparatus on a page.
 
[[Category:Help pages]]
 
[[Category:Help pages]]

Revision as of 11:21, 14 January 2019

Annotation is the process of text editing in which the editor tries to give more information about a specific text portion or a word.
E.g. in an hypothetical letter written by Roberto Bellarmino to Claudio Acquaviva in 1599, we could find a text like this

Thanks for your letter and bring my greetings to the Pope.


This text brings two pieces of information:

  1. the existence of a letter sent by Acquaviva to Bellarmino, to which Bellarmino is answering
  2. the reference to a not better specified 'Pope'

To help the readers to understand the text, in a traditional printed edition the editor would add a footnote to outline his knowledge about these points; it is possible to add footnotes also here, anyway annotation is a more powerful way to give and organize information. Somehow annotation looks more like a traditional indexing process, with the difference that

Coming back to our hypothetical letter, let's see how to annotate.

Edit and select the annotation toolbar

By clicking on 'Edit' we enter in the edit mode. On the top of the edit window, we can select different toolbars: Advanced, Special characters, Help, Edition and Annotation. To start annotation, select the Annotation toolbar. The top of the edit window will look like this: Annotation toolbar.png

Annotation toolbar

Within the annotation toolbar there are several buttons divided in two sections, Entities and Other. Each button allows to annotate different things.

Entities

  • Name: used to annotate names of people (e.g. Roberto Bellarmino, Claudio Acquaviva etc.) or institutions (e.g. Congregation fo the Index etc.);
  • Place: used to annotate geographical places (e.g. Roma, Montepulciano etc.) and physical places (e.g Church of Saint Ignatius, Basilica of the Holy House of Loreto etc.)
  • Work: used to annotate references to printed or manuscript works that are univocally identified;
  • Object: used to annotate objects like scientific instruments;
  • Concept: used to annotate concepts (e.g. novitas, heresy, censorship etc.)
  • Language: used to annotate languages.


Other

  • Marginalia: used to annotate printed or manuscript marginalia;
  • Image: used to annotate the presence of any kind of graphical apparatus on a page.