From bce2a5fbada8f8f0460b1a393aedde45e9524266 Mon Sep 17 00:00:00 2001 From: Guillaume Ayoub Date: Mon, 19 Apr 2010 16:43:46 +0200 Subject: [PATCH] Update documentation to add information about the Evolution support. --- technical_choices.rst | 7 +++++-- user_documentation.rst | 35 +++++++++++++++++++++++++---------- 2 files changed, 30 insertions(+), 12 deletions(-) diff --git a/technical_choices.rst b/technical_choices.rst index 218fae61..4e57c2c0 100644 --- a/technical_choices.rst +++ b/technical_choices.rst @@ -74,8 +74,8 @@ are very good choices if you want to develop and test new CalDAV clients, or if you have a possibly heterogeneous list of user agents. The Radicale Server does not and **will not** support the CalDAV standard. It -supports the CalDAV implementation of different clients (only Sunbird 0.9+ [#]_ and -Lightning 0.9+ [#]_ for the moment, including 1.0). +supports the CalDAV implementation of different clients (only Sunbird 0.9+ +[#]_, Lightning 0.9+ [#]_ and Evolution [#]_ for the moment). .. [#] `Cosmo `_, the web contents and calendars sharing server build to support the Chandler Project. @@ -89,6 +89,9 @@ Lightning 0.9+ [#]_ for the moment, including 1.0). .. [#] `Lightning `_, a calendar plugin bringing Sunbird in Mozilla Thunderbird. +.. [#] `Evolution `_, the default mail, + addressbook and calendaring client for Gnome. + Simple ~~~~~~ diff --git a/user_documentation.rst b/user_documentation.rst index 1009fc0a..07e306c9 100644 --- a/user_documentation.rst +++ b/user_documentation.rst @@ -23,7 +23,6 @@ known to work on Python 2.5, 2.6, 3.0 and 3.1 [#]_. Linux users certainly have Python already installed. For Windows and MacOS users, please install Python [#]_ thanks to the adequate installer. - .. [#] See `Python Versions and OS Support`_ for further information. .. [#] `Python download page `_. @@ -39,9 +38,10 @@ CalDAV Clients -------------- At this time Radicale has been tested and works fine with the latests version -of Mozilla Sunbird (versions 0.9 and 1.0). More clients will be supported in -the future. However, it may work with any calendar client which implements -CalDAV specifications too (luck is highly recommanded). +of Mozilla Sunbird (versions 0.9+), Mozilla Lightning (0.9+), and Evolution +(2.30+). More clients will be supported in the future. However, it may work +with any calendar client which implements CalDAV specifications too (luck is +highly recommanded). To download Sunbird, go to the `Sunbird project website `_ and choose the latest @@ -57,13 +57,14 @@ Starting Server To start Radicale CalDAV server, you have to launch the file called ``radicale.py`` located in the root folder of the software package. -Using Sunbird -------------- +Using Sunbird or Lightning +-------------------------- -After starting Sunbird, click on ``File`` and ``New Calendar``. Upcoming window -asks you about your calendar storage. Chose a calendar ``On the Network``, -otherwise Sunbird will use its own file system storage instead of Radicale's -one and your calendar won't be remotely accessible. +After starting Sunbird or Lightning, click on ``File`` and ``New +Calendar``. Upcoming window asks you about your calendar storage. Chose a +calendar ``On the Network``, otherwise Sunbird will use its own file system +storage instead of Radicale's one and your calendar won't be remotely +accessible. Next window asks you to provide information about remote calendar access. Protocol used by Radicale is ``CalDAV``. A standard location for a basic @@ -79,6 +80,20 @@ and tasks to your calendar. All events and tasks are stored in the server, they can be accessed and modified from multiple clients by multiple users at the same time. +Using Evolution +--------------- + +First of all, show the calendar page in Evolution by clicking on the calendar +icon at the bottom of the side pane. Then add a new calendar by choosing in the +menu ``File``, ``New``, ``Calendar``. + +A new window opens. The calendar ``type`` is ``CalDAV``, and the location is +something like ``caldav://localhost:5232/user/calendar``. You can fill other +attributes like the color and the name, these are only used for Evolution and +are not uploaded. + +Click on ``OK``, and your calendar should be ready for use. + Complex Configuration =====================