An dieser Stelle entsteht die öffentliche Dokumentation für Epigraf 5. Diese Seite ist noch in Bearbeitung.

Der Aufbau von Artikeln wird im Menüpunkt Typen an den Anwendungsfall angepasst. Dort wird festgelegt, wie sich Artikel zusammensetzen, welche Kategoriensysteme es gibt und welche Annotationen beziehungsweise Apparate (Fußnoten, Anmerkungen) möglich sind. Eine vollständige Konfiguration besteht aus Typen für folgende Komponenten:

• Projekte (=projects)
• Artikel innerhalb eines Projekts (=articles)
• Abschnitte innerhalb eines Artikels (=sections)
• Inhalte innerhalb eines Abschnitts (=items)
• Annotationen innerhalb von Textfeldern (=links)
• Fußnoten innerhalb von Textfeldern (=footnotes)
• Kategorien, die in Inhalten und für die Annotation genutzt werden (=properties).

Für jeden Typ wird eine eigene JSON-Konfiguration mit Schlüsseln und Werten angelegt, darin sind beispielsweise die Beschriftungen von Feldern definiert. Nachdem die Typen angepasst und miteinander verknüpft wurden, steht fest, wie Artikel angezeigt und bearbeitet werden können. 

Neben der Standardkonfiguration können weitere Darstellungsmodi konfiguriert werden. Dazu werden eigene Typen-Datensätze angelegt, die sich im Modus unterscheiden. Der Modus kann beispielsweise in der Artikelliste über die Schaltflächen im Footer gewählt werden:

• default: Die Standardkonfiguration, die immer vorhanden sein muss. Zusätzliche Modi überschreiben falls vorhanden einzelne Schlüssel in der Standardkonfiguration.
• preview: Einstellungen für die Leseansicht von Artikeln. Dieser Modus gilt grundsätzlich für Gäste.
• coding: Eine Konfiguration zur schnellen Kodierung von Artikeln. In diesem Modus sind nur die explizit freigegebenen Felder bearbeitbar.

Einige Einstellungen finden sich in mehreren Typen wieder:

• Spalten in Tabellenansichten werden über den Schlüssel `columns` definiert.
• Felder, die in Artikeln, Abschnitten oder Inhalten angezeigt werden oder bearbeitbar sind, werden im Schlüssel `fields` aufgeführt.
• Hierarchie und Verknüpfung der Typen:
  • Bei Projekten werden im Schlüssel `articles` die möglichen Artikeltypen des Projekts festgelegt. 
  • Bei Artikeln werden im Schlüssel `sections` die untergeordneten Abschnitte festgelegt. 
  • Bei Abschnitten werden im Schlüssel `items`  die untergeordneten Inhalte festgelegt.
• Für Kategorien-Felder legt der Schlüssel `types` fest, welches Kategoriensystem (properties) verwendet wird
• Für Text-Felder, in die Annotationen eingefügt werden können, legt der Schlüssel `types` fest, welche Annotationen oder Apparate erlaubt sind. Diese werden dann auch in der Toolbar angezeigt.

Die Konfiguration für die Abbildung der Artikel-Inhalte auf RDF-konforme Tripel ist in einem eigenen Abschnitt beschrieben.

Die Zusammensetzung von Artikeln

Artikel (articles)

Ein Artikel beschreibt ein Objekt, etwa einen Inschriftenträger oder einen Brief. In der Konfiguration wird angegeben, wie ein Artikel in der Einzelansicht und in der tabellarischen Ansicht dargestellt werden soll. Zudem wird festgelegt, welche Abschnitte ein neuer leerer Artikel enthält:

{
                      "di-articles-doc": {
                        "caption": "Word",
                        "scope": "article"
                      },
                      "di-epidoc": {
                        "caption": "EpiDoc"
                      },  
                      "di-book-doc": {
                        "caption": "Band",
                        "scope": "book",
                        "button": false
                      },
                      "di-images": {
                        "button":false
                      },
                      "dio-export-book": {
                        "button":false
                      },
                      "dio-export-img": {
                        "button":false
                      }
                    }

"geodata": {
                      "geolocations": "value",
                      "locations": "property.content"
                    }
                    

Abschnitte in einem Artikel (sections-Schlüssel)

Die Definition der Abschnitte im sections-Schlüssel eines Artikels bestimmt sowohl die Reihenfolge als auch die Hierarchie beim Anlegen von Artikeln und neuen Abschnitten. Voraussetzung ist, dass entsprechende Abschnitts-Typen angelegt wurden. Die Abschnitte werden dann mit Schlüsseln aufgeführt, die dem Typ entsprechen, weitere Einstellungen erfolgen im Wert. 

Im folgenden Beispiel wird festgelegt, dass beim Anlegen eines Artikels eine Inschrift und ein untergeordneter Inschriftenteil (parent-Schlüssel) entstehen sollen. Zudem können anschließend manuell beliebig viele Inschriften-Abschnitte und untergeordnete Inschriftenteile-Abschnitte hinzugefügt werden (count-Schlüssel):  
 

{
  "sections": {
    "inscription": {
      "type": "inscription",
      "caption": "Inschrift",
      "count": "*"
    },
    "inscriptionpart": {
      "type": "inscriptionpart",
      "caption": "Inschriftenteil",
      "parent": "inscription",
      "count": "*"
    }
  }
}

Soll ein Abschnitt zwar manuell eingefügt werden können, aber nicht automatisch beim Anlegen eines Artikels, dann wird der default-Schlüssel auf false gesetzt:  
 

{
  "sections": {
    "geolocations": {
      "type": "geolocations",
      "caption": "Standorte",
      "count": "*",
      "default": false
    }
  }
}

Ein Abschnitts-Typ kann mehrfach verwendet werden, wenn er durch unterschiedliche Namen differenziert wird, dazu wird der Schlüssel nach dem Schema <sectiontype>[<sectionname>] gebildet. Dieser Schlüssel kann auch zur Mehrfachverwendung für Unterabschnitte eingesetzt werden. Im folgenden Beispiel wird ein Artikel konfiguriert, der ausschließlich aus text-Abschnitten besteht. Beim Anlegen eines Artikels würden ein Abschnitt mit dem Namen Beschreibung und zwei untergeordnete Abschnitte mit den Namen Objektbeschreibung und Textbeschreibung angelegt werden. Zudem wird die Möglichkeit eingeräumt, weitere Textabschnitte nicht beim Anlegen des Artikels, sondern später manuell hinzuzufügen (default-Schlüssel).  
 

{
  "sections": {
    "text[Beschreibung]": {
      "type": "text",
      "caption": "Beschreibung"
    },
    "text[Objektbeschreibung]": {
      "type": "text",
      "caption": "Objektbeschreibung",
      "parent": "text[Beschreibung]"
    },
    "text[Textbeschreibung]": {
      "type": "text",
      "caption": "Textbeschreibung",
      "parent": "text[Beschreibung]"
    },
    "text": {
      "type": "text",
      "caption": "Weiterer Text",
      "count": "*",
      "default": false
    }    
  }
}

Die Reihenfolge der Abschnitte beim Anlegen von Artikeln ergibt sich aus der Reihenfolge in der Konfiguration. Anschließend können Abschnitte in der Bearbeitungsansicht manuell verschoben werden. Zudem besteht die Möglichkeit, Abschnitte über eine Gewichtung zu verschieben. Auf diese Weise können etwa mit einer eigenen Konfiguration für den Code-Modus oder den Preview-Modus die inhaltlich relevanten Abschnitte nach oben geholt werden. Negative Gewichte schieben einen Abschnitt nach oben, positive Gewichte nach unten. Im folgenden Beispiel werden die Abschnitte zwar in der Reihenfolge Standorte -> Beschreibung angelegt, aber in umgedrehter Reihenfolge angezeigt:

{
  "sections": {
    "geolocations" : {
      "type": "geolocations",
      "caption": "Standorte"
    }
    "text[Beschreibung]": {
      "type": "text",
      "caption": "Beschreibung",
      "weight": -10
    }
  }
}

In der folgenden Tabelle findet sich eine Übersicht über die in den Beispielen verwendeten Schlüssel:

Konfiguration der Artikelvorschau (preview-Schlüssel)

Zusätzlich zur vollständigen Einzelansicht und zur tabellarischen Darstellung können Artikel in Kacheln oder Lanes angezeigt werden. Eine Kachel enthält ein Bild oder einen Textausschnitt, die um zusammenfassende Angaben ergänzt werden können:

Das folgende Beispiel definiert eine Kachel mit einem Bild aus dem Inhaltstyp "images", an dessen Stelle falls nicht verfügbar der Text aus dem Inhaltstyp "transcriptions" tritt. Auf der Kachel werden zudem die in den Spalten source, location und date (columns-Schlüssel des Artikels) konfigurierten Inhalte angezeigt:

{
  "preview": {
    "images": ["images"],
    "text": ["transcriptions"],
    "summary": ["source", "location", "date"]
  }
}

Abschnitte (sections)

Ein Abschnitt gruppiert die Inhalte eines Artikels. Abschnitte sind hierarchisch angeordnet und jeder Abschnitt enthält ein Notizfeld. In der Konfiguration wird angegeben:

Inhalte in einem Abschnitt (items-Schlüssel)

Die Definition der Inhalte im items-Schlüssel eines Abschnitts bestimmt, welche Inhalte beim Anlegen von Abschnitten automatisch erzeugt werden und welche Eingabefelder für die Bearbeitung zur Verfügung stehen. Voraussetzung ist, dass entsprechende Inhaltstypen angelegt wurden. 

Im folgenden Beispiel wird ein Abschnitt vom Typ "heraldry" definiert, der 0 oder mehr Inhalte enthalten kann.  Beim Anlegen wird noch kein Inhalt erzeugt - dafür sorgt die Einstellung im default-Schlüssel:

  "items": [
    {
      "type": "heraldry",
      "count": "*",
      "default": false
    }
  ]

Eine vollständige Inhaltsdefinition umfasst folgende Schlüssel:

Darstellungsmöglichkeiten (view-Schlüssel)

Der view-Schlüssel eines Abschnitttyps kann entweder einen der in der folgenden Tabelle aufgelisteten Werte enthalten oder ein Objekt, das im name-Schlüssel einen dieser Werte enthält. Mit einem Objekt sind weitere Einstellungen möglich, zum Beispiel um eine Tabelle und eine Karte anzuzeigen:

"view": {
  "name": "table",
  "grouped": false,
   "widgets": {
     "map": {
       "itemtype":"geolocations"
     }
   }
}

Die folgenden Werte sind im view-Schlüssel eines Sectiontype möglich:

"view": {
                      "name": "table",
                      "grouped": true
                    }

"view": {
                      "name": "table",
                      "grouped": false,
                      "captions": true
                    }

Zusätzlich können Widgets angezeigt werden, die Inhalte zusammenfassen. Es stehen folgende Widgets zur Verfügung: map, thumbs, grid, upload.

Karten (map): Es wird eine Karte angezeigt. Beispielkonfiguration: 
 

 "widgets": {
     "map": {
       "itemtypes": {
         "geolocations": {
           "segment": "Artikel",
           "field": "value",
           "edit": true
         },
         "locations": {
           "segment": "Kategorie",
           "field": "property.content"
         }
       }
     }
   }

Bilder (thumbs): Es werden Vorschaubilder angezeigt. Beispielkonfiguration:

 "widgets": {
     "thumbs": {
       "itemtype": "images",
       "link": true,
       "fields": [
         "sortno",
         "file"
       ]
     }
}

Dateiupload (upload): Bilder können ausgehend vom Artikel hochgeladen und eingebunden werden. Dazu wird mit folgender Einstellung unterhalb der Abbildungsliste ein Button aktiviert:

 "widgets": {
     "upload": true
}

Der Button öffnet den Bildordner in der Seitenleiste oder bietet dort die Möglichkeit an, den Ordner anzulegen. Voraussetzung ist, dass der Artikel einem Projekt zugeordnet ist, über eine Signatur verfügt und mindestens einmal gespeichert wurde. 

Gitter (grid): Die Einträge werden in einem Gitter angezeigt. Die Größe des Gitters wird im Abschnitt erfasst (section.layout_cols, section.layout_rows). Jeder Eintrag wird in diesem Gitter positioniert, wobei in einer Zelle auch mehrere Einträge gestapelt werden können (items.pos_x, items.pos_y, items.z). Diese Form der Darstellung eignet sich beispielsweise, um die Position von Wappen auf einem Objekt zu erfassen. Die Zählung der Positionen beginnt bei 1. 

Inhalte (items)

Items enthalten die Inhalte eines Artikels. Sie können folgende Datentypen repräsentieren:

• Texte und Übersetzungen (content, translation)
• Quellenangaben (source_ autopsy, source_from, source_addition)
• Einzelne Werte oder Zahlen (value)
• 0/1-Kennzeichnungen (flagged)
• Einbindung einer Datei bzw. eines Bildes (file, file_meta)
• Positionen auf einem Objekt (pos)
• Verweis auf eine Kategorie (property)
• Verweise auf andere Abschnitte oder Inhalte (links)
• Bearbeitungsstatus (published)

Für jedes Item können alle der aufgeführten Felder gleichzeitig verwendet werden, um einen Inhalt abzubilden. Reichen die Felder nicht aus, so können sie entweder vertieft werden, indem in den Textfeldern JSON oder XML  verwendet wird. Oder mehrere Items werden zu einem komplexen Inhalt gruppiert.

Die Item-Konfiguration legt fest, welche Felder verwendet werden, wie sie beschriftet sind und welche Funktionen sie umfassen:

{
                      "dc:rights":"file_copyright",
                      "xmpRights:UsageTerms":"file_licence"
                    }

{
                      "filename": "di-{root.project.description|json:bandnummer}-{root.signature}-{sortno|padzero:2}.{file_type}"
                    }
                    

 "geodata": "value"

  "geodata": "property.content"

  "summary": {
                         "caption": "Automated summary",
                         "service":"llm",
                         "task": "summarize",
                         "prompts": "default",
                         "input": "article",
                         "fields": {
                           "content": "result",
                           "value": "state"
                         }
                       }
                    

Im fields-Schlüssel wird für jedes Item bestimmt, welche Felder verwendet  und wie sie beschriftet werden. Als Schlüssel werden die Feldnamen verwendet, im Wert werden die Beschriftungen und weitere Einstellungen konfiguriert. Einige der Feldschlüssel entsprechen nicht zwangsläufig den Feldern in der Datenbank, sondern stellen eine Sammelbezeichnung für zusammenhängende und von Epigraf automatisch befüllte Felder dar. Beispielsweise umfasst der Feldschlüssel date die Datenbankfelder date_value, date_sort, date_start und date_end. 

Folgende Feldschlüssel können verwendet werden:

Textfelder können zur weiteren Strukturierung XML oder JSON enthalten, wenn das Format entsprechend konfiguriert ist. Reichen die Felder nicht aus, können folgende Varianten verfolgt werden:

• Vertiefung: Die Daten werden in JSON-Objekten erfasst. Mit Unterschlüsseln können beliebige Textinhalte als eigenständige Felder angezeigt werden.
• Item-Gruppierung: Die Daten werden auf mehrere Items aufgeteilt und einander über das Feld itemgroup zugeordnet. Alle Items innerhalb einer Section, die im Feld itemgroup den gleichen Wert enthalten, gehören zusammen.
• Section-Gruppierung: Die Daten werden auf mehrere Items aufgeteilt und zur Gruppierung werden Sections eingesetzt. Alle Items innerhalb einer Section werden als zusammengehörig betrachtet.