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 中的所有日历提供一组高级 Kalendaring 视图，并且尽管组件架构是由 Zope Corporation 创建的，但 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，一组实现 Kalends UI 的 Zope 视图，以及 Plone4ArtistCalendar，一个将 Plone 文件夹变成事件提供者的 Plone 产品。