From d135a7224725c80b729ede26fe1433b50cd3a9e4 Mon Sep 17 00:00:00 2001 From: Hauke Mehrtens Date: Sat, 22 Aug 2026 19:39:36 +0200 Subject: [PATCH] README: describe the calendar as it is built today MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `build.sh` no longer post-processes anything: since the switch to ICS files it just deletes `public/` and runs `hugo`. The `CALENDAR` placeholder, the Python dependency on `icalendar`, `python-dateutil` and `pytz`, and the `de_DE.UTF-8` locale requirement are all gone, and nothing in `packages.nix`, `devShells.nix` or `flake.nix` pulls in Python any more. Drop those claims. Describe instead where the two calendar views actually come from: the "Nächste Veranstaltungen" table and the calendar page are rendered in the browser from `/calendars/all.ics`, which is published separately on the web server and is not generated by Hugo, so both stay empty in a local build. That also replaces the old advice to preview them via `./build.sh` plus a local HTTP server, which no longer helps. Mention the per-section `.ics` feeds Hugo does generate, so the ICS templates under `layouts/` are not mistaken for the source of `all.ics`. Fixes: c28f04c6e85c ("switch to ics files; make calendars work; fix some minor issues") Assisted-by: Claude:claude-opus-5 Signed-off-by: Hauke Mehrtens --- README.md | 23 ++++++++++++----------- 1 file changed, 12 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 5f72bd0..e7f7a22 100644 --- a/README.md +++ b/README.md @@ -29,20 +29,22 @@ This is the website of the CCCB. Every change you make on the project will be reflected in your browser as long as `hugo serve` is running. -The *"Nächste Veranstaltungen"* table on the home page is generated by post-processing in `./build.sh`, not by Hugo, so -it is **not** visible under `hugo serve`. To preview the fully built site (including the home-page calendar), or to -ready the site for upload, run: +The *"Nächste Veranstaltungen"* table on the home page and the calendar under `/verein/calendar/` are rendered in the +browser by `static/js/upcoming.js` and `assets/js/calendar.js`. Both fetch `/calendars/all.ics`, which is **not** +generated by Hugo and is not part of this repo — it is published separately on the web server. Locally those two +tables therefore stay empty; check them on the [staging site](https://staging.berlin.ccc.de/) instead. + +Hugo does generate an `.ics` feed per section (for example `/veranstaltungen/index.ics`) from the `dtstart`, `dtend` +and `rrule` front matter of the pages in `content/veranstaltungen/`, using the `.ics` templates under `layouts/`. + +To build the site for upload, run: ```shell ./build.sh -python3 -m http.server -d public 1313 ``` -`build.sh` replaces the `CALENDAR` placeholder in `index.html` with the upcoming-events table. It depends on Python -with the `icalendar`, `python-dateutil`, and `pytz` packages, plus a `de_DE.UTF-8` locale (used to format weekday -names). Inside `nix develop` these are provided automatically. - -To build with *nix*: `nix build '.?submodules=1#production-content'` +This deletes `public/` and runs `hugo` with the parameters from `.hugo-params`. To build with *nix* instead: +`nix build '.?submodules=1#production-content'` ## Making a change @@ -59,8 +61,7 @@ To build with *nix*: `nix build '.?submodules=1#production-content'` ## Nix stuff -- After entering the shell with `nix develop`, hugo is available and `hugo serve` should work -- Python including required packages will be available, so the `build.sh` should work without a venv +- After entering the shell with `nix develop`, hugo is available and `hugo serve` and `./build.sh` should work - You can build the staging and production builds with `nix build .#staging-content` and `nix build .#production-content` - Do not update the nixpkgs branch - 25.05 contains a newer hugo version that is incompatible with the theme (last