YunoHost/doc
1
0
Fork 0
mirror of https://github.com/YunoHost/doc.git synced 2024-09-03 20:06:26 +02:00
Code Issues Projects Releases Packages Wiki Activity

[enh] radicale: layout, proofreading.

Browse source
This commit is contained in:
Moul 2016-04-28 17:27:19 +02:00
parent 63af00d97f
commit c94392d3c6
1 changed files with 33 additions and 33 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

66
app_radicale_fr.md
View file

@ -1,52 +1,52 @@
# Radicale # Radicale
Radicale est un serveur de calendrier et de contact CalDAV/CardDAV. Il ne dispose pas d'une interface d'administration. Radicale est un serveur de calendrier et de contact CalDAV/CardDAV. Il ne dispose pas d’interface graphique d’administration.
Radicale est installé par défaut avec le client web InfCloud qui permettra de visualiser et de modifier vos calendriers et carnets d'adresses. Radicale est installé par défaut avec le client web InfCloud qui permettra de visualiser et de modifier vos calendriers et carnets d’adresses.
Pour connecter un autre client au serveur radicale, il faut renseigner ces adresses: Pour connecter un autre client au serveur radicale, il faut renseigner ces adresses :
## Collection CalDAV/CardDAV complète d'un utilisateur: ### Collection CalDAV/CardDAV complète d’un utilisateur
URL : https://domain.tld/path/user/ URL : https://domain.tld/path/user/
Exemple : https://example.org/radicale/moi/ Exemple : https://example.org/radicale/moi/
## Pour connecter un calendrier en particulier: ### Pour connecter un calendrier en particulier
URL : https://domain.tld/path/user/calendar.ics/ URL : https://domain.tld/path/user/calendar.ics/
Exemple : https://example.org/radicale/moi/calendar.ics/ Exemple : https://example.org/radicale/moi/calendar.ics/
## Pour connecter un carnet d'adresses en particulier: ### Pour connecter un carnet d’adresses en particulier
URL : https://domain.tld/path/user/AddressBook.vcf/ URL : https://domain.tld/path/user/AddressBook.vcf/
Exemple : https://example.org/radicale/moi/AddressBook.vcf/ Exemple : https://example.org/radicale/moi/AddressBook.vcf/
## Créer un nouveau calendrier ou un nouveau carnet d'adresses: ### Créer un nouveau calendrier ou un nouveau carnet d’adresses
Créer un nouveau calendrier ou un nouveau carnet d'adresses est très simple avec radicale, il suffit d'y accéder! Radicale créera tout nouveau calendrier ou carnet d'adresses inexistant si vous tentez d'y accéder. Créer un nouveau calendrier ou un nouveau carnet d’adresses est très simple avec radicale, il suffit d’y accéder! Radicale créera tout nouveau calendrier ou carnet d’adresses inexistant si vous tentez d’y accéder.
Il suffit donc de se connecter (comme précédemment) à un calendrier ou un carnet d'adresses inexistant pour le créer. Il suffit donc de se connecter (comme précédemment) à un calendrier ou un carnet d’adresses inexistant pour le créer.
Cela peux être fait simplement avec un navigateur, pour le voir apparaître dans une collection déjà connectée à un client. Cela peut être fait simplement avec un navigateur, pour le voir apparaître dans une collection déjà connectée à un client.
## Accéder à un calendrier ou un carnet d'adresses d'un autre utilisateur: ### Accéder à un calendrier ou un carnet d’adresses d’un autre utilisateur
Les adresses précédentes fonctionnent également pour accéder à des ressources n'appartenant pas à l'utilisateur authentifié. Les adresses précédentes fonctionnent également pour accéder à des ressources n’appartenant pas à l’utilisateur authentifié.
> Exemple: > Exemple :
> User1 peut se connecter à la collection de user2 > User1 peut se connecter à la collection de user2
> https://example.org/radicale/user2/ > https://example.org/radicale/user2/
> Il lui suffira d'indiquer le login et mot de passe de user1. > Il lui suffira d’indiquer le login et mot de passe de user1.
> Ce sont les règles de partage (voir ci-dessous) qui permettront ou pas à user1 de voir le contenu de la collection de user2. > Ce sont les règles de partage (voir ci-dessous) qui permettront ou pas à user1 de voir le contenu de la collection de user2.
> Par défaut, aucun partage n'est autorisé. > Par défaut, aucun partage n’est autorisé.
--- ---
## Configurer les droits d'accès et les partages de calendriers et de carnets d'adresses: ### Configurer les droits d’accès et les partages de calendriers et de carnets d’adresses
Par défaut, tout utilisateur à le droit de lecture et d'écriture sur ses propres calendriers et carnets d'adresses. Par défaut, tout utilisateur a le droit de lecture et d’écriture sur ses propres calendriers et carnets d’adresses.
Il est toutefois possible d'affiner ces règles par défaut et d'autoriser des partages en autorisant des utilisateurs à accéder à des ressources ne leurs appartenant pas. Il est toutefois possible d’affiner ces règles par défaut et d’autoriser des partages en autorisant des utilisateurs à accéder à des ressources ne leurs appartenant pas.
Les règles régissant ces droits doivent être inscrite dans le fichier */etc/radicale/rights* Les règles régissant ces droits doivent être inscrite dans le fichier */etc/radicale/rights*
Chaque règle se présente sous cette forme: Chaque règle se présente sous cette forme:
```bash ```bash
# Commentaire précédant la règle et l'expliquant (optionnel évidemment): ## Commentaire précédant la règle et l’expliquant (optionnel évidemment)
[Nom de la règle] [Nom de la règle]
user: utilisateur concerné user: utilisateur concerné
collection: calendrier, carnet ou collection concernée. collection: calendrier, carnet ou collection concernée.
@ -58,44 +58,44 @@ Pour valider les modifications apportées au fichier */etc/radicale/rights*, rad
sudo service uwsgi restart sudo service uwsgi restart
``` ```
## Partager des ressources: ### Partager des ressources
Pour partager un calendrier ou un carnet d'adresses, il suffit d'écrire une règle le permettant. Le partage peut se faire avec un autre utilisateur. Pour partager un calendrier ou un carnet d’adresses, il suffit d’écrire une règle le permettant. Le partage peut se faire avec un autre utilisateur.
```bash ```bash
user: ^user1$ user: ^user1$
collection: ^user2/shared2.ics$ collection: ^user2/shared2.ics$
permission: rw permission: rw
``` ```
Ou publiquement pour un utilisateur distant n'utilisant pas le même serveur. Ou publiquement pour un utilisateur distant n’utilisant pas le même serveur.
```bash ```bash
user: .* user: .*
collection: ^user2/shared2$ collection: ^user2/shared2$
permission: r permission: r
``` ```
Dans les 2 cas, le partage ne fonctionnera qu'en utilisant l'adresse complète du calendrier ou de la collection. Autrement dit, les partages n'apparaissent pas dans la collection d'un utilisateur. Dans les deux cas, le partage ne fonctionnera qu’en utilisant l’adresse complète du calendrier ou de la collection. Autrement dit, les partages n’apparaissent pas dans la collection d’un utilisateur.
Cette limitation peut s'avérer bloquante pour des clients gérant une seule collection, tel que InfCloud. Pour ce cas particulier, une solution permet de contourner ce problème. Cette limitation peut s’avérer bloquante pour des clients gérant une seule collection, tel que InfCloud. Pour ce cas particulier, une solution permet de contourner ce problème.
### Partager des ressources directement dans la collection d'un utilisateur: #### Partager des ressources directement dans la collection d’un utilisateur
> Cette solution est fonctionnelle, mais reste du bidouillage... > Cette solution est fonctionnelle, mais reste du bidouillage…
Pour permettre à un partage d'apparaître directement dans la collection d'un utilisateur, il faut exploiter l'usage des fichiers sous Radicale. Pour permettre à un partage d’apparaître directement dans la collection d’un utilisateur, il faut exploiter l’usage des fichiers sous Radicale.
En créant simplement un lien symbolique de la ressource à partager. En créant simplement un lien symbolique de la ressource à partager.
```bash ```bash
ln -sr user2/shared.ics user1/user2_shared.ics ln -sr user2/shared.ics user1/user2_shared.ics
``` ```
La ressource partagée devient ainsi une ressource de la collection de user1, alors qu'elle reste physiquement dans la collection de user2. La ressource partagée devient ainsi une ressource de la collection de user1, alors qu’elle reste physiquement dans la collection de user2.
En revanche, sans avoir recours à des règles pour chaque ressource de la collection de user1, la règle générale s'applique. user1 obtient donc le droit de lecture ET d'écriture par défaut sur la ressource partagé car elle fait partie de sa collection. En revanche, sans avoir recours à des règles pour chaque ressource de la collection de user1, la règle générale s’applique. user1 obtient donc le droit de lecture ET d’écriture par défaut sur la ressource partagée, car elle fait partie de sa collection.
--- ---
## Rendre le log de Radicale plus loquace: ### Rendre le log de Radicale plus loquace
Par défaut, le log de Radicale est réglé sur INFO. Ce mode épargne le disque dur mais ne permet pas de débugger Radicale en cas de problème. Par défaut, le log de Radicale est réglé sur INFO. Ce mode épargne le disque dur mais ne permet pas de débugger Radicale en cas de problème.
Pour passer Radicale en mode DEBUG, il faut éditer le fichier */etc/radicale/logging* et passer INFO à DEBUG dans les sections *[logger_root]* et *[handler_file]* puis recharger le service uwsgi. Pour passer Radicale en mode DEBUG, il faut éditer le fichier */etc/radicale/logging* et passer INFO à DEBUG dans les sections *[logger_root]* et *[handler_file]* puis recharger le service uwsgi.
Dés lors, le log affiche toutes les requêtes qui sont faite à Radicale ainsi que l'analyse du fichier *rights*. Dès lors, le log affiche toutes les requêtes qui sont faites à Radicale ainsi que l’analyse du fichier *rights*.
Il est toutefois déconseillé de rester sur ce mode, car le log se rempli très rapidement. Il est toutefois déconseillé de rester sur ce mode, car le log se remplie très rapidement.
--- ---
## Modifier la configuration de InfCloud: ### Modifier la configuration de InfCloud
La configuration de InfCloud se trouve dans le fichier *infcloud/config.js* La configuration de InfCloud se trouve dans le fichier *infcloud/config.js*
Pour prendre en compte une modification dans le fichier *config.js* (ou tout autre fichier de InfCloud) il faut recharger le cache avec le script fourni. Pour prendre en compte une modification dans le fichier *config.js* (ou tout autre fichier de InfCloud) il faut recharger le cache avec le script fourni.
```bash ```bash