From aea067b288072290cdd4c28aa19a01eb3c67d3d2 Mon Sep 17 00:00:00 2001
From: Jonas Smedegaard <dr@jones.dk>
Date: Mon, 9 Mar 2015 02:47:46 +0100
Subject: Add topic event.

---
 account.mdwn       |  2 +-
 event.mdwn         |  8 +++++++
 event/farbar.mdwn  |  2 ++
 event/intro.mdwn   | 62 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 event/sidebar.mdwn |  2 ++
 services.mdwn      |  2 +-
 6 files changed, 76 insertions(+), 2 deletions(-)
 create mode 100644 event.mdwn
 create mode 100644 event/farbar.mdwn
 create mode 100644 event/intro.mdwn
 create mode 100644 event/sidebar.mdwn

diff --git a/account.mdwn b/account.mdwn
index d61791d..04508a4 100644
--- a/account.mdwn
+++ b/account.mdwn
@@ -22,7 +22,7 @@ User accounts provide access to various shared resources:
 
  * Collaborative [[file shares|files]]
  * [[Addressbooks|contact]]
- * [[Calendars]]
+ * [[Calendars|event]]
 
 
 ## Account administration
diff --git a/event.mdwn b/event.mdwn
new file mode 100644
index 0000000..f4ee2a2
--- /dev/null
+++ b/event.mdwn
@@ -0,0 +1,8 @@
+# Overview of calendaring info
+
+[[!template id=realm]] handles personal and group calendars.
+Some calendars are also public readable.
+
+## Setup
+
+ * Short [[event/intro]] to start using calendaring
diff --git a/event/farbar.mdwn b/event/farbar.mdwn
new file mode 100644
index 0000000..175623c
--- /dev/null
+++ b/event/farbar.mdwn
@@ -0,0 +1,2 @@
+ * [[contact]]
+ * [[account]]
diff --git a/event/intro.mdwn b/event/intro.mdwn
new file mode 100644
index 0000000..7cc535e
--- /dev/null
+++ b/event/intro.mdwn
@@ -0,0 +1,62 @@
+# Calendaring introduction
+
+Anyone can read calendars shared publicly at [[!template id=realm]].
+
+Your personal [[account]] grants read-only access to closed-group shared calendars.
+
+Custom group accounts provide write access to (closed-group or public) shared calendars.
+
+
+## Clients
+
+Recommended calendaring client depends on the operating system you use:
+
+  * Mac, iPhone and iPad: Apple Calendar
+  * Windows and Linux: [Mozilla Lightning](https://www.mozilla.org/en-US/projects/calendar/)
+  * Android: [DavDroid](https://f-droid.org/app/at.bitfire.davdroid)
+
+
+## Security
+
+Before you setup any password-protected calendars,
+make sure to install the [CACert.org security certificate](http://wiki.cacert.org/FAQ/BrowserClients).
+
+
+## Read-only access
+
+If you only need to read a calendar maintained by others,
+then the best (most efficient) is to subscribe to an "iCal" calender:
+
+ 1. Go to web page http://[[!template id=eventhost]]/
+ 2. Copy address of relevant calendar.
+ 3. Open calendaring client, and add new account profile.
+ 4. Request creation of a new "ical" profile
+ 5. Paste the calendar address as server address.
+
+Closed-group calendars also require username and password,
+and require a secure connection (TLS or SSL, or "https://" address).
+
+
+## Read-write access
+
+To both read a calendar and help maintain its content,
+you need to setup a "CalDAV" profile.
+
+Some calendaring clients (e.g. recent Apple Calendar) need little profile info:
+
+ * Server address: **[[!template id=eventhost]]:8443**
+ * Username and password: Credentials for either your personal account or a custom group account
+
+Some calendaring clients (e.g. older Apple ical) need slightly more profile info:
+
+ * Server address: **https://[[!template id=eventhost]]:8443/calendars/users/**
+ * Username and password: Credentials for either your personal account or a custom group account
+
+Other calendaring clients (e.g. Mozilla Lightning) need exact calendar address:
+
+ 1. Go to web page https://[[!template id=eventhost]]:8443/calendars/users/USERNAME/
+    (replace USERNAME with personal or calendar-group account name)
+ 2. Copy address for relevant calendar (a.k.a. "Collection").
+ 3. Open calendaring client, and add new account profile.
+ 4. Request creation of a new "CalDAV" profile (also called "on the network")
+ 5. Paste the calendar address as server address.
diff --git a/event/sidebar.mdwn b/event/sidebar.mdwn
new file mode 100644
index 0000000..de93eb1
--- /dev/null
+++ b/event/sidebar.mdwn
@@ -0,0 +1,2 @@
+* [[overview|index]]
+* [[intro]]
diff --git a/services.mdwn b/services.mdwn
index 4ff3e95..d0b6b1b 100644
--- a/services.mdwn
+++ b/services.mdwn
@@ -6,7 +6,7 @@ A set of services is offered at [[!template id=realmdescription]].
  * [[Mailinglists]]
  * [[Printers]]
  * [[Addressbooks|contact]]
- * [[Calendars]]
+ * [[Calendars|event]]
 
 
 See also [[account]] for services only accessible by local trusted
-- 
cgit v1.2.3