Cartographer App

The Cartographer App is used to provide placement information of zones of interest in (historical) documents. The first and foremost use case is the identification of bounding boxes of measures in music documents. It is a successor of the Vertaktoid, but other than that uses web technology and is thus platform independent. It optionally uses the Measure Detector for automatic recognition of measure positions, but allows manual correction of these results.

Important Tools and their Documentation

• Vectre, which is a VueJS version of Spectre CSS. See https://vectrejs.github.io/docs/#/pages/getting-started
• OpenSeadragon. See http://openseadragon.github.io/
• Annotorious OpenSeadragon Plugin. See https://recogito.github.io/annotorious/getting-started/osd-plugin/

Project setup

npm install

Compiles and hot-reloads for development

npm run serve

Compiles and minifies for production

npm run build

Run your unit tests

npm run test:unit

Lints and fixes files

npm run lint

Other approaach to linting which automatically fixes code and gives a nicer rendition of errors using snazzy

npm run test:lint

Customize configuration

See Configuration Reference.

Deploying to a subdirectory

In compile stage

docker build \
dockercontainer

Run

 docker run \
-e CLIENT_ID="your client id" \
-e CLIENT_SECRET= "your client secret"\
-e CALL_BACK= "your call back" \
-e VUE_APP_CALL_BACK=$CALL_BACK \
-e VUE_APP_PUBLIC_PATH="your subpath"
dockercontainer