[enh] radicale: layout, proofreading.

This commit is contained in:
Moul 2016-04-28 17:32:25 +02:00
parent c94392d3c6
commit 6d92aea439
2 changed files with 23 additions and 29 deletions

View file

@ -1,33 +1,30 @@
# Radicale
Radical is a calendar and contact server CalDAV/CardDAV. It does not have an administration interface.
Radical is a calendar and contact server CalDAV/CardDAV. It does not have a graphical administration interface.
Radical is installed by default with the web client InfCloud that will view and edit your calendars and address books.
To connect another client to radical, we must inform these addresses:
## Complete CalDAV/CardDAV collection of a user:
URL : https://domain.tld/path/user/
### Complete CalDAV/CardDAV collection of a user
- URL: https://domain.tld/path/user/
- Exemple : https://example.org/radicale/me/
Exemple : https://example.org/radicale/me/
### To connect a calendar in particular
- URL: https://domain.tld/path/user/calendar.ics/
- Exemple: https://example.org/radicale/me/calendar.ics/
## To connect a calendar in particular:
URL : https://domain.tld/path/user/calendar.ics/
### To connect an address book in particular
- URL: https://domain.tld/path/user/AddressBook.vcf/
- Exemple: https://example.org/radicale/me/AddressBook.vcf/
Exemple : https://example.org/radicale/me/calendar.ics/
## To connect an address book in particular:
URL : https://domain.tld/path/user/AddressBook.vcf/
Exemple : https://example.org/radicale/me/AddressBook.vcf/
## Create a new schedule or a new address book:
### Create a new schedule or a new address book
Create a new schedule or a new address book is very simple with radical, just go there! Radical create all new calendar or notebook to nonexistent addresses if you try to access it.
So just log on (as before) to a calendar or a nonexistent address book to create it.
This can be done simply with a browser, to appear in a collection already connected to a client.
## Go to a calendar or an address book of another user:
### Go to a calendar or an address book of another user
Previous addresses also work to access resources not owned by the authenticated user.
> Example:
@ -39,7 +36,7 @@ Previous addresses also work to access resources not owned by the authenticated
---
## Configure the access rights and sharing of calendars and address books:
### Configure the access rights and sharing of calendars and address books
By default, any user has the right to read and write on its own calendars and address books.
It is possible to refine these default rules and to allow sharing by allowing users to access their resources do not own.
The rules governing these rights should be included in the */etc/radicale/rights*
@ -58,7 +55,7 @@ To validate changes to the */etc/radicale/rights* file, radical must be recharge
sudo service uwsgi restart
```
## Share resources:
### Share resources
To share a calendar or address book, just write a rule permitting. Sharing can be done with another user.
```bash
user: ^user1$
@ -74,7 +71,7 @@ permission: r
In both cases, the sharing works only using the full address of the calendar or collection. In other words, the shares do not appear in the collection of a user.
This limitation may be blocking for clients managing a single collection, as InfCloud. In this particular case, a solution overcomes this problem.
### Share resources directly in the collection of a user:
#### Share resources directly in the collection of a user
> This solution is functional, but is an hack ...
To enable sharing to occur directly in the collection of a user, it must exploit the use of files in Radicale.
@ -87,7 +84,7 @@ However, without recourse to the rules for each resource in the collection of us
---
## Making Radical log more verbose:
### Making Radical log more verbose
By default, the Radical log is set to INFO. This method savings the hard drive but does not debug Radicale in case of problems.
To pass Radicale in DEBUG mode, edit the */etc/radicale/logging* and change INFO to DEBUG in sections *[logger_root]* and *[handler_file]*. Then reload the uwsgi service.
Now, the log displays all requests that are made to Radicale and analysis of *rights* file.
@ -95,7 +92,7 @@ However, do not stay on this mode because the log is filled very quickly.
---
## Change config of InfCloud:
### Change config of InfCloud
The configuration of InfCloud is in the *infcloud/config.js* file
To load any changes in the *config.js* file (or other file of InfCloud) must reload the cache with the script provided.
```bash

View file

@ -7,19 +7,16 @@ Radicale est installé par défaut avec le client web InfCloud qui permettra de
Pour connecter un autre client au serveur radicale, il faut renseigner ces adresses :
### Collection CalDAV/CardDAV complète dun utilisateur
URL : https://domain.tld/path/user/
Exemple : https://example.org/radicale/moi/
- URL : https://domain.tld/path/user/
- Exemple : https://example.org/radicale/moi/
### Pour connecter un calendrier en particulier
URL : https://domain.tld/path/user/calendar.ics/
Exemple : https://example.org/radicale/moi/calendar.ics/
- URL : https://domain.tld/path/user/calendar.ics/
- Exemple : https://example.org/radicale/moi/calendar.ics/
### Pour connecter un carnet dadresses en particulier
URL : https://domain.tld/path/user/AddressBook.vcf/
Exemple : https://example.org/radicale/moi/AddressBook.vcf/
- URL : https://domain.tld/path/user/AddressBook.vcf/
- Exemple : https://example.org/radicale/moi/AddressBook.vcf/
### Créer un nouveau calendrier ou un nouveau carnet dadresses
Créer un nouveau calendrier ou un nouveau carnet dadresses est très simple avec radicale, il suffit dy accéder! Radicale créera tout nouveau calendrier ou carnet dadresses inexistant si vous tentez dy accéder.