Merge pull request #847 from Jaxom99/patch-1

Ajout doc My_webapp

app_my_webapp.md

@@ -0,0 +1,20 @@
+# Documentation My_webapp
+
+In addition to the application's Readme.md, here are some useful tips.
+
+## Automatic update of the site content
+
+The application creates a new user with limited rights: it can connect (with a password) through SFTP to access the `/var/www/my_webapp` directory (or `/var/www/my_webapp__<number>` if there are several installations of this application).
+
+This configuration requires updating the site content manually, with a password connection.
+
+If you want to automate things, you need to be able to connect without typing a password (i.e. "non-interactive"). Here are the steps to follow to get there:
+- Enable public key connection, in `/etc/ssh/ssh/sshd_config`, on the server
+- Create a public/private key pair for your script on the "writing" computer - without a protective passphrase.
+- Copy the public key to the server, in `/var/www/my_webapp(__#)/.ssh/authorized_keys`
+- Set the user `webapp#` as owner of the file and directory
+- You can now connect without a password, with `sftp -b`, `lftp` or other SFTP clients.
+
+NB: The port number to use for the SFTP connection is the one used for the SSH, and configured in `/etc/ssh/sshd_config`.
+
+This tip allows you to automatically update your site. For example, the makefile of the Pelican tool allows you to use `make ftp_upload`.

app_my_webapp_fr.md

@@ -0,0 +1,20 @@
+# Documentation My_webapp
+
+En complément du Readme.md de l'application, voici des astuces utiles.
+
+## Mise à jour automatique du contenu du site.
+
+L'application créée un nouvel utilisateur avec des droits limités : il peut se connecter (avec un mot de passe) en SFTP pour accéder au dossier `/var/www/my_webapp` (ou `/var/www/my_webapp__<numero>` s'il y a plusieurs installations de cette appli).
+
+Cette configuration oblige à mettre à jour le contenu du site à la main, avec une connexion à mot de passe.
+
+Si vous souhaitez automatiser des choses, il vous faut une possibilité de connexion sans mot de passe à taper (dite "non-interactive"). Voici les étapes à suivre pour y arriver :
+- Activer la connexion par clé publique, dans `/etc/ssh/sshd_config`, sur le serveur
+- Créer une paire clé publique/privée pour votre script, sur l'ordinateur "de rédaction" - sans mettre de phrase de passe de protection.
+- Copier la clé publique sur le serveur, dans `/var/www/my_webapp(__#)/.ssh/authorized_keys`
+- Rentre l'utilisateur `webapp#` propriétaire du fichier et du dossier
+- Vous pouvez maintenant vous connecter sans mot de passe, avec `sftp -b`, `lftp` ou bien d'autres clients SFTP.
+
+NB : Le numéro de port à utiliser pour la connection SFTP est celui utilisé pour le SSH, et configuré dans `/etc/ssh/sshd_config`.
+
+Cette asctuce vous permet de mettre à jour automatiquement votre site. Par exemple, le makefile de l'outil Pelican vous permet d'utiliser `make ftp_upload`.

app_rainloop_fr.md

@@ -8,12 +8,18 @@ Pour le configurer après l'installation, veuillez vous rendre sur http://DOMAIN
 - Le mot de passe admin par défaut est : Mot de passe choisi lors de l'installation 
 - Si vous avez oublié votre mot de passe, vous pouvez le retrouver avec ``sudo yunohost app settings rainloop password``
  
-Chaque utilisateur peut ajouter un carnet d'adresse distant CardDav via leur propre paramètres.
- 
+## 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 Baikal, 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
 
-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 [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 **http://DOMAIN.TLD/rainloop/pgpback** pour stocker vos clés privées PGP sur le serveur ou les restaurer dans un nouveau navigateur.
+## 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
+``sudo yunohost app upgrade -u https://github.com/YunoHost-Apps/rainloop_ynh rainloop``