4.2.5. UghConvert
Um die oben beschriebenen Serialisierungsformate des genutzten Dokumentmodells unabhängig von einer externen Applikation zwischen einander zu konvertieren, kann UghConvert genutzt werden. Es handelt sich dabei um eine Java-Applikation, die auf Kommandozeilen-Ebene mit mitgelieferten Skripten für Windows- und Linux-Systeme die jeweiligen Formate lesen und schreiben kann. Zur Ausführung wird lediglich eine vollständige Version der UGH Bibliothek (ughCLI) sowie ein Java-Runtime-Environment in Version 1.5 benötigt.
UghConvert liest ein DigitalDocument in einem gegebenen Serialisierungsformat ein – wenn nötig unter Angabe des genutzten Regelsatzes – und serialisiert es anschließend wieder in einem ebenfalls gegebenen Format. Es können Daten auch nur gelesen werden sowie in einem Format gelesen und im selben Format wieder gespeichert werden.
4.2.5.1 Die Kommandozeile
Das Skript wird wie folgt aufgerufen, wobei der Pfad zum Java Runtime Environment gesetzt sein muss:
Die grundlegenden Parameter sind die folgenden:
Parameter
Beschreibung
-c, --config <file>
Der Pfad zur genutzten Regelsatzdatei.
-r, --read <format>
Das zu lesende Format: Hier kommen die folgenden in Frage: mets, rdf, xstream oder picaplus. Als METS Variante kann hier - wie schon oben beschrieben - zunächst nur das interne METS-Format gelesen werden.
-w, --write <format>
Das zu schreibende Format: Die folgenden Serialisierungsformate kommen hierfür in Frage: mets, dvmets, rdf oder xstream, wobei hier zwischen dem internen METS-Format (mets) und dem zvdd/DFG-Viewer- METS unterschieden wird (dvmets).
-i, --input <file>
Der Pfad zur Quelldatei, im Format wie mit -r angegeben.
-o, --output <file>
Der Pfad, unter der die Zieldatei gespeichert werden soll; diese wird im Format wie unter -o angegeben serialisiert.
-v, --verbose
Mit diesem Parameter werden die Struktur- und Metadaten des Dokuments beim Lesen ausgegeben.
-h, --help
Gibt eine Hilfe zur Syntax aus.
-q, --quiet
Vermeidet jegliche Art der Ausgabe, Fehler jedoch ausgenommen.
-V, --version
Gibt die Versionen der einzelnen von UGH genutzten Fileformat Implementierungen aus.
Beispiel: Lesen einer XStream-Datei mit Ausgabe der Struktur- und Metadaten
Beispiel: Konvertieren einer XStream-Datei in eine (interne) METS-Datei
Beispiel: Konvertieren einer RDF-Datei in eine (interne) METS-Datei, incl. Ausgabe der Struktur- und Metadaten
4.2.5.2 Administrative Metadatensektion
Für die Konvertierung in das zvdd/DFG-Viewer METS-Format sind noch einige weitere Werte konfigurierbar, die sich in drei Gruppen einteilen lassen (siehe auch “Eigenheiten des METS- Exports”). Eine davon enthält die Daten für die administrative Metadaten-Sektion dv:rights und dv:links.
Parameter
Beschreibung
-mro, --metsrightsowner <owner>
Der Urheber des Digitalisats.
-mrl, --metsrightslogo <url>
Eine URL des Logos des Urhebers; dieses Logo wird durch den DFG-Viewer sowie das zvdd-Portal entsprechend angezeigt.
-mru, --metsrightsurl <url>
Eine URL der Homepage des Urhebers.
-mrc, --metsrightscontact <url>
Eine URL zu einem Kontaktformular der Homepage des Urhebers oder alternativ eine E- Mail-Adresse. Hiermit soll vom DFG-Viewer ein direkter Kontakt zum Urheber ermöglicht werden.
-mdr, --metsdigiprovreference <url>
Eine URL auf den Katalogeintrag des Digitalisats - oder auf die untergeordnete Struktur, zum Beispiel einen Band - falls eine solche existiert.
-mdra, --metsdigiprovreferenceanchor <url>
Eine URL auf den Katalogeintrag des Digitalisats - oder auf die Übergeordnete Struktur, zum Beispiel eine Zeitschrift - wenn eine solche existiert.
-mdp, --metsdigiprovpresentation <url>
Eine URL auf die Online-Präsentation des Digitalisats - oder auf die untergeordnete Struktur, zum Beispiel einen Band - falls eine solche existiert.
-mdpa, --metsdigiprovpresentationanchor <url>
Eine URL auf die Online-Präsentation des Digitalisats - oder auf die übergeordnete Struktur, zum Beispiel eine Zeitschrift - falls eine solche existiert.
4.2.5.3 Dateigruppen (FileGroups)
Daten für die für den DFG-Viewer benötigten Dateigruppen (FileGroups), mindestens erforderlich sind FileGroups mit den Namen MIN und DEFAULT.
Parameter
Beschreibung
-fmin, --minfilesuffix <filesuffix>
Die Dateiendung der Dateinamen in der FileGroup MIN.
-mmin, --minmimetype <mimetype>
Der Mimetype der Dateien in der FileGroup MIN.
-pmin, --minpath <path>
Der Pfad der Dateien in der FileGroup MIN, der Dateiname wird aus den Eigenschaften des Objekts ContentFile genommen.
-smin, --minidsuffix <idSuffix>
Die Endung der XML ID, die in der METS-Datei für die FileGroup MIN verwendet wird.
Alle weiteren Angaben sind für die Dateigruppen DEFAULT, MAX, DOWNLOAD, LOCAL, PRESENTATION und THUMBS äquivalent. Die Dateigruppe LOCAL wird automatisch erzeugt, kann jedoch bei Bedarf mit eigenen Werten überschrieben werden. Die Parameter für die weiteren Dateigruppen sind äquivalent zu minfilesuffix, minmimetype, minpath und minidsuffix festgelegt, zum Beispiel defaultpath, maxpath, downloadpath, localpath, presentationpath und thumbspath. Alle Parameter finden sich in der Hilfe von UghConvert:
Für die Konfiguration der erweiterten Parameter (administrative Metadaten und Dateigruppen) sollten die langen Parameter (--mimidsufffix, --minmimetype, etc.) verwendet werden.
Beispiel: Ausschnitt aus einer METS-Datei (FileGroups) Aus dem Angaben
ergibt sich die folgende METS FileGroup DEFAULT...
...und folgende administrative METS Metadatensektion:
Last updated
Was this helpful?