-
navigate to the calendar folder on acidburn,
/nfs/cistern/share/calendar
-
make a new folder for your date, if neccesary
- e.g.
/nfs/cistern/share/calendar/2024/nov/6
- the year is always 4 digits, the month is one of {jan, feb, mar, apr, may, jun, jul, aug, sep, oct, nov, dec}, the day has no preceding zeroes
- e.g.
-
copy meeting.yml.sample from this repository into that folder as <something>.yml. edit to taste
-
run the script (on acidburn this happens automatically)
- your change should propagate to the html event calendar in <= one minute, and a wiki page / listserv post should be made the day of
- add an executable to the
hooks/always
folder. make sure it's +x. - the main script will call it using the absolute path to the manifest as the first argument
- process all the events therein as you like.
- follow the same instructions as for
always
hooks, but withhooks/days-before/N
- note that handling the 'triggers N days before' part is up to the script
- look at
wiki.py
andlistserv.py
for guidance
- the main script,
calendarium.py
, gets called (manually, by a cronjob, w/e) with the path to the calendar folder as the first argument - it parses the calendar folder into an event manifest, in
calendar/manifest.json
- it calls all the hooks.