The CentOS Project Calendar
This project aims to provide an easier way to track CentOS related meetings. Every project meeting is defined by a YAML files. These are combined using yaml2ical into a web page listing all meetings and an
.ical file that can be read by your calendaring application of choice.
For the actual calendar, please see:
Instructions for adding or changing a meeting are also there.
This system is based on the fantastic work done by the OpenStack Project as documented at https://github.com/openstack-infra/irc-meetings for managing their internal meetings.
YAML Meeting File Format
Each meeting consists of:
project: the name of the project
project_urlthe URL to the page of the project
meeting_id: the name given to the
agenda_urlthe URL to the page with the agenda for the meeting, usually in the wiki
schedule: a list of schedule each consisting of
time: time string in UTC
day: the day of week the meeting takes place
irc: the irc room in which the meeting is held
frequency: frequent occurrence of the meeting
chair: name of the meeting's chair
description: a paragraph description about the meeting
The file name should be a lower-cased, hyphenated version of the meeting name,
.yaml . For example,
Atomic SIG Team Meeting should be
This is an example for the yaml meeting for Software Collections SIG. The whole file will be import into Python as a dictionary.
The project name is shown below.
project: Software Collections SIG Sync-up
The schedule is a list of dictionaries each consisting of
dayof the week, the
ircmeeting room, and the
frequencyof the meeting. Options for the
biweekly-oddat the moment.
schedule: - time: '1600' day: Wednesday irc: centos-devel frequency: weekly
The chair is just a one liner. The might be left empty if there is not a chair.
chair: Honza Horak
The project description is as follows. Use
>for paragraphs where new lines are folded, or
|for paragraphs where new lines are preserved.
description: > Discussions related to the Software Collections SIG. The SIG will provide an upstream development area for various software collections and related tools. Developers can build on and extend existing SCLs, so they don't need to re-invent the wheel or take responsibility for packaging unnecessary dependencies.
https://github.com/openstack-infra/yaml2ical). A container, bexelbie/yaml2ical has been created to assist with this. Using the container, run:To create the output files, run yaml2ical (
docker run --rm=true --privileged -u `id -u`:`id -g` -v `pwd`:/workdir bexelbie/yaml2ical -y meetings -o output/irc-meetings.ical -t list.markdown.jinja -w output/calendar.markdown -f -n "CentOS Meetings" -d "Meeting schedule for the CentOS Project and SIGS"
To publish output, do the following
mv output/calendar.markdown output/calendar.md
- Commit the output ical (and optionally but recommended) the markdown output to the CentOS git server
- Copy/Commit output/calendar.md to git.centos.org/git/websites/centos.org.git/content/community/calendar.md