# gxde-calendar

**Repository Path**: GXDE-OS/gxde-calendar

## Basic Information

- **Project Name**: gxde-calendar
- **Description**: Calendar for GXDE Desktop Environment.
- **Primary Language**: C++
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2024-02-09
- **Last Updated**: 2026-05-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# gxde-calendar

GXDE 桌面环境的日历应用。

## 功能特性

- **农历支持**：自动显示传统农历信息，包括农历月、日以及干支纪年（天干地支）
- **节日识别**：高亮显示中国传统节日和二十四节气，并通过视觉标识区分不同类型的节日
- **假期管理**：集成在线节假日 API，动态显示调休安排（周末上班、工作日放假）和工作日状态
- **多主题支持**：适配系统亮色/暗色主题，支持日历单元格的自定义配色方案
- **周首日配置**：支持设置周一或周日为一周的开始
- **每日一句**：获取并展示每日励志语句或心灵鸡汤
- **DBus 集成**：提供 DBus 接口用于唤出主窗口和支持进程间通信
- **单例模式**：确保只有一个日历实例运行，重复启动时会激活已有窗口

## 创新亮点

- **混合日历引擎**：通过 DBus 服务将公历日期与精确的农历计算无缝结合，在统一视图内同时提供现代和传统日期参照
- **智能工作日检测**：实时获取政府发布的官方节假日安排，动态确定工作日/休息日状态，并自动叠加到标准日历网格上
- **优雅的节日高亮**：对农历节日、节气和法定节假日采用不同的视觉样式，让重要日期一目了然
- **自适应单元格渲染**：智能区分普通工作日、周末、节日和当天等不同状态，农历信息支持独立的文字和背景色管理
- **离线优先的假期数据**：内置本地假期数据，网络可用时自动静默更新，确保断网环境下依然稳定运行