Home of Recogito v2.0 - a Linked Data annotation tool for texts and images, developed by Pelagios. Track our progress on Waffle.io.
- Java 8 JDK
- SBT (tested with version 1.0.2)
- PostgreSQL DB
- To use image annotation, you need to have the vips image processing system installed. If vips is not available on the command line, Recogito is set to reject uploaded images as 'unsupported content'. (Note: on Ubuntu, 'libvips-tools' is the package you need.)
- Clone this repository
- Create a copy of the file
conf/application.conf.templateand name itconf/application.conf. Make any environment-specific changes there. (For the most part, the defaults should be fine.) - Create a database named 'recogito' on your Postgres DB server. (If you want a different name, adjust
the settings in your
conf/application.confaccordingly.) - Type
sbt runto start the application in development mode. - Point your browser to http://localhost:9000
- Recogito automatically creates a single user with administrator privileges with username 'recogito' and password 'recogito'. Be sure to remove this user - or at least change the password - for production use!
- To generate an Eclipse project, type
sbt eclipse.
- A gazetteer dump file from the Digital Atlas of the Roman Empire (in Pelagios
Gazetteer Interconnection Format)
is included in the
/gazetteersfolder. - You can import this gazetteer to Recogito on the Gazetteer Administration page at http://localhost:9000/admin/gazetteers. Note that you need to be logged in with a user that has administrator privileges (e.g. the default 'recogito').
- WARNING the admin pages are work in progress. Don't expect any fancy functionality or styling there yet! Importing gazetteers can take a while, and there is no progress display yet. Bear with us. You can track progress through Recogito's JSON Place API at http://localhost:9000/api/place/search?q=*&pretty=true
- It's not possible to upload controlled vocabularies for persons, periods or events yet.
- To test production mode before deploying, type
sbt testProd - To change to a different port (than default 9000), type
sbt "testProd -Dhttp.port=9876" - For full production deployment, refer to the current Play Framework docs
- Be sure to set a random application secret in
conf/application.conf. Play includes a utility to generate one for you - typesbt playGenerateSecret. - Production deployment requires an installation of ElasticSearch v2.4.4. (Recogito will automatically create an embedded ElasticSearch index if cannot find a running cluster. However we strictly recommend this only for development purposes!).
- Last but not least: another reminder to remove the default 'recogito' admin user - or at least change its password!
Recogito v2.0 is licensed under the terms of the Apache 2.0 license.