yuxing/lunar-calendar
1
0
Fork 0
mirror of https://github.com/infinet/lunar-calendar.git synced 2026-01-12 21:17:00 +08:00
Code Issues Packages Projects Releases Wiki Activity

update readme

Browse Source
This commit is contained in:
Chen Wei
2014-01-29 09:46:00 +08:00
parent a37a0aeb78
commit cf1aba3270
1 changed files with 29 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

39
README.md
View File

@@ -19,13 +19,18 @@ copy of which is include in the file COPYRIGHT.
### How to run
run `lunar_ical`, it will fetch data from Hong Kong Observatory, save the data
to a local sqlite database, then use that database to generate two ics files,
one for all days from 1901 to 2100, **Warning**, this file is huge, over 6M;
another is only cover 3 years, from the previous to the end of next year.
run `lunar_ical`, it will fetch data from [Hong Kong Observatory][HK_Obs], save the data
to a local sqlite database, then use that database to generate a ics file, which
covers from the previous to the end of next year.
Try the Chinese Lunar Calendar by add this [link][iCal] to your favorite calendar app.
Try the Chinese Lunar Calendar by add this [ics file][iCal] to your favorite
calendar app.
start and end date can also be specified as command line options, for example
`lunar_ical.py --start=1990-01-01 --end=2001-01-01`
The date must in ISO format.
### iCalendar格式的中国农历 节气 及传统节日
@@ -33,23 +38,37 @@ Try the Chinese Lunar Calendar by add this [link][iCal] to your favorite calenda
iCalendar是一种通用的日历交换格式，很多软件和设备，比如google calendar, apple
calendar, thunderbird + lightning插件, iphone/ipad, 安卓都支持。
以前订过iCalendar格式农历日历，但慢慢地它们都停止了更新。所幸香港天文台上可以
找到从1901年到2100年间两百年的农历-公历对照表，也就是这里用到的数据。
以前订过iCalendar格式农历日历，但慢慢地它们都停止了更新。所幸[香港天文台][HK_Obs]上可以
找到从1901年到2100年间两百年的农历-公历对照表，也就是这里用到的数据。
这个[链接][iCal]是覆盖前年、今年以及明年三年的日历，把它加入到你最常用的软件
下面是覆盖前年、今年以及明年三年的日历[ics文件][iCal]链接，把它加入到你最常用的软件
就可以了。
[https://raw.github.com/infinet/lunar-calender/master/chinese_lunar_prev_year_next_year.ics][iCal]
苹果设备上应该是:
设置 => 邮件、通讯录、日历 => 添加账户 => 日历 添加已订阅日历
如果在Mac的日历程序里订阅到iCloud，这个日历还可以自动推送到所有使用那个iCloud
如果在Mac的*iCal*里订阅到iCloud，这个日历还可以自动推送到所有使用那个iCloud
账户的ios设备。
### 生成更长时段农历
如果你需要更长时段的农历，可以下载`lunar_ical.py`
直接运行`./lunar_ical.py`会从香港天文台抓取1901到2100年间所有数据，然后生成上面
那个前后三年时段的农历ics文件；
使用参数--start和--end指定需要的起至日期, 例如:
./lunar_ical.py --start=2010-05-01 --end=2021-12-31
[Contact me](mailto: weichen302@gmail.com)
[iCal]: https://raw.github.com/infinet/lunar-calender/master/chinese_lunar_prev_year_next_year.ics
[Hong Kong Observatory]: http://gb.weather.gov.hk/gts/time/conversionc.htm
[HK_Obs]: http://gb.weather.gov.hk/gts/time/conversionc.htm