Changes for README.md: 4 added lines, 2 removed lines.
Original line number
Diff line number
Diff line
@@ -12,9 +12,11 @@ This site is built using the [Hugo static site generator](https://gohugo.io/).
- Refer to [this example](https://gitlab.com/hsbxl/agenda/raw/master/content/events/panpanpan.md) for guidance.
3. If the event has an `image:` at the top and the image carries information (a poster with a date, a map), add `image_alt:` with a short description of what it shows. Leave it out for a logo or a decorative picture.
### Regular series in the Agenda
### The Agenda
The Agenda in the sidebar, and on phones in the home page itself, shows each regular series with its rhythm and at most its next three dates, and lists the other events separately, so one-off events stay visible. A series is regular when the `_index.md` of its folder has a `recurrence:` line, for example `recurrence: "open evening for everyone, every Tuesday, 19:00"` in `content/events/techtuesday/_index.md`. That text appears next to the series name. To cancel one date of a series, add `cancelled: true` to that event: it then appears with the other events, and the series shows the next three dates that still take place. The events page and the calendar file always list every date.
The Agenda appears in the sidebar, in the home page itself on phones, and at the top of the events page. "Coming up" lists every event of the next two weeks (six weeks on the events page) in start order, with the weekly ones tagged "weekly" and the others in bold, at most 8 rows in the sidebar and on the home page. "Every week" names each weekly series once, with its day and time, and links to the series page. A series is weekly when the `_index.md` of its folder has a `recurrence:` line, for example `recurrence: "open evening for everyone, every Tuesday, 19:00"` in `content/events/techtuesday/_index.md`. To cancel one date, add `cancelled: true` to that event: it leaves "Coming up", and its series stays under "Every week". The events page and the calendar file always list every date.
The site is rebuilt every night, and the build writes the next two days beyond the window too. `static/js/agenda.js` then compares each event's start and end with the visitor's clock, on load and once a minute: it hides events that have ended, puts the ones in progress at the top with a "now" badge and their end time, and keeps the row limit. Without JavaScript, the list shows as it was at build time.