Gemeinsam mit diesen kommt auch eine neue Such-Schnittstelle für md:term (siehe Dokumentation).

Die Dokumentation kann hier abgerufen werden:

• md:term
• frontend (via the global portal)

Zuerst aber ein Schritt zurück: Das Ziel von md:term ist, einen zentralen öffentlich referenzierbaren Ort für die kontrollierten Vokabulare von museum-digital zu bieten, und sie einerseits über eine gut erreichbare Schnittstelle leicht nachnutzbar und anderseits leicht durchsuchbar zu machen.

Der Wunsch nach einer Download-Funktion kam im Sinne der Nachnutzbarkeit auf: Für manche Zwecke ist es sinnvoller, gleich das ganze Vokabular in einem Rutsch herunterzuladen und auszuwerten, als die vorhandenen Einträge jeweils einzeln abzurufen. Deshalb bieten z.B. auch die Wikipedia und Wikidata alle Ihre Inhalte gebündelt zum Download an. Mit der neuen Download-Funktion lassen sich ebenso die zentralen Vokabulare (für Orte, Personen, Zeiten und Schlagworte) von museum-digital als ZIP herunterladen.

Ein Re-Design wurde so sowohl technisch als auch im Bezug auf das Design nötig. Auf technischer Seite musste der Code wesentlich modularer aufgebaut werden, damit wir dieselben Funktionen zum Aufbau der menschenlesbaren Seite wie für die Erstellung der ZIP-Dateien benutzen konnten. Das der Code so wesentlich leichter wartbar und erweiterbar wird, ist ein glücklicher Nebeneffekt.

Die menschenlesbare Anzeige bedurfte vor allem wegen der Seitenspalte einer Überarbeitung. Wo jetzt eine neue Download-Sektion verlinkt werden sollte, war nach dem vorhandenen Design schlicht kein sauber nutzbarer Platz. Eine nicht allzu große Änderung hätte vielleicht genügt, aber um ein allgemein besser mit der regulären „Ausgabe“ von museum-digital harmonierendes Design zu finden, war es leichter, das Design noch einmal grundlegend neu zu implementieren. So zeigt sich md:term jetzt vor allem in Grautönen, und nutzt mit Source Sans Pro dieselbe Schriftart wie die anderen öffentlichen Seiten von museum-digital.

Die Seitenspalte ist jetzt in mehrere klar voneinander abgetrennte Unterbereiche unterteilt, mit einer eigenen Sektion für Links und den Wechsel der benutzten Sprache. Neu ist eine bei Orten, Schlagworten und Zeiten auf großen Bildschirmen dazugekommene zweite Seitenspalte, in der man direkt zu den übergeordneten und untergeordneten Begriffe navigieren kann. Bisher war diese Hierarchie recht weit unten auf den Seiten zu finden, sodass md:term jetzt sicher noch auch noch ein kleines Stück schneller navigierbar ist.

This content is licensed under a Creative Commons Attribution 4.0 International license.

Bisher nicht übersetzbar waren Zeitbegriffe, sodass deutsche und ungarische Zeitbegriffe, die z.B. denselben den selben Tag abbilden, bisher als zwei verschiedene Zeiten geführt werden mussten. Auch für „normale“ Benutzer wirkt sich das dadurch aus, dass ungarische Zeitbegriffe in den Auswahllisten in der deutschsprachigen Eingabe in musdb und in der Auswahlliste für Zeiten in der erweiterten Suche der Ausgabe erscheinen.

Um an dieser Stelle Abhilfe zu schaffen, haben wir jetzt die Möglichkeit eingerichtet, auch Zeitbegriffe zu übersetzen und – so vorhanden – übersetzt anzuzeigen.

Beitragsbild: „Wanduhr (Kake Tokei), Japan, 19. Jahrhundert“, CC BY-SA @ Deutsches Uhrenmuseum / Deutsches Uhrenmuseum

This content is licensed under a Creative Commons Attribution 4.0 International license.

Wichtig dabei ist die Programmierschnittstelle von md:term, die etwa in der „Graphennavigation“ zum Einsatz kommt, und auch für externe Programmierer offen steht. Weil wir hier – wie auch sonst – im Sinne einer größeren Offenheit keine Authentifizierung für die Benutzung der API verlangen, gibt es leider keine vollständige Liste der Projekte, die md:term benutzen. Deshalb richtet sich dieser Blogeintrag vor allem an eben jene Benutzer der API.

Wie wird die Mehrsprachigkeit der Einträge implementiert und wie zeigt sie sich in md:term?

Wir haben die Mehrsprachigkeit als tatsächliche Übersetzungsfunktion implementiert, in dem Sinne, dass es eine Basis-Tabelle – in der Ausgangssprache, also Deutsch oder Ungarisch – und eine Übersetzungstabelle mit Übersetzungen in knapp 25 Sprachen, die aus Wikidata ausgelesen werden (soweit möglich). Ist eine Übersetzung in der vom User angeforderten Sprache vorhanden, wird der gegebene Eintrag beim Ausgeben durch den Eintrag aus der Übersetzungstabelle ersetzt.

Auch in den API-Ausgaben werden die Werte so ersetzt. Beim Aufrufen der API ist es deshalb ratsam, die Sprache explizit anzugeben.

This content is licensed under a Creative Commons Attribution 4.0 International license.

Seit letzter Woche ist die neue API für die kontrollierten Vokabulare bei Museum-Digital online: md:term. Zusätzlich zur eigentlichen Schnittstelle bietet md:term einen Vokabularbrowser, mit dem Benutzer (ob Programmierer oder nicht) durch die Vokabulare navigieren können.

Kontrollierte Vokabulare bei Museum-Digital

Kontrollierte Vokabulare kommen bei Museum-Digital sowohl bei der Suche als auch bei der Bereitstellung von Kontextdaten zu Museumsobjekten zur Anwendung. Wer z.B. in der deutschlandweiten version von Museum-Digital nach Helm sucht, wird in der Seitenspalte links eine Liste mit unterbegriffen und verwandten Begriffen von Helm finden, die aus den internen kontrollierten Vokabularen gespeist wird. Ist nun ein Objekt ausgewählt, finden sich hinter den Namen von verknüpften Personen und Orten Schalter mit dem Buchstaben i. Klickt der Benutzer auf einen dieser Schalter, werden (so vorhanden) Daten aus den kontrollierten Vokabularen von Museum-Digital angezeigt – Beschreibungen, alternative Namen, Links zu z.B. Wikipedia – oder anhand dieser Daten aus anderen Quellen hinzugeladen – z.B. Karten im Fall eines verknüpften Ortes, auf denen der Ort mithilfe von bei Museum-Digital gespeicherter Koordinaten lokalisiert wird.

Kontrollierte Vokabulare sind also ein wichtiges, wenn auch relativ leicht zu übersehendes Element von Museum-Digital. Entsprechend wird viel Arbeit in die Moderation der Vokabulare gesteckt.

Während jeder Eingebende neue Begriffe hinzufügen kann, werden diese von einer ausgewählten Gruppe von Leuten moderiert, angereichert oder ggfs. mit existierenden Begriffseinträgen zusammengeführt.

Mittlerweile sind alleine in den deutschsprachigen kontrollierten Vokabularen – unterteilt in Personen, Orte, Zeiten und Schlagworte – über 55000 moderierte Begriffe vorhanden, die sicherlich nicht nur für die Verwendung bei Museum-Digital nützlich sein können. Das Schreiben einer öffentlichen und generell nutzbaren Schnittstelle ist eine logische Konsequenz hiervon.

md:term

Daten aus den kontrollierten Vokabularen sind bei md:term in bisher drei Formaten abrufbar: Einer im Webbrowser betrachtbaren und navigierbaren HTML-Version, in JSON und SKOS, die als leicht maschinenlesbare Formate die Benutzung durch externe Programierer erleichtern.

Ein wichtiger Teil von md:term ist hierbei die Umbenennung von Variablen. Während museum-digital ursprünglich in Deutschland entstanden ist und in der Datenbank entsprechend deutsche Namen verwendet werden, wird es mittlerweile beispielsweise auch in Ungarn eingesetzt. Damit die Benutzung der kontrollierten Vokabulare auch durch nicht deutschsprachige Programmierer möglich ist, werden die Variablennamen mit englischen Entsprechungen überschrieben.

Ebenfalls auf internationale Benutzbarkeit ausgerichtet, bietet die HTML-Version deutsche und englische Übersetzungen von feststehenden (also nicht nur zu einem einzelnen Datensatz gehörenden) Texten, z.B. Überschriften und der Navigation. Dies kann in Zukunft leicht um zusätzliche Sprachen erweitert werden.

Daten von md:term abfragen

Zur Abfrage von md:term in JSON und SKOS muss die ID eines Eintrags in der entsprechenden Datenbank bekannt sein. Ist dies der Fall, wird eine Abfrage in der URL nach dem Format https://term.museum-digital.de/Name der Vokabularversion (z.B. md-de)/Typ des Eintrages/ID/format durchgeführt. Zum Beispiel:

$ curl https://term.museum-digital.de/md-de/place/13384/json
{
    "id": "13384",<br>"name": "Abtstra\u00dfe (Brandenburg an der Havel)",
    "class": "Stra\u00dfe",
    "tgn": "",
    "geonames": "",
    "latitude": "52.406989561274",
    "longitude": "12.564392566637",
    "zoom": "16",
    "note": "Stra\u00dfe in Brandenburg an der Havel",
    "synonyms": [],
    "references": [],
    "broader": {
        "": [{
            "name": "Brandenburg an der Havel",
            "broader_id": "246"
        }]
    },
    "narrower": []
}

Aus den Abfrageergebnissen kann man IDs für weitere Abfragen finden, der Ort im Beispiel, die Abtstraße (Brandenburg an der Havel) mit der ID 13384 ist Brandenburg an der Havel mit der ID 246 untergeordnet.

Eine Suchfunktion ist bisher nur in der HTML-Ausgabe vorhanden. Gibt es ein im Namen perfekt übereinstimmendes Suchergebnis oder nur ein einziges bei einer loseren Entsprechung, wird direkt auf den entsprechenden Eintrag umgeleitet. Gibt es zwei oder mehr, so werden dem Benutzer die möglichen Suchergebnisse mit Titel und, so vorhanden, Beschreibung aufgelistet.

Ist man so zum gewünschten Eintrag gelangt, ist über der Ausspielung der Daten ein Feld mit der Abfrage-URL und – direkt darunter – Links zum Eintrag in alternativen Formaten zu finden.

[Originalbeitrag: https://www.jrenslin.de/post/40]

This content is licensed under a Creative Commons Attribution 4.0 International license.