Local IIIF Annotation server

Installation instructions are found here: https://dnoneill.github.io/annotate/help

Quickstart

1. Install Dependencies

• Vagrant
• VirtualBox 6.0.x. Note: VirtualBox 6.1.x currently does not work with Vagrant. Make sure to use 6.0.x or older.
• Git

2. (Optional). Fork repository and create own website. See GitHub pages instructions for steps. Otherwise use https://github.com/dnoneill/annotate.git for step 3.

3. Open Terminal(Mac/Linux)/Git Bash or Command Line(Windows). Clone this repository or clone forked repository and change directory:

   $ git clone https://github.com/[username]/annotate.git
   $ cd annotate
   
   

4. Start vagrant environment in terminal.

   $ vagrant up

5. Start Jekyll and Flask

   $ vagrant ssh
   [vagrant@localhost ~]$ cd /vagrant
   [vagrant@localhost vagrant]$ dos2unix run.sh #windows machines only
   [vagrant@localhost vagrant]$ ./run.sh
   
   

Navigate to http://localhost:5555/annotate/ to create annotations. Note Not all manifests load using Microsoft Edge. Firefox and Chrome are better alternatives.

Requirements for Development

• Ruby >=2.2
• Jekyll =3.8
• Bundler >=1.12
• Python3 (with pip and venv)

Development

• Clone this repository and navigate into it:

  $ git clone https://github.com/biblhertz/annotate.git && cd annotate

• Install dependencies:

  $ bundle install

• If it complains about Bundle 2.0 in Gemfile.lock, remove .lock file and repet :

  $ rm Gemfile.lock

• Create ENV, install Flask in ENV, start Flask and Jekyll

  $ ./run.sh

• In Debian you may need to use python3

  $ chmod +x run_deb.sh

  $ ./run_deb.sh