document events

README.md

@@ -40,7 +40,7 @@ werden.
 [2]: https://git.agdsn.de/help/user/markdown.md
 [3]: https://vdsc.de/clubs/
 
-### Lokales Bearbeiten mit Docker
+## Lokales Bearbeiten mit Docker
 
     docker run \
         --rm \
@@ -50,3 +50,19 @@ werden.
         --volume $(pwd):/srv/jekyll \
         jekyll/jekyll:4.2.2 \
         jekyll serve
+
+## Veranstaltungen
+
+[`assets/events.js`](./assets/events.js) lädt Veranstaltungen von <https://events.vdsc.de/calendar.json>
+und erstellt die Übersicht.
+
+<https://events.vdsc.de/calendar.json> wird von [icsmerge](https://github.com/schnusch/icsmerge)
+erstellt. *icsmerge* führt Veranstaltungen aus verschiedenen iCalendar-Quellen
+([RFC5545](https://www.rfc-editor.org/rfc/rfc5545)) zusammen (siehe
+<https://github.com/schnusch/icsmerge/blob/master/example/vdsc.toml>).
+*icsmerge* läuft stündlich auf dem `vdsc.de`-Uberspace in `~/icsmerge`.
+
+Einige Clubs stellen eigene iCalendar-Feeds bereit. Für die andereen Clubs
+erstellt [studentenclub-ics-adapter](https://codeberg.org/VDSC/studentenclub-ics-adapter)
+diese aus den Websites oder eXma. *studentenclub-ics-adapter* läuft
+stündlich auf `exma.de` in `/home/exma/forum/downloads/schnusch/ics`.