Overhaul of Config Parser & Calendar Offset

.gitignore

@@ -1 +1,4 @@
 outputCalendar.svg
+*.conf
+.idea
+templates

README.md

@@ -1,10 +1,47 @@
-CRCR
-====
-
-FSI CE's version of the CalendrCreatr for fast creation of beautiful calendars
-in svg format.
+# CRCR
 
+CalendrCreatr is a python script for fast creation of simple-styled calendars in svg format. 
 This is a fork from t-animal/CRCR.
 
-This software is released under CC-BY-SA-NC 3
+## Features
+- Automatic Import of german holidays if `holidays` package is installed.
+- Creates a calendar for any period of 12 months
+- Write periodic dates in the calendar
+
+## Quick Execution Guide
+
+On Linux:
+```
+python -m venv ./venv
+source venv/bin/activate
+# following line optional
+pip install holidays
+python calendrcreatr.py ./calendar_2024_2025_temp.conf
+```
+
+On Windows:
+```
+python -m venv .\venv
+.\venv\bin\activate
+# following line optional
+pip install holidays
+python calendrcreatr.py .\calendar_2024_2025_temp.conf
+```
+
+## Config Structure
+
+See `calendar_2024_2025_temp.conf` for an example of a config file.
+
+Empty lines and lines starting with `#` are ignored.
+Single dates can be given in den format `DD.MM.YYYY`, a range can be also given by `DD.MM.YYYY-DD.MM.YYYY`.
+Weekly dates can be written by `DD.MM.YYYY~1w~DD.MM.YYYY`. The given number can be adjusted to `2` for biweekly schedules.
+
+## License
+
+This software is released under CC-BY-SA-NC 3.
 (yes I know that this is technically not a software license. So use it for personal use, ask if you want to make money from that and retain a notice of this license. Use your common sense.)
+
+### Contributors
+- t-animal
+- FS CE
+- Timm638

calendar_2024_2025_temp.conf

@@ -0,0 +1,78 @@
+# Config-Datei für Kalenderskript
+
+# Title
+FSI-Kalender WS 2024 / SS 2025
+
+# Startmonat (inklusiv)
+# MM / YYYY
+10/2024
+# Endmonat (inklusiv)
+# MM / YYYY
+09/2025
+
+# Vorlesungezeiten:
+# DD.MM.YYYY-DD.MM.YYYY, ...
+13.10.2024-07.02.2025, 23.04.2025-25.07.2025
+
+# Vorlesungsfreie Zeiten
+# DD.MM.YYYY-DD.MM.YYYY, ...
+26.12.2024-06.01.2025
+
+# Prüfungszeiträume:
+# DD.MM.YYYY-DD.MM.YYYY, ...
+10.02.2025-22.02.2025, 28.03.2025-17.04.2025, 28.07.2025-09.08.2025, 19.09.2025-12.10.2025
+
+# Sondertage, Keine Kommata im Namen:
+# DD.MM, <Name>,birthday
+01.01,Hans,birthday
+# TODO: Hier weitere Geburtage eintragen
+
+# Feiertage
+# Werden automatisch eingepflegt durchs Skript
+# 18.04.2025,Karfreitag,feiertag
+# 21.04.2025,Ostermontag,feiertag
+# 29.05.2025,Christi Himmelfahrt,feiertag
+# 20.05.2025,Pfingstmontag,feiertag
+# 19.06.2025,Fronleichnam,feiertag
+# same day every year
+# 01.01,Neujahr,feiertag
+# 06.01,Heilige Drei Könige,feiertag
+# 01.05,Tag der Arbeit,feiertag
+# 15.08,Mariä Himmelfahrt,feiertag
+# 03.10,Deutsche Einheit,feiertag
+# 01.11,Allerheiligen,feiertag
+# 25.12,1. Weihnachtstag,feiertag
+# 26.12,2. Weihnachtstag,feiertag
+
+# Nerd-Feiertage
+# same day every year
+# DD.MM, <Name>,loscher
+12.03,GNU Terry Pratchett,loscher
+14.03,Pi Day,loscher
+25.05,Towel Day,loscher
+28.06,Tau Day,loscher
+
+# Uni-Events
+# TODO: TdI 2025
+# DD.MM, <Name>,sonstiges
+04.11.2024,Dies Academicus,sonstiges
+# TODO: Schlossgartenfest 2025
+14.10.2024,TFGDT,sonstiges
+05.05.2025-16.05.2025,Berch,sonstiges
+
+# Loscher
+# DD.MM.YYYY~2w~DD.MM.YYYY bedeutet alle zwei Wochen beginnend vom Startdatum bis zum Enddatum
+12.01.2024~2w~31.12.2024,Loscher,loscher
+10.01.2025~2w~31.12.2025,Loscher,loscher
+
+# Semesterbeitrag
+01.07.2024-07.07.2024,72€,sosonstiges
+# DD.MM, <Name>,sonstigesnstiges
+05.02.2025-09.02.2025,72€,sonstiges
+
+# KIF
+17.10.2024-21.10.2024,KIF 52.5,sonstiges
+18.06.2025-22.06.2025,KIF 53.0,sonstiges
+
+# CCC
+27.12.2024-30.12.2024,CCC,sonstiges