< KDE PIMRevision as of 22:16, 24 May 2012 by Jlayt (talk | contribs) (→Resources)(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff) Contents 1 The KHolidays Library 2 Introduction 3 Maintainers 4 Resources 5 Features 6 File Format 7 Future Plans The KHolidays Library Introduction The KHolidays library in kdepimlibs provides details on public holidays for a given country and date range. A separate library and file format is required as iCalendar is not capable of expressing recurrence rules for all possible holidays. Maintainers John Layt (IRC jlayt) Allen Winter Resources API: Browse api.kde.org Code: Browse projects.kde.org Code: Browse quickgit.kde.org Bugs: Bugzilla Search Features The following features are available in KHolidays that are not supported in iCalendar: Alternative calendar systems (Hebrew, Islamic, etc) Special date calculations, currently Easter and Orthodox Easter, but can include events like solstices, or any named day of the year. Commemoration date, i.e. Christmas occurs on a Sunday, you get the Monday off. Holiday Class, i.e.day-of,not day off, religious day off, school holiday, etc Holiday Categories, i.e. Cutural, Official, Religious, etc. File Format The file format originally used was the PLAN format, but this has been extended a number of times to support new features. The limits of the format have about been reached and it is too complex for easy maintenance. It is intended to add a few more features to the format then to design a new XML file format to replace it. Historic document: http://community.kde.org/KDE_PIM/KOrganizer/Holiday_File_Format Future Plans Old design document http://websvn.kde.org/trunk/playground/pim/libkholidays_ng/ The following development plan is designed to become a Freedesktop.org project so that the maintenance burden can be shared with Gnome and any other interested parties. A proposal will be presented at the Berlin Desktop Summit in August 2011. Design a new XML based file format Convert KDE files to new format Implement a base C (?) library to parse the XML file and calculate the holidays, will include calendar systems if not in glibc by then. No desktop specific code allowed, i.e. to be equivalent to libical. Implement a pure Qt library to wrap the C library in kdesupport Implement an Akonadi resource Retrieved from "https://community.kde.org/index.php?title=KDE_PIM/KHolidays&oldid=21068" Content is available under Creative Commons License SA 4.0 unless otherwise noted.