An annotation platform designed for teaching and learning in the humanities, and with aspirations to more general use.
There are two servers required to run this application. This one, and the MIT Annotation Data Store. You MUST get the Annotation server running to be able to create or view annotations.
Set up Rails (if you haven't yet, try: Thoughtbot's Laptop repo)
Do these first, regardless if you are installing locally or on Heroku:
git clone git@github.com:hyperstudio/Annotation-Studio.git annotation-studiocd annotation-studiobundle install- Copy
config/application.sample.ymltoconfig/application.ymlDo not check this into git - Update
config/application.ymlwith your configuration preferences: See file for in-line comments - Update the
API_CONSUMERvalue in application.yml to point to the full URI of your running instance of MIT-Annotation-Data-Store
These are rough instructions on how to get Annotation Studio working on your local development machine or server
- Install and setup PostgreSQL-server (see Laptop repo above)
- Create a PostgreSQL database
- Copy
config/database.sample.ymltoconfig/database.ymlDo not check this into git - Add PostgreSQL connection URI into database.yml
Rake db migraterake db:seedrails s
If you would like to run the application on Heroku (recommended), do the following
- Create a Heroku app
heroku apps:create $APPNAME - Add the Heroku PostgreSQL add-on
heroku addons:add heroku-postgresql- Don't worry about providing db configuration, Heroku will do it for you
- Use Figaro to load your
application.ymlinto environment variables and communicate them to Herokurake figaro:heroku[$APPNAME]
Thanks to OKFN and Nick Stenning for creating The Annotator: https://github.com/okfn/annotator/ which is bundled here.
- Lab: MIT HyperStudio
- http://hyperstudio.mit.edu/
- Developer: Jamie Folsom
- jfolsom@mit.edu
GPL2