Календарь Pineapple

Руководство по установке | 安装指南

Мотивация заключается в том, чтобы решить проблему, с которой я не могу просматривать китайский лунный календарь в KDE. Текущая цель этого проекта — предоставить некоторый общий код (возможно, библиотеку), чтобы я мог создать плазмоид для Plasma 5 для отображения китайского лунного календаря, а также предоставить простое автономное приложение, которое также использует тот же код для быстрого тестирования и, возможно, дальнейшего развития.

Хотя целью этого проекта будет только поддержка простого китайского лунно-солнечного календаря, я всё ещё хотел бы сделать код расширяемым/гибким, чтобы иметь возможность реализовать поддержку других календарных систем.

На самом деле я не знаком с датами и временем, это может быть сложнее, когда нам также приходится иметь дело с разными локалями, поэтому поправьте меня, если что-то из упомянутого здесь неверно. Я также предоставлю ресурсы, которые нашёл здесь, при необходимости.

Ожидаемый результат

Текущие цели

• Плазмоид для KDE Plasma 5, который может...
  • отображать григорианский календарь как основной календарь.
  • отображать простой китайский лунный (лунно-солнечный) календарь как альтернативный календарь.
• Рассмотреть возможность включения этой функции в KDE
  • См. эту страницу, которая будет отслеживать состояние силы, чтобы включить эту функцию в KDE.
• Автономное приложение Qt Calendar, которое...
  • использует григорианский календарь в качестве основного календаря, может установить альтернативный календарь, загруженный через его систему плагинов.
  • поставляется с простым китайским лунным календарём в виде плагина.
  • разделяет один и тот же код с плазмоидом, насколько это возможно.

Не является целью, но может быть рассмотрено

• Поддержка календарных событий.
  • Поддержка Solar Terms(节气) через календарные события.
  • Поддержка ics.

Сборка

В настоящее время у нас уже есть пригодный для использования апплет для самой последней среды KDE Plasma Environment, см. инструкции ниже о том, как его опробовать.

По умолчанию он будет создавать только автономное приложение (для простого тестирования). Плазмоид не будет создаваться, пока вы не включите опцию BUILD_PLASMOID CMake. Также обратите внимание, что этот апплет содержит только жёстко запрограммированный китайский лунный календарь в качестве альтернативного календаря.

Создайте и протестируйте плазмоид

Убедитесь, что вы собираете с опцией -DBUILD_PLASMOID=ON, выполните sudo make install после завершения компиляции.

После установки вы можете щёлкнуть правой кнопкой мыши на цифровом часовом апплете и заменить его на апплет «Дата и календарь». Или, если вы просто хотите посмотреть, на что это похоже, вы можете использовать plasmoidviewer:

$ plasmoidviewer -a net.blumia.pineapple.calendar -l topedge -f horizontal

Примечание: я не уверен, как получить нативный плагин C++ при использовании пользовательского DESTDIR для вашей установки, не меняйте каталог установки, если вы тоже не знаете, и сообщите мне, если знаете.

Прочее

Файлы в /plasmoid/package/contents/ui/calendar/ разветвлены из plasma-framework с путём /src/declarativeimports/calendar/qml/ и хешем фиксации 532817c00455ef7ddb400529b9c102f142db508b.

Все файлы .cpp и .h под /app/declarativeimports/net/blumia/pineapple/calendar/ и файлы .qml под /app/calendar/ разветвлены от plasma-framework с путём /src/declarativeimports/calendar/ и хешем фиксации 532817c00455ef7ddb400529b9c102f142db508b, за исключением CalendarView.qml, который разветвлён от plasma-workspace с тегом 5.21.

Если у вас есть какие-либо предложения относительно моей реализации или лучшая идея о том, как внедрить поддержку альтернативных календарей в KDE, пожалуйста, не стесняйтесь открывать новую проблему или комментировать запрос функции в трекере ошибок KDE или странице Google Document о моих мыслях, или напишите в список рассылки plasma-devel!

Лицензия?

TBD, будет выпущена под лицензией, одобренной OSI и совместимой с DFSG. Апплет, который предоставлен в этом репозитории, лицензирован по лицензии LGPL-2.1-or-later.