README
This applet is a fork of Cinnamon's own calender. It adds the capability to mark public holidays in the calender panel in addition to the weekend days. Like the World Clock calendar, it has the capability to display additional time zones. The capability to display events is identical to the Cinnamon calendar (for Cinnamon version 5.2+).
Choose the Country and region for which to show the public holidays in the applet "Calendar" settings page. Add timezones to display in the applet "World Clocks" settings page.
The holiday data are obtained from the webservice Enrico by Kayaposoft.com.
Enrico Service 2.0 is a free service written in PHP providing public holidays for several countries. You can use Enrico Service to display public holidays on your website or in your desktop application written in any programming language.
Enrico Service 2.0 is an open-source software licensed under the MIT License so you can study, contribute, change or use it. See Enrico source code on Github.
See here for a list of supported countries and its regions. It needs to be noted that each change to their list needs to be reflected by an update to this applet. While I will try to keep track, if you notice something missing in the applet that the service offers, let me know about it.
Both the list of supported countries and the actual holiday data are provided by Enrico. If you find errors or have suggestions, please contact them directly at enrico@kayaposoft.com or raise an issue at Github.
If you find bugs in the applet itself or know about other sources of holiday information that can be included as webservices, please tell me about them.
About Events and Holidays
Most people using calendars today have adopted the logic behind the iCalendar format (RFC 5545). Applications using it may gloss over that, but the available categories for things to be entered in a calendar are limited to: event, to-do, journal, free/busy and alarm.
Holidays do not really fit any of those. And because of that, they mostly get entered as all-day (probably recurring) events, without any more distinction from the rest.
Suppose your calendar mentions someone's birthday. You will add it to your calendar as a whole-day event. If the calendar also mentions your country's National Holiday, both have no distinguishing feature that would make it possible to mark one and not the other as a non-working day.
This applet distinguishes between holidays and events. They have separate data sources, and they are visualised in a different way.
Holidays are marked as non-working days, the same as a weekend day. (Religious observances are not yet implemented).
Events are marked separately, and their details are shown in a side column.
Log In To Comment!
12 Comments