From a0e11ad9943fa6c7853d0169995d4d19b3327705 Mon Sep 17 00:00:00 2001 From: Alexandre Aubin Date: Thu, 11 Feb 2021 01:34:28 +0100 Subject: [PATCH 1/5] Inline images in email_configure_client --- .../email_configure_client.es.md | 15 +++++------ .../email_configure_client.fr.md | 27 ++++++++----------- .../02.emailclients/email_configure_client.md | 27 ++++++++----------- 3 files changed, 28 insertions(+), 41 deletions(-) diff --git a/pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.es.md b/pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.es.md index f024dd87..84147524 100644 --- a/pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.es.md +++ b/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) - -### Configurar K-9 Mail (en Android) +### ![](image://k9mail.png?resize=50&classes=inline) 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_2.png?resize=300) -![](image://k9mail_config_3.png?resize=300) -![](image://k9mail_config_4.png?resize=300) +![](image://k9mail_config_1.png?resize=300&classes=inline) +![](image://k9mail_config_2.png?resize=300&classes=inline) +![](image://k9mail_config_3.png?resize=300&classes=inline) +![](image://k9mail_config_4.png?resize=300&classes=inline) diff --git a/pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.fr.md b/pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.fr.md index 6a6233d9..f953bb35 100644 --- a/pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.fr.md +++ b/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) - -### Configurer K-9 Mail (sur Android) +### ![](image://k9mail.png?resize=50&classes=inline) 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_2.png?resize=300) -![](image://k9mail_config_3.png?resize=300) -![](image://k9mail_config_4.png?resize=300) +![](image://k9mail_config_1.png?resize=300&classes=inline) +![](image://k9mail_config_2.png?resize=300&classes=inline) +![](image://k9mail_config_3.png?resize=300&classes=inline) +![](image://k9mail_config_4.png?resize=300&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) 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_2.png?resize=300) -![](image://dekko_config_3.png?resize=300) -![](image://dekko_config_4.png?resize=300) +![](image://dekko_config_1.png?resize=300&classes=inline) +![](image://dekko_config_2.png?resize=300&classes=inline) +![](image://dekko_config_3.png?resize=300&classes=inline) +![](image://dekko_config_4.png?resize=300&classes=inline) diff --git a/pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.md b/pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.md index 0c5c6762..a43ea17f 100644 --- a/pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.md +++ b/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) - -### Configure Mozilla Thunderbird (on a desktop computer) +### ![](image://thunderbird.png?resize=50&classes=inline) 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) - -### Configure K-9 Mail (on Android) +### ![](image://k9mail.png?resize=50&classes=inline) 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_2.png?resize=300) -![](image://k9mail_config_3.png?resize=300) -![](image://k9mail_config_4.png?resize=300) +![](image://k9mail_config_1.png?resize=300&classes=inline) +![](image://k9mail_config_2.png?resize=300&classes=inline) +![](image://k9mail_config_3.png?resize=300&classes=inline) +![](image://k9mail_config_4.png?resize=300&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_2.png?resize=300) -![](image://dekko_config_3.png?resize=300) -![](image://dekko_config_4.png?resize=300) +![](image://dekko_config_1.png?resize=300&classes=inline) +![](image://dekko_config_2.png?resize=300&classes=inline) +![](image://dekko_config_3.png?resize=300&classes=inline) +![](image://dekko_config_4.png?resize=300&classes=inline) From 6723499fc81d423242f6d321c99b9db562cde828 Mon Sep 17 00:00:00 2001 From: Alexandre Aubin Date: Thu, 11 Feb 2021 01:37:13 +0100 Subject: [PATCH 2/5] Try to optimize width for cosmetic/rendering --- .../02.emailclients/email_configure_client.es.md | 8 ++++---- .../02.emailclients/email_configure_client.fr.md | 16 ++++++++-------- .../02.emailclients/email_configure_client.md | 16 ++++++++-------- 3 files changed, 20 insertions(+), 20 deletions(-) diff --git a/pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.es.md b/pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.es.md index 84147524..871841d6 100644 --- a/pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.es.md +++ b/pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.es.md @@ -33,7 +33,7 @@ Para configurar manualmente un nuevo cuenta en Thunderbird, añadir las informac 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&classes=inline) -![](image://k9mail_config_2.png?resize=300&classes=inline) -![](image://k9mail_config_3.png?resize=300&classes=inline) -![](image://k9mail_config_4.png?resize=300&classes=inline) +![](image://k9mail_config_1.png?resize=280&classes=inline) +![](image://k9mail_config_2.png?resize=280&classes=inline) +![](image://k9mail_config_3.png?resize=280&classes=inline) +![](image://k9mail_config_4.png?resize=280&classes=inline) diff --git a/pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.fr.md b/pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.fr.md index f953bb35..cde298ef 100644 --- a/pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.fr.md +++ b/pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.fr.md @@ -34,10 +34,10 @@ Pour configurer manuellement un nouveau compte dans Thunderbird commencez par re Suivez les instructions suivantes. (Comme pour Thunderbird, il vous faudra peut-être accepter des certificats à un moment) -![](image://k9mail_config_1.png?resize=300&classes=inline) -![](image://k9mail_config_2.png?resize=300&classes=inline) -![](image://k9mail_config_3.png?resize=300&classes=inline) -![](image://k9mail_config_4.png?resize=300&classes=inline) +![](image://k9mail_config_1.png?resize=280&classes=inline) +![](image://k9mail_config_2.png?resize=280&classes=inline) +![](image://k9mail_config_3.png?resize=280&classes=inline) +![](image://k9mail_config_4.png?resize=280&classes=inline) ### ![](image://dekko-app.png?resize=50&classes=inline) Configure Dekko (on Ubuntu Touch) @@ -45,7 +45,7 @@ La première fois, vous pouvez simplement choisir "Ajouter un compte". Si vous a 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&classes=inline) -![](image://dekko_config_2.png?resize=300&classes=inline) -![](image://dekko_config_3.png?resize=300&classes=inline) -![](image://dekko_config_4.png?resize=300&classes=inline) +![](image://dekko_config_1.png?resize=280&classes=inline) +![](image://dekko_config_2.png?resize=280&classes=inline) +![](image://dekko_config_3.png?resize=280&classes=inline) +![](image://dekko_config_4.png?resize=280&classes=inline) diff --git a/pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.md b/pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.md index a43ea17f..67388a3e 100644 --- a/pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.md +++ b/pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.md @@ -33,10 +33,10 @@ To manually configure a new account in Thunderbird, add the account information, Follow the following steps. (As for Thunderbird, you might need to accept certificates at some points) -![](image://k9mail_config_1.png?resize=300&classes=inline) -![](image://k9mail_config_2.png?resize=300&classes=inline) -![](image://k9mail_config_3.png?resize=300&classes=inline) -![](image://k9mail_config_4.png?resize=300&classes=inline) +![](image://k9mail_config_1.png?resize=280&classes=inline) +![](image://k9mail_config_2.png?resize=280&classes=inline) +![](image://k9mail_config_3.png?resize=280&classes=inline) +![](image://k9mail_config_4.png?resize=280&classes=inline) ### ![](image://dekko-app.png?resize=50&classes=inline) Configure Dekko (on Ubuntu Touch) @@ -45,7 +45,7 @@ The first time you can simply choose "Add account". If you already have an accou 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&classes=inline) -![](image://dekko_config_2.png?resize=300&classes=inline) -![](image://dekko_config_3.png?resize=300&classes=inline) -![](image://dekko_config_4.png?resize=300&classes=inline) +![](image://dekko_config_1.png?resize=280&classes=inline) +![](image://dekko_config_2.png?resize=280&classes=inline) +![](image://dekko_config_3.png?resize=280&classes=inline) +![](image://dekko_config_4.png?resize=280&classes=inline) From 215cec0248eb80cc465bfc56845e483316bd85ad Mon Sep 17 00:00:00 2001 From: Alexandre Aubin Date: Thu, 11 Feb 2021 01:48:00 +0100 Subject: [PATCH 3/5] Tip about using USBimager to backup an entire sd card --- .../06.overview/10.backups/backup.fr.md | 22 +++++++++++-------- .../06.overview/10.backups/backup.it.md | 16 ++++++++++---- .../06.overview/10.backups/backup.md | 20 ++++++++++------- 3 files changed, 37 insertions(+), 21 deletions(-) diff --git a/pages/01.administrate/06.overview/10.backups/backup.fr.md b/pages/01.administrate/06.overview/10.backups/backup.fr.md index 641e6e98..7ffa29c7 100644 --- a/pages/01.administrate/06.overview/10.backups/backup.fr.md +++ b/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 -``` diff --git a/pages/01.administrate/06.overview/10.backups/backup.it.md b/pages/01.administrate/06.overview/10.backups/backup.it.md index dd35b520..168d7129 100644 --- a/pages/01.administrate/06.overview/10.backups/backup.it.md +++ b/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: -#### 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) diff --git a/pages/01.administrate/06.overview/10.backups/backup.md b/pages/01.administrate/06.overview/10.backups/backup.md index 30277da7..c08552d1 100644 --- a/pages/01.administrate/06.overview/10.backups/backup.md +++ b/pages/01.administrate/06.overview/10.backups/backup.md @@ -161,17 +161,21 @@ Alternatively, the app Archivist allows to setup a similar system: ./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 -``` From b77e4e496e8534f44ce9192d2c4eb189fa2d9afd Mon Sep 17 00:00:00 2001 From: Alexandre Aubin Date: Thu, 11 Feb 2021 01:52:58 +0100 Subject: [PATCH 4/5] sidebar: minimalism ftw, no need for box shadow --- themes/yunohost-docs/scss/theme/_global.scss | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/themes/yunohost-docs/scss/theme/_global.scss b/themes/yunohost-docs/scss/theme/_global.scss index ed008e1a..411f21eb 100644 --- a/themes/yunohost-docs/scss/theme/_global.scss +++ b/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; From a413dcf5a36a517e3106b821e9a825bf724450bf Mon Sep 17 00:00:00 2001 From: Alexandre Aubin Date: Thu, 11 Feb 2021 01:59:12 +0100 Subject: [PATCH 5/5] Add icon to prerequisites --- pages/01.administrate/05.install/install.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/01.administrate/05.install/install.md b/pages/01.administrate/05.install/install.md index cd94dda3..ee39e12c 100644 --- a/pages/01.administrate/05.install/install.md +++ b/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)