@recogito/recogito-js
Version:
A JavaScript library for text annotation
65 lines (46 loc) • 2.01 kB
Markdown
<p align="center">
<br/>
<img width="270" src="https://raw.githubusercontent.com/recogito/recogito-js/master/recogitojs-logo-small.png" />
<br/><br/>
</p>
A JavaScript library for text annotation. Use it to add annotation functionality to a web page, or as a toolbox
for building your own, completely custom annotation apps. Try the [online demo](https://recogito.github.io/recogito-js/)
or see the [API reference](https://github.com/recogito/recogito-js/wiki/API-Reference).
<br/>
<br/>
## Installing
If you use npm, `npm install @recogito/recogito-js` and
```javascript
import { Recogito } from '@recogito/recogito-js';
import '@recogito/recogito-js/dist/recogito.min.css';
const r = new Recogito({ content: 'my-content' });
```
Otherwise download the [latest release](https://github.com/recogito/recogito-js/releases/latest) and
include it in your web page.
```html
<link href="recogito.min.css" rel="stylesheet">
<script src="recogito.min.js"></script>
```
## Using
```html
<body>
<pre id="my-content">My text to annotate.</pre>
<script type="text/javascript">
(function() {
var r = Recogito.init({
content: document.getElementById('my-content') // ID or DOM element
});
// Add an event handler
r.on('createAnnotation', function(annotation) { /** **/ });
})();
</script>
</body>
```
Full documentation is [on the Wiki](https://github.com/recogito/recogito-js/wiki). Questions? Feedack? Feature requests? Join the
[RecogitoJS chat on Gitter](https://gitter.im/recogito/recogito-js).
[](https://gitter.im/recogito/recogito-js?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
## License
[BSD 3-Clause](LICENSE) (= feel free to use this code in whatever way
you wish. But keep the attribution/license file, and if this code
breaks something, don't complain to us :-)