Overview

mirador-annotations is a Mirador 3 plugin that adds annotation creation tools.

https://github.com/ProjectMirador/mirador-annotations

This time, I tried combining it with the following SimpleAnnotationServer, and this is a memorandum of the process.

https://github.com/glenrobson/SimpleAnnotationServer

Preparing SimpleAnnotationServer

Follow the Getting Started guide below.

https://github.com/glenrobson/SimpleAnnotationServer#getting-started

When you access http://localhost:8888/index.html, the following screen is displayed.

The endpoint appears to be http://localhost:8888/annotation/, which displays a list of registered annotations (initially empty).

This endpoint will be used from Mirador 3.

Preparing Mirador 3

From Source Code

Clone and launch the source code from the following site.

https://github.com/ProjectMirador/mirador-annotations

gcnnidpptmmmciirlruoa#nndeonsrpth-matartnitpnso:t-/af/togirioctnehsub.com/ProjectMirador/mirador-annotations

When you access http://localhost:3000/, the following screen is displayed.

Configuring the Adapter

In demo/src/index.js, import SimpleAnnotationServerV2Adapter and specify the previously launched SimpleAnnotationServer as the endpoint (here, endpointUrlV2).

iiiiiccc}mmmmmmooo;ipppppnnna}iw}w}rooooosssn,di,i]arrrrrtttnae:ndsnl,dtttttdxdeidooeectap'ofdoarmaLASnnoaaapodwaewd.inoniddntddtre:uBsevrncnmppfiaaetmla:diaoaopooiopprLo{trMedtltliigntt:o'SO[awoaSoenn:eec,ip{nertttAtt=rr(adeirioAnUU{::clenf(fordnrr{aSBBecrnaaoll((ntaysooPgptVccvorDtnmleta=2aaarPe:fuAetnnsaafi'gdri'=vvIgna'gmiaohaadeeuh,inpfnt'ss)AlltrstrSthIIn:tt[aeoeptdd=n:p.dfrmr:t))>o's.orv/ptat:.rfe/:==nanr/amrr1/>>etnu/ndoV2/wioeinim270nnot,iosA..eeSnaittd00wwistfaa..m:i.tesp00LApohisrt..onlfnaoce10cneasrnssr::aoAl'vPrrA38ltns,alccsnf08Soneru/'rnr08tto,dgi;co08oAtaintm//rdarndLoaaaattseotnngpim]xcAnnetodu)'adooAenis;;lattdrSseSpaaa(eputtttpcrlmoe/iitavasrrsooeney.a'rnnrvrog;cs'(aVare/';`s2ngAS;lIAn/dioddomamc,atappapantllettieeSneifrAtdroe'nop(ns;nroctoaiaJstgnnS/aetvOot:UaNbi/rsjo/lIeen?)dxcSc,,pteao/rner2vvnt9ead9rspb8VIou42dit3A=nt'd$to,a{UnpcrtalenVrv2'a);s,Id}`),

Modifying the Adapter

As noted in the following pull request, a partial modification to the adapter is required.

https://github.com/ProjectMirador/mirador-annotations/pull/55

In createV2Anno, it was necessary to remove .id from the part that specifies the Canvas URI.

s}tCac}rrto;eein''mo}tacs@@on,cuttctt:'forecoyi@upnsrvnpv{tlye2teaylvaaae'tp:i2tnx:iedaVento'vn2Vo'n:3in2:o:afoaA=an;nn':oninn{hAoaotootna:.t(tn:Stiavpocpast3:toeria/amcgSon/tmieAnniieftSoioni.-f)intcsgrf'iRoeo{.,neunmigsreo'ocra/,ueaar,tVpce3ied/'ap,nr.neiosdte,anttiaotnion/2/context.json',

Result

Annotations were registered as shown below.

They were also registered in SimpleAnnotationServer as follows:

{}"""""]"]"]"@@ddr,o,m,@itcce{}n{}o"cdytts"too"peeo"""":""}"}"ian:erru@hfc@w,s,fv:t"mmrttoh[ti""e""}"}uace":sscytrayt@@l@d,iltoxh::eppmrphitete""t""limtt"cm"e:aseidycyf@ve@v"om"toro:"/t""n"ptpatamta:ne:paed:/"::":eoeuyl"yl"n::ai[d::"r"lpu:pu":t"/Atf"e""":":teeeehih/neidv"<o{h:"""{""t[nt0ndec.tpat"":::::tgt.o"dtle>:ts{op"p0t:"ylxSpca{""""s:.a:pgtps::oxo<:/0t"ece:MCayas//.i2"s.h<c/ah:w:v/i0o02:ot/i/noFhSgii:n20Trmpfiiir=vii8"32egl>iifca8gxif8,-3x.""cieeg3Smf.80-tu,Rfs"m7el.i880"ke.t,e,lnho/-8,/sh"n1esa/a1-soat7c=ran81aurS0t'vpnT8srve5ohaio0T/cal,rtr/t90fere3"tdpa:9u"dc8,part0:l,at2:rei60lro,/tso:6_tr3/men1:tm"4wun/21eu,3wst1"2xs"wea6,"te.ut9,"uwmi2:m3so3s..n1".oo/7orr21rgg/7g//c2"/2mo7,m0an9a0nt9n0ie"i/fx,fsetevs.sgtjt'sss>/o/<onopb"bajjteehccttx//m22l99n99s88=44\33"/"hc,tatnpv:a/s//wcwawn.vwa3s.-o4r7g1/724080906/"svg\"d=\"M836.6688,1704.92666h190.98836v0h190.98836v171.69267v171.69267h-190.98836h-190.98836v-171.69267z\"data-paper-data=\"{"strokeWidth":1,"rotation":0,"deleteIcon":null,"rotationIcon":null,"group":null,"editable":true,"annotation":null}\"id=\"rectangle_21042e1d-1663-4d00-b5f0-2fa6437fc8fb\"fill-opacity=\"0.00001\"fill=\"#00bfff\"fill-rule=\"nonzero\"stroke=\"#00bfff\"stroke-width=\"1\"stroke-linecap=\"butt\"stroke-linejoin=\"miter\"stroke-miterlimit=\"10\"stroke-dasharray=\"\"stroke-dashoffset=\"0\"font-family=\"none\"font-weight=\"none\"font-size=\"none\"text-anchor=\"none\"style=\"mix-blend-mode:normal\"/></svg>"

The above results could be retrieved by specifying the Canvas URI as follows:

http://0.0.0.0:8888/annotation/search?uri=https://iiif.harvardartmuseums.org/manifests/object/299843/canvas/canvas-47174896

The endpoint documentation was available at: https://github.com/glenrobson/SimpleAnnotationServer/blob/master/doc/Endpoints.md

Summary

I tried the mirador-annotations plugin and SimpleAnnotationServer with Mirador 3. I hope this serves as a useful reference.