[Pkg-owncloud-commits] [owncloud-doc] 90/270: Update calendar app document for OC7
David Prévot
taffit at moszumanska.debian.org
Thu Jul 31 03:53:05 UTC 2014
This is an automated email from the git hooks/post-receive script.
taffit pushed a commit to branch master
in repository owncloud-doc.
commit 74c1a06c5f4ad287c6178f3ce1056f6fe8d4d760
Author: Volkan Gezer <volkangezer at gmail.com>
Date: Mon May 19 17:52:38 2014 +0200
Update calendar app document for OC7
New instructions and images
---
user_manual/images/caldav.png | Bin 0 -> 338 bytes
user_manual/images/calendar_createevent.png | Bin 17972 -> 13663 bytes
user_manual/images/calendar_export.png | Bin 18885 -> 9835 bytes
user_manual/images/calendar_import.png | Bin 8250 -> 9074 bytes
user_manual/images/calendar_manage-calendars.png | Bin 39313 -> 34730 bytes
user_manual/images/calendar_newtimezone1.png | Bin 5253 -> 4868 bytes
user_manual/images/calendar_share.png | Bin 0 -> 16185 bytes
user_manual/images/cross.png | Bin 0 -> 181 bytes
user_manual/images/download.png | Bin 0 -> 162 bytes
user_manual/images/gear.png | Bin 0 -> 452 bytes
user_manual/images/pencil.png | Bin 0 -> 193 bytes
user_manual/images/share.png | Bin 0 -> 264 bytes
user_manual/pim/calendar.rst | 208 +++++++++++++++++------
user_manual/pim/sync_kde.rst | 6 +-
14 files changed, 157 insertions(+), 57 deletions(-)
diff --git a/user_manual/images/caldav.png b/user_manual/images/caldav.png
new file mode 100644
index 0000000..077bb75
Binary files /dev/null and b/user_manual/images/caldav.png differ
diff --git a/user_manual/images/calendar_createevent.png b/user_manual/images/calendar_createevent.png
index ceabce3..5ca9bb3 100644
Binary files a/user_manual/images/calendar_createevent.png and b/user_manual/images/calendar_createevent.png differ
diff --git a/user_manual/images/calendar_export.png b/user_manual/images/calendar_export.png
index ffcde28..916cedf 100644
Binary files a/user_manual/images/calendar_export.png and b/user_manual/images/calendar_export.png differ
diff --git a/user_manual/images/calendar_import.png b/user_manual/images/calendar_import.png
index 17fb7e3..9806f99 100644
Binary files a/user_manual/images/calendar_import.png and b/user_manual/images/calendar_import.png differ
diff --git a/user_manual/images/calendar_manage-calendars.png b/user_manual/images/calendar_manage-calendars.png
index e1b6a9a..610cfcb 100644
Binary files a/user_manual/images/calendar_manage-calendars.png and b/user_manual/images/calendar_manage-calendars.png differ
diff --git a/user_manual/images/calendar_newtimezone1.png b/user_manual/images/calendar_newtimezone1.png
index db0f333..961c58c 100644
Binary files a/user_manual/images/calendar_newtimezone1.png and b/user_manual/images/calendar_newtimezone1.png differ
diff --git a/user_manual/images/calendar_share.png b/user_manual/images/calendar_share.png
new file mode 100644
index 0000000..ac408e0
Binary files /dev/null and b/user_manual/images/calendar_share.png differ
diff --git a/user_manual/images/cross.png b/user_manual/images/cross.png
new file mode 100644
index 0000000..3389c66
Binary files /dev/null and b/user_manual/images/cross.png differ
diff --git a/user_manual/images/download.png b/user_manual/images/download.png
new file mode 100644
index 0000000..0f71a5a
Binary files /dev/null and b/user_manual/images/download.png differ
diff --git a/user_manual/images/gear.png b/user_manual/images/gear.png
new file mode 100644
index 0000000..f6eb6ce
Binary files /dev/null and b/user_manual/images/gear.png differ
diff --git a/user_manual/images/pencil.png b/user_manual/images/pencil.png
new file mode 100644
index 0000000..975bd2d
Binary files /dev/null and b/user_manual/images/pencil.png differ
diff --git a/user_manual/images/share.png b/user_manual/images/share.png
new file mode 100644
index 0000000..fdacbba
Binary files /dev/null and b/user_manual/images/share.png differ
diff --git a/user_manual/pim/calendar.rst b/user_manual/pim/calendar.rst
index 8d92419..0aae77b 100644
--- a/user_manual/pim/calendar.rst
+++ b/user_manual/pim/calendar.rst
@@ -1,91 +1,189 @@
Using the Calendar App
======================
-Creating a calendar
--------------------
-
.. figure:: ../images/calendar_manage-calendars.png
-Calendar view
+Calendar view with global settings pane is open
+
+.. _managing-calendars:
+
+Managing calendars
+------------------
+
+You can manage your calendars by clicking appropriate buttons next to
+your calendar in the calendar list on the left. You can also click on |gear| icon
+to change global settings for all calendars. Here, there will be also
+links for CalDAV access.
+
+Create
+~~~~~~
If you use the calendar the first time, there will be already a calendar called
-"Default calendar". You can manage your calendars with a click on the "Calendar"
-button in the top right corner. In the dialog, which will appear, you can add,
-edit, export, enable, disable and delete your calendars. There will be also a
-link for CalDAV access.
+"Personal". To create another calendar, click on *New Calendar* button on the left
+pane, type a calendar name and pick a color. Then, click on the tick button to
+complete.
-Synchronising Calendars with CalDAV
------------------------------------
+.. _eds:
-Assuming you access your web interface via an address like this::
+Edit/Delete
+~~~~~~~~~~~~~~~~~~~~~~~~~~
- http://ADDRESS
+To edit a calendar name and/or color, click on the |pencil| icon and change the values.
+Then, click on the tick button to apply changes.
-Then you can access your calendars with CalDAV-compatible programs like
-Kontact, Evolution, Thunderbird using the following URL::
+.. |pencil| image:: ../images/pencil.png
- http://ADDRESS/remote.php/caldav
+To delete a calendar, click on the |cross| icon next to the calendar name.
-To use the ownCloud calendar with Apple iCal you will need to use the following
-URL, including the trailing slash::
+.. |cross| image:: ../images/cross.png
- http://ADDRESS/remote.php/caldav/principals/username/
-Mozilla Lightning users need to this URL scheme::
+Show/Hide
+~~~~~~~~~
- https://ADDRESS/remote.php/caldav/calendars/USERNAME/CALENDARNAME
+To hide/show a calendar, click on the color next to the calendar name. The calendar view
+will be refreshed automatically. Currently, in shared calendars, only the users with update
+permission can hide/show the calendars.
- Example for a simple calendar: The "Default calendar" is referred to as "defaultcalendar",
- and the users' name here is "test".
- The full URL (which on the picture can't be seen because of the
- short edit field) is then::
- https://localhost/owncloud/remote.php/caldav/calendars/test/defaultcalendar
+Share
+~~~~~
-.. Note: the calendar names are lowercased and the spaces removed. They are not to be URL-encoded anymore.
+Calendar sharing is done in the same way as the other apps in ownCloud. To share a calendar,
+click on the |share| icon and fill in the desired fields.
-Creating events
----------------
+.. |share| image:: ../images/share.png
-To create an event just click on the date in the month view or choose the
-timeframe in the weekview. In the dialog which will appear you can enter your
-information like title, category, etc.
+A calendar can be shared with a user, group, and/or public. It can have a password and a
+expiration date which will expiry the share after the specified date.
-.. figure:: ../images/calendar_createevent.png
-New event window
+If the calendar is shared with a user or group, it is possible to set permissions to
+create, edit, delete, and share the events in it.
+
+
+Import
+~~~~~~
-With the advanced options you can set the
-description, the location and the repetition rate of an event. If the repeating
-should end you can choose between setting the end by date or by occurrences. If
-you choose in the weekview all days from Monday to Friday it will automatically
-set the repeat rule to "every weekday". If the interval of the weekview can be
-divided by two it automatically set the repeat rule to "Bi-Weekly".
+.. figure:: ../images/calendar_import.png
+Importing calendar
+
+Importing your calendar as iCal file is done by using the files app. Upload the iCal file
+and just click on the calendar file to open the import dialog. You can import the calendar
+into a new calendar or an already existing one.
-Exporting / Importing events
-----------------------------
+.. note:: If the progress bar does not work properly, the folder
+ ``apps/calendar/import_tmp/`` has probably no write permission. Please contact
+ your administrator for this issue.
+
+.. _export-calendar:
Export
~~~~~~
+If you want to export a whole calendar to an iCal file, use the |download| icon
+next to your calendar in the calendar list.
+
+.. |download| image:: ../images/download.png
+
.. figure:: ../images/calendar_export.png
-Exporting an event
+Exporting calendar
-You can export either a single event or a whole calendar. If you want to export
-a single event click on it and press the export button in the bottom right
-corner. If you want to export a whole calendar use the "Calendar" button as
-described in the chapter "Creating a calendar".
+Managing events
+---------------
-Import
-~~~~~~
+Create events
+~~~~~~~~~~~~~
-.. figure:: ../images/calendar_import.png
-Importing events
+To create an event, just click on the date in the month view or choose the
+timeframe in the weekview. In the dialog which will appear, you can enter the event
+information such as title, category, etc. If there is more than one calendar, you will
+be given an option to choose the calendar in which you would like to create the event.
+
+.. figure:: ../images/calendar_createevent.png
+New event window
+
+With the advanced options you can set the description, the location, categories etc.
+
+In the repeating tab, you can choose one from various options. If repeating should end,
+you can choose between setting the end by date or by occurrences by clicking *Advanced*
+button next to the repeat option.
-Import your calendar as iCal file using the files app. Just click on the
-calendar file to open the import dialog. You can import the calendar into a new
-calendar or into an already existing calendar.
+.. note:: Events are draggable. You can also bring the mouse cursor close to the right
+ (in monthly view) or bottom (in weekview or day view) of an event to adjust
+ date/time.
+
+
+Edit/Delete events
+~~~~~~~~~~~~~~~~~~
+
+Events can be edited by clicking on them in the calendar view. To export or share,
+an event needs to be saved first. You can also delete the event by clicking
+on *Delete event*.
+
+Import events
+~~~~~~~~~~~~~
+
+Importing events is done as importing calendars. Upload your event's iCal file
+using the files app. Then, click on the event file to open the import dialog.
+You can import the event into a new calendar or an already existing one.
.. note:: If the progress bar does not work properly, the folder
- ``apps/calendar/import_tmp/`` has probably no write permission.
+ ``apps/calendar/import_tmp/`` has probably no write permission. Please contact
+ your administrator for this issue.
+
+Export events
+~~~~~~~~~~~~~
+
+If you want to export a single event click on it and press the *Export* button
+on the bottom left corner of the event (you need to expand *Advanced* settings
+in event editing window to see this button).
+
+To export all events in calendar see :ref:`export-calendar` section in :ref:`managing-calendars`.
+
+
+Synchronising Calendars with CalDAV
+-----------------------------------
+
+To synchronise the calendars with your favourite calendar software, you can
+use the *CalDAV Links* of your calendars.
+
+To get this link, click on the |caldav| icon next to your calendar name in the
+calendars list. You will be provided with a link to access your calendars
+with the software you like.
+
+.. |caldav| image:: ../images/caldav.png
+
+To get the global link of your calendars, click on the |gear| icon on the bottom
+left of the calendar app and copy the relevant address.
+
+To manually get those addresses, please follow the following steps::
+
+Assuming you access your web interface via an address like this::
+
+ http://ADDRESS
+
+Then you can access your calendars with CalDAV-compatible programs like
+Kontact, Evolution, Thunderbird using the following URL::
+
+ http://ADDRESS/remote.php/caldav
+
+To use the ownCloud calendar with Apple iCal you will need to use the following
+URL, including the trailing slash::
+
+ http://ADDRESS/remote.php/caldav/principals/username/
+
+Mozilla Lightning users need to this URL scheme::
+
+ https://ADDRESS/remote.php/caldav/calendars/USERNAME/CALENDARNAME
+
+ Example for a simple calendar: The "Default calendar" is referred to as "defaultcalendar",
+ and the username here is "test".
+ The full URL is then:
+
+ https://ADDRESS/remote.php/caldav/calendars/test/defaultcalendar
+
+.. note:: Calendar names are lowercased and the spaces removed. They are not to be URL-encoded
+ anymore.
+
Why is the calendar app asking for my current location?
-------------------------------------------------------
@@ -97,3 +195,5 @@ The calendar needs your current position in order to detect your timezone.
Without the correct timezone there will be a time offset between the events in
ownCloud and your desktop calendar you synchronise with ownCloud. You can also
set the timezone manually in the personal settings.
+
+.. |gear| image:: ../images/gear.png
diff --git a/user_manual/pim/sync_kde.rst b/user_manual/pim/sync_kde.rst
index 2a52827..7f05321 100644
--- a/user_manual/pim/sync_kde.rst
+++ b/user_manual/pim/sync_kde.rst
@@ -3,9 +3,9 @@ Synchronizing with KDE SC
.. image:: /images/kdes1.png
-From KDE SC 4.8 and forward setting up ownCloud is very easy. From System
-Settings Personal Information/Akonadi Resources Configuration select DAV
-Groupware resource.
+From KDE SC 4.8 and forward setting up ownCloud is very easy. From
+:menuselection:`System Settings --> Personal Information`, click on *Add*
+and choose *DAV groupware resource* in *Akonadi Resources Configuration* window.
.. image:: ../images/kdes2.png
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-owncloud/owncloud-doc.git
More information about the Pkg-owncloud-commits
mailing list