Merge pull request #900 from Gofannon/filezilla

[enh] Add graphical program to exchange files

admindoc.md

@@ -35,6 +35,7 @@
     * [Security](/security)
 * Going further
     * [Noho.st / nohost.me / ynh.fr domain names](/dns_nohost_me)
+    * [Exchange files with your server using a graphical interface](/filezilla)
     * [Adding an external storage](/external_storage)
     * [Migrating emails to YunoHost](/email_migration)
     * [Hide services with Tor](/torhiddenservice)

admindoc_fr.md

@@ -44,6 +44,7 @@
        * [SFR](/isp_sfr_fr)
        * [Orange](/isp_orange_fr)
        * [Free](/isp_free_fr)
+    * [Échanger des fichiers avec son serveur à l'aide d'une interface graphique](/filezilla)
     * [Ajouter un stockage externe](/external_storage_fr)
     * [Migrer ses emails vers YunoHost](/email_migration_fr)
     * [YunoHost avec un service caché Tor](/torhiddenservice_fr)

backup.md

@@ -61,9 +61,11 @@ Downloading and uploading backups
 
 After creating backup archives, it is possible to list and inspect them via the corresponding views in the webadmin, or via `yunohost backup list` and `yunohost backup info <archivename>` from the command line. By default, backups are stored in `/home/yunohost.backup/archives/`.
 
-There is currently no straightfoward way to download or upload a backup archive.
+Currently, the most accessible way to download archives is to use the program FileZilla as explained in [this page](/filezilla).
 
-One solution consists in using `scp` (a program based on [`ssh`](/ssh)) to copy files between two machines via the command line. Hence, from a machine running Linux, you should be able to run the following to download a specific backup: 
+Alternatively, a solution can be to install Nextcloud or a similar app and configure it to be able to access files in `/home/yunohost.backup/archives/` from a web browser.
+
+Finally, you can use `scp` (a program based on [`ssh`](/ssh)) to copy files between two machines via the command line. Hence, from a machine running Linux, you should be able to run the following to download a specific backup: 
 
 ```bash
 scp admin@your.domain.tld:/home/yunohost.backup/archives/<archivename>.tar.gz ./
@@ -75,8 +77,6 @@ Similarly, you can upload a backup from a machine to your server with:
 scp /path/to/your/<archivename>.tar.gz admin@your.domain.tld:/home/yunohost.backup/archives/
 ```
 
-Alternatively, a solution can be to install Nextcloud or a similar app and configure it to be able to access files in `/home/yunohost.backup/archives/` from a web browser.
-
 Restoring backups
 -----------------
 

backup_fr.md

@@ -61,9 +61,11 @@ Télécharger et téléverser des sauvegardes
 
 Après avoir créé des sauvegardes, il est possible de les lister et de les inspecter grâce aux vues correspondantes dans la webadmin, ou via `yunohost backup list` et `yunohost backup info <nom_d'archive>` depuis la ligne de commande. Par défaut, les sauvegardes sont stockées dans `/home/yunohost.backup/archives/`.
 
-Il n'existe actuellement pas de solution "rapide et facile" pour télécharger ou téléverser une archive depuis une autre machine.
+À l'heure actuelle, la solution la plus accessible pour récupérer les sauvegardes est d'utiliser le programme FileZilla comme expliqué dans [cette page](/filezilla_fr).
 
-Une solution consiste à utiliser `scp` (un programme basé sur [`ssh`](/ssh)) pour copier des fichiers entre deux machines grâce à la ligne de commande. Ainsi, depuis une machine sous Linux, vous pouvez utiliser la commande suivante pour télécharger une archive :
+Une autre solution alternative consiste à installer une application comme Nextcloud et à la configurer pour être en mesure d'accéder aux fichiers dans `/home/yunohost.backup/archives/` depuis un navigateur web.
+
+Enfin, il est possible d'utiliser `scp` (un programme basé sur [`ssh`](/ssh)) pour copier des fichiers entre deux machines grâce à la ligne de commande. Ainsi, depuis une machine sous Linux, vous pouvez utiliser la commande suivante pour télécharger une archive :
 
 ```bash
 scp admin@your.domain.tld:/home/yunohost.backup/archives/<nom_d'archive>.tar.gz ./
@@ -75,8 +77,6 @@ De façon similaire, vous pouvez téléverser une sauvegarde depuis une machine
 scp /path/to/your/<nom_d'archive>.tar.gz admin@your.domain.tld:/home/yunohost.backup/archives/
 ```
 
-Une solution alternative consiste à installer une application comme Nextcloud et à la configurer pour être en mesure d'accéder aux fichiers dans `/home/yunohost.backup/archives/` depuis un navigateur web.
-
 Restaurer des sauvegardes
 -------------------------
 

filezilla.md

@@ -0,0 +1,85 @@
+# Exchange files with your server using a graphical interface
+
+This page explains how to exchange files (backup archives, music, pictures,
+movies, ...) with your server using a graphical interface. This is an alternative
+to using `scp` which can be deemed technical and cryptic, or using an app like
+Nextcloud.
+
+[Filezila](https://filezilla-project.org/) can be used for this. It is a free
+software and is available for Windows, Linux and macOS.
+
+## Download and install FileZilla
+
+Get the client from the [download page](https://filezilla-project.org/download.php?type=client). It should automatically detect the version needed for your computer. Otherwise, follow the instructions to [install the client](https://wiki.filezilla-project.org/Client_Installation)
+
+Install the program and run *Filezilla*.
+
+## Configuration
+
+1. Click the *Site Manager* icon in the upper left to begin.
+
+   ![Main screen of Filezilla](images/filezilla_1.png)
+
+2. Click **New Site** and give a name the server you will be using : *Familly* here. Fill the settings as on the screenshot (replace the server adress with your own), and click on **Connect**.
+
+   ![Site manager screen](images/filezilla_2.png)
+
+3. You will get a warning as you connect for the first time to the server. *You can ignore it safely the first time you get it.*
+
+   ![warning about the unknown fingerprint of the server](images/filezilla_3.png)
+
+4. Filezilla is now asking the `admin` password for connecting to your server.
+
+   ![credential screen asking for the password](images/filezilla_4.png)
+
+5. Once bookmarked, your server will be backup up and you will get this screen.
+
+   ![View of the "site manager" with the newly server added](images/filezilla_5.png)
+
+<div class="alert alert-success">
+  <span class="glyphicon glyphicon-chevron-right"></span> You can now use your new bookmark to connect to the server
+</div>
+
+## Usage
+
+1. Connect to the Site created previously. *Your passwork might be asked again*
+
+   The left panel corresponds to your computer. The right panel corresponds to your remote Yunohost server. You can browse folders and drag-and-drop files between the two panels.
+
+   ![view while connected to a remote server](images/filezilla_6.png)
+
+2. In the right panel, you can browse to `/home/yunohost.backup/archives/` to find [backup archives](/backup).
+
+   ![path where backups are located on Yunohost](images/filezilla_7.png)
+
+<div class="alert alert-warning">
+  <span class="glyphicon glyphicon-cloud-download"></span> Be sure to download both the `.tar.gz` and `.json` files.
+</div>
+
+![Copy backups from Yunohost to local computer](images/filezilla_8.png)
+
+----
+
+Sources
+
+* [Official documentation](https://wiki.filezilla-project.org/FileZilla_Client_Tutorial_(en))
+* [General tutorial about using FileZilla](https://www.rc.fas.harvard.edu/resources/documentation/sftp-file-transfer/)
+
+## Alternatives to Filezilla
+
+### Linux
+
+From any recent Linux, you should be able to use the `file manager` to reach your server.
+
+Nautilus from Gnome3 has features similar to FileZilla, out of the box.
+
+* <https://help.gnome.org/users/gnome-help/stable/nautilus-connect.html.en>
+* <https://www.techrepublic.com/article/how-to-use-linux-file-manager-to-connect-to-an-sftp-server/>
+
+### Windows
+
+* [WinSCP](https://winscp.net/) is also a nice candidate for Windows
+
+### MacOS
+
+Feel free to complete this part

filezilla_fr.md

@@ -0,0 +1,87 @@
+# Échanger des fichiers avec son serveur à l'aide d'une interface graphique
+
+Cette page explique comment échanger des fichiers (sauvegardes, musiques,
+photos, films, ...) avec son serveur à l'aide d'un outil graphique. C'est donc
+une méthode alternative au fait d'utiliser la commande `scp` qui peut être jugée
+technique et cryptique, ou de devoir installer Nextcloud.
+
+[FileZilla](https://filezilla-project.org/) permet d'accomplir cela. Il s'agit
+d'un logiciel libre disponible pour Windows, Linux et MacOS.
+
+## Télécharger et installer FileZilla
+
+Vous pouvez télécharger FileZilla depuis [cette page](https://filezilla-project.org/download.php?type=client).
+Le site devrait détecter automatiquement la version nécessaire pour votre ordinateur.
+Sinon, suivez les instructions pour [installer le client](https://wiki.filezilla-project.org/Client_Installation)
+
+Installez le programme et lancez *Filezilla*.
+
+## Configuration
+
+1. Cliquez sur l'icône *Gestionnaire de Sites* en haut à gauche de sorte à crééer une configuration utilisable ultérieurement.
+
+   ![écran principal de Filezilla](images/filezilla_1.png)
+
+2. Cliquez sur **Nouveau site** et donnez un nom au serveur que vous allez utiliser. Par exemple "Famille". Remplissez les paramètres comme sur la capture d'écran (en remplaçant l'adresse du serveur par la votre). Une fois terminé, cliquez sur **Connexion**.
+
+   ![écran du gestionnaire de site](images/filezilla_2.png)
+
+3. Vous recevrez un avertissement. *Vous pouvez l'ignorer si il s'agit de la première connexion*.
+
+   ![avertissement au sujet de l'empreinte inconnue du serveur](images/filezilla_3.png)
+
+4. Filezilla vous demande maintenant le mot de passe `admin` pour vous connecter à votre serveur
+
+   ![écran d'identification demandant le mot de passe](images/filezilla_4.png)
+
+5. Une fois cette configuration créée, elle sera réutilisable les fois suivanteS.
+
+   ![la vue du "gestionnaire de site" avec le nouveau serveur ajouté](images/filezilla_5.png)
+
+<div class="alert alert-success">
+  <span class="glyphicon glyphicon-chevron-right"></span> Vous pouvez désormais utiliser cette configuration pour vous connecter.
+</div>
+
+## Utilisation
+
+1. Connectez-vous au Site créé précédemment. *Il se peut que le mot de passe soit redemandé.*
+
+   La partie gauche correspond à votre ordinateur. La partie droite correspond au serveur YunoHost distant. Vous pouvez naviguer dans les dossiers et faire des glisser-déposer entre les deux panneaux.
+
+   ![la vue pendant la connexion à un serveur distant](images/filezilla_6.png)
+
+2. Dans le panneau de droite, vous pouvez aller dans `/home/yunohost.backup/archives/` pour trouver les archives de [sauvegardes](/backup_fr).
+
+   ![le chemin où les sauvegardes sont situées sur Yunohost](images/filezilla_7.png)
+
+<div class="alert alert-warning">
+  <span class="glyphicon glyphicon-cloud-download"></span> Assurez-vous de télécharger à la fois le fichier `.tar.gz` et le fichier `.json`
+</div>
+
+![Copier les sauvegardes de Yunohost sur l'ordinateur local](images/filezilla_8.png)
+
+----
+
+Sources
+
+* [Documentation officielle](https://wiki.filezilla-project.org/FileZilla_Client_Tutorial_(fr))
+* [Tutoriel général à Filezilla](https://www.rc.fas.harvard.edu/resources/documentation/sftp-file-transfer/)
+
+## Alternatives à Filezilla
+
+### Sous Linux
+
+Depuis n'importe quel Linux récent, vous devriez pouvoir utiliser le gestionnaire de fichiers pour accéder à votre serveur.
+
+Nautilus de Gnome3 intègre de base des fonctionnalités similaires à FileZilla :
+
+* <https://help.gnome.org/users/gnome-help/stable/nautilus-connect.html.en>
+* <https://www.techrepublic.com/article/how-to-use-linux-file-manager-to-connect-to-an-sftp-server/>
+
+### Sous Windows
+
+* [WinSCP](https://winscp.net/) est aussi un bon candidat pour Windows
+
+### Sous MacOS
+
+N'hésitez pas à compléter cette partie