dateable.kalends 1.0

简介

Kalends是一个Python模块，它使用接口和适配器等组件架构技术来分离日历事件的存储和显示。其目的是提供一个通用的Python API，以便任何日历UI都可以显示来自任何日历源的数据。因此，人们可以在不重新实现底层日历功能的情况下创建新的UI，同样也可以在重用现有UI的同时实现专门的日历功能。

例如，如果你有一个具有良好日历UI的群件系统，但需要使用外部服务器来管理你的日历，你不需要重新编写用户界面。

次要目标还包括提供一个日历API，以帮助人们克服将来可能会遇到的某些障碍，例如如何处理重复事件、搜索等，通过提供一个可以处理这些问题的API来实现。

该API的两个主要概念是事件提供者，它们是事件来源，以及事件使用者，它们获取事件并将它们显示出来、导出等。有关如何使用Kalends创建EventProvider的更多信息，请参阅doc/PROVIDING.txt，有关如何使用Kalends从EventProvider获取事件的更多信息，请参阅doc/USING.txt。

需求

虽然Kalends的创建是由希望在Plone中为所有日历提供一组高级日历视图的愿望所推动的，尽管组件架构是由Zope公司创建的，但Kalends并不特定于Plone、Zope甚至Web应用程序。它是一个Python模块，可在任何可以安装组件架构的Python版本（2.3或更高版本）的系统上安装，这在很大程度上是任何具有C编译器的Python系统。

Kalends需要：- Python 2.3或更高版本（最后测试版本：2.4.3）- zope.interface 3.2或更高版本（最后测试版本：3.2.2）

已知实现

目前，Dateable（《https://svn.plone.org/svn/collective/dateable/》）模块集正在使用Kalends。它包含chronos，这是一个Zope的视图集合，实现了Kalends UI，以及Plone4ArtistCalendar，这是一个将Plone文件夹变成事件提供者的Plone产品。