Re: [orca-list] Troubles with text annotation tools

["David E. Price" <david ed price gmail com>]

Hi, Didier,


Thanks for your response. However, I'm afraid that I should have done a 
better job of explaining what I'm working on.


I'm part of a team working on an automatic programming task. Automatic 
programming is generating usable source code directly from 
specifications, and it tends to work in small domains of language. In 
this case, 2 groups have developed a number of machine learning tools 
building towards an automatic programming system. I, and 2 others, are 
tasked with creating "ground truth" annotations on specifications for 
5G. In other words, we need to read through the selected documents and 
annotate all of the information in those documents that will be needed 
to create source code.


The file format for these annotations normally is set up with the 
original text in a block at the start of the file, and the annotations 
are stored as metadata based on the character offset from the start of 
the original text. This is similar to what asciidoctor is doing, but we 
need the annotations to be based on character offsets, not line offsets.


When I referred to annotation tools using a web interface, I was not 
referring to doing the annotations in HTML. For instance, with Teamtat, 
you select the text you want to annotate, and controls appear to let you 
select the correct annotation tag. The highlight is then changed to a 
color to indicate which tag it represents, and the back end stores the 
metadata on the annotation type and the starting and ending offsets. 
When you have finished annotating the document, you can export the 
properly formatted annotation file or compare it to other people's 
annotation of the same document in order to test the consistency of the 
annotations across different annotators.


Each of the annotation tools I've tested so far have not responded when 
I highlight text within the web interface by providing access to the 
annotation controls (the ability to select an annotation type). I fear 
they are assuming that a mouse will be used, and they are looking for 
mouse events. I've tried using flat review to click and shift-click to 
highlight text with no appearance of the annotation controls. And, as I 
said before, I tried highlighting using the keyboard in focus mode and 
then shifting to browse mode to locate the annotation controls with no 
success.


If anyone knows of any ways that might work to select text and activate 
the annotation controls, I'd love to hear about them. Or, about an 
annotation tool that is accessible.


Thanks,


dave


On 12/11/21 12:53 PM, Didier Spaier via orca-list wrote:
> Hi,
>
> I don't know an answer using a web browser, i.e. editing an html document.
>
> But If you are ready to use a text format for a document you are writing I would
> suggest to use asciidoctor:
> https://docs.asciidoctor.org/asciidoc/latest/verbatim/callouts/
>
> or to write the text in LibreOffice Writer. In LibreOffice you ca can highlight
> the text you want to annotate then a (simulated with Orca) left click on it
> raise a drop down menu in which you can choose Insert a comment. Then the
> comment appears in a box with an arrow. Clicking on this arrow or in the small
> window allows to perform actions like Delete Format or mark as solved.
>
> Cheers,
> Didier
>
>
> Le 11/12/2021 à 21:01, David E. Price via orca-list a écrit :
> > Hi,
> >
> >
> > I am using Orca 3.36.2 on Ubuntu 20.04.
> >
> > I need to annotate text for a natural language processing project I'm working
> > on. I've been testing out a number of text annotation tools, and I've run into a
> > problem. These tools use a web-based interface and I haven't figured out a way
> > to access the functionality. I'm hoping someone on this list can suggest how to
> > make it work.
> >
> > An example is Teamtat (https://www.teamtat.org/). This is a free tool that
> > doesn't require you to set up an account and there are example projects to play
> > with.
> >
> > Once you have a file open for tagging, you are supposed to highlight the text
> > that you want to annotate. Once the text is highlighted, controls are supposed
> > to appear that let you select the correct annotation tag. I have been unable to
> > find any way, after highlighting the text to reach those controls. I have tried
> > highlighting the text in focus mode, then switching into browse mode to find the
> > controls, but never succeed.
> >
> > Does anyone have suggestions for how to access the controls after highlighting
> > text in the browser?
> >
> > Or, if you know of an annotation tool that is accessible, please let me know.
> >
> > Thanks,
> >
> > dave
> >
> > _______________________________________________
> > orca-list mailing list
> > orca-list gnome org
> > https://mail.gnome.org/mailman/listinfo/orca-list
> > Orca wiki: https://wiki.gnome.org/Projects/Orca
> > Orca documentation: https://help.gnome.org/users/orca/stable/
> > GNOME Universal Access guide:
> > https://help.gnome.org/users/gnome-help/stable/a11y.html
> _______________________________________________
> orca-list mailing list
> orca-list gnome org
> https://mail.gnome.org/mailman/listinfo/orca-list
> Orca wiki: https://wiki.gnome.org/Projects/Orca
> Orca documentation: https://help.gnome.org/users/orca/stable/
> GNOME Universal Access guide: https://help.gnome.org/users/gnome-help/stable/a11y.html