source: gs3-extensions/iiif-servlet/trunk/src/README.txt@ 38200

First time use:

    ./PREPARE-GSDL-AND-COMPILE-CORE.sh
    ./PREPARE-CANTALOUPE.sh
    ./COMPILE-CANTALOUPE.sh
    ./INSTALL-CANTALOUPE-WAR.sh
    
Bump to cantaloupe v4.03 (as some of the URLs of maven dependencies in the older version were no longer available)

====
To make use of this extension in GS3, add the IIIFPMH service to a collection's
collectionConfig.xml file:


    <serviceRack name="IIIFPMH">
        <setName>intermuseprogammes</setName>
        <setDescription/><!-- uncomment the following and set the name attribute if 
           you want this collection to be part of a super set. --><!--<oaiSuperSet name="xxx"/>-->
        <ListMetadataFormats><!--What metadata sets to support for this collection. You can select any set that is specified in OAIConfig.xml. To use a new set, you need to add a set definition in OAIConfig.xml, then reference it here, like:
               <metadataFormat metadataPrefix="prefix"/> -->
            <metadataFormat metadataPrefix="oai_dc"><!-- you can customize the mappings by adding elements in here. See resources/oai/OAIConfig.xml for the format--></metadataFormat>
        </ListMetadataFormats>
    </serviceRack>

(Note: the IIIF service was strongly based off OAIPMH)



General form of IIIF Image Server requests:

  http://localhost:8383/gs-cantaloupe/
  http://localhost:8383/gs-cantaloupe/admin
  http://localhost:8383/gs-cantaloupe/iiif/2


  http://localhost/gs-cantaloupe/iiif/2/<site>:<col>:<docid>/info.json

  http://localhost/gs-cantaloupe/iiif/2/<site>:<col>:<docid.subsection>/info.json




Specific example IIIF image server requests:

  http://localhost:8383/gs-cantaloupe/iiif/2/intermuse:programmes:HASHc5edd00c6c45cc68ce9532/info.js
  http://localhost:8383/gs-cantaloupe/iiif/2/intermuse:programmes:HASHc5edd00c6c45cc68ce9532/full/full/0/default.jpg


For an image that is a sub-section:

  http://localhost:8383/gs-cantaloupe/iiif/2/intermuse:programmes:HASHc5edd00c6c45cc68ce9532.1/info.js

  http://localhost:8383/gs-cantaloupe/iiif/2/intermuse:programmes:HASHc5edd00c6c45cc68ce9532.1/full/full/0/default.jpg


Currently the jar files for Greenstone3: 

$ ls ../../web/WEB-INF/lib/ | wc
     79      79    1405

Are copied into Cantaloupe's WEB-INF/classes/lib area:

$ ls ./packages/cantaloupe-4.0.2/target/cantaloupe-4.0.2/WEB-INF/classes/lib | wc
     79      79    1405





=====

Might actually turn out to need to be:

  ./packages/cantaloupe-4.0.2/target/cantaloupe-4.0.2/WEB-INF/lib

e.g. jdbm.jar needs to be here to avoid Class Not Found


pushd $GSDL3SRCHOME
cp -i ./packages/tomcat/webapps/gs-cantaloupe/WEB-INF/classes/lib/jdbm.jar ./packages/tomcat/webapps/gs-cantaloupe/WEB-INF/lib/.
popd



=====

# Deprecated

The following is taken care of in ./PREPATE-AND-COMPILE-GSDL.sh

cd $GSDL3SRCHOME
cp web/WEB-INF/lib/jdbm.jar packages/tomcat/webapps/gs-cantaloupe/WEB-INF/lib/.

For debugging XML output as String:

  cp web/WEB-INF/lib/xalan.jar packages/tomcat/webapps/gs-cantaloupe/WEB-INF/lib/.

  cp web/WEB-INF/lib/serialeizer.jar packages/tomcat/webapps/gs-cantaloupe/WEB-INF/lib/.


=======