From 2ec0f30e4dcb65088604fcbd0c8677cd967cbfa3 Mon Sep 17 00:00:00 2001 From: ericgaspar Date: Mon, 17 Oct 2022 23:03:16 +0200 Subject: [PATCH] Fix typos --- .../10.docs/pihole/app_pihole.fr.md | 11 +++++---- .../10.docs/pihole/app_pihole.md | 7 ++++-- .../10.docs/radicale/app_radicale.fr.md | 23 +++++++++++++++++-- .../10.docs/radicale/app_radicale.md | 21 ++++++++++++++++- .../10.docs/rainloop/app_rainloop.fr.md | 4 ++++ .../10.docs/roundcube/app_roundcube.fr.md | 10 ++++---- .../10.docs/roundcube/app_roundcube.md | 2 +- .../10.docs/rss-bridge/app_rss-bridge.fr.md | 4 ---- .../10.docs/rss-bridge/app_rss-bridge.md | 4 ---- 9 files changed, 63 insertions(+), 23 deletions(-) diff --git a/pages/04.applications/10.docs/pihole/app_pihole.fr.md b/pages/04.applications/10.docs/pihole/app_pihole.fr.md index d7150f78..ec670446 100644 --- a/pages/04.applications/10.docs/pihole/app_pihole.fr.md +++ b/pages/04.applications/10.docs/pihole/app_pihole.fr.md @@ -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 ``` diff --git a/pages/04.applications/10.docs/pihole/app_pihole.md b/pages/04.applications/10.docs/pihole/app_pihole.md index 6138b73a..fbb068b7 100644 --- a/pages/04.applications/10.docs/pihole/app_pihole.md +++ b/pages/04.applications/10.docs/pihole/app_pihole.md @@ -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 ``` diff --git a/pages/04.applications/10.docs/radicale/app_radicale.fr.md b/pages/04.applications/10.docs/radicale/app_radicale.fr.md index 6dfd034a..6eae0c51 100644 --- a/pages/04.applications/10.docs/radicale/app_radicale.fr.md +++ b/pages/04.applications/10.docs/radicale/app_radicale.fr.md @@ -7,31 +7,36 @@ routes: default: '/app_radicale' --- -Radicale est un serveur de calendrier et de contact CalDAV/CardDAV. Il ne dispose pas d’interface graphique 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. Pour connecter un autre client au serveur radicale, il faut renseigner ces adresses : ### Collection CalDAV/CardDAV complète d’un 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 d’adresses 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 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. Il suffit donc de se connecter (comme précédemment) à un calendrier ou un carnet d’adresses 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 d’adresses d’un autre utilisateur + Les adresses précédentes fonctionnent également pour accéder à des ressources n’appartenant pas à l’utilisateur authentifié. > Exemple : @@ -44,11 +49,13 @@ Les adresses précédentes fonctionnent également pour accéder à des ressourc --- ### Configurer les droits d’accès et les partages de calendriers et de 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. 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 l’expliquant (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 d’adresses, 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 n’utilisant pas le même serveur. + ```bash user: .* collection: ^user2/shared2$ permission: r ``` + 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. #### Partager des ressources directement dans la collection d’un utilisateur + > 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. 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 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é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 l’analyse 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 diff --git a/pages/04.applications/10.docs/radicale/app_radicale.md b/pages/04.applications/10.docs/radicale/app_radicale.md index 59a35ee0..0adbf716 100644 --- a/pages/04.applications/10.docs/radicale/app_radicale.md +++ b/pages/04.applications/10.docs/radicale/app_radicale.md @@ -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 diff --git a/pages/04.applications/10.docs/rainloop/app_rainloop.fr.md b/pages/04.applications/10.docs/rainloop/app_rainloop.fr.md index 911f2dba..c88d6c73 100644 --- a/pages/04.applications/10.docs/rainloop/app_rainloop.fr.md +++ b/pages/04.applications/10.docs/rainloop/app_rainloop.fr.md @@ -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 diff --git a/pages/04.applications/10.docs/roundcube/app_roundcube.fr.md b/pages/04.applications/10.docs/roundcube/app_roundcube.fr.md index 45aa9ba4..56b7b6e3 100644 --- a/pages/04.applications/10.docs/roundcube/app_roundcube.fr.md +++ b/pages/04.applications/10.docs/roundcube/app_roundcube.fr.md @@ -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 l’application « Contacts » de Nextcloud, tous deux disponibles pour YunoHost, a l’avantage 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 l’application « Contacts » de Nextcloud, tous deux disponibles pour YunoHost, a l’avantage 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 d’avoir accès à vos contacts depuis une multitude de clients, dont Roundcube. Avec CardDAV, nous n’aurez donc plus besoin d’importer 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 l’icône représentant une roue dentée en bas à gauche. Ensuite, cliquez sur l’icône « Lien CardDAV » et copiez l’URL qui s’affiche en dessous. -* Rendez-vous ensuite dans la section CardDAV des paramètres de Roundcube et entrez « nextcloud » dans le champ « Label », collez l’URL que vous venez de copier et enfin entrez votre nom d’utilisateur 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 l’icône représentant une roue dentée en bas à gauche. Ensuite, cliquez sur l’icône « Lien CardDAV » et copiez l’URL qui s’affiche en dessous. +* Rendez-vous ensuite dans la section CardDAV des paramètres de Roundcube et entrez « nextcloud » dans le champ « Label », collez l’URL que vous venez de copier et enfin entrez votre nom d’utilisateur et votre mot de passe. Vos contacts sont désormais synchronisés ! ## Liens utiles diff --git a/pages/04.applications/10.docs/roundcube/app_roundcube.md b/pages/04.applications/10.docs/roundcube/app_roundcube.md index 261c1a61..8527a889 100644 --- a/pages/04.applications/10.docs/roundcube/app_roundcube.md +++ b/pages/04.applications/10.docs/roundcube/app_roundcube.md @@ -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 diff --git a/pages/04.applications/10.docs/rss-bridge/app_rss-bridge.fr.md b/pages/04.applications/10.docs/rss-bridge/app_rss-bridge.fr.md index c88b9d77..9a02f45e 100644 --- a/pages/04.applications/10.docs/rss-bridge/app_rss-bridge.fr.md +++ b/pages/04.applications/10.docs/rss-bridge/app_rss-bridge.fr.md @@ -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) diff --git a/pages/04.applications/10.docs/rss-bridge/app_rss-bridge.md b/pages/04.applications/10.docs/rss-bridge/app_rss-bridge.md index ec28a369..282a214c 100644 --- a/pages/04.applications/10.docs/rss-bridge/app_rss-bridge.md +++ b/pages/04.applications/10.docs/rss-bridge/app_rss-bridge.md @@ -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)