Diese Anleitung beschreibt die Schritte zur Einrichtung und Installation des Cantaloupe-Bildservers und des Universal Viewers, um die Anwendung aufzubauen, die im Rahmen einer wissenschaftlichen Arbeit entstanden ist.
Im Rahmen der Arbeit wurden ein IIIF-Server und ein IIIF-Viewer eingerichtet und konfiguriert, um Stoffmuster (Dateigrößen von über 250 mb pro Bild) digital für die Hochschule für Technik und Wirtschaft Berlin (HTW) zugänglich zu machen. Die Untersuchung zeigt, dass Komponenten wie der IIIF-Server Cantaloupe leistungsfähig genug sind, um große Digitalisate ohne Performanceverluste zu verarbeiten. Die Arbeit verdeutlicht, dass durch die Kombination von IIIF-Standards mit individuell entwickelten Skripten große Bilddigitalisate bereitgestellt werden können.
- Windows-Unterstützung: Die Anleitung und die Skripte sind auf Windows-Rechner ausgelegt. Die Einrichtung auf anderen Betriebssystemen ist jedoch ebenfalls möglich.
- Keine Bilder und Metadaten: Aufgrund der Datenschutzbestimmungen der Universität stehen keine Beispieldigitalisate und Metadaten zur Verfügung. Das Projekt muss mit eigenen Digitalisaten und Metadaten aufgesetzt werden.
- Das Repository wurde im Nachgang hinzugefügt.
- Java 11 oder höher
- Node.js 18.17.0 oder höher
- Npm 8.1.1 oder höher
- Git
- ImageMagick
- Node.js-Bibliotheken:
- sharp
- xml2js
- Download und Vorbereitung:
- Laden Sie die neueste Version von Cantaloupe (5.0.6) von der offiziellen Projektseite: https://cantaloupe-project.github.io/ herunter
- Entpacken Sie die ZIP-Datei und benennen Sie das Verzeichnis in cantaloupe um.
- Verschieben Sie das Verzeichnis nach C:\cantaloupe.
- Verzeichnisstruktur erstellen
- Erstellen Sie in C:\cantaloupe den Ordner images für ihre Bilder die Sie bereitstellen wollen und fügen sie dort ihre Bilder hinzu.
(3. Optional - Farbprofile umwandeln)
- Falls ihre Bilder ein ungültiges Farbprofil haben, führen sie das Skript convertToSRGB unter C:/cantaloupe/script/ aus.
- Für diesen Zweck muss ebenso ImageMagick installiert werden unter folgender URL: https://imagemagick.org/script/download.php
- Unter Windows ist diese Version zu installieren: "ImageMagick-7.1.1-36-Q16-HDRI-x64-dll.exe"
- Mit dem Befolgen der Installationsschritte sollte ImageMagick von selbst das sRGB-Farbprofil unter folgender URL bereitstellen: "C:/Program Files/ImageMagick-7.1.1-Q16-HDRI/sRGB.icc".
- Cantaloupe starten
- Öffnen Sie die Eingabeaufforderung und wechseln Sie in das Verzeichnis C:\cantaloupe.
- Starten Sie Cantaloupe mit folgendem Befehl:
java -Dcantaloupe.config=C:\cantaloupe\cantaloupe.properties -Xmx4g -jar cantaloupe-5.0.6.jar
- Dev Branch klonen
- Der Universal Viewer zum Anzeigen der Bilder befindet sich im "Dev" Branch.
Die sharp-Bibliothek und die xml2js-Bibliothek sind als Abhängigkeiten zu installieren:
npm install sharp
npm install xml2js
- IIIF-Manifeste und Metadaten einbinden
- Für das Einbinden Ihrer individuellen IIIF-Manifeste in den Universal Viewer muss die Datei: “iiif-collection.json” angepasst werden. Beispiele befinden sich schon in der erwähnten Datei.
- Für das Einbinden der Metadaten muss im "src-Ordner" bestenfalls eine LIDO-Datei mit allen Metadaten der eingebetteten Digitalisate hinzugefügt werden.
- Universal Viewer starten
npm start
- Anwendung testen
- Wenn sowohl Cantaloupe als auch der Universal Viewer laufen, sollten alle Digitalisate korrekt angezeigt werden.
Diese Anwendung wurde im Rahmen einer wissenschaftlichen Arbeit entwickelt. Bitte beachten Sie, dass die bereitgestellten Dateien und Anleitungen für Forschungszwecke gedacht sind. Bei Fragen oder Problemen wenden Sie sich an mich über LinkedIn.