ajout de la documentation

This commit is contained in:
Quentin 2023-09-26 16:14:53 +02:00
parent 3d40a7134e
commit c174b3fdcb
Signed by untrusted user: quentin
GPG key ID: E9602264D639FF68
3 changed files with 58 additions and 1 deletions

View file

@ -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.

View file

@ -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 : 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 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. * [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 ! ### Bravo !
Une fois l'un de ces trois guides suivi, vous aurez désormais votre propre site web accessible publiquement en ligne ! 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: 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/) [![Badge indiquant qu'un site est hébergé sur Garage en français](/img/garage_fr.png)](https://garagehq.deuxfleurs.fr/)
``` ```

View file

@ -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