Merge branch 'grav' of https://github.com/YunoHost/doc into grav

pages/01.administrate/05.install/install.md

@@ -144,7 +144,7 @@ However, community images exist and are available on Docker Hub:
 {% else %}
 
 
-## Pre-requisites
+## [fa=list-alt /] Pre-requisites
 
 {% if regular %}
 * A x86-compatible hardware dedicated to YunoHost: laptop, nettop, netbook, desktop with 512MB RAM and 16GB capacity (at least)

pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.es.md

@@ -19,9 +19,8 @@ A continuación puedes encontrar los elementos a configurar en el cliente de cor
 | IMAP     | 993  | SSL/TLS    | Normal password | `nombre_de_usuario` (sin `@domain.tld`) |
 | SMTP     | 587  | STARTTLS   | Normal password | `nombre_de_usuario` (sin `@domain.tld`) |
 
-![](image://thunderbird.png?resize=50)
 
-### Configurar Mozilla Thunderbird (en un ordenador)
+### ![](image://thunderbird.png?resize=50&classes=inline) Configurar Mozilla Thunderbird (en un ordenador)
 
 Para configurar manualmente un nuevo cuenta en Thunderbird, añadir las informaciones de la cuenta, y después seleccionar el puerto 993 con SSL/TLS para IMAP, y puerto 587 con STARTTLS para SMTP. Después seleccionar 'Normal Password' para Autenticación y haz click en el botón 'Advanced Config'. Se puede que tendrás que aceptar los certificados para que todo funciona normalmente.
 
@@ -30,13 +29,11 @@ Para configurar manualmente un nuevo cuenta en Thunderbird, añadir las informac
 
 * [Gestionar un alias para una dirección de correo electrónico](https://support.mozilla.org/es/kb/configurar-un-alias-para-una-direccin-de-correo-el)
 
-![](image://k9mail.png?resize=50)
+### ![](image://k9mail.png?resize=50&classes=inline) Configurar K-9 Mail (en Android)
-
-### Configurar K-9 Mail (en Android)
 
 Seguir los pasos a continuación. (Como para Thunderbird, se puede que tendrás que aceptar los certificados para que funciona normalmente.)
 
-![](image://k9mail_config_1.png?resize=300)
+![](image://k9mail_config_1.png?resize=280&classes=inline)
-![](image://k9mail_config_2.png?resize=300)
+![](image://k9mail_config_2.png?resize=280&classes=inline)
-![](image://k9mail_config_3.png?resize=300)
+![](image://k9mail_config_3.png?resize=280&classes=inline)
-![](image://k9mail_config_4.png?resize=300)
+![](image://k9mail_config_4.png?resize=280&classes=inline)

pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.fr.md

@@ -20,9 +20,8 @@ Voici les éléments que vous devrez entrer pour configurer manuellement votre c
 | IMAP      | 993  | SSL/TLS     | Mot de passe normal | `nom_dutilisateur` (sans `@domain.tld`) |
 | SMTP      | 587  | STARTTLS    | Mot de passe normal | `nom_dutilisateur` (sans `@domain.tld`) |
 
-![](image://thunderbird.png?resize=50)
 
-### Configurer Mozilla Thunderbird
+### ![](image://thunderbird.png?resize=50&classes=inline) Configurer Mozilla Thunderbird
 
 Pour configurer manuellement un nouveau compte dans Thunderbird commencez par remplir les informations de base (Nom, adresse et mot de passe), cliquez sur Continuer puis Configuration Manuelle. Enlevez le `.` avant le nom de domaine. Sélectionnez le port 993 avec SSL/TLS pour IMAP, et le port 587 avec STARTTLS pour SMTP. Sélectionnez 'Mot de passe normal' pour l'authentification. Testez la configuration puis validez. (Il vous faudra ensuite possiblement accepter des certificats pour que tout fonctionne correctement.)
 
@@ -31,26 +30,22 @@ Pour configurer manuellement un nouveau compte dans Thunderbird commencez par re
 
 * [Gérer les alias mails](https://support.mozilla.org/en-US/kb/configuring-email-aliases)
 
-![](image://k9mail.png?resize=50)
+### ![](image://k9mail.png?resize=50&classes=inline) Configurer K-9 Mail (sur Android)
-
-### Configurer K-9 Mail (sur Android)
 
 Suivez les instructions suivantes. (Comme pour Thunderbird, il vous faudra peut-être accepter des certificats à un moment)
 
-![](image://k9mail_config_1.png?resize=300)
+![](image://k9mail_config_1.png?resize=280&classes=inline)
-![](image://k9mail_config_2.png?resize=300)
+![](image://k9mail_config_2.png?resize=280&classes=inline)
-![](image://k9mail_config_3.png?resize=300)
+![](image://k9mail_config_3.png?resize=280&classes=inline)
-![](image://k9mail_config_4.png?resize=300)
+![](image://k9mail_config_4.png?resize=280&classes=inline)
 
-![](image://dekko-app.png?resize=50)
+### ![](image://dekko-app.png?resize=50&classes=inline) Configure Dekko (on Ubuntu Touch)
-
-### Configure Dekko (on Ubuntu Touch)
 
 La première fois, vous pouvez simplement choisir "Ajouter un compte". Si vous avez déjà un compte configuré, appuyez sur le menu hamburger puis sur le rouage, choisissez Courrier, Comptes et appuyez sur le symbole " + ".
 
 Sélectionnez ensuite IMAP. Remplissez les champs et appuyez sur Suivant. Dekko va ensuite chercher la configuration. Vérifiez que tous les champs sont corrects. Assurez-vous d'avoir votre nom d'utilisateur yunohost, PAS votre adresse email et choisissez "Autoriser les certificats non fiables". Faites ceci pour IMAP et SMTP et appuyez sur Suivant. Dekko va ensuite synchroniser le compte après quoi vous aurez terminé. Félicitations !
 
-![](image://dekko_config_1.png?resize=300)
+![](image://dekko_config_1.png?resize=280&classes=inline)
-![](image://dekko_config_2.png?resize=300)
+![](image://dekko_config_2.png?resize=280&classes=inline)
-![](image://dekko_config_3.png?resize=300)
+![](image://dekko_config_3.png?resize=280&classes=inline)
-![](image://dekko_config_4.png?resize=300)
+![](image://dekko_config_4.png?resize=280&classes=inline)

pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.md

@@ -20,9 +20,7 @@ Here are the element you should enter to manually configure your mail client (`d
 | IMAP     | 993  | SSL/TLS    | Normal password | `username` (without the `@domain.tld`) |
 | SMTP     | 587  | STARTTLS   | Normal password | `username` (without the `@domain.tld`) |
 
-![](image://thunderbird.png?resize=50)
+### ![](image://thunderbird.png?resize=50&classes=inline) Configure Mozilla Thunderbird (on a desktop computer)
-
-### Configure Mozilla Thunderbird (on a desktop computer)
 
 To manually configure a new account in Thunderbird, add the account information, then select port 993 with SSL/TLS for IMAP, and port 587 with STARTTLS for SMTP. Afterwards select 'Normal Password' for Authentication and click on 'Advanced Config'. You may need to accept the certificate exceptions for fetching mails and after you send your first mail. Don't forget to remove the dot before the domain name.
 
@@ -31,26 +29,23 @@ To manually configure a new account in Thunderbird, add the account information,
 
 * [Manage alias mails](https://support.mozilla.org/en-US/kb/configuring-email-aliases)
 
-![](image://k9mail.png?resize=50)
+### ![](image://k9mail.png?resize=50&classes=inline) Configure K-9 Mail (on Android)
-
-### Configure K-9 Mail (on Android)
 
 Follow the following steps. (As for Thunderbird, you might need to accept certificates at some points)
 
-![](image://k9mail_config_1.png?resize=300)
+![](image://k9mail_config_1.png?resize=280&classes=inline)
-![](image://k9mail_config_2.png?resize=300)
+![](image://k9mail_config_2.png?resize=280&classes=inline)
-![](image://k9mail_config_3.png?resize=300)
+![](image://k9mail_config_3.png?resize=280&classes=inline)
-![](image://k9mail_config_4.png?resize=300)
+![](image://k9mail_config_4.png?resize=280&classes=inline)
 
-![](image://dekko-app.png?resize=50)
 
-### Configure Dekko (on Ubuntu Touch)
+### ![](image://dekko-app.png?resize=50&classes=inline) Configure Dekko (on Ubuntu Touch)
 
 The first time you can simply choose "Add account". If you already have an account configured, tap the hamburger menu then tap the gear, choose Mail, Accounts and press the '+'-symbol.
 
 Then you choose IMAP. Fill in the fields and press Next. Now Dekko will look for the configuration. Check that all fields are correct. Make sure you have your yunohost username, NOT your mailadress and choose "Allow untrusted certificates". Do this for IMAP and SMTP and press Next. Dekko will now synchronise the account after which you are done. Congratz!
 
-![](image://dekko_config_1.png?resize=300)
+![](image://dekko_config_1.png?resize=280&classes=inline)
-![](image://dekko_config_2.png?resize=300)
+![](image://dekko_config_2.png?resize=280&classes=inline)
-![](image://dekko_config_3.png?resize=300)
+![](image://dekko_config_3.png?resize=280&classes=inline)
-![](image://dekko_config_4.png?resize=300)
+![](image://dekko_config_4.png?resize=280&classes=inline)

pages/01.administrate/06.overview/10.backups/backup.fr.md

@@ -154,18 +154,22 @@ Il existe aussi l'application Archivist qui permet un système similaire : https
 #### Éviter de sauvegarder certains dossiers
 Si besoin, vous pouvez spécifier que certains dossiers `home` d'utilisateurs ne soient pas sauvegardés par la commande `yunohost backup`, en créant un fichier vide nommé `.nobackup` à l'intérieur.
 
-#### Backup complet avec `dd`
 
-Si vous êtes sur une carte ARM, une autre méthode pour créer une sauvegarde complète consiste à créer une image (copie) de la carte SD. Pour cela, éteignez votre serveur, insérez la carte SD dans votre ordinateur et créez une image avec une commande comme :
+#### Pour les cartes ARM: backup complet avec USBimager ou `dd`
+
+Si vous êtes sur une carte ARM, une autre méthode de backup consiste à créer une image de la carte SD.
+
+Ceci peut être effectué avec [USBimager](https://bztsrc.gitlab.io/usbimager/) (N.B. : assurez-vous de télécharger la version 'Read-write' ! Pas la version 'Write-only' !). Le processus consiste ensuite à "l'inverse" du processus de flashage de la carte SD:
+- Éteignez votre serveur
+- Récupérez la carte SD et branchez la dans votre ordinateur
+- Dans USBimager, cliquez "Read" pour créer une image ("photographie") de la carte SD. Vous pouvez utiliser le fichier obtenu pour plus tard restaurer le système en entier.
+
+Plus de détails dans [la doc d'USBimager](https://gitlab.com/bztsrc/usbimager/#creating-backup-image-file-from-device)
+
+Il est possible d'obtenir la même chose avec `dd` si vous êtes à l'aise avec la ligne de commande:
 
 ```bash
-dd if=/dev/mmcblk0 of=./backup.img status=progress
+dd if=/dev/mmcblk0 | gzip > ./my_snapshot.gz
 ```
 
 (remplacez `/dev/mmcblk0` par le vrai nom de votre carte SD)
-
-Vous pouvez aussi compresser l'image à l'aide de gzip :
-
-```bash
-dd if=/dev/mmcblk0 | gzip > ./image.gz
-```

pages/01.administrate/06.overview/10.backups/backup.it.md

@@ -164,13 +164,21 @@ Potete seguire questo tutorial sul forum per impostare Borg fra due server: <htt
 
 Alternativamente, la app Archivist permette di impostare un sistema simile: <https://forum.yunohost.org/t/new-app-archivist/3747>
 
-#### Backup completo con `dd`
+#### For ARM boards: full backup with USBimager or `dd`
 
-Se state usando una board ARM un altro metodo per eseguire un backup completo è quello di creare un'immagine della card SD. Per fare questo innanzitutto spegnete la vostra board ARM, prendete la card SD e createne un'immagine completa con un comando come il seguente:
+If you are using an ARM board, another method for doing a full backup can be to create an image of the SD card.
 
+This can be done easily using [USBimager](https://bztsrc.gitlab.io/usbimager/) (N.B. be sure to get the Read-Write version! Not the write-only version!). The process is basically the *reverse* of flashing the SD card.
+- Poweroff your server
+- Get the SD card and plug it into your computer
+- Using USBimager, click the *Read* button to create an image (snapshot) of the sd card. You can use it later to restore the entire system. 
+
+More details [in the USBimager doc](https://gitlab.com/bztsrc/usbimager/#creating-backup-image-file-from-device)
+
+Alternatively you can use `dd` if you're comfortable with the command line with something like:
 
 ```bash
-dd if=/dev/mmcblk0 of=./backup.img status=progress
+dd if=/dev/mmcblk0 | gzip > ./my_snapshot.gz
 ```
 
-(modificate `/dev/mmcblk0` con il device reale della vostra card)
+(replace `/dev/mmcblk0` with the actual device of your SD card)

pages/01.administrate/06.overview/10.backups/backup.md

@@ -161,17 +161,21 @@ Alternatively, the app Archivist allows to setup a similar system: <https://foru
 #### Avoiding the backup of some folders
 If needed, you can specify that some `/home/user` folders are left out of the `yunohost backup` command, by creating a blank file named `.nobackup` in them.
 
-#### Full backup with `dd`
+#### For ARM boards: full backup with USBimager or `dd`
 
-If you are using an ARM board, another method for doing a full backup can be to create an image of the SD card. For this, poweroff your ARM board, get the SD card in your computer then create a full image with something like:
+If you are using an ARM board, another method for doing a full backup can be to create an image of the SD card.
+
+This can be done easily using [USBimager](https://bztsrc.gitlab.io/usbimager/) (N.B. be sure to get the Read-Write version! Not the write-only version!). The process is basically the *reverse* of flashing the SD card.
+- Poweroff your server
+- Get the SD card and plug it into your computer
+- Using USBimager, click the *Read* button to create an image (snapshot) of the sd card. You can use it later to restore the entire system. 
+
+More details [in the USBimager doc](https://gitlab.com/bztsrc/usbimager/#creating-backup-image-file-from-device)
+
+Alternatively you can use `dd` if you're comfortable with the command line with something like:
 
 ```bash
-dd if=/dev/mmcblk0 of=./backup.img status=progress
+dd if=/dev/mmcblk0 | gzip > ./my_snapshot.gz
 ```
 
 (replace `/dev/mmcblk0` with the actual device of your SD card)
-
-You can also create a compressed image using gzip this way:
-```bash
-dd if=/dev/mmcblk0 | gzip > ./image.gz
-```

themes/yunohost-docs/scss/theme/_global.scss

@@ -137,6 +137,10 @@ body #top-bar #navigation {
  SIDE BAR
 =================================================*/
 
+body.off-canvas .learn-sidebar .learn-brand {
+  box-shadow: none;
+}
+
 body .off-canvas .learn-sidebar .learn-nav ul li ul li.active > a {
   background-color: rgba(0, 0, 0, 0.1);
   border-left: 4px solid mediumturquoise;