# calendark

**Repository Path**: gin9/calendark

## Basic Information

- **Project Name**: calendark
- **Description**: 一个命令行日历
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2021-01-26
- **Last Updated**: 2021-01-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# calendarK

#### 初心
”给岁月以文明“

#### 介绍
一个命令行日历工具


#### 功能
- 显示西历和农历日历
- 支持干支纪年
- 支持生肖

#### 截图
![输入图片说明](https://images.gitee.com/uploads/images/2019/1101/202227_850ac20d_2292516.png "深度截图_选择区域_20191101201647.png")


#### 软件架构
使用python3编写


#### 安装教程
等待施工:)



#### 使用说明
- 终端移动到项目根目录
- python3 calendark1.py 
- 提供4个参数, -y 年份(如:1997) -m 月份(如:8) -d 日(如:27) -l(显示对应农历) ,不加任何选项默认显示当前日期

### 关于开发
程序的一个重要部分是calendark.py里的CHINESEYEARCODE(年度编码表),这个表包含了1900-2100间201年的农历信息.如果打算自己生成这个表,只需 
要先下载python3,并最好创建一个虚拟环境,详见
[关于venv](https://docs.python.org/zh-cn/3/tutorial/venv.html),然后
```
pip install scrapy -i https://pypi.tuna.tsinghua.edu.cn/simple
```

然后进入scrapyspider1目录,然后scrapy crawl lunar,就可以看到目录下生成许多txt文件,再执行python3 encode.py就可以在终端打印出编码表了(目前生成的表还有些错误,待解决,不过程序使用的表是copy大佬的所以没问题).

打算实现公历-农历互检以及农历-帝号年号互检

打算给calendarK写个简单的图形界面，打算实现以下效果：
- 启动默认显示今天所在月份的月视图并高亮显示今天
- 年时图模式
- 搜索框可输入年月日或帝号年号直接跳转
- 双击当前日期显示对应朝代年号帝号

#### 参与贡献

- Fork 本仓库
- 新建 Feat_xxx 分支
- 提交代码
- 新建 Pull Request


#### 感谢
[参考了CutePandaSh的中国农历转换项目zhdate](https://github.com/CutePandaSh/zhdate)

[参考了CutePandaSh的简书](https://www.jianshu.com/p/272c5dfa3eef)



####  TODO
- 改用天文方法计算农历并生成公元元年到2100年的年度编码表
- 节气,传统节日
- 朝代,帝号,年号查询(呵呵,要手动录入数据)
- 日程安排与提醒(通过发邮件,且支持特定星期或日期重复)
- 简单的图形界面,以及后台常驻
- 利用[EAF](https://github.com/manateelazycat/emacs-application-framework)在emacs中运行
- 更多个性化设置(字体,背景等)
- 无障碍交互
- 持续优化


#### Bug
- 32位系统上会有2038问题,2038年1月19日 03:14:07，星期二（UTC）这一刻以后运行程序会出错,请改用64或更高位系统
- 有的年份日期可能与历史不符(研究古代文献者请谨慎使用)