This is an Annotation Server which is compatible with IIIF and Mirador. This Annotation Server includes a copy of Mirador so you can get started creating annotations straight away. The annotations are stored as linked data in an Apache Jena triple store by default. It is also possible to store the annotations in SOLR.
For details see IIIF Search
To verify you have the correct package installed, you can run the following command from a terminal or command prompt:
$ java -version # java version "1.11.0_102"
You should see version
Step 1: Download
Download the pre-built SimpleAnnotationStore by going to the Releases page:
Download the latest
sas.zip which might be hidden under the Assets drop down.
Step 2: Extract Zip file
Extract the zip file, on a Mac double clicking on the file will extract it. On windows make sure the zip file is extracted by right clicking on the zip file and selecting uncompress.
Step 3: Run the SimpleAnnotationServer
Open up a terminal or command prompt and do the following:
cd extracted_sas_directory/sas java -jar dependency/jetty-runner.jar --port 8888 simpleAnnotationStore.war
You should now see Mirador with the default example objects. You can choose any manifest to start annotating
SimpleAnnotationServer or SAS aims to fulfil two main use cases; an easy to install and get going annotation server and also a production quality annotation server. The guides below detail different operations you can undertake with SAS. In the next section it discusses how to develop with SAS and looks at some of the more complicated deployment options.
- Installing SAS on Windows
- Adding your own Manifests
- Populating the Annotation Store with IIIF Annotation List
- Using the IIIF Search API with SAS
- Downloading annotations and linking to static Manifests
- Java 11 with JDK (Java Development Kit, not just the Runtime)
To begin working with Mirador and the Simple Annotation Server do the following:
- Download code
git clone https://github.com/glenrobson/SimpleAnnotationServer.git
- Move into the SimpleAnnotationServer directory.
- Start the jetty http server
- Start Annotating
Navigate to http://localhost:8888/index.html
You should now see Mirador with the default example objects. You can choose any manifest to start annotating.
There are a number of docker files in the docker directory with different backend configurations. For details on the different options see the dev guide but to run the basic SAS instance with a Jena database you can run the following script:
which will use this Dockerfile docker/sas-tomcat/Dockerfile
- Developing with SimpleAnnotationServer
- Developing locally, Docker installs, deployment tricks and Jetty config
- Connecting Fuseki with Jena to view triple store
- SAS Endpoints
- Deploying to tomcat
- Using the Sesame RDF store
- Remote Annotation Store
- Migrating annotations from one backend to another.
Note this project doesn't currently contain Authentication although it is possible to secure the SAS web application with a single username and password using Apache forwarding. Plans for future developments include:
- Add ElasticSearch as a backend.
- Easy Deployment on AWS with ElasticSearch
- Web annotations
- Removing support for Sesame
- Support for Mirador 3
- Authentication – Shibboleth, Facebook/Google
- Annotation versioning
Please add an issue if there are other enhancements which would be useful.
- azaroth42 for help with JsonLd framing and other useful tips.
- Illtud and Paul for help with testing and fixing build problems.
- Dan for introducing me to Apache Jena and SOLR documentation.
- regisrob for help with the Mirador within code.
and finally thanks to the IIIF and Mirador communities which make all this cool stuff possible.