# easy-calendar

**Repository Path**: whitenfly/easy-calendar

## Basic Information

- **Project Name**: easy-calendar
- **Description**: 一个学生专用的简便型日历~~
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2022-10-16
- **Last Updated**: 2024-04-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: calendar, calendar, PyQt5

## README

# Easy Calendar

<br/>

> Easy Calendar: 一个学生专用的简便型日历~~
> 版本：1.0_beta



<p align='center'>
   <img src="./image/logo.png" alt="logo" style="zoom: 200%;" />
</p>


## 主界面效果图

<p align='center'>
   <img src="./image/主界面截图.png" alt="主界面截图" style="zoom: 200%;" />
</p>


## 日程添加界面



<p align='center'>
   <img src="./image/日程添加界面.png" alt="日程添加界面" style="zoom: 200%;" />
</p>

## 安装

- 获取源代码：

```
git clone https://gitee.com/whitenfly/easy-calendar.git
```



- 使用Anaconda 安装Python 依赖库：

```
conda create -n easy_calendar python=3.6
conda activate easy_calendar
pip install -r requirements.txt
```







## 使用

- 运行easy_calendar:

```python
cd code/
python mainwindow.py
```

- 使用easy_calendar:

  详细使用见下方Easy-Calendar 用户使用手册

  PDF版位置：doc/Easy-Clendar_v1.0_beta用户手册.pdf
  
- 使用已打包的easy-calendar：

  请下载 easy-calendar发行版，解压后运行start.exe即可完成安装，并自动生成Easy-Clendar快捷方式，双击即可运行软件。

## 引用

### 	1. 气象信息来源：[中国天气网 ](http://www.weather.com.cn/)







## 日历功能结构图



![功能结构图](./image/功能结构图.png)





# Easy-Calendar_v1.0_beta用户使用手册



## 一、主界面介绍

本节对主界面做简单介绍，具体功能使用将在下一节详细介绍。

打开软件，即可见到软件主界面，如下图所示：

![](./image/1.png)

### 1.精简日期显示区

​	主界面左上方部分（下图红框区域）是精简日期显示区。在这个区域可以快速查看当日日期、星期、节气信息，还有当天的贴心小提示、小祝福等，供用户查看、参考。

【界面截图】![](./image/2.png)

### 2.天气信息显示区

主界面右上角部分（下图红框区域）是天气信息显示区域。在这个区域可以快速查看设定区域的天气情况、温度情况。

【界面截图】![](./image/3.png)

### 3.教学周信息显示区

主界面左下角部分（下图红框区域）是教学周信息显示区域。在该区域可以查看学生当前所处教学周周次。

【界面截图】![](./image/4.png)

### 4.日历信息显示区

主界面右下角的部分（下图红框区域）是日历信息显示区域。在该区域可以查看日历的详细信息，添加日程等。

【界面截图】![](./image/5.png)

### 5.其他区域

除上述区域外，还有搜索部分和日历切换部分（下图红框区域），在该区域可以与查找日程或切换日历部分的显示。

【界面截图】![](./image/6.png)

## 二、功能介绍

### 1.日历相关

#### 	1.1 日历日期切换

点击软件主界面中间部分的单双箭头可对日历进行翻页，其中单箭头以月份为单位翻页，双箭头以年为单位翻页。如下图所示：

![](./image/2-1.png)

#### 	1.2 日历日期信息查找

点击日历区域 “月”字右上角的按钮，可见右侧搜索栏将会高亮，并显示“请输入日期”，如下图所示：

![](./image/2-2.png)

查找格式为“X年X月”，暂不支持其他查找格式。

![](./image/2-3.png)

输入符合格式日期后，回车即可，查找成功后日历区域将会切换至所查找月份的日历。

![](./image/2-4.png)

若未查找成功，则显示查找失败界面：

![](./image/2-5.png)

### 2.日程相关

#### 	2.1 添加日程

点击日历显示区域任意一个日期即可在该日期添加一个日程。如下图所示：

![](./image/2-6.png)

点击日期后将会显示添加日期按钮，点击将会出现日期添加界面，如下图所示：

![](./image/2-7.png)

在该界面可以详细定义日程的详细信息如事件名称、开始时间、结束时间、事件描述、类型等，同时可以在上方选项处设置是否提醒：

![](./image/2-8.png)

根据右侧提示可以在日程中添加多媒体信息，如照片或视频信息，点击“+”即可选择图片并上传，上传完毕后可在右侧预览图片：

![](./image/2-9.png)

当上传了多张图片时，可在列表处选择图片预览：

![](./image/2-11.png)

点击预览图右上角的放大镜即可查看原图：

![](./image/2-10.png)



视频的添加、预览和多视频预览的方式和图片一样：

![](./image/2-12.png)



日程信息填写完成后，需点击界面左上角的保存按钮保存日期。保存成功后将会弹窗提示，随后可关闭日程窗口。

回到主界面将会发现有日程的日期右上角将会多出一个小红点，以提示日程所在。

![](./image/2-13.png)

当一个日期有多个日程时，点击该日期将会显示多个日程，上下滑动即可浏览或选择添加新日程。

![](./image/2-14.png)

注：日程的标题不能为空。若为空将会弹窗提示：

![](./image/2-26.png)





#### 	2.2 修改日程信息

点击日期，选择需要修改的日程，点击进入日程界面即可对日程信息进行修改，随后点击保存即可成功保存修改：

![](./image/2-14.png)

#### 	2.3 删除日程信息

点击日期，选择需要删除的日程，点击进入日程界面，点击左上角的删除按钮:

![](./image/2-15.png)

随后将会弹出确定删除窗口，再次点击Yes后将会删除该日程：

![](./image/2-16.png)

#### 	2.4 日程信息查找

在常规情形下（搜索框显示“请输入事件关键字”时），在主界面点击搜索框，输入想要搜索的字即可搜索日程信息中是否有相关的信息，并显示搜索结果;

![](./image/2-17.png)

![](./image/2-18.png)

注：搜索区分大小写

### 3.天气相关

#### 	3.1 默认天气地点设置

设置默认天气后，每次打开软件显示的天气将是默认地点的天气信息。

点击主界面右上角的设置按钮，打开设置界面：

![](./image/2-19.png)

在设置默认天气地点标签下方输入设置的天气地点，并点击应用，即可完成默认天气地点设置。

#### 	3.2 天气信息更新

点击主界面天气信息区域中地点右上角的刷新按钮，主界面中的搜索栏将会高亮，并显示请输入地址：

![](./image/2-21.png)

输入希望显示天气信息的地址，回车即可更新主界面的天气信息。

![](./image/2-22.png)

![](./image/2-23.png)

### 4.界面相关

#### 	4.1 界面背景切换

点击主界面右上角的设置按钮，进入设置界面：

![](./image/2-24.png)

点击切换背景下的几张背景图片，红框高亮即表明选中，再点击应用即可更换主界面背景;

![](./image/2-25.png)

### 5.教学周相关

#### 5.1 教学周时间设置

点击主界面右上角的设置按钮，进入设置界面：

![](./image/2-19.png)

在设置教学周标签下方可以设置本学期第一周的第一天和本学期周数。设置完后点击应用可见主界面已自动计算教学周，非教学周将会显示“休”：

![](./image/2-25.png)

## 三、其他说明

### 1.天气信息来源

本软件天气信息来自[中国天气网 ](http://www.weather.com.cn/)。