An dieser Stelle entsteht die öffentliche Dokumentation für Epigraf 5. Diese Seite ist noch in Bearbeitung.
In die Projektdatenbanken können Bilder, PDF-Dateien oder weitere Dokumente eingebunden werden. Projektübergreifend sind solche Dateien für das Erstellen von Export-Pipelines, die Hilfe und das Wiki relevant.
Hochladen von Dateien
In Epigraf gelten für die Benennung von Dateien und Ordnern folgende Konventionen:
- Erlaubt: Buchstaben a-z, nur Kleinschreibung
- Erlaubt: Ziffern 0-9, Bindestrich, Unterstrich, Pluszeichen
- Nicht erlaubt: Keine Umlaute und kein ß, stattdessen ue, ae, oe, ss
- Nicht erlaubt: Keine Leerzeichen und keine Kommata, stattdessen Unterstrich oder Bindestrich
- Nicht erlaubt: Keine Punkte, außer vor der Dateiendung
Werden neue Dateien hochgeladen, bereinigt Epigraf die Dateinamen automatisch.
Die Ordnerstruktur von Epigraf
Die datenbankspezifischen Dateien werden über den Menüpunkt "Dateien" verwaltet. Achten Sie darauf, die passenden Ordner zu verwenden:
- notes: Dateien, die in Notizen eingebunden werden. Es wird empfohlen, für jede Kategorie einen eigenen Unterordner einzurichten.
- articles: der richtige Ort für alle artikelbezogenen Dateien wie zum Beispiel Bilder. Es sollten Unterordner mit dem Kürzel des Projekts und darin wiederum Ordner mit der Artikelnummer verwendet werden.
- properties: Dateien, die in Kategorien verwendet werden. Legen Sie für die verschiedenen Kategoriensysteme jeweils eigene Unterordner an.
Die Verwaltung der weiteren Ordner sollte Epigraf überlassen werden:
- backup: hier befinden sich die Backups der Datenbank.
- jobs: enthält das Ergebnis von Pipeline-Aufrufen.
- import: darin werden die importierten CSV-Dateien zwischengespeichert.
Darüberhinaus können über den Menpunkt "Repositorium" datenbankübergreifende Dateien verwaltet werden:
- help: Der help-Ordner im shared-Mount enthält Screenshots und weitere Dokumente für die Hilfe.
- wiki: Ebenfalls im shared-Mount befinden sich in diesem Unterordner die Dateien für das Wiki.
- public: Dateien, die ohne Anmeldung zugänglich sind, sollten hier abgelegt werden, zum Beispiel Bilder für die Startseite von Epigraf.
- export: im export-Mount finden sich alle für die Pipelines verwendeten Dateien, zum Beispiel XSL-Stylesheets.
Die Dateien sind in verschiedene Mounts gruppiert, die im Menü auf der linken Seite ausgewählt werden können. Für die Zusammenarbeit ist in Epigraf der shared-Mount relevant. Der root-Mount erlaubt einen Einstieg in alle Ordner - auch die projektspezifischen - und ist Administrator:innen vorbehalten bzw. nur mit speziellen Berechtigungen zugänglich.
Verlinkung von Dateien
Alle Dateien, ob Bilder oder Dokumente, werden in Epigraf entweder über den Dateipfad oder über eine ID erreicht.
- Download-Links bieten die Datei zum Herunterladen an, zum Beispiel /files/download/76459.
- Display-Links zeigen eine Datei falls möglich direkt im Browser an, zum Besipiel /files/display/76459.
Für Bilder kann mit dem thumbs-Parameter eine heruntergerechnete Version verlinkt werden, zum Beispiel: /files/display/76459?format=thumb&size=600.
Auch HTML-Dateien können mittels Display-Link so verlinkt werden, dass sie direkt im Browser angezeigt, statt heruntergeladen werden. So können komplexere interaktive Dokumente bereit gestellt werden.
Achten Sie darauf, bei internen Links und bei der Einbindung von Bildern in Hilfe, Wiki oder Notizen die Domain zu entfernen. Entfernen Sie außerdem grundsätzlich falls vorhanden überflüssige Parameter, insbesondere den database-Parameter. Verwenden Sie also zum Beispiel /help/epiweb-epi-files-index anstelle von https://epigraf.inschriften.net/help/epiweb-epi-files-index oder /help/epiweb-epi-files-index?database=epi_public.
In Download- und Display-Links können alternativ zur ID einer Datei auch Pfad und Dateiname als Parameter angegeben werden. Beispiel: /files/display?root=shared&path=help%2Fb.dateneingabe%2F02.artikel&filename=bedienelemente-artikel.png.
Metadaten in Bildern
Mit Epigraf können beim Exportieren automatisch Metadaten in Bilder geschrieben werden. Dazu müssen für die Item-Einträge mit Bildern erstens die entsprechenden Eingabefelder konfiguriert werden und zweitens wird festgelegt, welche Angaben in die Metadaten der Bilddateien übernommen werden.
Folgende Tabelle zeigt eine typische Konfiguration von Eingabefeldern. Die Spalte Verwendung bezieht sich auf eine typische Interpretation der Felder wie sie etwa im Projekt Deutsche Inschriften erfolgt. Die Spalte Attribut bezieht sich auf den Standard Extensible Metadata Platform (XMP) oder Exchangeable Image File Format (Exif) für Bild-Metadaten.
| Verwendung | Attribut | Beispiele | Erläuterung |
|---|---|---|---|
| Bildüberschrift | xmp:Title | DI 34, Nr. 13 - Niederhausen, Evang. Pfarrkirche - 1. H. 13. Jh. | Empfohlenes Schema für Inschriftenartikel: Bandnummer, Katalognummer - Standort - Datierung |
| Bildunterschrift | xmp:Headline | Epitaph des Johann von Schmidtburg; Grabplatte des Thomas Martius; Schwellbalken; Jahreszahl | Empfehlung für Inschriftenartikel: Typ des Inschriftenträgers mit Hinweis auf Person, sofern vorhanden, oder Inschriftentyp |
| Ersteller | xmp:Creator exif:Artist | Thomas G. Tempel | Name des Urhebers oder der Urheberin des Bildes, das heißt Fotograf:in |
| Quelle | xmp:Source | Bildarchiv ADW Mainz | Organisation bzw. Person, die das Bild zur Verfügung gestellt hat (zum Beispiel Museen). Bei eigens angefertigten Bildern einer Arbeitsstelle, Bezeichnung des Arbeitsstellenarchivs. |
| Copyright-Informationen in der Bildunterschrift | xmp:Rights | Heidelberger Akademie | Inhaber:in der Nutzungsrechte. Normalerweise Name der Institution, sofern bekannt dahinter Ersteller:in oder Fotograf:in in Klammern. Bei Fotos von Privatleuten oder freien Mitarbeitenden ist der Inhalt dieses Feldes mit dem Erstellerfeld identisch. |
| Nutzungsbedingungen | xmp:UsageTerms | CC BY 4.0 CC BY-NC-ND 4.0 | Name der Lizenz oder Beschreibung der Nutzungsrechte. ("Unerlaubte Vervielfältigung oder Weitergabe nicht gestattet. Die Herstellung von Kopien für den persönlichen, privaten oder nicht kommerziellen Gebrauch ist erlaubt.") |
| Credit / Anbieter | xmp:Credit | ADW Mainz, Inschriftenkommission | Organisation oder Person, die bei der Weiterverwendung genannt werden soll, notwendig insbesondere bei CC-Lizenzen. |
| Copyright-Status | xmp:Marked | True oder False | True: Durch Urheberrecht geschützt. False: Public Domain, das heißt gemeinfrei. |
Welche Angaben davon schlussendlich in den Bilddateien landen, wird an zwei Stellen festgelegt:
- In der Konfiguration von Bildern wird eine Basiseinstellung vorgenommen
- In einer Exportpipeline können bei Bedarf weitere Metadaten ergänzt werden.
Es können auch Angaben wie der Titel aus einem Artikel oder aus dem zugehörigen Projekt übernommen werden.