From a9d05dc30e957c88d69da50de5332bf55bc8feb2 Mon Sep 17 00:00:00 2001 From: vincent Date: Thu, 1 Dec 2022 22:51:00 +0100 Subject: Comment publier. Un peu de refonte du _index.md du dossier web aussi. --- content/prise_en_main/web/_index.md | 38 +------- content/prise_en_main/web/publier-le-contenu.md | 45 --------- .../prise_en_main/web/publier-le-contenu/_index.md | 32 +++++++ .../web/publier-le-contenu/_index.md~ | 16 ++++ .../web/publier-le-contenu/aws-cli.md | 55 +++++++++++ .../web/publier-le-contenu/aws-cli.md~ | 71 ++++++++++++++ .../prise_en_main/web/publier-le-contenu/rclone.md | 102 ++++++++++++++++++++ .../web/publier-le-contenu/rclone.md~ | 104 +++++++++++++++++++++ .../prise_en_main/web/publier-le-contenu/winscp.md | 60 ++++++++++++ .../web/publier-le-contenu/winscp.md~ | 62 ++++++++++++ content/prise_en_main/web/rclone.md | 104 --------------------- content/prise_en_main/web/winscp.md | 62 ------------ 12 files changed, 504 insertions(+), 247 deletions(-) delete mode 100644 content/prise_en_main/web/publier-le-contenu.md create mode 100644 content/prise_en_main/web/publier-le-contenu/_index.md create mode 100644 content/prise_en_main/web/publier-le-contenu/_index.md~ create mode 100644 content/prise_en_main/web/publier-le-contenu/aws-cli.md create mode 100644 content/prise_en_main/web/publier-le-contenu/aws-cli.md~ create mode 100644 content/prise_en_main/web/publier-le-contenu/rclone.md create mode 100644 content/prise_en_main/web/publier-le-contenu/rclone.md~ create mode 100644 content/prise_en_main/web/publier-le-contenu/winscp.md create mode 100644 content/prise_en_main/web/publier-le-contenu/winscp.md~ delete mode 100644 content/prise_en_main/web/rclone.md delete mode 100644 content/prise_en_main/web/winscp.md diff --git a/content/prise_en_main/web/_index.md b/content/prise_en_main/web/_index.md index cd026d7..7849a00 100644 --- a/content/prise_en_main/web/_index.md +++ b/content/prise_en_main/web/_index.md @@ -10,7 +10,7 @@ Vous en avez marre de faire toute votre communication associative via Facebook ? 2. [Initialiser votre accès](./initialiser-votre-acces) 3. [Mettre en place le DNS](./mettre-place-dns) 4. [Créer du contenu](./créer-du-contenu/) -5. [Publier le contenu](./publier-le-contenu) +5. [Publier le contenu](./publier-le-contenu/) # Ils nous font confiance pour leur site web @@ -20,38 +20,4 @@ Vous en avez marre de faire toute votre communication associative via Facebook ? - [quentin.dufour.io](https://quentin.dufour.io) - *Portfolio et blog d'un ingénieur en informatique* - [erwan.dufour.io](https://erwan.dufour.io) - *Portfolio et blog d'un passionné d'électronique* - [rfid.deuxfleurs.fr](https://rfid.deuxfleurs.fr) - *Rencontres Francophones de l'Infonuagique Décentralisé* - - - - - - - - - - - - -# Sites statiques - -Nous fournissons un système d'hébergement de site statique, c'est à dire de HTML, CSS et Javascript. -Il n'est pas possible d'utiliser du PHP ou Wordpress car ces derniers utilisent trop de ressources et ne sont pas compatibles avec nos choix techniques. - -Si vous ne savez pas quels outils utiliser pour la création de votre site statique, nous vous proposons la sélection suivante : - - [Publii](https://getpublii.com/) - si vous êtes seul·e à gérer votre site web - - NetlifyCMS (à venir) - pour publier à plusieurs - - [Hugo](https://gohugo.io/) (avancé) - Avec un générateur de site statique - - [VSCodium](https://vscodium.com/) (avancé) - [Apprenez à créer votre site web avec HTML5 et CSS3](https://openclassrooms.com/fr/courses/1603881-apprenez-a-creer-votre-site-web-avec-html5-et-css3) sur OpenClassrooms - -# Mise en ligne - -Si vous avez déjà votre site web statique, voici notre suggestion d'outils pour le mettre en ligne : - - - [WinSCP](./winscp) (Windows seulement, niveau facile) - - [Rclone Browser](./rclone) (Linux, macOS et Windows, niveau moyen) - - (à venir) notre propre outils - - (à venir, avancé) drone + git - - (à venir, avancé) awscli - - - + - [giraud.eu](https://giraud.eu) - *Site d'un ingénieur en informatique* diff --git a/content/prise_en_main/web/publier-le-contenu.md b/content/prise_en_main/web/publier-le-contenu.md deleted file mode 100644 index 917eacb..0000000 --- a/content/prise_en_main/web/publier-le-contenu.md +++ /dev/null @@ -1,45 +0,0 @@ -+++ -title = "Publier le contenu" -description = "Comment mettre en ligne son contenu" -date = 2022-09-01 -weight = 0 -[extra] -weight_custom = 5 -+++ - -parler du .awsrc - - -### 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. - - - -aws s3 website giraud.eu --index-document index.html --error-document erreur.html - -ou - -aws s3api put-bucket-website --bucket --website-configuration ' -{ - "ErrorDocument": { - "Key": "/errors/4xx.html" - }, - "IndexDocument": { - "Suffix": "index.html" - } -} -' - - - - - -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: - -[![Badge indiquant qu'un site est hébergé sur Garage en français](/img/garage_fr.png)](https://garagehq.deuxfleurs.fr/) -[![Badge indiquant qu'un site est hébergé sur Garage en anglais](/img/garage_en.png)](https://garagehq.deuxfleurs.fr/) -``` -Badge indiquant que ce site est propulsé par le logiciel Garage -``` 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: + +[![Badge indiquant qu'un site est hébergé sur Garage en français](/img/garage_fr.png)](https://garagehq.deuxfleurs.fr/) +[![Badge indiquant qu'un site est hébergé sur Garage en anglais](/img/garage_en.png)](https://garagehq.deuxfleurs.fr/) + +En HTML: +``` +Badge indiquant que ce site est propulsé par le logiciel Garage +``` +En Markdown: +``` +[![Badge indiquant qu'un site est hébergé sur Garage en français](/img/garage_fr.png)](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: + +[![Badge indiquant qu'un site est hébergé sur Garage en français](/img/garage_fr.png)](https://garagehq.deuxfleurs.fr/) +[![Badge indiquant qu'un site est hébergé sur Garage en anglais](/img/garage_en.png)](https://garagehq.deuxfleurs.fr/) + +En HTML: +``` +Badge indiquant que ce site est propulsé par le logiciel Garage +``` +En Markdown: +``` +[![Badge indiquant qu'un site est hébergé sur Garage en français](/img/garage_fr.png)](https://garagehq.deuxfleurs.fr/) +``` 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..3b82c15 --- /dev/null +++ b/content/prise_en_main/web/publier-le-contenu/rclone.md @@ -0,0 +1,102 @@ ++++ +title = "Rclone Browser" +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. + +# 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`). + +![gedit.png](/img/rclone_gedit.png) + +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 = +secret_access_key = +region = garage +endpoint = garage.deuxfleurs.fr +bucket_acl = private +force_path_style = true +no_check_bucket = true +``` + +Maintenant enregistrez le à un endroit où vous ne le perdrez pas. Dans mon cas, j'ai choisi de le mettre dans Mon Dossier Personnel > Documents > Configuration et je l'ai appelé `rclone.conf`. + +![rclone-conf.png](/img/rclone_conf.png) + +Maintenant lancez "Rclone Browser" en cherchant l'application dans votre menu d'application + +![capture_d’écran_de_2021-11-25_14-43-03.png](/img/rclone_menu.png) + +L'application devrait se lancer : + +![rclone_init.png](/img/rclone_init.png) + +Cliquez sur "File" (Fichiers) en haut à gauche, puis sur "Preferences...". La fenêtre suivante s'ouvre : + +![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. + +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é ! + +![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. + +# Utiliser comme un drive + +Ce n'est pas forcément très pratique de devoir passer par cette interface pour envoyer ou récupérer des fichiers. Ce qui serait génial, c'est que ces dossiers apparaissent sur votre ordinateur comme des dossiers normaux. + +Pour cela, sélectionnez un dossier racine, moi j'ai choisi `quentin.bibliotheque` puis cliquez sur le bouton "Mount". + +![rclone-mount.png](/img/rclone_mount.png) + +Un sélecteur de fichier s'ouvre alors. Je vais dans "Dossier Personnel > Documents", je créer un nouveau dossier que j'appelle "Distant". Je vais dedans et clique sur "Choisir" (ou Ok). + +Maintenant, quand je vais dans un explorateur de fichier, je vois les fichiers sur Garage comme si ils étaient sur mon ordinateur. + +![nautilus-distant.png](/img/rclone_nautilus.png) + +Je peux aussi accéder à ces documents depuis mon logiciel préféré, comme ici "LibreOffice Calc" : + +![capture_d’écran_de_2021-11-25_15-01-42.png](/img/rclone_calc.png) + + + 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`). + +![gedit.png](/img/rclone_gedit.png) + +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 = +secret_access_key = +region = garage +endpoint = garage.deuxfleurs.fr +bucket_acl = private +force_path_style = true +no_check_bucket = true +``` + +Maintenant enregistrez le à un endroit où vous ne le perdrez pas. Dans mon cas, j'ai choisi de le mettre dans Mon Dossier Personnel > Documents > Configuration et je l'ai appelé `rclone.conf`. + +![rclone-conf.png](/img/rclone_conf.png) + +Maintenant lancez "Rclone Browser" en cherchant l'application dans votre menu d'application + +![capture_d’écran_de_2021-11-25_14-43-03.png](/img/rclone_menu.png) + +L'application devrait se lancer : + +![rclone_init.png](/img/rclone_init.png) + +Cliquez sur "File" (Fichiers) en haut à gauche, puis sur "Preferences...". La fenêtre suivante s'ouvre : + +![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. + +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é ! + +![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. + +# Utiliser comme un drive + +Ce n'est pas forcément très pratique de devoir passer par cette interface pour envoyer ou récupérer des fichiers. Ce qui serait génial, c'est que ces dossiers apparaissent sur votre ordinateur comme des dossiers normaux. + +Pour cela, sélectionnez un dossier racine, moi j'ai choisi `quentin.bibliotheque` puis cliquez sur le bouton "Mount". + +![rclone-mount.png](/img/rclone_mount.png) + +Un sélecteur de fichier s'ouvre alors. Je vais dans "Dossier Personnel > Documents", je créer un nouveau dossier que j'appelle "Distant". Je vais dedans et clique sur "Choisir" (ou Ok). + +Maintenant, quand je vais dans un explorateur de fichier, je vois les fichiers sur Garage comme si ils étaient sur mon ordinateur. + +![nautilus-distant.png](/img/rclone_nautilus.png) + +Je peux aussi accéder à ces documents depuis mon logiciel préféré, comme ici "LibreOffice Calc" : + +![capture_d’écran_de_2021-11-25_15-01-42.png](/img/rclone_calc.png) + + + diff --git a/content/prise_en_main/web/publier-le-contenu/winscp.md b/content/prise_en_main/web/publier-le-contenu/winscp.md new file mode 100644 index 0000000..f88e6dd --- /dev/null +++ b/content/prise_en_main/web/publier-le-contenu/winscp.md @@ -0,0 +1,60 @@ ++++ +title = "WinSCP" +description = "Publier avec WinSCP" +weight = 3 ++++ + + +# Installation + +Commencez par télécharger l'outil [WinSCP](https://winscp.net/eng/download.php). + +![winscp_dl.png](/img/winscp_dl.png) + +Installez le logiciel. + +# Configuration + +Lancez le. La fenêtre de connexion suivante devrait apparaitre : + +![](/img/winscp_login.png) + +Vous devez : + 1. Vérifier que c'est bien "Nouveau site" qui est sélectionné + 2. Dans *protocole de fichier*, vous devez choisir *Amazon S3* + 3. Dans *nom d'hôte*, vous devez mettre `garage.deuxfleurs.fr` + 4. Dans *numéro de port*, vous devez mettre (ou plutôt laisser) `443` + 5. Dans *id de clé d'accès*, vous devez mettre l'identifiant de votre clé d'accès, exemple : `GK...` + 6. Dans *clé d'accès secrète*, vous devez mettre votre clé d'accès secrète. + 7. Maintenant, cliquez sur le bouton *Avancé*. (Cliquez bien sur le mot "Avancé" et non sur la flèche à droite). Une fenêtre s'ouvre : + +![](/img/winscp_avance.png) + + 1. Dans le menu de gauche, cliquez sur *S3* + 2. Dans la partie de droite, pour *Région par défaut*, inscrivez au clavier *garage* + 3. Toujours à droite, dans *Style URL*, choisissez *Chemin* + 4. Cliquez sur OK + +Vous voilà de retour sur la fenêtre de connexion : + +![](/img/winscp_sauvegarder.png) + + 1. Cliquez sur *Sauver* (cliquez bien sur le texte et non sur la flèche noire à droite) + +La fenêtre suivante apparait : + +![](/img/winscp_session.png) + + 1. Dans *Enregistrer la sessions sous :*, donnez un nom qui identifie bien votre site web, c'est ce qui vous permettra de l'identifier dans la liste de connexion. + 2. Pour la case *Enregistrer le mot de passe*, nous vous conseillons de la cocher sauf si vous êtes sur un ordinateur public (bibliothèque, cybercafé, etc.) ou au travail. + 3. Pour la case *Créer un raccourci sur le bureau*, nous vous conseillons de la cocher, vous pourrez alors mettre votre site en ligne en un seul clic (ou presque) depuis votre bureau. + 4. Cliquez sur OK + +Vous pouvez maintenant cliquer sur "Connexion". + +# Envoyer votre site web + +À gauche, naviguez jusqu'au dossier de votre site web. +Faites en un glisser déposer à droite à l'intérieur du dossier qui contient le nom de votre site web. + +![commander.png](/img/winscp_commander.png) diff --git a/content/prise_en_main/web/publier-le-contenu/winscp.md~ b/content/prise_en_main/web/publier-le-contenu/winscp.md~ new file mode 100644 index 0000000..6f63d97 --- /dev/null +++ b/content/prise_en_main/web/publier-le-contenu/winscp.md~ @@ -0,0 +1,62 @@ ++++ +title = "WinSCP" +description = "WinSCP " +weight = 20 +[extra] +weight_custom = 10 ++++ + + +# Installation + +Commencez par télécharger l'outil [WinSCP](https://winscp.net/eng/download.php). + +![winscp_dl.png](/img/winscp_dl.png) + +Installez le logiciel. + +# Configuration + +Lancez le. La fenêtre de connexion suivante devrait apparaitre : + +![](/img/winscp_login.png) + +Vous devez : + 1. Vérifier que c'est bien "Nouveau site" qui est sélectionné + 2. Dans *protocole de fichier*, vous devez choisir *Amazon S3* + 3. Dans *nom d'hôte*, vous devez mettre `garage.deuxfleurs.fr` + 4. Dans *numéro de port*, vous devez mettre (ou plutôt laisser) `443` + 5. Dans *id de clé d'accès*, vous devez mettre l'identifiant de votre clé d'accès, exemple : `GK...` + 6. Dans *clé d'accès secrète*, vous devez mettre votre clé d'accès secrète. + 7. Maintenant, cliquez sur le bouton *Avancé*. (Cliquez bien sur le mot "Avancé" et non sur la flèche à droite). Une fenêtre s'ouvre : + +![](/img/winscp_avance.png) + + 1. Dans le menu de gauche, cliquez sur *S3* + 2. Dans la partie de droite, pour *Région par défaut*, inscrivez au clavier *garage* + 3. Toujours à droite, dans *Style URL*, choisissez *Chemin* + 4. Cliquez sur OK + +Vous voilà de retour sur la fenêtre de connexion : + +![](/img/winscp_sauvegarder.png) + + 1. Cliquez sur *Sauver* (cliquez bien sur le texte et non sur la flèche noire à droite) + +La fenêtre suivante apparait : + +![](/img/winscp_session.png) + + 1. Dans *Enregistrer la sessions sous :*, donnez un nom qui identifie bien votre site web, c'est ce qui vous permettra de l'identifier dans la liste de connexion. + 2. Pour la case *Enregistrer le mot de passe*, nous vous conseillons de la cocher sauf si vous êtes sur un ordinateur public (bibliothèque, cybercafé, etc.) ou au travail. + 3. Pour la case *Créer un raccourci sur le bureau*, nous vous conseillons de la cocher, vous pourrez alors mettre votre site en ligne en un seul clic (ou presque) depuis votre bureau. + 4. Cliquez sur OK + +Vous pouvez maintenant cliquer sur "Connexion". + +# Envoyer votre site web + +À gauche, naviguez jusqu'au dossier de votre site web. +Faites en un glisser déposer à droite à l'intérieur du dossier qui contient le nom de votre site web. + +![commander.png](/img/winscp_commander.png) diff --git a/content/prise_en_main/web/rclone.md b/content/prise_en_main/web/rclone.md deleted file mode 100644 index d7e03d1..0000000 --- a/content/prise_en_main/web/rclone.md +++ /dev/null @@ -1,104 +0,0 @@ -+++ -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`). - -![gedit.png](/img/rclone_gedit.png) - -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 = -secret_access_key = -region = garage -endpoint = garage.deuxfleurs.fr -bucket_acl = private -force_path_style = true -no_check_bucket = true -``` - -Maintenant enregistrez le à un endroit où vous ne le perdrez pas. Dans mon cas, j'ai choisi de le mettre dans Mon Dossier Personnel > Documents > Configuration et je l'ai appelé `rclone.conf`. - -![rclone-conf.png](/img/rclone_conf.png) - -Maintenant lancez "Rclone Browser" en cherchant l'application dans votre menu d'application - -![capture_d’écran_de_2021-11-25_14-43-03.png](/img/rclone_menu.png) - -L'application devrait se lancer : - -![rclone_init.png](/img/rclone_init.png) - -Cliquez sur "File" (Fichiers) en haut à gauche, puis sur "Preferences...". La fenêtre suivante s'ouvre : - -![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. - -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é ! - -![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. - -# Utiliser comme un drive - -Ce n'est pas forcément très pratique de devoir passer par cette interface pour envoyer ou récupérer des fichiers. Ce qui serait génial, c'est que ces dossiers apparaissent sur votre ordinateur comme des dossiers normaux. - -Pour cela, sélectionnez un dossier racine, moi j'ai choisi `quentin.bibliotheque` puis cliquez sur le bouton "Mount". - -![rclone-mount.png](/img/rclone_mount.png) - -Un sélecteur de fichier s'ouvre alors. Je vais dans "Dossier Personnel > Documents", je créer un nouveau dossier que j'appelle "Distant". Je vais dedans et clique sur "Choisir" (ou Ok). - -Maintenant, quand je vais dans un explorateur de fichier, je vois les fichiers sur Garage comme si ils étaient sur mon ordinateur. - -![nautilus-distant.png](/img/rclone_nautilus.png) - -Je peux aussi accéder à ces documents depuis mon logiciel préféré, comme ici "LibreOffice Calc" : - -![capture_d’écran_de_2021-11-25_15-01-42.png](/img/rclone_calc.png) - - - diff --git a/content/prise_en_main/web/winscp.md b/content/prise_en_main/web/winscp.md deleted file mode 100644 index 6f63d97..0000000 --- a/content/prise_en_main/web/winscp.md +++ /dev/null @@ -1,62 +0,0 @@ -+++ -title = "WinSCP" -description = "WinSCP " -weight = 20 -[extra] -weight_custom = 10 -+++ - - -# Installation - -Commencez par télécharger l'outil [WinSCP](https://winscp.net/eng/download.php). - -![winscp_dl.png](/img/winscp_dl.png) - -Installez le logiciel. - -# Configuration - -Lancez le. La fenêtre de connexion suivante devrait apparaitre : - -![](/img/winscp_login.png) - -Vous devez : - 1. Vérifier que c'est bien "Nouveau site" qui est sélectionné - 2. Dans *protocole de fichier*, vous devez choisir *Amazon S3* - 3. Dans *nom d'hôte*, vous devez mettre `garage.deuxfleurs.fr` - 4. Dans *numéro de port*, vous devez mettre (ou plutôt laisser) `443` - 5. Dans *id de clé d'accès*, vous devez mettre l'identifiant de votre clé d'accès, exemple : `GK...` - 6. Dans *clé d'accès secrète*, vous devez mettre votre clé d'accès secrète. - 7. Maintenant, cliquez sur le bouton *Avancé*. (Cliquez bien sur le mot "Avancé" et non sur la flèche à droite). Une fenêtre s'ouvre : - -![](/img/winscp_avance.png) - - 1. Dans le menu de gauche, cliquez sur *S3* - 2. Dans la partie de droite, pour *Région par défaut*, inscrivez au clavier *garage* - 3. Toujours à droite, dans *Style URL*, choisissez *Chemin* - 4. Cliquez sur OK - -Vous voilà de retour sur la fenêtre de connexion : - -![](/img/winscp_sauvegarder.png) - - 1. Cliquez sur *Sauver* (cliquez bien sur le texte et non sur la flèche noire à droite) - -La fenêtre suivante apparait : - -![](/img/winscp_session.png) - - 1. Dans *Enregistrer la sessions sous :*, donnez un nom qui identifie bien votre site web, c'est ce qui vous permettra de l'identifier dans la liste de connexion. - 2. Pour la case *Enregistrer le mot de passe*, nous vous conseillons de la cocher sauf si vous êtes sur un ordinateur public (bibliothèque, cybercafé, etc.) ou au travail. - 3. Pour la case *Créer un raccourci sur le bureau*, nous vous conseillons de la cocher, vous pourrez alors mettre votre site en ligne en un seul clic (ou presque) depuis votre bureau. - 4. Cliquez sur OK - -Vous pouvez maintenant cliquer sur "Connexion". - -# Envoyer votre site web - -À gauche, naviguez jusqu'au dossier de votre site web. -Faites en un glisser déposer à droite à l'intérieur du dossier qui contient le nom de votre site web. - -![commander.png](/img/winscp_commander.png) -- cgit v1.2.3