Die Event-Drehscheibe für Würzburg
Find a file
2025-07-27 22:22:34 +02:00
events-data/json/2025 Frisch aus dem Kellerperle-Collector 2025-07-27 22:22:34 +02:00
README.md README.md aktualisiert 2025-07-27 16:44:35 +00:00

DIGIWUE/EVENTS

Das Events-Projekt von DigiWUE soll eine "Drehscheibe" für Veranstaltungen in und um Würzburg sein. Hier sollen möglichst alle Veranstaltungen in Würzburg und Umgebung gesammelt werden. Und von hier aus können sie dann weiter verarbeitet werden. Sei es durch eine Schnittstelle nach Wuelender oder als iCal-Feed direkt in deinen eigenen Kalender (möglicherweise gefiltert).

Roadmap

Step 1 (Grundlagen schaffen)

Repository anlegen

README.md anlegen 👷

JSON-Datei anlegen 👷

  • Jede Veranstaltung bekommt eine eigene JSON-Datei
  • als Dateiformat verwenden wir JSON(-LD), und folgen dem Event-Schema von schema.org
  • Die "Rohdaten" werden nach Jahr und Monat gegliedert abgelegt, z.B. unter events-data/json/2025/07
  • für den Dateinamen haben wir noch kein konkretes Namensschema
    • der Dateiname sollte auf .json enden
    • der Dateiname sollte den Namen der Location enthalten
    • wenn das Event von einer Website gescraped wurde und dort eine ID verwendet wird, sollte die sich im Dateinamen wiederfinden

Step 2 (Projekt etablieren & stabilisieren)

  • automatische Prüfung auf Duplikate
  • automatische Schemapürfung bei Pull Requests

Mitmachen

Du möchtest bei uns mitmachen? oder dir fehlt ein Event in unserer Sammlung?

Dies ist ein offenes, (und bewusst) noch relativ unorganisiertes Projekt ... mach einfach mit. Im Moment haben wir leider noch kein bequemes Formular, wo du dein Event einfach eintragen kannst. Am geschicktesten wäre es, wenn du einen Pull Request öffnen könntest und einfach eine neue Datei mit deinem Event beiträgst.

Falls das zu technisch ist, nimm aber gerne einfach Kontakt mit uns auf und/oder lege einen Issue an, und wir finden eine Lösung :)

Definitionen

Zunächst, vgl. oben, wir legen eine Datei pro Event an.

Events mit mehreren Auftritten

Bei einem Format wie dem Stramu oder Ringparkfest, wo jede Stunde wer anderes spielt, soll eine Datei für das ganze Stramu angelegt werden. Das Event-Schema von schema.org sieht bereits vor, dass man mit subEvent eine (Liste von) Unterevents anlegen kann.
Ziel davon ist, dass die Anzahl an "top-level" Events überschaubar bleibt. Beispiel, z.B. Ringparkfest Event

Bei einem Format wie dem Hafensommer, wo ein Konzert am Abend gespielt wird, soll statt dessen möglichst ein Event pro Abend angelegt werden. Die Eigenschaft superEvent kann verwendet werden um auf eine Dachveranstaltung zu verweisen. Beispiel, z.B. Buntspecht beim Hafensommer

Validierung

Von schema.org gibt es hier einen Online-Validator.