From c174b3fdcbc371ef449360fe3ea2d15c7baee101 Mon Sep 17 00:00:00 2001 From: Quentin Dufour Date: Tue, 26 Sep 2023 16:14:53 +0200 Subject: ajout de la documentation --- content/prise_en_main/filezilla.md | 23 +++++++++++++++++++++++ content/prise_en_main/publier-le-contenu.md | 7 ++++++- content/prise_en_main/webdav.md | 29 +++++++++++++++++++++++++++++ 3 files changed, 58 insertions(+), 1 deletion(-) create mode 100644 content/prise_en_main/filezilla.md create mode 100644 content/prise_en_main/webdav.md diff --git a/content/prise_en_main/filezilla.md b/content/prise_en_main/filezilla.md new file mode 100644 index 0000000..d394805 --- /dev/null +++ b/content/prise_en_main/filezilla.md @@ -0,0 +1,23 @@ +--- +title: "FileZilla" +description: "Publier avec FileZilla" +date: 2023-09-16 +weight: 1 +extra: + parent: "prise_en_main/publier-le-contenu.md" +--- + +Pour servir votre site sur Garage via SFTP, vous aurez besoin de votre nom d'utilisateur ainsi que du mot de passe utilisé pour se connecter au [guichet Deuxfleurs](https://guichet.deuxfleurs.fr). + +Les dispositions qui suivent peuvent potentiellement fonctionner avec n'importe quel client SFTP. Si vous n'en connaissez pas, nous vous recommandons d'utiliser [FileZilla](https://filezilla-project.org/download.php?type=client). + +Après avoir installé FileZilla Client (à ne pas confondre avec FileZilla Server), vous pouvez paramétrer les accès à Garage comme suit : +* ouvrez le Gestionnaire de sites (via le premier bouton à gauche de la barre d'outils, ou le menu Fichier, ou le raccourci `Ctrl+S`) +* choisissez le protocole "*SFTP - SSH File Transfer Protocol*" +* renseignez l'hôte `bagage.deuxfleurs.fr` et le port *2222* +* choisissez le type d'authentification "*Demander le mot de passe*" +* renseignez le même nom d'utilisateur que celui que vous utilisez sur le guichet Deuxfleurs + +En cliquant sur "Connexion", une pop-up apparaîtra pour vous demander un mot de passe. Renseignez le même mot de passe que celui que vous utilisez sur le guichet Deuxfleurs. Vous pouvez désormais vous connecter à votre site. + +Lorsque vous serez connecté, vous verrez affichés vos différents sites dans la moitié droite de la fenêtre de FileZilla, et les fichiers de votre ordinateur dans la moitié gauche. Vous pourrez ainsi verser ou télécharger les fichiers de votre ordinateur vers vos sites sur Garage et vice-versa. diff --git a/content/prise_en_main/publier-le-contenu.md b/content/prise_en_main/publier-le-contenu.md index b58c2e7..274fcd5 100644 --- a/content/prise_en_main/publier-le-contenu.md +++ b/content/prise_en_main/publier-le-contenu.md @@ -12,9 +12,13 @@ Nous allons désormais verser votre site sur Garage, et ce dernier le servira à 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 `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. +Il existe aussi d'autres méthodes plus proches de celles habituellement utilisées pour verser des pages web en ligne : +* [En SFTP avec FileZilla](@/prise_en_main/filezilla.md). Ce logiciel bien connu fonctionne sur Linux, Windows et macOS. +* [En WebDAV avec votre navigateur de fichiers](@/prise_en_main/webdav.md). Avec cette méthode, vous pourrez manipuler les fichiers de votre site comme s'ils étaient sur votre ordinateur. Pour l'instant, seuls les gestionnaires de fichier Linux sont évoqués ici. + ### 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: @@ -30,3 +34,4 @@ 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/webdav.md b/content/prise_en_main/webdav.md new file mode 100644 index 0000000..0f8e6e8 --- /dev/null +++ b/content/prise_en_main/webdav.md @@ -0,0 +1,29 @@ +--- +title: "WebDAV" +description: "Publier via un gestionnaire de fichiers avec WebDAV" +date: 2023-09-16 +weight: 1 +extra: + parent: "prise_en_main/publier-le-contenu.md" +--- + +Comme avec [le SFTP]((@/prise_en_main/sftp.md)), vous aurez besoin pour utiliser le WebDAV de votre nom d'utilisateur ainsi que du mot de passe utilisé pour se connecter au [guichet Deuxfleurs](https://guichet.deuxfleurs.fr). + +**Attention cependant : si vous venez de créer un site via le guichet Deuxfleurs, celui-ci ne pourra être modifié via WebDAV tant que vous n'avez pas ajouté un fichier dessus via [les autres méthodes décrites dans ce guide](@/prise_en_main/publier-le-contenu.md).** + +### Paramétrer l'accès WebDAV avec le gestionnaire de fichiers GNOME (Nautilus) + +Si vous utilisez Ubuntu ou Fedora, votre gestionnaire de fichiers par défaut est probablement celui de GNOME, également appelé Nautilus. Voici comment accéder à vos sites en WebDAV : +* dans la barre latérale de Nautilus, cliquez sur "Autres emplacements" (tout en bas) +* dans le champ "Connexion à un serveur", saisissez `davs://bagage.deuxfleurs.fr/webdav` et cliquez sur "Se connecter" +* renseignez les mêmes nom d'utilisateur et mot de passe que deux que vous utilisez sur le guichet Deuxfleurs + +Un nouveau dossier "bagage.deuxfleurs.fr" apparaîtra dans la barre latérale de Nautilus : c'est lui qui affiche le contenu de votre espace sur Garage. Vous pouvez interagir avec de la même façon qu'avec les fichiers sur votre ordinateur. + +### Paramétrer l'accès WebDAV avec le gestionnaire de fichiers KDE (Dolphin) + +TODO + +### Paramétrer l'accès WebDAV avec le gestionnaire de fichiers Linux Mint (Nemo) + +TODO -- cgit v1.2.3