kwarc / kat Goto Github PK
View Code? Open in Web Editor NEWKAT: An Annotation Tool for STEM Documents
Home Page: http://kwarc.github.io/KAT
License: Other
KAT: An Annotation Tool for STEM Documents
Home Page: http://kwarc.github.io/KAT
License: Other
It would be nice if there was a help button in the annotation bar. That might lead to a FAQ or something (which would have to be written; maybe on the github wiki).
After successfully making the first annotation in a page, the next click on "Annotate" simply scrolls the page to the top.
The issues only appears some of the time, mostly on larger selections (e.g. an entire paragraph). And I still had to dance around issue #8 so they might or might not be related.
I am using FF 27 on Ubuntu 13.
I think we should think of annotation frames instead of concepts, So we should have . We should also update the manual.
I executed the commands in the readme.md, but I had trouble finding out what npm
is and how to install it. Say something about this or link to a good description.
Nathan Carter told me at CICM that he may have a library we could use for visualizing nested/overlapping annotations in KAT. They have (just) reworked Lurch (see http://lurchmath.org/) for the web, and have developed a CSS library for the bubbly visualization of their "annotations" (to be relesased in the next days apparently). @tkw1536 @LiftnLearn, this may be a good thing to look at, I will get a demo in the next days. I will keep you posted.
It would be good to have a "report issue" button in the annotator bar. It should just link to the issues page on github. Then our users (with Randa we may have one) can more easily report issues.
We are currently not making progress on CorTeX, therefore we should think of other venues for KAT integration. A natural one is integration into MathHub, where we can use KAT with the OMDoc KannSpec for semantic annotation.
This is the KAT-side tracker bug, to be used for planning. The MathHub-side one is KWARC/MathHub#164 cc: @m-iancu @LiftnLearn
Here are the things that need doing (from the KAT side things are relatively simple)
I would like to have a nice demo setup like JOBAD has. Once that is done, we should also change the demo URL in kwarcpubs.bib
.
The popover stays fixed when you scroll and there are still scenarios where you can close the sidebar and the popover stays.
Still to be done:
The title is "Annotator Testing", I think it should be "KAT Demo".
We want to read RDF XML back in, that means we cannot use the templating engine to generate the XML. Instead we decorate
<concept>
element in a KannSpec with a rdftype="o:foo"
attribute, this generates a RDF triple of the form <rdf:type rdf:resource="o:foo"/>
.<field>
element with a ```rdfpred="o:bar" attribute, this generates an RDF triple
<o:bar>baz</o:bar>
if the type of the field is text
<o:bar rdf:resource="#ref#"/>
, if the type of the field is reference
and #ref#
the value of the reference.<o:bar>#val#</o:bar>
if the type of the field is select
and #val#
is the value of the chosen option.<o:bar rdf:resource="#obj#"/>
if the type of the field is select
and the chosen option carries an attribute rdfobj="#obj#"
.In the CorTeX workflow, we have many annotators working on the same corpus of documents. Hence, they also will annotate with the same ontology.
To achieve this, we need a way for KAT to pick ontologies server-side and let the client use them directly. Since I am writing the KAT-enabled page in the first place, I can add any parameters necessary to make that happen, as long as KAT is able to fetch the ontology from the server.
I would appreciate help with understanding exactly how to do that.
I'm not sure what it should do, but at the moment it seems to rerender the whole page.
I guess we should GPL-license KAT. There are lots of good templates around.
It seems like sometimes the tooltip doesn't disappear after you stop hovering over the annotation; although I'm not sure yet when exactly it appears nor if it's a KAT or JOBAD issue. Also I think there shouldn't be any tooltips shown under the sidebar when it's open.
The installation instructions in readme.md
end in
take a look at the demo.
Give a few sentences that explain what to expect and what can be done, link to the paper. In particular mention
We need some storage solution for KAT. The most natural way to do that is to integrate KAT into CorTeX. This also needs to be documented in the manual.
When we have the "show all annotations" (the little eye) in the KAT control panel, then the visualization boxes of both source and target of the annotation frames should be shown .
The browser window should automagically focus the annotation we're looking at.
At the moment the annotations are shown in the order they were created, but it might be useful to show them in the logical order in which they appear in the document.
The KannSpec stanford.xml
was never complete in the RDF templates, and so the new version (see #15) does not validate, since we do not have rdfpred
attributes on the <field>
elements. These need to be systematically added (the ontology at http://acoli.cs.uni-frankfurt.de/resources/olia/stanford.owl should have the respective relations).
The current workflow of: "open browser, download text, insert KAT, annotate" is tedious and inefficient if you would have a corpus with multiple similar articles.
I was thinking of integrating KAT into a Firefox extension (I've worked a lot with Chrome extension, but I know FF is very similar so it shouldn't be a problem) which would be a permanent button in your browser. Therefore whenever the user would want to annotate a document they would click the button and the system would be inserted on top of the current webpage.
In readme.md
I see the line
# Whenever you update you will have to re-run this command.
and it is unclear to me which command it pertains to, and when to re-run, when I update grunt or KAT?
It might be much easier to have a point and click feature which allows users to select the current tag by clicking on it. Generally relevant content is contained within the tag - in the case of MathML in a math tag. This can offer a much smoother and more precise workflow which would not be subject as much to the change of content.
I have recently updated the code to just use the color of the last annotation created, but this should be solved in a different way. Maybe we should mix colours.
The code where the color is determined is here:
https://github.com/KWARC/KAT/blob/dev/src/KAT/storage/annotation.js#L469-L474
Clicking on it should display general information about the field (i. e. the contents of the tag) and optionally validations it has to pass.
When you want to open/close the sidebar by hovering over the bar and have an edit/create-field open, then the wrapper seems to block the sidebar where the field is on a vertical level.
Getting an error:
TypeError: result[key] is undefined
sometimes when making selections. In that case not bubble to annotate shows up.
We could possibly use something like doT
You can't reach the menu at the very bottom since it goes out of the screen.
and reference the manual there. This now has more up to date installation instructions, so I think the ones that are there can go.
I get
Michaels-MBP:KAT kohlhase$ grunt serve
Loading "jsdoc-ng-task.js" tasks...ERROR
>> Error: Cannot find module '../node_modules/jsdoc/node_modules/requizzle'
Running "jshint:all" (jshint) task
>> 15 files lint free.
Warning: Task "jsdoc-ng" not found. Use --force to continue.
Aborted due to warnings.
but grunt serve --force
works after some complaing.
The function KAT.storage.gui.getRange(...) doesn't seem to include the math expressions.
I have followed the installation instructions in readme.md
, but when I annotate a symbol and enter a symbol name, clicking on save does not work, I can only cancel my way ouf of the dialogue. (this may be a consequence of using --force
in starting the grunt server.
Currently, there is a serialization method in Annotation.js that outputs JSON. For the CorTeX integration we need:
var rdf_string = service._annotationRegistry.getAnnotations(serialize:"RDF");
and that would already provide me with a serialized RDF document that I can insert back into CorTeX.
From what I am seeing at the moment, the KAT annotations are relative to the document. That works while you have a single document, but not for a corpus, where you want each annotation to point to an absolute URI for the document.
CorTeX passes that information along with the document body, so KAT should make use of it and we should decide on how. The simplest extension would be to add a setURL
method to the KAT service, or something on those lines.
We should use the element of the KAnnSpec for this. We also might have to change the templating.
possibly we just have to re-tokenise the sample document
A declarative, efficient, and flexible JavaScript library for building user interfaces.
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. ๐๐๐
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google โค๏ธ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.