ProsopoCogito
("Prosopographical Recogito")
A fork of the Recogito 2 codebase, begun in 2017 to add SNAP-compatible person-search and annotation features to the platform. Agenda described in the outline of the OEDUc hackathon.
Recogito 2
![Project Stats](https://www.openhub.net/p/recogito2/widgets/project_thin_badge.gif)
Home of Recogito v2.0 - a Linked Data annotation tool for texts and images, developed by
Pelagios. Track our progress on
Waffle.io.
Prerequisites
- 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.)
Installation
- Clone this repository
- Create a copy of the file
conf/application.conf.template
and name it conf/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.conf
accordingly.)
- Type
sbt run
to 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
.
Importing gazetteers
Running in production
- 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 - type sbt 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!
License
Recogito v2.0 is licensed under the terms of the
Apache 2.0 license.