Fix typos

This commit is contained in:
ericgaspar 2022-10-17 23:03:16 +02:00
parent 12ad4e0cd3
commit 2ec0f30e4d
9 changed files with 63 additions and 23 deletions

View file

@ -11,15 +11,15 @@ routes:
[![Installer Pi-hole avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=pihole)[![Niveau d'intégration](https://dash.yunohost.org/integration/pihole.svg)](https://dash.yunohost.org/appci/app/pihole)
- [Utiliser Pi-Hole comme serveur DHCP](#utiliser-pi-hole-comme-serveur-dhcp)
- [Configurer Pi-Hole](#configurer-pi-hole)
- [Utiliser Pi-hole comme serveur DHCP](#utiliser-pi-hole-comme-serveur-dhcp)
- [Configurer Pi-hole](#configurer-pi-hole)
- [Configurer mon routeur](#configurer-mon-routeur)
- [Restaurer le réseau](#restaurer-le-réseau)
- [Liens utiles](#liens-utiles)
Pi-hole est un bloqueur de publicité au niveau du réseau qui agit comme un DNS menteur et éventuellement un serveur DHCP3, destiné à être utilisé sur un réseau privé. Il est conçu pour être installé sur des périphériques intégrés dotés de capacités réseau, tels que le Raspberry Pi, mais il peut être utilisé sur d'autres machines exécutant GNU/Linux ou dans des environnements virtualisés.
*Pi-hole* est un bloqueur de publicité au niveau du réseau qui agit comme un DNS menteur et éventuellement un serveur DHCP3, destiné à être utilisé sur un réseau privé. Il est conçu pour être installé sur des périphériques intégrés dotés de capacités réseau, tels que le Raspberry Pi, mais il peut être utilisé sur d'autres machines exécutant GNU/Linux ou dans des environnements virtualisés.
## Utiliser Pi-Hole comme serveur DHCP
## Utiliser Pi-hole comme serveur DHCP
> **Attention, vous devez savoir que toucher à votre DHCP pourrait casser votre réseau.
Dans le cas où votre serveur serait inaccessible, vous perdriez votre résolution dns et votre adresse IP.
@ -56,17 +56,20 @@ Ne paniquez pas, on va surmonter ça \o/
Utilisez votre terminal favori sur votre ordinateur de bureau.
Et tout d'abord, récupérer votre interface réseau (Le plus souvent `eth0`).
``` bash
sudo ifconfig
```
Ensuite, changer votre ip pour une ip statique.
``` bash
sudo ifconfig eth0 192.168.1.100
```
Maintenant, vous pouvez vous connecter à votre routeur et rallumer son serveur DHCP pour l'utiliser à nouveau.
Vous pouvez maintenant retirer votre ip statique et réobtenir une ip dynamique.
``` bash
sudo ifconfig eth0 0.0.0.0 && sudo dhclient eth0
```

View file

@ -19,7 +19,7 @@ routes:
- [Restore Network](#restore-network)
- [Useful links](#useful-links)
Pi-hole is a network-level ad blocker that acts as a DNS layer and possibly a DHCP3 server for use on a private network. It is designed to be installed on embedded devices with network capabilities, such as the Raspberry Pi, but can be used on other machines running GNU/Linux or in virtualised environments.
*Pi-Hole* is a network-level ad blocker that acts as a DNS layer and possibly a DHCP3 server for use on a private network. It is designed to be installed on embedded devices with network capabilities, such as the Raspberry Pi, but can be used on other machines running GNU/Linux or in virtualised environments.
## Using Pi-Hole as a DHCP server
@ -53,22 +53,25 @@ In this case, using Pi-hole's dns will allow you to connect to your server by it
### Restore network
> Oops!
Your Pi-hole server has crashed, and you don't have DHCP anymore.
Your Pi-Hole server has crashed, and you don't have DHCP anymore.
Don't panic. We'll get through this.
Use your favorite device on your desktop computer.
And first, get your network interface (usually `eth0`).
```bash
sudo ifconfig
```
Then change your IP to a static one.
```bash
sudo ifconfig eth0 192.168.1.100
```
Now you can connect to your router and reboot its DHCP server to use it again.
You can now remove your static IP and get a dynamic IP again.
```bash
sudo ifconfig eth0 0.0.0 && sudo dhclient eth0
```

View file

@ -7,31 +7,36 @@ routes:
default: '/app_radicale'
---
Radicale est un serveur de calendrier et de contact CalDAV/CardDAV. Il ne dispose pas dinterface graphique dadministration.
*Radicale* est un serveur de calendrier et de contact CalDAV/CardDAV. Il ne dispose pas dinterface graphique dadministration.
Radicale est installé par défaut avec le client web InfCloud qui permettra de visualiser et de modifier vos calendriers et carnets dadresses.
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/
### Pour connecter un calendrier en particulier
- 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/
### 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.
Il suffit donc de se connecter (comme précédemment) à un calendrier ou un carnet dadresses inexistant pour le créer.
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 dadresses dun autre utilisateur
Les adresses précédentes fonctionnent également pour accéder à des ressources nappartenant pas à lutilisateur authentifié.
> Exemple :
@ -44,11 +49,13 @@ Les adresses précédentes fonctionnent également pour accéder à des ressourc
---
### Configurer les droits daccès et les partages de calendriers et de carnets dadresses
Par défaut, tout utilisateur a le droit de lecture et décriture sur ses propres calendriers et carnets dadresses.
Il est toutefois possible daffiner ces règles par défaut et dautoriser 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*
Chaque règle se présente sous cette forme:
Chaque règle se présente sous cette forme :
```bash
## Commentaire précédant la règle et lexpliquant (optionnel évidemment)
[Nom de la règle]
@ -56,42 +63,53 @@ user: utilisateur concerné
collection: calendrier, carnet ou collection concernée.
permission: permission, r (lecture), w (écriture) ou rw (lecture/écriture)
```
Le fichier *rights* contient plusieurs exemples pouvant être exploités.
Pour valider les modifications apportées au fichier */etc/radicale/rights*, radicale doit être rechargé via le service uWSGI.
```bash
sudo service uwsgi restart
```
### Partager des ressources
Pour partager un calendrier ou un carnet dadresses, il suffit décrire une règle le permettant. Le partage peut se faire avec un autre utilisateur.
```bash
user: ^user1$
collection: ^user2/shared2.ics$
permission: rw
```
Ou publiquement pour un utilisateur distant nutilisant pas le même serveur.
```bash
user: .*
collection: ^user2/shared2$
permission: r
```
Dans les deux cas, le partage ne fonctionnera quen utilisant ladresse complète du calendrier ou de la collection. Autrement dit, les partages napparaissent pas dans la collection dun utilisateur.
Cette limitation peut savé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 dun utilisateur
> Cette solution est fonctionnelle, mais reste du bidouillage...
Pour permettre à un partage dapparaître directement dans la collection dun utilisateur, il faut exploiter lusage des fichiers sous Radicale.
En créant simplement un lien symbolique de la ressource à partager.
```bash
ln -sr user2/shared.ics user1/user2_shared.ics
```
La ressource partagée devient ainsi une ressource de la collection de user1, alors quelle 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 sapplique. 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
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.
Dès lors, le log affiche toutes les requêtes qui sont faites à Radicale ainsi que lanalyse du fichier *rights*.
@ -100,6 +118,7 @@ Il est toutefois déconseillé de rester sur ce mode, car le log se remplie trè
---
### Modifier la configuration de InfCloud
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.
```bash

View file

@ -7,30 +7,35 @@ routes:
default: '/app_radicale'
---
Radicale is a calendar and contact server CalDAV/CardDAV. It does not have a graphical administration interface.
*Radicale* is a calendar and contact server CalDAV/CardDAV. It does not have a graphical administration interface.
Radicale 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/
- 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 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 is very simple with Radicale, just go there! Radicale creates 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
Previous addresses also work to access resources not owned by the authenticated user.
> Example:
@ -43,11 +48,13 @@ Previous addresses also work to access resources not owned by the authenticated
---
### 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*
Each rule is in this form:
```bash
# Comment before rule and explaining that (optional of course):
[Rule Name]
@ -55,42 +62,53 @@ user: user concerned
collection: calendar, book or collection concerned.
permission: permission, r (read), w (write) or rw (read/write)
```
*Rights* file contains several examples that can be exploited.
To validate changes to the */etc/radicale/rights* file, radical must be recharged via uWSGI service.
```bash
sudo service uwsgi restart
```
### Share resources
To share a calendar or address book, just write a rule permitting. Sharing can be done with another user.
```bash
user: ^user1$
collection: ^user2/shared2.ics$
permission: rw
```
Or publicly for a remote user does not use the same server.
```bash
user: .*
collection: ^user2/shared2.ics$
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
> 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.
By simply creating a symbolic link to the resource sharing.
```bash
ln -sr user2/shared.ics user1/user2_shared.ics
```
The shared resource becomes a resource from the collection of user1, while it physically remains in the collection of user2.
However, without recourse to the rules for each resource in the collection of user1, the general rule applies. user1 gets so read and write access by default on the shared resource because it is part of his collection.
---
### 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.
@ -99,6 +117,7 @@ However, do not stay on this mode because the log is filled very quickly.
---
### 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

@ -27,19 +27,23 @@ Pour le configurer après l'installation, veuillez vous rendre sur http://DOMAIN
- Si vous avez oublié votre mot de passe, vous pouvez le retrouver avec `sudo yunohost app setting rainloop password`
### Carnet d'adresses
Rainloop intègre par défaut un carnet d'adresse avec les utilisateurs du serveur YunoHost. Chaque utilisateur peut ajouter un carnet d'adresse distant CardDAV via leurs propres paramètres.
- Si vous utilisez Baïkal, l'adresse à renseigner est du type : https://DOMAIN.TLD/baikal/card.php/addressbooks/UTILISATEUR/default/
- Si vous utilisez Nextcloud, l'adresse à renseigner est du type : https://DOMAIN.TLD/nextcloud/remote.php/carddav/addressbooks/USER/contacts
### Gestion des domaines
Les utilisateurs peuvent se servir de Rainloop pour accéder à d'autres boites mail que celle fournie par YunoHost (par exemple gmail.com ou laposte.net). L'option est disponible par le bouton "compte -> ajouter un compte".
L'administrateur doit pour cela autoriser la connexion à des domaines tiers, via une liste blanche dans l'interface administration.
### Gestion des clés PGP
Rainloop stocke les clés PGP privées dans le stockage de navigateur. Cela implique que vos clés seront perdues quand vous videz le stockage de navigateur (navigation incognito, changement d'ordinateur, ...). Ce paquet intègre donc [PGPback de chtixof](https://github.com/chtixof/pgpback_ynh) pour que vous puissiez stocker vos clés privées PGP de manière sécurisée sur le serveur. Rendez-vous à l'adresse **http://DOMAIN.TLD/rainloop/pgpback** pour stocker vos clés privées PGP sur le serveur ou les restaurer dans un nouveau navigateur.
### Mise à jour
Pour mettre à jour Rainloop lorsqu'une nouvelle version est disponible, lancez en console locale (SSH ou autre) :
`sudo yunohost app upgrade -u https://github.com/YunoHost-Apps/rainloop_ynh rainloop`
## Liens utiles

View file

@ -15,11 +15,11 @@ routes:
- [Liens utiles](#liens-utiles)
Roundcube est un client web de courrier électronique libre ou aussi appelé un webmail.
*Roundcube* est un client web de courrier électronique libre ou aussi appelé un webmail.
### Synchronisation des contacts
Roundcube vous propose à l'installation, via un greffon tiers, de pouvoir synchroniser vos contacts avec un serveur CardDAV. Utiliser un serveur CardDAV comme Baïkal ou lapplication « Contacts » de Nextcloud, tous deux disponibles pour YunoHost, a lavantage de permettre une gestion centralisée de vos contacts.
Roundcube vous propose à l'installation, via un greffon tiers, de pouvoir synchroniser vos contacts avec un serveur CardDAV. Utiliser un serveur CardDAV comme Baïkal ou lapplication « Contacts » de Nextcloud, tous deux disponibles pour YunoHost, a lavantage de permettre une gestion centralisée de vos contacts.
De la même façon que le protocole IMAP vous permet de synchroniser vos courriels avec votre serveur mail, CardDAV vous permet davoir accès à vos contacts depuis une multitude de clients, dont Roundcube. Avec CardDAV, nous naurez donc plus besoin dimporter vos contacts dans chaque client.
@ -27,10 +27,10 @@ Notez que si Baïkal ou Nextcloud sont déjà installés, les carnets d'adresses
----
Si vous avez installé Nextcloud après, voici comment ajouter vos carnets d'adresses :
Si vous avez installé Nextcloud après, voici comment ajouter vos carnets d'adresses :
* Rendez-vous dans la section « Contacts » de votre espace Nextcloud et cliquez sur licône représentant une roue dentée en bas à gauche. Ensuite, cliquez sur licône « Lien CardDAV » et copiez lURL qui saffiche en dessous.
* Rendez-vous ensuite dans la section CardDAV des paramètres de Roundcube et entrez « nextcloud » dans le champ « Label », collez lURL que vous venez de copier et enfin entrez votre nom dutilisateur et votre mot de passe. Vos contacts sont désormais synchronisés!
* Rendez-vous dans la section « Contacts » de votre espace Nextcloud et cliquez sur licône représentant une roue dentée en bas à gauche. Ensuite, cliquez sur licône « Lien CardDAV » et copiez lURL qui saffiche en dessous.
* Rendez-vous ensuite dans la section CardDAV des paramètres de Roundcube et entrez « nextcloud » dans le champ « Label », collez lURL que vous venez de copier et enfin entrez votre nom dutilisateur et votre mot de passe. Vos contacts sont désormais synchronisés !
## Liens utiles

View file

@ -15,7 +15,7 @@ routes:
- [Useful links](#useful-links)
Roundcube is a web client for email messaging also called webmail.
*Roundcube* is a web client for email messaging also called webmail.
### Synchronize your contacts

View file

@ -67,10 +67,6 @@ Par défaut, le script crée `whitelist.txt` et ajoute les ponts principaux (voi
Pour des raisons de simplicité, ce paquet YunoHost active tous les ponts par défaut.
##### Multi-users support
Cette application est publique et il n'y a pas de notion d'utilisateur.
## Liens utiles
+ Site web : [github.com/RSS-Bridge/rss-bridge](https://github.com/RSS-Bridge/rss-bridge)

View file

@ -67,10 +67,6 @@ By default, the script creates `whitelist.txt` and adds the main bridges (see ab
As a matter of simplicity, this YunoHost package enables every bridge by default.
##### Multi-users support
This is application is public and there's no notion of user.
## Useful links
+ Website: [github.com/RSS-Bridge/rss-bridge](https://github.com/RSS-Bridge/rss-bridge)