Merge branch 'main' of git.deuxfleurs.fr:Deuxfleurs/guide.deuxfleurs.fr

12 files changed, 72 insertions, 23 deletions

diff --git a/content/prise_en_main/avec-un-générateur.md b/content/prise_en_main/avec-un-générateur.md
index 5f9d58e..7bcda6d 100644
--- a/content/prise_en_main/avec-un-générateur.md
+++ b/content/prise_en_main/avec-un-générateur.md
@@ -53,7 +53,7 @@ Quand on écrit du texte sans mettre quoi que ce soit autour ou avant, cela devi
 
 Une fois votre fichier écrit, enregistrez-le avec l'extension `.md`, par exemple sous le nom `recette-tartre-au-citron.md`. L'idée est qu'à chaque page de votre site correspond un fichier `.md`, et ceux-ci seront regroupés dans un dossier. Vous trouverez [dans notre forge](https://git.deuxfleurs.fr/Deuxfleurs/guide.deuxfleurs.fr/src/branch/main/content) les fichiers Markdown écrits pour faire ce guide.
 
-Cependant, il reste juste une petite chose à faire lorsque vous avez fini votre texte : écrire l'en-tête au dessus du markdown, qui donnera au générateur des informations importantes sur ce contenu. On encadre cet en-têtre avec trois signes plus. Voici un exemple basé sur cette page :
+Cependant, il reste juste une petite chose à faire lorsque vous avez fini votre texte : écrire l'en-tête au dessus du markdown, qui donnera au générateur des informations importantes sur ce contenu. On encadre cet en-tête avec trois signes plus. Voici un exemple basé sur cette page :
 
 ```
 ---
diff --git a/content/prise_en_main/aws-cli.md b/content/prise_en_main/aws-cli.md
index a1e7ee6..21fbc98 100644
--- a/content/prise_en_main/aws-cli.md
+++ b/content/prise_en_main/aws-cli.md
@@ -2,7 +2,7 @@
 title: "aws-cli"
 description: "Publier avec aws-cli"
 date: 2022-09-01
-weight: 1
+weight: 20
 extra: 
   parent: "prise_en_main/publier-le-contenu.md"
 ---
@@ -16,7 +16,7 @@ Vous pouvez installer `aws` :
 - soit via les paquets fournis par votre distribution (par ex. [Ubuntu](https://snapcraft.io/aws-cli) ou [Fedora](https://packages.fedoraproject.org/pkgs/awscli2/awscli2/))
 - soit en suivant les instructions sur [le site officiel d'Amazon](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
 
-Une fois `aws` installé sur votre machine, vous pouvez suivre les instructions de connexion indiquées sur [le guichet](https://guichet.deuxfleurs.fr/website/configure#). Cliquez sur le lien "`awscli`" dans la section "Confgurez votre logiciel" pour afficher les instructions.
+Une fois `aws` installé sur votre machine, vous pouvez suivre les instructions de connexion indiquées sur [le guichet](https://guichet.deuxfleurs.fr/website/configure#). Cliquez sur le lien "`awscli`" dans la section "Configurez votre logiciel" pour afficher les instructions.
 
 ### Configurer la page par défaut et celle pour les erreurs
 Puisqu'on est sur la configuration S3, profitons-en pour paramétrer une page d'accueil et une page d'erreur.
diff --git a/content/prise_en_main/configurer_apex_Gandi.md b/content/prise_en_main/configurer_apex_Gandi.md
index 1d963b5..c90725d 100644
--- a/content/prise_en_main/configurer_apex_Gandi.md
+++ b/content/prise_en_main/configurer_apex_Gandi.md
@@ -13,7 +13,7 @@ D'abord, rendez-vous dans votre espace utilisateur Gandi, puis de là cliquez da
 
 ![dns1.png](/img/apex_gandi_1.png)
 
-Une fois sur la page «Nom de domaines», votre nom de domaine devrait apparaitre dans la liste, ici «camille-michu.fr». Cliquez dessus :
+Une fois sur la page «Nom de domaines», votre nom de domaine devrait apparaître dans la liste, ici «camille-michu.fr». Cliquez dessus :
   
 ![dns2.png](/img/apex_gandi_2.png)
 
diff --git a/content/prise_en_main/deploiement_hugo.md b/content/prise_en_main/deploiement_hugo.md
new file mode 100644
index 0000000..29cfac4
--- /dev/null
+++ b/content/prise_en_main/deploiement_hugo.md
@@ -0,0 +1,45 @@
+---
+title: "Hugo"
+description: "Publier un site web sur Deuxfleurs avec Hugo"
+weight: 10
+extra:
+  parent: 'prise_en_main/publier-le-contenu.md'
+---
+
+Configurez le fichier `~/.aws/credentials` de la manière suivante avec votre
+identifiant de clef (`GKxxxx`) et votre clef secrète (`xxxxxx`), que vous
+pouvez récupérer depuis [le
+guichet](https://guichet.deuxfleurs.fr/website/configure#):
+
+```ini
+[default]
+aws_access_key_id = GKxxxxxx
+aws_secret_access_key = xxxxxxxx
+```
+
+Ensuite, ajoutez les lignes suivantes dans le fichier `config.toml` du dossier
+de votre site web utilisé par Hugo:
+
+```toml
+[deployment]
+order = [".jpg$", ".gif$", ".png$"]
+
+
+[[deployment.targets]]
+name = "deuxfleurs"
+URL = "s3://votresiteweb.fr&endpoint=garage.deuxfleurs.fr&region=garage&s3ForcePathStyle=true"
+```
+
+Dans la ligne `URL`, remplacez `votresiteweb.fr` par le nom de domaine que vous souhaitez utiliser.
+
+Une fois la configuration faite, vous pouvez publier votre site web en
+exécutant simplement la commande suivante:
+
+```
+hugo deploy
+```
+
+Pour en savoir plus, consulter la documentation officielle à l'adresse:
+
+* <https://gohugo.io/hosting-and-deployment/hugo-deploy/>
+
diff --git a/content/prise_en_main/drive_garage.md b/content/prise_en_main/drive_garage.md
index cde90b4..6a83c21 100644
--- a/content/prise_en_main/drive_garage.md
+++ b/content/prise_en_main/drive_garage.md
@@ -11,11 +11,11 @@ extra:
 **Objectif:**
 
 - stocker vos données chez Deuxfleurs et les faire apparaître dans votre navigateur de fichier comme un disque réseau, ce qui vous permet d'y accéder comme à des fichiers normaux.
-- optionnellement, ajouter une couche de chiffrement afin que vos fichiers ne soient pas stockés en clair sur les serveurs de Deuxfleurs.i
+- optionnellement, ajouter une couche de chiffrement afin que vos fichiers ne soient pas stockés en clair sur les serveurs de Deuxfleurs.
 
 **Attention:** ce tutoriel vous permet d'accéder à un dossier partagé depuis plusieurs machines. Cependant, Garage n'est pas capable de gérer l'édition en simultané d'un document depuis plusieurs lieux différents. Avec la méthode présentée ici, **ne modifiez jamais un fichier stocké sur Garage depuis plusieurs ordinateurs en même temps: vous pourriez perdre des données!**
 
-**En cas de problème avec ce tutoriel:** rappporter votre souci sur le chan Matrix `#tech:deuxfleurs.fr` ou directement par mail à `alex [at] adnab.me`.
+**En cas de problème avec ce tutoriel:** rapporter votre souci sur le chan Matrix `#tech:deuxfleurs.fr` ou directement par mail à `alex [at] adnab.me`.
 
 ## 1. Obtenir des clefs d'accès Garage
 
@@ -57,7 +57,7 @@ $ rclone lsd grgdf:
 $
 ```
 
-Ce résultat indique que vous disposez d'un bucket (un dossier de premier niveau) sur le stockage, ici appellé `alex.perso`. Celui-ci a été créé par un administrateur et vous ne pouvez pas en créer d'autre vous-même. Retenez son nom pour l'étape suivante.
+Ce résultat indique que vous disposez d'un bucket (un dossier de premier niveau) sur le stockage, ici appelé `alex.perso`. Celui-ci a été créé par un administrateur et vous ne pouvez pas en créer d'autre vous-même. Retenez son nom pour l'étape suivante.
 
 ### 2.2. Configurer la couche de chiffrement `rclone`
 
@@ -75,8 +75,8 @@ Pour lancer l'assistant interactif, tapez `rclone config` dans un terminal. Ensu
 - Choisissez l'option `encrypt directory names` (option `1`)
 - Pour le premier mot de passe, tapez `g` pour `Generate password`.
 - Entrez 128 pour la taille du mot de passe.
-- Prenoez note du mot de passe affiché et gardez-le en lieu sûr pour être sûr de pouvoir déchiffrer vos données dans le future. Confirmez en tapant `y`
-- On vous demande ensuite si vous voulez utiliser un sel personalisé. Tapez `g` pour en créer un automatiquement.
+- Prenez note du mot de passe affiché et gardez-le en lieu sûr pour être sûr de pouvoir déchiffrer vos données dans le future. Confirmez en tapant `y`
+- On vous demande ensuite si vous voulez utiliser un sel personnalisé. Tapez `g` pour en créer un automatiquement.
 - Entrez 128 pour la taille du sel.
 - Prenez note également du sel, qui fonctionne comme un second mot de passe. Confirmez en tapant `y`
 - Tapez `n` à la question `edit advanced config?`
@@ -101,7 +101,7 @@ Pour tester que votre dossier chiffré est bien configuré, vous pouvez par exem
 
 Nous allons maintenant faire en sorte que vos dossiers Garage apparaissent comme des disques réseau montés sur votre système de fichier, ce qui vous permettera d'y accéder depuis votre explorateur de fichier comme s'il s'agissait de dossiers normaux.
 
-Pour commencer, choissez un endroit où monter votre disque réseau. Dans cet exemple, j'utiliserai `$HOME/mnt/grgdf` pour le dossier non chiffré, et `$HOME/mnt/grgdfcrypt` pour le dossier chiffré. Créez ces deux dossier vides:
+Pour commencer, choisissez un endroit où monter votre disque réseau. Dans cet exemple, j'utiliserai `$HOME/mnt/grgdf` pour le dossier non chiffré, et `$HOME/mnt/grgdfcrypt` pour le dossier chiffré. Créez ces deux dossier vides:
 
 ```bash
 mkdir -p $HOME/mnt/grgdf
@@ -140,7 +140,7 @@ Pour tester le fonctionnement de votre dossier Garage, vous pouvez naviguer dans
 
 ## 4. Configurer une seconde machine pour accéder au dossier
 
-Vous pouvez assez facilement configurer une seconde machine pour accéder au même dossier partagé sur Garage. Pour cela, reprenez le fichier `~/.config/rclone/rclone.conf` de votre premère machine et copiez-le au même endroit sur votre seconde machine. Vous pouvez ensuite réaliser sur votre deuxième machine les étapes mentionnées dans la section 3 pour le service systemd.
+Vous pouvez assez facilement configurer une seconde machine pour accéder au même dossier partagé sur Garage. Pour cela, reprenez le fichier `~/.config/rclone/rclone.conf` de votre première machine et copiez-le au même endroit sur votre seconde machine. Vous pouvez ensuite réaliser sur votre deuxième machine les étapes mentionnées dans la section 3 pour le service systemd.
 
 **ATTENTION:** Garage ne supporte pas l'édition simultanée d'un document depuis plusieurs machines. Si vous ouvrez un fichier pour le modifier en même temps sur des machines différentes, **vous prenez le risque de perdre des données**. Pour utiliser votre dossier Garage comme un lieu de travail collaboratif, assurez-vous que des personnes différentes devant modifier un même fichier prendront chacun leur tour bien défini pour le faire.
 
diff --git a/content/prise_en_main/filezilla.md b/content/prise_en_main/filezilla.md
index d394805..e224bc5 100644
--- a/content/prise_en_main/filezilla.md
+++ b/content/prise_en_main/filezilla.md
@@ -2,7 +2,7 @@
 title: "FileZilla"
 description: "Publier avec FileZilla"
 date: 2023-09-16
-weight: 1
+weight: 50
 extra: 
   parent: "prise_en_main/publier-le-contenu.md"
 ---
diff --git a/content/prise_en_main/initialiser-votre-accès.md b/content/prise_en_main/initialiser-votre-accès.md
index 7450265..e6e170c 100644
--- a/content/prise_en_main/initialiser-votre-accès.md
+++ b/content/prise_en_main/initialiser-votre-accès.md
@@ -16,7 +16,7 @@ De par l'utilisation de son logiciel Garage, Deuxfleurs conserve et sert les sit
 * Spécifiez le nom de domaine pour votre site (l'identifiant du site qu'on tape dans la barre URL d'un navigateur pour y accéder) :
 	* Si vous n'avez pas votre propre nom de domaine, votre site peut être rendu accessible dans un sous-domaine de `web.deuxfleurs.fr`. Dans l'onglet "Je n'ai pas de nom de domaine", entrez le sous domaine de votre choix.
 	* Si vous avez votre propre nom de domaine, entrez-le dans l'onglet "Utiliser mon propre nom de domaine". Il faudra alors [configurer votre serveur DNS pour pointer sur l'adresse d'hébergement chez DeuxFleurs](@/prise_en_main/mettre-place-DNS.md).
-* Cliquez sur "Créer un nouveau site web" pour confirmer la création du bucket dans Garrage.
+* Cliquez sur "Créer un nouveau site web" pour confirmer la création du bucket dans Garage.
 
 Pour copier les fichiers du site web dans le bucket et [publier le site web](@/prise_en_main/publier-le-contenu.md), vous aurez besoin des clefs d'accès et des propriétés du bucket accessibles en cliquant sur "Mes identifiants".
 
diff --git a/content/prise_en_main/matrix.md b/content/prise_en_main/matrix.md
index f6faca5..3714247 100644
--- a/content/prise_en_main/matrix.md
+++ b/content/prise_en_main/matrix.md
@@ -33,5 +33,5 @@ Deuxfleurs a une pléthore de salons sur Matrix. C'est vraiment à cet endroit q
 * [deuxfleurs::asso](https://matrix.to/#/#deuxfleurs:deuxfleurs.fr) où l'on parle de l'association.
 * [deuxfleurs::forum](https://matrix.to/#/#forum:deuxfleurs.fr) où l'on discute beaucoup des questions de numérique et société mais pas que.
 * [deuxfleurs::infra](https://matrix.to/#/#tech:deuxfleurs.fr) où l'on parle « techniques » (informatique, notamment).
-* [deuxfleurs::usages](https://matrix.to/#/#usages:deuxfleurs.fr) où l'on parle « usages » des serivces fournis par DeuxFleurs: bugs, problèmes, questions, remarques, souhaits, idées.
+* [deuxfleurs::usages](https://matrix.to/#/#usages:deuxfleurs.fr) où l'on parle « usages » des services fournis par DeuxFleurs: bugs, problèmes, questions, remarques, souhaits, idées.
 
diff --git a/content/prise_en_main/publier-le-contenu.md b/content/prise_en_main/publier-le-contenu.md
index b06adcb..3087bb7 100644
--- a/content/prise_en_main/publier-le-contenu.md
+++ b/content/prise_en_main/publier-le-contenu.md
@@ -10,7 +10,11 @@ extra:
 
 Nous allons désormais verser votre site sur Garage, et ce dernier le servira à toutes les personnes qui voudront le voir. Vous aurez besoin de l'identifiant de votre clé d'accès et de la clé d'accès secrète, obtenus dans la partie «[Initialiser votre accès](@/prise_en_main/initialiser-votre-accès.md)».
 
-Vous avez le choix entre trois méthodes :
+Si vous utilisez Hugo, vous pouvez le configurer pour envoyer directement le site sur les serveurs de Deuxfleurs:
+
+* [Publier un site web sur Deuxfleurs avec Hugo](@/prise_en_main/deploiement_hugo.md)
+
+Dans les autres cas, vous avez le choix entre trois méthodes :
 * [Faire ça en ligne de commande avec `aws-cli`](@/prise_en_main/aws-cli.md). C'est la méthode la plus habituelle et la plus éprouvée, cependant il faut utiliser le terminal, et être sur linux est grandement conseillé pour celle-ci.
 * [Faire ça avec l'utilitaire graphique `rclone`](@/prise_en_main/rclone.md). Cette méthode vous paraîtra peut-être moins intimidante grâce à l'interface graphique du logiciel rclone. Celui-ci tourne sur Linux, Windows, et macOS.
 * [Faire ça avec l'utilitaire graphique `winscp`](@/prise_en_main/winscp.md). Cette méthode propose elle également une interface graphique, mais ne fonctionne que sur Windows.
diff --git a/content/prise_en_main/rclone.md b/content/prise_en_main/rclone.md
index 34bb825..f6ab17f 100644
--- a/content/prise_en_main/rclone.md
+++ b/content/prise_en_main/rclone.md
@@ -1,7 +1,7 @@
 ---
 title: "Rclone Browser"
 description: "Publier avec Rclone Browser"
-weight: 2
+weight: 30
 date: 2021-11-25T14:31:35.570Z
 dateCreated: 2021-11-25T14:02:30.997Z
 extra:
@@ -70,17 +70,17 @@ Cliquez sur "File" (Fichiers) en haut à gauche, puis sur "Preferences...". La f
 
 ![rclone-conf2.png](/img/rclone_conf2.png)
 
-Repérez la deuxième ligne intitulée `rclone.conf location:`. Tout au bout de la ligne, cliquez sur le bouton avec les trois points `[...]`. Vous aurez alors la possibilité d'indiquer à Rclone Browser où se trouve le fichier de configuration créé juste avant (pour ma part, je rappelle, "Dossier personnel > Documents > Configuration > rclone.conf", on voit que le chemin complet vers le fichier apparait maintenant dans le champs texte.
+Repérez la deuxième ligne intitulée `rclone.conf location:`. Tout au bout de la ligne, cliquez sur le bouton avec les trois points `[...]`. Vous aurez alors la possibilité d'indiquer à Rclone Browser où se trouve le fichier de configuration créé juste avant (pour ma part, je rappelle, "Dossier personnel > Documents > Configuration > rclone.conf", on voit que le chemin complet vers le fichier apparaît maintenant dans le champs texte.
 
 Appuyez sur OK, et la fenêtre principale devrait maintenant ressembler à ça :
 
 ![rclone-s3.png](/img/rclone_s3.png)
 
-Cliquez sur "S3 garage" puis cliquez sur "Open". Si vous voyez des dossiers apparaitre, c'est gagné !
+Cliquez sur "S3 garage" puis cliquez sur "Open". Si vous voyez des dossiers apparaître, c'est gagné !
 
 ![rclone-conn.png](/img/rclone_conn.png)
 
-Vous pouvez maintenant naviguer dans vos dossiers, envoyer des fichiers sur Garage ou en récupérer. Attention, vous ne pouvez pas créer de "nouveaux dossiers" à la racine, mais vous pouvez créer des sous-dossiers dans les dossiers existants pré-alablement créés pour vous.
+Vous pouvez maintenant naviguer dans vos dossiers, envoyer des fichiers sur Garage ou en récupérer. Attention, vous ne pouvez pas créer de "nouveaux dossiers" à la racine, mais vous pouvez créer des sous-dossiers dans les dossiers existants préalablement créés pour vous.
 
 # Utiliser comme un drive
 
diff --git a/content/prise_en_main/webdav.md b/content/prise_en_main/webdav.md
index ae94187..2c08da3 100644
--- a/content/prise_en_main/webdav.md
+++ b/content/prise_en_main/webdav.md
@@ -2,7 +2,7 @@
 title: "WebDAV"
 description: "Publier via un gestionnaire de fichiers avec WebDAV"
 date: 2023-09-16
-weight: 1
+weight: 60
 extra: 
   parent: "prise_en_main/publier-le-contenu.md"
 ---
diff --git a/content/prise_en_main/winscp.md b/content/prise_en_main/winscp.md
index 6528836..bdd3e49 100644
--- a/content/prise_en_main/winscp.md
+++ b/content/prise_en_main/winscp.md
@@ -1,7 +1,7 @@
 ---
 title: "WinSCP"
 description: "Publier avec WinSCP"
-weight: 3
+weight: 40
 extra:
   parent: 'prise_en_main/publier-le-contenu.md'
 ---
@@ -17,7 +17,7 @@ Installez le logiciel.
 
 # Configuration
 
-Lancez le. La fenêtre de connexion suivante devrait apparaitre :
+Lancez le. La fenêtre de connexion suivante devrait apparaître :
 
 ![](/img/winscp_login.png)
 
@@ -43,7 +43,7 @@ Vous voilà de retour sur la fenêtre de connexion :
 
  1. Cliquez sur *Sauver* (cliquez bien sur le texte et non sur la flèche noire à droite)
  
-La fenêtre suivante apparait :
+La fenêtre suivante apparaît :
 
 ![](/img/winscp_session.png)