diff --git a/assets/chrome.png b/assets/chrome.png deleted file mode 100644 index ceb9340..0000000 Binary files a/assets/chrome.png and /dev/null differ diff --git a/assets/firefox.png b/assets/firefox.png deleted file mode 100644 index 0969cee..0000000 Binary files a/assets/firefox.png and /dev/null differ diff --git a/assets/snippet.png b/assets/snippet.png deleted file mode 100644 index 4ade374..0000000 Binary files a/assets/snippet.png and /dev/null differ diff --git a/docs/User_Guide.md b/docs/User_Guide.md index 9753e09..f18806e 100644 --- a/docs/User_Guide.md +++ b/docs/User_Guide.md @@ -14,8 +14,10 @@ [neath](https://github.com/qurator-spk/neath) is developed at the [Berlin State Library](http://staatsbibliothek-berlin.de/) for data annotation in the context of the [SoNAR-IDH](https://sonar.fh-potsdam.de/) project and the [QURATOR](https://qurator.ai/) project. ### 2. User Guide + #### Technical Requirements [neath](https://github.com/qurator-spk/neath) runs locally as a pure HTML+JavaScript webpage in your web browser. No software needs to be installed, but JavaScript has to be enabled in the browser. Any fairly recent browser should work, but only Chrome and Firefox are tested. + #### Data format The data format is based on the format used in the [GermEval2014 Named Entity Recognition Shared Task](https://sites.google.com/site/germeval2014ner/data). Text is encoded as one token per line, with name spans encoded in the BIO-scheme, provided as tab-separated values: * the first column contains either a `#`, which signals the source the sentence is cited from, or @@ -82,6 +84,7 @@ No. TOKEN NE-TAG NE-EMB GND-ID url_id left,right,top,bottom The processing pipeline applied is documented in [Provenance](https://github.com/qurator-spk/neath/blob/master/docs/Provenance.md). We also provide some [Python tools](https://github.com/qurator-spk/page2tsv) that help with data wrangling. + #### Keyboard-Navigation | Key Combination| Action | @@ -127,15 +130,13 @@ We also provide some [Python tools](https://github.com/qurator-spk/page2tsv) tha #### Mouse-Navigation * use mouse wheel to scroll up and down * use navigation `<<` and `>>` to move faster + #### Image Support Provided facsimile images are available online via the [iiif.io](https://iiif.io/) Image API, [neath](https://github.com/qurator-spk/neath) supports the embedding of facsimile snippets into its interface to help with data annotation and correction. This further requires that OCR with word segmentation is applied to the image to determine bounding boxes for tokens. The iiif-image-url contained in the source ``#`` can then be used as a replacement for ``url_id`` in combination with the token bounding boxes as ``left,right,top,bottom`` to obtain the facsimile snippet url and display the image in the leftmost column. Clicking on the facsimile snippet opens up a new tab with a larger context. -![Screenshot](./../assets/snippet.png) - - #### Tagging * adding a tag * removing a tag @@ -146,17 +147,9 @@ The iiif-image-url contained in the source ``#`` can then be used as a replaceme * merging two tokens * splitting a token * sentence boundaries -#### Saving progress -[neath](https://github.com/qurator-spk/neath) runs fully locally in the browser. Therefore it can not automatically save any changes you made to disk. You have to use the `Save Changes` button in order to so manually from time to time. - -If your browser automatically saves all downloads to your `Downloads` folder, you might want to configure it so that it instead prompts you where to save. - -Configuration option in Firefox: -![Screenshot](./../assets/firefox.png) - -Configuration option in Chrome: +#### Saving progress +[neath](https://github.com/qurator-spk/neath) runs fully locally in the browser. Therefore it can not automatically save any changes you made to disk. You have to use the `Save Changes` button in order to so manually from time to time. If your browser automatically saves all downloads to your `Downloads` folder, you might want to configure it so that it instead prompts you where to save. -![Screenshot](./../assets/chrome.png) ### 3. Annotation Guidelines The most recent version of the [Annotation Guidelines](https://github.com/qurator-spk/neath/blob/master/docs/Annotation_Guidelines.pdf) is included in this repository.