Bonjour; bienvenue sur mon site !
+ + +``` +Vous pourrez facilement trouver moult ressources en ligne pour maîtriser le HTML. [La documentation de Mozilla sur le sujet](https://developer.mozilla.org/fr/docs/Web/HTML) est un bon départ. Enfin, il faut savoir que le HTML est un langage pour décrire le contenu de la page seulement, pas l'allure ou l'esthétique ! La conséquence directe est qu'une page reposant uniquement sur HTML sera sobre : texte noir sur fond blanc, avec alignement à gauche. Si cela vous suffit, vous pouvez d'ores et déjà vous arrêter sur ça. + +### Décrire l'apparence +Si vous souhaitez ajouter des couleurs, modifier la disposition, ou l'arrangement par exemple, il faut rajouter, au-dessus du HTML, une description CSS qui contient vos règles esthétiques. Vous pouvez par exemple créer un fichier `style.css` à la racine du dossier représentant votre site. Ensuite, dans vos pages HTML que vous souhaitez styliser, il faut rajouter, dans la section ``, la formule suivante : `` (attention le chemin de `style.css` est relatif, par exemple si vous voulez styliser une page dans un dossier, il faudrait alors marquer `../style.css` à la place). Une fois ceci fait, lorsque quelqu'un va visiter une page HTML, il va automatiquement récupérer le fichier CSS associé, et l'appliquer. Voici encore une fois, à titre indicatif, un contenu exemple pour `style.css` : +``` +body +{ + margin: 0 auto; + max-width: 1000px; + padding: 10px 10px 10px 10px; +} +``` +Encore une fois, plein de ressources sont disponibles en ligne, et Mozilla propose encore une fois [une bonne base](https://developer.mozilla.org/fr/docs/Web/CSS). + +Une fois que vous avez tous vos fichiers `.html` et `.css` réunis, [vous pouvez passer à la publication](../../publier-le-contenu/) ! diff --git a/content/prise_en_main/web/dns.md b/content/prise_en_main/web/dns.md deleted file mode 100644 index 491abb5..0000000 --- a/content/prise_en_main/web/dns.md +++ /dev/null @@ -1,40 +0,0 @@ -+++ -title = "DNS" -description = "" -date = 2022-08-25T08:56:54.837Z -dateCreated = 2021-11-29T08:46:18.021Z -weight = 10 -+++ - -# Louer son nom de domaine - -Nous recommandons également de choisir un nom de domaine en `.fr` (géré par l'association française AFNIC), `.org` (géré par l'association américaine Public Internet Regitry) ou `.eu` (géré par l'association EURid). Ces entités ont pour historique de ne pas augmenter arbitrairement les prix tout en garantissant la disponibilité de votre nom de domaine. - -Pour référence, la location d'un nom de domaine en `.fr` est d'environ 12 euros par an. Parfois, les bureaux d'enregistrement vous fournissent "des extras" en plus comme une boite email, mais par rapport à la concurrence, ces "extras" n'influent (généralement) pas sur les prix. - -Gandi est un bureau d'enregistrement de nom de domaine que nous recommandons. [Voir la fiche Wikipeda](https://fr.wikipedia.org/wiki/Gandi_(entreprise)). - -# Le configurer pour Deuxfleurs, exemple de Gandi - -Une fois loué, il faut maintenant le configurer. -Supposons que vous avez loué camille-michu.fr chez Gandi et que vous vouliez que votre site web soit accessible à l'URL suivante : https://camille-michu.fr - -D'abord, rendez-vous dans votre espace utilisateur Gandi, puis de là cliquez dans le menu à gauche sur "Nom de domaine" : - - - -Une fois sur la page "Nom de domaines", votre nom de domaine devrait apparaitre dans la liste, ici "camille-michu.fr". Cliquez dessus. - - - -Dans le menu du haut, sélectionnez "Enregistrements DNS" : - - - -Ensuite cliquez sur le bouton "Ajouter un enregistrement" : - - - -Choisissez alors "ALIAS" comme type, et `garage.deuxfleurs.fr` comme nom d'hôte. - - diff --git a/content/prise_en_main/web/initialiser-votre-accès.md b/content/prise_en_main/web/initialiser-votre-accès.md new file mode 100644 index 0000000..328b106 --- /dev/null +++ b/content/prise_en_main/web/initialiser-votre-accès.md @@ -0,0 +1,34 @@ ++++ +title = "Initialiser votre accès" +description = "Initialiser le stockage objet sur Garage" +date = 2022-09-01 +weight = 0 +[extra] +weight_custom = 2 ++++ + +De par l'utilisation de son logiciel Garage, Deuxfleurs conserve et sert les sites web en recourant au stockage objet. Pour chaque site, on a un bucket (seau en français), partageant le même nom que lui. On peut voir un bucket comme un récipient dans lequel on va mettre tout nos fichiers à publier. Pour des raisons de sécurité, l'initialisation de ce dispositif et des identifiants d'accès ne peut être faite que par un administrateur du stockage de Deuxfleurs. Une fois tout ceci mis en place, vous pourrez gérer votre site seul·e. + +# Contacter un·e administrateur·rice +Vous allez donc devoir contacter quelqu'un avec les droits nécessaires pour tout mettre en place. Deux opérations sont nécessaires, faisons d'une pierre deux coups : demandez à la fois les accès et la mise du bucket en global en une fois. + +Une dernière chose avant de se lancer : avez-vous à votre disposition le nom de domaine pour le site ? Il s'agit de l'identifiant du site qu'on tape dans la barre URL d'un navigateur web pour le visiter. Ici on prendra pour exemple `exemple-un.fr`. Si vous n'avez pas réservé le vôtre au moment où vous lisez ces lignes, il vaut mieux vérifier sa disponibilité d'abord, par exemple [ici](https://www.gandi.net/fr/domain). + +### Demander un accès +Nous allons vous fournir un identifiant et un secret que vous utiliserez pour gérer votre site. En effet, sans eux, n'importe qui pourrait le modifier à votre insu. Vous aurez deux choses à conserver : + - L'identifiant de votre clé d'accès. Il ressemble par exemple à `cSGcEQoInTVgkxPIzzF6IyU7C7`. Même s'il ne vaut mieux pas le crier sur tous les toits, il n'y a pas de risque de sécurité si vous le dévoilez à des gens. + - La clé d'accès secrète. Elle ressemble à `rCE6vzSVkll54FNd0Jvx7uoRsNqAXexxX1b3rm2BofquQKln6bdnDLRRli1dZbSS`. Comme son nom l'indique, elle doit absolument rester secrète. Si elle est dévoilée par accident, contactez un·e administrateur·rice immédiatement ! + +### Demander un bucket avec un nom global +Il faut qu'un·e administrateur·rice crée le bucket correspondant correspondant à votre nom de domaine pour vous. Une fois fait, de son point de vue, lorsqu'iel listera une partie d'entre eux, iel verra ceci : +``` +$ sudo docker exec -ti 78e6b7e53241 /garage bucket list|grep -P 'exemple-un.fr|exemple-deux.eu' + 4bdce6:exemple-un.fr 56a0f10929f0d63d0177415a22a0b636cf1efe92845f2b00e04b91298656e78e + exemple-deux.eu 941956ebfffa8fd564ad6b40e4bb5ac2f2b93bdbba1d1bf88fe6daff2cf4df6c +``` +Si `exemple-un.fr` n'est pas à gauche dans la même colonne que `exemple-deux.eu`, c'est parce qu'il n'est pas réglé en global. L'administrateur·rice va corriger ça en faisant `garage bucket alias 56a0f10929f0d63d0177415a22a0b636cf1efe92845f2b00e04b91298656e78e exemple-un.fr`. Résultat : +``` + exemple-un.fr 4bdce6:exemple-un.fr 56a0f10929f0d63d0177415a22a0b636cf1efe92845f2b00e04b91298656e78e + exemple-deux.eu 941956ebfffa8fd564ad6b40e4bb5ac2f2b93bdbba1d1bf88fe6daff2cf4df6c +``` +C'est réglé. [Vous pouvez désormais vous occuper du DNS](../mettre-place-dns/). \ No newline at end of file diff --git a/content/prise_en_main/web/mettre-place-DNS.md b/content/prise_en_main/web/mettre-place-DNS.md new file mode 100644 index 0000000..d27489a --- /dev/null +++ b/content/prise_en_main/web/mettre-place-DNS.md @@ -0,0 +1,38 @@ ++++ +title = "Mettre en place le DNS" +description = "Mise en place du nom de domaine" +date = 2022-09-01 +weight = 0 +[extra] +weight_custom = 3 ++++ + +# Louer son nom de domaine +Les noms de domaine sont gérés et loués par les _registraires de nom de domaine_. Ce sont eux qui proposent aux clients finaux de réserver des noms. On peut citer [Gandi](https://www.gandi.net/fr), [OVHcloud](https://www.ovhcloud.com/fr/), ou [Scaleway](https://www.scaleway.com/fr/) par exemple. Lorsqu'on veut s'offrir `exemple-un.fr` notamment, c'est chez eux que ça se passe; ensuite, à leur tour, ils vont enregistrer notre demande auprès de l'organisme correspondant à l'extension choisie : l'association française [AFNIC](https://www.afnic.fr/) pour `.fr`, l'association états-unienne [Public Internet Registry ](https://thenew.org/) pour `.org`, l'association européenne (belge en particulier) [EURid](https://eurid.eu/fr/) pour `.eu`... Nous recommandons de privilégier l'une de ces trois extensions parmis la myriade qui existe, car ces entités ont pour historique de ne pas augmenter arbitrairement les prix tout en garantissant la disponibilité de votre nom de domaine. + +Pour référence, la location d'un nom de domaine en `.fr` est d'environ 12 euros par an. Certaines offres vous fournissent «des extras» en plus comme une boîte courriel, sans que ça n'influe grandement sur les prix. En ce qui nous concerne, Gandi est un des registraires que nous recommandons. + +### Configurer un enregistrement DNS pour un site hébergé chez Deuxfleurs : exemple avec Gandi +Une fois votre nom de domaine réservé, il faut maintenant le configurer. La procédure change en fonction de l'entreprise choisie. Nous expliquons ici comment configurer chez Gandi. Supposons que vous avez loué `camille-michu.fr` chez eux. + +D'abord, rendez-vous dans votre espace utilisateur Gandi, puis de là cliquez dans le menu à gauche sur «Nom de domaine» : + + + +Une fois sur la page «Nom de domaines», votre nom de domaine devrait apparaitre dans la liste, ici «camille-michu.fr». Cliquez dessus : + + + +Dans le menu du haut, sélectionnez «Enregistrements DNS» : + + + +Ensuite cliquez sur le bouton «Ajouter un enregistrement» : + + + +Choisissez alors «ALIAS» comme type, et `garage.deuxfleurs.fr` comme nom d'hôte. + + + +Maintenant que votre configuration DNS est réglée, vous pouvez [préparer votre contenu](../créer-du-contenu/) ! diff --git a/content/prise_en_main/web/publier-le-contenu/_index.md b/content/prise_en_main/web/publier-le-contenu/_index.md new file mode 100644 index 0000000..bffea49 --- /dev/null +++ b/content/prise_en_main/web/publier-le-contenu/_index.md @@ -0,0 +1,32 @@ ++++ +title = "Publier le contenu" +description = "Comment mettre en ligne son contenu" +date = 2022-09-01 +weight = 0 +sort_by = "weight" +[extra] +weight_custom = 5 ++++ + +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](../initialiser-votre-acces/)». + +Vous avez le choix entre trois méthodes : +* [Faire ça en ligne de commande avec `aws-cli`](aws-cli/). 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`](rclone/). 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`](winscp/). Cette méthode propose elle également une interface graphique, mais ne fonctionne que sur Windows. + +### Bravo ! +Une fois l'un de ces trois guides suivi, vous aurez désormais votre propre site web accessible publiquement en ligne ! +Vous pouvez rajouter dessus le badge attestant fièrement son hébergement sur Garage: + +[](https://garagehq.deuxfleurs.fr/) +[](https://garagehq.deuxfleurs.fr/) + +En HTML: +``` +
+```
+En Markdown:
+```
+[](https://garagehq.deuxfleurs.fr/)
+```
diff --git a/content/prise_en_main/web/publier-le-contenu/_index.md~ b/content/prise_en_main/web/publier-le-contenu/_index.md~
new file mode 100644
index 0000000..442cd27
--- /dev/null
+++ b/content/prise_en_main/web/publier-le-contenu/_index.md~
@@ -0,0 +1,16 @@
++++
+title = "Publier le contenu"
+description = "Comment mettre en ligne son contenu"
+date = 2022-09-01
+weight = 0
+sort_by = "weight"
+[extra]
+weight_custom = 5
++++
+
+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](../initialiser-votre-acces/)».
+
+Vous avez le choix entre trois méthodes :
+* [Faire ça en ligne de commande avec `aws-cli`](../aws-cli/). 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`](../rclone/). 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`](../winscp/). Cette méthode propose elle également une interface graphique, mais ne fonctionne que sur Windows.
diff --git a/content/prise_en_main/web/publier-le-contenu/aws-cli.md b/content/prise_en_main/web/publier-le-contenu/aws-cli.md
new file mode 100644
index 0000000..9316d33
--- /dev/null
+++ b/content/prise_en_main/web/publier-le-contenu/aws-cli.md
@@ -0,0 +1,55 @@
++++
+title = "aws-cli"
+description = "Publier avec aws-cli"
+date = 2022-09-01
+weight = 1
++++
+
+Nous allons désormais verser votre site sur Garage, 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](../initialiser-votre-acces/)».
+
+### Paramétrer votre accès localement
+Pour verser votre site sur Garage, nous allons utiliser l'outil de base pour faire des commandes S3 : [aws-cli](https://github.com/aws/aws-cli) et son binaire, `aws`. À chaque fois, il aura besoin de savoir :
+* l'identifiant de votre clé d'accès
+* votre clé d'accès secrète
+* la région et l'URL de l'infrastructure Garage qui hébergera votre site
+
+En temps normal, il faudrait préciser ces paramètres à chaque fois (donc toutes les fois que vous voulez mettre quelque chose sur votre site, ou le modifier). Pour éviter ça, on va stocker ces informations dans un fichier ; il suffira de l'invoquer avant de faire ses modifications. Dans votre répertoire personnel, créez un fichier nommé par exemple `.awsrc`. À l'intérieur, mettez le contenu suivant :
+```
+export AWS_ACCESS_KEY_ID={votre identifiant de clé d'accès}
+export AWS_SECRET_ACCESS_KEY={votre clé d'accès privée}
+export AWS_DEFAULT_REGION='garage'
+
+function aws { command aws --endpoint-url https://garage.deuxfleurs.fr $@ ; }
+aws --version
+```
+Il vous faut bien entendu insérer vos deux clés aux endroits spécifiés. Une fois ceci fait, dans le futur, avant d'utiliser `aws`, il vous faudra faire `source ~/.awsrc`, et cela mettra en place tous les paramètres pour vous. Vous serez automatiquement authentifié et vous parlerez à la bonne infrastructure Garage.
+
+### 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. En effet, les URL qu'on utilise pour naviguer sur votre site correspondront à la hiérarchie de fichiers présents sur Garage. Si on visite `https://votre-site.fr/blog/recette-de-gateau.html`, Garage va simplement servir le fichier `blog/recette-de-gateau.html`, en partant de la racine du bucket. Mais que ce passe-t-il si on demande à voir `https://votre-site.fr/blog/` ? Garage ne peut pas retourner un dossier; et de toute façon cela ne fonctionnerait pas, puisqu'un dossier n'a pas données propre à lui-même, il ne fait que contenir des fichiers distincts en son sein. On voit pourtant souvent ce genre d'URL en ligne. En fait, les serveurs web sont configurés pour que si aucun fichier du dossier n'est spécifié, alors on va utiliser celui avec un nom paramétré à l'avance. C'est de ça dont on parle.
+De même, lorsque quelqu'un demande une page qui n'existe pas, que peut faire Garage ? Dans la même logique, on va lui donner un nom de fichier à servir par défaut si jamais cela arrive.
+
+Après avoir fait votre `source ~/.awsrc`, faites :
+```
+aws s3 website exemple-un.fr --index-document index.html --error-document erreur.html
+```
+si votre `aws` est en version 2.x, ou
+```
+aws s3api put-bucket-website --bucket exemple-un.fr --website-configuration '
+{
+ "ErrorDocument": {
+ "Key": "/errors/4xx.html"
+ },
+ "IndexDocument": {
+ "Suffix": "index.html"
+ }
+}
+'
+```
+s'il est en version 1.x . Pensez à remplacer `exemple-un.fr` par votre nom de domaine à vous !
+
+### Publier
+On y est ! Avec un terminal, positionnez-vous dans le répertoire qui reflète ce que vous voulez mettre en ligne. Celui-ci devrait contenir des fichiers en `.html`, `.css`, ou `.js`, mais pas de `.md`. Si vous ne l'avez pas fait, faites `source ~/.awsrc`, et lancez ensuite :
+```
+aws s3 sync . s3://exemple-un.fr
+```
+si vous avez `aws` en version 2. N'oubliez pas de mettre votre nom de domaine à la place d'`exemple-un.fr`. Vos fichiers devrait être téléversés. Une fois le processus fini, vous devriez pouvoir ouvrir un navigateur internet tel que Firefox par exemple, tapez votre nom de domaine dans la barre URL, et naviguer sur votre site. En cas de pépin, essayez d'actualiser la page en faisant `ctrl`+`shift`+`r` avec votre clavier, ça vous garantira que votre navigateur récupère le vrai contenu en ligne au lieu de piocher dans le cache local sur votre ordinateur.
diff --git a/content/prise_en_main/web/publier-le-contenu/aws-cli.md~ b/content/prise_en_main/web/publier-le-contenu/aws-cli.md~
new file mode 100644
index 0000000..ba74e8c
--- /dev/null
+++ b/content/prise_en_main/web/publier-le-contenu/aws-cli.md~
@@ -0,0 +1,71 @@
++++
+title = "aws-cli"
+description = "Publier avec aws-cli"
+date = 2022-09-01
+weight = 1
++++
+
+Nous allons désormais verser votre site sur Garage, 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](../initialiser-votre-acces/)».
+
+### Paramétrer votre accès localement
+Pour verser votre site sur Garage, nous allons utiliser l'outil de base pour faire des commandes S3 : [aws-cli](https://github.com/aws/aws-cli) et son binaire, `aws`. À chaque fois, il aura besoin de savoir :
+* l'identifiant de votre clé d'accès
+* votre clé d'accès secrète
+* la région et l'URL de l'infrastructure Garage qui hébergera votre site
+
+En temps normal, il faudrait préciser ces paramètres à chaque fois (donc toutes les fois que vous voulez mettre quelque chose sur votre site, ou le modifier). Pour éviter ça, on va stocker ces informations dans un fichier ; il suffira de l'invoquer avant de faire ses modifications. Dans votre répertoire personnel, créez un fichier nommé par exemple `.awsrc`. À l'intérieur, mettez le contenu suivant :
+```
+export AWS_ACCESS_KEY_ID={votre identifiant de clé d'accès}
+export AWS_SECRET_ACCESS_KEY={votre clé d'accès privée}
+export AWS_DEFAULT_REGION='garage'
+
+function aws { command aws --endpoint-url https://garage.deuxfleurs.fr $@ ; }
+aws --version
+```
+Il vous faut bien entendu insérer vos deux clés aux endroits spécifiés. Une fois ceci fait, dans le futur, avant d'utiliser `aws`, il vous faudra faire `source ~/.awsrc`, et cela mettra en place tous les paramètres pour vous. Vous serez automatiquement authentifié et vous parlerez à la bonne infrastructure Garage.
+
+### 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. En effet, les URL qu'on utilise pour naviguer sur votre site correspondront à la hiérarchie de fichiers présents sur Garage. Si on visite `https://votre-site.fr/blog/recette-de-gateau.html`, Garage va simplement servir le fichier `blog/recette-de-gateau.html`, en partant de la racine du bucket. Mais que ce passe-t-il si on demande à voir `https://votre-site.fr/blog/` ? Garage ne peut pas retourner un dossier; et de toute façon cela ne fonctionnerait pas, puisqu'un dossier n'a pas données propre à lui-même, il ne fait que contenir des fichiers distincts en son sein. On voit pourtant souvent ce genre d'URL en ligne. En fait, les serveurs web sont configurés pour que si aucun fichier du dossier n'est spécifié, alors on va utiliser celui avec un nom paramétré à l'avance. C'est de ça dont on parle.
+De même, lorsque quelqu'un demande une page qui n'existe pas, que peut faire Garage ? Dans la même logique, on va lui donner un nom de fichier à servir par défaut si jamais cela arrive.
+
+Après avoir fait votre `source ~/.awsrc`, faites :
+```
+aws s3 website exemple-un.fr --index-document index.html --error-document erreur.html
+```
+si votre `aws` est en version 2.x, ou
+```
+aws s3api put-bucket-website --bucket exemple-un.fr --website-configuration '
+{
+ "ErrorDocument": {
+ "Key": "/errors/4xx.html"
+ },
+ "IndexDocument": {
+ "Suffix": "index.html"
+ }
+}
+'
+```
+s'il est en version 1.x . Pensez à remplacer `exemple-un.fr` par votre nom de domaine à vous !
+
+### Publier
+On y est ! Avec un terminal, positionnez-vous dans le répertoire qui reflète ce que vous voulez mettre en ligne. Celui-ci devrait contenir des fichiers en `.html`, `.css`, ou `.js`, mais pas de `.md`. Si vous ne l'avez pas fait, faites `source ~/.awsrc`, et lancez ensuite :
+```
+aws s3 sync . s3://exemple-un.fr
+```
+si vous avez `aws` en version 2. N'oubliez pas de mettre votre nom de domaine à la place d'`exemple-un.fr`. Vos fichiers devrait être téléversés. Une fois le processus fini, vous devriez pouvoir ouvrir un navigateur internet tel que Firefox par exemple, tapez votre nom de domaine dans la barre URL, et naviguer sur votre site. En cas de pépin, essayez d'actualiser la page en faisant `ctrl`+`shift`+`r` avec votre clavier, ça vous garantira que votre navigateur récupère le vrai contenu en ligne au lieu de piocher dans le cache local sur votre ordinateur.
+
+### Bravo !
+Fécilicitations ! Vous avez désormais votre propre site web accessible publiquement en ligne !
+Vous pouvez rajouter dessus le badge attestant fièrement son hébergement sur Garage:
+
+[](https://garagehq.deuxfleurs.fr/)
+[](https://garagehq.deuxfleurs.fr/)
+
+En HTML:
+```
+
+```
+En Markdown:
+```
+[](https://garagehq.deuxfleurs.fr/)
+```
diff --git a/content/prise_en_main/web/rclone.md b/content/prise_en_main/web/publier-le-contenu/rclone.md
similarity index 97%
rename from content/prise_en_main/web/rclone.md
rename to content/prise_en_main/web/publier-le-contenu/rclone.md
index 9647339..3b82c15 100644
--- a/content/prise_en_main/web/rclone.md
+++ b/content/prise_en_main/web/publier-le-contenu/rclone.md
@@ -1,13 +1,13 @@
+++
title = "Rclone Browser"
-description = "Rclone Browser"
-weight = 30
+description = "Publier avec Rclone Browser"
+weight = 2
date = 2021-11-25T14:31:35.570Z
dateCreated = 2021-11-25T14:02:30.997Z
+++
-rclone browser est un outil simple qui vous permet d'accéder directement à Garage.
+Rclone browser est un outil simple qui vous permet d'accéder directement à Garage.
# Installation
diff --git a/content/prise_en_main/web/publier-le-contenu/rclone.md~ b/content/prise_en_main/web/publier-le-contenu/rclone.md~
new file mode 100644
index 0000000..d7e03d1
--- /dev/null
+++ b/content/prise_en_main/web/publier-le-contenu/rclone.md~
@@ -0,0 +1,104 @@
++++
+title = "Rclone Browser"
+description = "Rclone Browser"
+weight = 30
+date = 2021-11-25T14:31:35.570Z
+dateCreated = 2021-11-25T14:02:30.997Z
+[extra]
+weight_custom = 15
++++
+
+
+rclone browser est un outil simple qui vous permet d'accéder directement à Garage.
+
+# Installation
+
+Si vous êtes sous macOS ou Windows, vous pouvez télécharger la dernière version depuis la page [github de rclone-browser](https://github.com/kapitainsky/RcloneBrowser/releases) (descendez un peu pour voir les liens).
+
+Sous Ubuntu (lubuntu, kubuntu, etc.), Debian et Linux Mint, cherchez et installez "Rclone Browser" dans la logithèque ("App Store") ou lancez directement depuis un terminal :
+
+```bash
+sudo apt-get install -y rclone-browser
+```
+
+---
+
+Le paquet existe aussi pour d'autres distributions :
+
+```bash
+sudo dnf install -y rclone-browser # fedora
+sudo yay -S rclone-browser # arch linux
+sudo nix-env -iA nixos.rclone-browser # nix os
+```
+
+# Premier lancement
+
+Avant de lancer Rclone Browser, ouvrez un éditeur de texte.
+Moi j'utilise "Éditeur de texte" sous Gnome aussi connu sous le nom de `gedit`. Sous Windows il s'appelle Bloc-Note Windows (ou `notepad.exe`).
+
+
+
+Entrez le texte suivant dedans, tout en remplaçant bien les lignes 5 et 6 par vos identifiants communiqués précédemment :
+
+```toml
+[garage]
+type = s3
+provider = Other
+env_auth = false
+access_key_id =