The motivation is to solve the issue that we, well, I, am not able to watch Chinese Lunar Calendar under KDE. The current goal of this project is, provide some generic code (probably a library) so I can create a plasmoid for Plasma 5 to display Chinese Lunar Calendar, and also provide a simple standalone application which also use the same code for quick testing and maybe some further development.
Although the goal of this project will only provide Simple Chinese Luni-solar calendar support, I still would like to make the code extendable/flexable to be able to implement other calendar system support.
Actually I'm not familiar with the date and time thing, it could be more complex when we also need to deal with different locales, so correct me if anything mentioned here is wrong. I'll also provide the resources I found here when needed.
- A Plasmoid for KDE Plasma 5, which can...
- display a Gregorian Calendar as main calendar.
- display a Simple Chinese Lunar (luni-solar) calendar as alternate calendar.
- See the possibility if we can get this feature into KDE
- A standalone Qt calendar application, which...
- use Gregorian Calendar as main calendar, can set alternate calendar which loaded via its plugin system.
- comes with a Simple Chinese Lunar calendar plugin.
- share the same code with the Plasmoid one as much as possible.
- Support calendar events.
- Support Solar Terms(节气) via calendar events.
- Support ics.
Current state we already got a usable applet for the most recent KDE Plasma Environment, see the instruction below about how to try it out.
By default it will only build the standalone application (for simple testing). The plasmoid won't build unless you enable the BUILD_PLASMOID
CMake option. Also please notice this applet only contains a hard-coded Chinese lunar calendar as alternate calendar.
Ensure you build with -DBUILD_PLASMOID=ON
option, do sudo make install
once your compile completed.
Once it's installed, you can right click the digital clock applet and replace with the "Date and Calendar" applet. Or if you just would like to see what it's like, you can use plasmoidviewer
:
$ plasmoidviewer -a net.blumia.pineapple.calendar -l topedge -f horizontal
Note: I'm not sure how to get the c++ native plugin loaded if you use custom DESTDIR for your installation, don't change install dir if you don't know either, and please let me know if you know
Files under /plasmoid/package/contents/ui/calendar/
are forked from plasma-framework
with path /src/declarativeimports/calendar/qml/
and commit hash 532817c00455ef7ddb400529b9c102f142db508b
.
All .cpp
and .h
files which under /app/declarativeimports/net/blumia/pineapple/calendar/
and .qml
files under /app/calendar/
are forked from plasma-framework
with path /src/declarativeimports/calendar/
and commit hash 532817c00455ef7ddb400529b9c102f142db508b
, except CalendarView.qml
is forked from plasma-workspace
with tag 5.21
.
If you have any suggestion about my implementation, or have any better idea about pushing alternate calendar support into KDE, please feel free to open up a new issue, or comment on the feature request in the KDE bug tracker or the Google Document page about my thought, or write to plasma-devel mailing list!
TBD, will be released under an OSI approved DFSG-compatible license.
For the plasma applet which provided in this repo, it's licensed under the license of LGPL-2.1-or-later.