Merge branch 'French' into 'master'

French

Translations of pages in French

See merge request !33
This commit is contained in:
muppeth 2017-12-24 13:22:25 +01:00
commit fbf55e1508
6 changed files with 649 additions and 0 deletions

111
pages/07.Polls/docs.fr.md Normal file
View file

@ -0,0 +1,111 @@
---
title: Sondages
page-toc:
active: true
published: true
taxonomy:
category:
- docs
---
Disroot est un service en ligne de planification de rendez-vous et de prise de décision.
Aucune inscription n'est requise. Vous pouvez l'utiliser même si vous n'avez pas de compte Disroot.
Ce service est rendu possible grâce à [Framadate](https://framadate.org/).
Dans ce tutoriel, nous allons vous montrer comment travailler avec les sondages Disroot.
----------
# Comment créer un sondage
Créer un sondage est très facile, il suffit d'aller à [poll.disroot.org](https://poll.disroot.org/). Vous pouvez choisir la langue de votre sondage dans le coin supérieur droit, et choisir si vous voulez un sondage standard ou un sondage pour planifier un événement ou un rendez-vous.
![](en/polls1.png)
Les principales différences entre "Programmer un événement" et "Faire un sondage standard" sont:
* **Programmer un événement**, comme son nom l'indique, est mieux adapté pour planifier des réunions, des actions, car il permet de définir les propositions avec plusieurs dates et heures.
* **Sondage standard** est mieux adapté aux questionnaires.
Si vous voulez faire un sondage sur un événement qui s'étend sur plusieurs jours (sans aucune option sur l'heure de début), Sondage standard est également mieux adapté.*
Une fois que vous choisissez le type de sondage que vous préférez, la première étape dans la réalisation d'un sondage est commune aux deux.
Dans la première page vous devez remplir:
* Votre nom (qui sera affiché publiquement en tant que créateur du sondage, choisissez le nom de votre choix)
* Titre du sondage
* Description
Et en appuyant sur le bouton "Paramètres optionnels" ![](en/polls07.png?resize=40,18)
Vous pouvez choisir les options suivantes:
* Lien du sondage (URL personnalisée, par exemple: polls.disroot.org/big-decision)
* Mot de passe (pour restreindre l'accès au sondage)
* Tous les électeurs peuvent modifier n'importe quel vote
* Les électeurs peuvent modifier eux-mêmes leur vote
* Les votes ne peuvent pas être modifiés
* Seul le créateur peut voir les résultats du sondage
Ensuite, passez à l'étape 2 en appuyant sur le bouton vert en bas de la page.
Traduit avec www.DeepL.com/Translator
![](en/polls2.gif)
A l'étape 2, vous devrez définir les choix dans votre sondage "Sondage standard" ou "Programmer un événement".
## Définir les choix dans Sondage Standard
Vous pouvez choisir le nombre de choix en utilisant les boutons + et -. ![](en/polls2.png?resize=40,18), et remplir le texte que vous voulez. Une fois que vous avez terminé, appuyez sur le bouton suivant, sélectionnez la date d'expiration de votre sondage et appuyez sur "Créer un sondage".
![](en/polls3.gif)
![](en/polls4.gif)
Vous pouvez également ajouter des photos et des liens aux options que vous créez, mais dans le cas de photos, elles doivent être téléversés ailleurs et vous avez besoin d'un lien vers leur URL:
![](en/polls5.gif)
## Régler les choix dans "Programmer un événement".
Vous pouvez choisir le nombre de choix en utilisant les boutons + et -. ![](en/polls2.png?resize=40,18) Sélectionnez les dates et les heures de chaque choix. Une fois que vous avez terminé, appuyez sur le bouton suivant, sélectionnez la date d'expiration de votre sondage et cliquez sur "Créer un sondage".
![](en/polls6.gif)
----------
# Partagez votre sondage
Une fois que votre sondage est créé, vous verrez dans la partie gauche de l'écran le lien public vers le sondage, il vous suffit de le copier et de l'envoyer aux personnes que vous souhaitez participer au sondage.
![](en/polls7.gif)
----------
# Administrer votre sondage
Pour administrer votre sondage après sa création, vous avez besoin du lien "Lien admin du sondage", que vous pouvez voir et copier dans la partie centrale de l'écran. ** (ne le perdez pas ou sinon vous ne pourrez pas entrer dans le panneau d'administration)**
![](en/polls3.png)
Avec ce lien d'administration, vous pouvez revenir à cette page quand vous le souhaitez et modifier les options du sondage.
# Vérifier les résultats du sondage
Il vous suffit d'appuyer sur la touche "Afficher le graphique des résultats" ou de l'exporter dans un fichier. csv.
![](en/polls8.gif)
----------
# Participer au sondage
* Inscrivez votre nom (ou tout autre nom que vous voulez)
* Sélectionnez dans chaque choix l'une des trois options; oui ![](en/polls4.png?resize=32,22), le cas échéant ![](en/polls5.png?resize=31,20), et non ![](en/polls6.png?resize=32,21)
* Et appuyez sur enregistrer à la fin
## Utiliser la section commentaire
Les utilisateurs du sondage peuvent utiliser la section "commentaire" en bas de la page du sondage pour s'envoyer des messages.
![](en/polls9.gif)
Les utilisateurs peuvent voir les résultats du sondage (si cette option a été activée par le créateur du sondage) sous la liste des personnes ayant voté, ou en appuyant sur Afficher le graphique des résultats.

View file

@ -0,0 +1,150 @@
---
title: Discourse - Usage de base
page-toc:
active: true
published: true
visible: true
taxonomy:
category:
- docs
---
Le forum Discourse offre une interface utilisateur simple et intuitive. Même si vous utilisez Discourse principalement comme liste de diffusion, il est recommandé de voir l'interface web pour une expérience utilisateur supérieure. Voici quelques conseils pour commencer:
----------
# Connectez-vous d'abord
Vous pouvez vous connecter au forum avec votre compte Discourse ou votre compte Disroot, si vous en avez un.
Aller à https://forum.disroot.org/ et cliquez ![](en/forum_basics1.png?resize=64,25) dans le coin supérieur droit.
**Si vous avez un compte Disroot, assurez-vous de sélectionner Connexion avec un compte Disroot avant d'entrer vos identifiants.**
Si vous n'avez pas encore de compte, vous pouvez enregistrer un compte Disroot via https://user.disroot.org, ce qui vous donnera un accès supplémentaire au stockage cloud, à l'email, au xmpp et au tableau de projet. Vous pouvez également décider de créer un compte forum seulement - vous trouverez le bouton S'inscrire en haut à droite de la page du forum.
# Le menu
Les boutons d'icônes en haut à droite incluent la recherche et vos paramètres personnels:
![](en/forum_basics2.png)
Cliquez sur votre icône d'utilisateur (la première lettre de votre nom jusqu' à ce que vous changiez d'avatar) pour voir vos messages et notifications et pour entrer dans votre paramétrage personnel et voir votre page d'utilisateur.
Les petits nombres en haut de votre avatar indiquent combien de notifications (à droite) et de messages (à gauche) vous avez. Lorsque vous cliquez sur votre avatar, vous verrez tous les avis et messages non lus listés ci-dessous. Vous pouvez également accéder à tous vos messages via l'icône ![](en/forum_basics3.png?resize=30,25).
Cliquez sur votre avatar et ensuite sur le bouton ![](en/forum_basics4.png?resize=23,24) pour saisir vos paramètres personnels. Là, vous pouvez changer votre avatar, ajuster le niveau des notifications, vos catégories vues et bien plus encore.
# Navigation
Lorsque vous vous connectez pour la première fois au forum (ou cliquez sur l'icône ![](en/forum_basics5.png?resize=100,20) pour revenir à la page d'accueil à tout moment), vous trouverez une liste des catégories que vous suivez. Les catégories sont comme des sous-forums. Si vous êtes membre d'un forum privé, les catégories de ce groupe seront listées en premier et toutes les catégories publiques seront listées ci-dessous. Plus d'informations sur la façon de suivre et de cacher certaines catégories seront bientôt publiées dans un autre tutoriel.
~[](en/forum_basics6.png)
La barre en haut vous permet de naviguer rapidement entre les derniers messages, nouveaux, non lus et la plupart des messages actifs. Vous pouvez également filtrer les catégories que vous souhaitez voir sous le bouton ![](en/forum_basics7.png?resize=133,30).
A l'extrême droite, vous trouvez un bouton d'onglet pour lancer un nouveau fil de discussion (thème).
Les derniers sujets sont également listés dans votre page d'accueil, à droite des catégories. N'importe quel titre de sujet que vous sélectionnez pour l'afficher vous amènera au prochain message non lu.
# Continuer à faire défiler
Une fois que vous êtes dans le fil du sujet, vous pouvez faire défiler vers le bas pour lire. Il n' y a pas de boutons ni de numéros de page - pour en savoir plus, continuez à faire défiler les pages!
Au fur et à mesure que de nouveaux messages entreront, ils apparaîtront automatiquement.
# Répondre aux messages
Pour répondre à l'ensemble du sujet, utilisez le bouton ![](en/forum_basics8.png?resize=80,29) en bas de la page.
Pour répondre à un message spécifique dans le fil, utilisez le bouton ![](en/forum_basics9.png?resize=82,30) sur ce poste.
Pour insérer une citation, sélectionnez le texte que vous souhaitez citer, puis appuyez sur n'importe quel bouton Répondre. Répétez pour plusieurs citations!
Pour aviser quelqu'un de votre réponse, mentionnez son nom. Tapez @ pour commencer à sélectionner un nom d'utilisateur.
Vous pouvez également aimer, partager, signaler ou ajouter un message à vos favoris.
![](en/forum_basics1.gif)
# Créer un nouveau sujet
Vous pouvez créer un nouveau sujet dans une catégorie (Howtos, support, changelog, etc.) en naviguant dans la catégorie et en appuyant sur le bouton nouveau sujet ![](en/forum_basics10.png?resize=121,26), ou en appuyant simplement sur le bouton et dans le panneau de composition du sujet/message, sélectionnez la catégorie dans laquelle il se trouve. Les sujets doivent avoir un minimum de 8 lettres dans le sujet et 10 lettres dans le sujet, sinon le message ne sera pas envoyé.
![](en/forum_basics2.gif)
# L'interface
L'interface est relativement simple.
![](en/forum_basics11.png)
Discourse supporte Markdown et HTML pour composer des messages, sur le côté gauche du panneau vous écrivez votre sujet, et sur le côté droit vous pouvez prévisualiser la façon dont le sujet sera présenté.
![](en/forum_basics3.gif)
Mais vous n'avez pas besoin d'apprendre le Markdown ou le HTML pour écrire un sujet, vous pouvez simplement utiliser les options de formatage présentées dans la barre supérieure, citation de bloc **Gras**, **Mise en valeur**, **Liste à bulles**, **Liste numérotée**, **Titre**, **Règle horizontale**, **Emojis**. Les commandes comme CTRL+b ou CTRL+I fonctionnent également.
![](en/forum_basics4.gif)
## Insertion d'images et de vidéos
Vous pouvez insérer des images dans votre sujet en les faisant glisser jusqu' à la partie du message où vous voulez qu'elles soient.
![](en/forum_basics5.gif)
Pour insérer une vidéo, c'est le même processus.
## Transfert de fichiers vers votre sujet
Vous pouvez télécharger des fichiers en appuyant sur le bouton de téléchargement puis en naviguant jusqu' à ce que vous atteigniez et sélectionniez le fichier que vous voulez.
![](en/forum_basics6.gif)
## Déplacement de fichiers, photos et vidéos d'un endroit à un autre dans le message
Les fichiers, images et vidéos seront présentés sur le côté gauche de l'écran (où se trouve tout le code) comme ceci:
**Fichiers**
> < a class="attachment" href="/uploads/default/original/1X/ffd8f38b235dbf199a919f0187ae63a183d22ada.odt">hello world.odt</a> (8.0 KB)
**Photos**
> < img src="/uploads/default/original/1X/019a9706a4676128e452b81f450851353f36175c.png" width="690" height="347">
**Vidéos**
>https ://forum.disroot.org/uploads/default/original/1X/59b17ec97a8daabcb96a787b4900f3d3221083da.mp4
Pour les déplacer, coupez simplement la ligne et collez-la où vous voulez. Dans le cas des images, vous pouvez également ajuster leur taille en changeant les valeurs de "hauteur" et "largeur" dans la ligne.
## Ajouter des étiquettes à votre sujet
L'ajout d'une étiquette facilite la recherche de sujets ou de fils de discussion sur un certain sujet. Les ajouter est un super facile.
![](en/forum_basics7.gif)
Une fois que vous avez fini de composer votre sujet, cliquez simplement sur "Créer un sujet". ![](en/forum_basics14.png)
# Comment couper le son ou regarder des catégories
Dans Discourse, il vous est possible de régler le flux des messages que vous recevez via le forum ou par email. Vous pouvez mettre en sourdine des catégories ou simplement une sous-catégorie qui ne vous intéresse pas ou définir des catégories à regarder, ce qui vous garantira de toujours recevoir des notifications et des courriels de chaque message dans une catégorie ou sous-catégorie qui vous intéresse.
Si vous mettez simplement une catégorie en sourdine, vous désactiverez toutes les sous-catégories, à moins que vous ne choisissiez une sous-catégorie spécifique à regarder. Si vous coupez le son d'une catégorie ou d'une sous-catégorie, vous pourrez toujours y accéder dans le tableau d'affichage, si vous voulez le consulter de temps en temps. Vous ne recevez tout simplement pas d' e-mails ou de notifications à ce sujet.
Les catégories et sous-catégories actuelles du Forum Disroot sont:
* disroot
* disroot-Changelog
* support
* feature
* main
* FAQ
* Open Talks
* TOFU
* Engineering Yuvasamithi
La meilleure façon de regarder/modifier les catégories est dans vos préférences, à partir de là, vous pouvez définir toutes vos préférences d'un seul endroit.
![](en/forum_basics12.png)
Il vous suffit de faire défiler jusqu' à **Catégories**, vous verrez les champs **champs** pour **Sourdine** et **Regarder**, écrivez les catégories que vous voulez dans chacun et à la fin **enregistrez vos paramètres** pour qu'ils prennent effet.
![](en/forum_basics8.gif)
L'autre méthode est de naviguer dans chaque catégorie ou sous-catégorie une par une et de le faire à partir de là, en appuyant sur le bouton qui se trouve à droite de "nouveau sujet". ![](en/forum_basics13.png?resize=50,25)
![](en/forum_basics9.gif)
----------
Vous trouverez d'autres conseils à l'adresse suivante [Message de bienvenu de Discourse](https://forum.disroot.org/t/welcome-to-discourse)

View file

@ -0,0 +1,106 @@
---
title: Utiliser le forum comme liste de diffusion
page-toc:
active: true
published: true
visible: true
taxonomy:
category:
- docs
---
Dans ce tutoriel, nous montrerons comment Discourse peut être utilisé comme liste de diffusion pour les Collectifs/Associations/projets.
Disroot, accueille principalement des groupes de discussion privés. Si vous êtes intéressé, écrivez-nous.
**Remarque:** Pour pouvoir être membre d'un groupe (public ou privé), vous n'avez pas besoin d'avoir un compte Disroot. Vous pouvez créer des comptes forum seulement.
----------
# Comment fonctionne la liste de diffusion dans Discourse
Discourse, le logiciel utilisé par Disroot, est un logiciel de Forum avec des fonctionnalités de liste de diffusion. Il a ce que nous avons appelé pour ce tutoriel des **Groupes**. Et ces Groupes peuvent avoir ou non des **Catégories** (pensez à eux comme sujets ou sujets principaux).
A titre d'exemple, le Groupe Disroot dispose de plusieurs Catégories dédiées à différents sujets pour organiser des discussions et échanger des messages entre utilisateurs:
![](en/forum_ml1.png)
Ces Groupes et chaque Catégorie qu'ils contiennent peuvent se voir attribuer un alias email qui fonctionne comme adresse pour une liste de diffusion, que vous pouvez utiliser pour créer un sujet via votre email (webmail ou client) dans ce Groupe/ ou cette Catégorie.
![](en/forum_ml2.png)
Les membres de ce groupe reçoivent une notification à ce sujet dans leur messagerie électronique.
![](en/forum_ml3.png)
![](en/forum_ml4.png)
Et sont en mesure de répondre à ce sujet via le forum ou par e-mail, selon leur préférence.
![](en/forum_ml5.png)
Ceci crée un système qui peut être utilisé à la fois par les fans des listes de diffusion et les fans du Forum.
Vous pouvez avoir un groupe avec une seule catégorie et un seul alias de courriel qui lui est attribué. Ou si c'est un grand collectif, avec des groupes de travail, vous pouvez avoir un groupe avec plusieurs catégories chacune avec un alias d'email différent et travailler comme une liste de diffusion propre, quelque chose comme ceci:
> * **Groupe** (Collective/Project/Association)
> * **Principal/General/Assemblée**
>email alias: **assembly_group@disroot.org**
> * **Categorie1**
>email alias: **categorie1_group@disroot.org**
> * **Categorie2**
>email alias: **categorie2_group@disroot.org**
> * **Categorie3**
>email alias: **categorie3_group@disroot.org**
<br>
Le système décrit ci-dessus présente deux avantages principaux:
1. Si vous faites partie d'un collectif/association/projet avec des groupes de travail ou beaucoup de sujets, vous pouvez diviser la discussion des groupes de travail ou des sujets par les différentes catégories au lieu de les regrouper dans une seule liste de diffusion.
2. Etant donné qu'il est possible pour les utilisateurs du Forum (en général) - et dans ce cas précis, les membres du Groupe - de sélectionner les catégories dont ils souhaitent être notifiés et recevoir des e-mails, les membres d'un Groupe peuvent filtrer les Catégories du Groupe qui ne les intéressent pas, au lieu de recevoir un flot de messages dans leur boîte aux lettres.
Ces paramètres peuvent être modifiés à tout moment, et les membres d'un groupe ou d'une liste de diffusion peuvent toujours accéder au contenu complet ou aux messages de toutes les catégories de l'interface Web du forum, même ceux qu'ils ont choisi de ne pas recevoir dans leur courriel.
Pour en savoir plus sur comment suivre ou mettre en sourdine des catégories [ici](https://howto.disroot.org/en/forum/basic-usage) si vous voulez.
Le nom du Groupe et des Catégories, ainsi que les alias de courriel correspondants, peuvent être ce que vous voulez (à moins qu'ils ne soient déjà pris).
----------
# Groupes privés / Listes de diffusion
Les groupes privés/listes de diffusion fonctionnent comme décrit ci-dessus, mais comme leur nom l'indique, ils sont privés et ne peuvent être vus et accessibles que par les membres du groupe. Vous ne pouvez envoyer un courriel à ce groupe que si vous êtes membre.
Les groupes privés peuvent être vus et accessibles seulement par les membres du groupe dans l'interface web du Forum, et ont un symbole de cadenas ![](en/forum_ml6.png?resize=20,21). Lorsque vous vous connectez au Forum, les catégories des groupes privés dont vous êtes membre apparaissent en haut de la page.
Les personnes qui ne sont pas membres du Groupe ne peuvent même pas voir que le Groupe privé existe.
Maintenant vous me voyer:
![](en/forum_ml7.png)
Plus maintenant:
![](en/forum_ml8.png)
## Ajouter des membres au groupe privé
Il y a deux façons d'ajouter des membres à un groupe privé:
1. Le ou les propriétaires du Groupe peuvent ajouter des utilisateurs individuellement. Mais ceci a deux inconvénients, les utilisateurs sont ajoutés un par un, ensuite vous devez faire les réglages de chaque utilisateur manuellement (i. e.: mettre en sourdine d'autres groupes publics dans le Forum Disroot pour que les membres ne reçoivent pas les mails de Disroot qu'ils ne veulent pas).
2. Les administrateurs de Disroot peuvent envoyer des invitations en masse à tous les membres en un seul instant et préconfigurer leurs comptes afin qu'ils ne reçoivent pas d' e-mails des autres groupes publics de Disroot (par exemple: Tutoriels, Support, etc.).
----------
# Groupes publics/liste de diffusion
Les groupes publics travaillent comme décrit ci-dessus. La principale différence par rapport aux Groupes privés est ceci:
Ils sont publics, et n'importe quel utilisateur du Forum peut voir ses discussions, et y poster un message via l'interface Web du Forum (ou par email si une adresse email est attribuée). Ils peuvent également être vus par les gens sur Internet, qui ne sont pas des utilisateurs du Forum et peuvent apparaître dans les résultats des moteurs de recherche comme Google.
----------
# Le cas des Groupes publics de Disroot
Les Catégories publiques du Forum Disroot (i. e. FAQ, Features, Changelog, Main, Howto / Toturials, Open Talks, etc.) n'ont pas d'alias de courriel qui leur sont assignés, vous ne pouvez donc pas créer de sujet dans ces Catégories par courriel.
Vous ne pouvez y répondre par e-mail que lorsque vous recevez un message dans votre boîte aux lettres.
----------

11
pages/08.Forum/docs.fr.md Normal file
View file

@ -0,0 +1,11 @@
---
title: Discourse - Forum
published: true
taxonomy:
category:
- docs
page-toc:
active: false
---
<br>

167
pages/09.Lufi/docs.fr.md Normal file
View file

@ -0,0 +1,167 @@
---
title: Utiliser Lufi
page-toc:
active: true
published: true
visible: true
taxonomy:
category:
- docs
---
Disroot fournit Lufi, un logiciel open-source en ligne pour télécharger et partager des fichiers de manière sécurisée et privée avec d'autres personnes, comme alternative à des services tels que le transfert par wetransfer.
Lufi travaille dans une logique de connaissance zéro.
Ce qui signifie que les fichiers sont chiffrés avant qu'ils ne quittent votre ordinateur, de sorte que votre fournisseur d'accès Internet et "l'administrateur de Disroot" ne peuvent pas voir le contenu du fichier. L'administrateur ne peut voir que le nom du fichier, sa taille et son type de mimetype (quel type de fichier c'est: vidéo, texte, etc.)".
**Vous "n'avez pas besoin de vous enregistrer pour téléverser des fichiers."**
Entre autres choses, vous pouvez l'utiliser pour:
- Stockez (temporairement) des fichiers en ligne, les téléchargez les partagez avec d'autres personnes.
- Envoyer des fichiers qui s'effaceront du serveur après le premier téléchargement
Dans ce tutoriel, nous allons vous montrer comment l'utiliser. Vous pouvez accéder à Uploads/Lufi sur [upload.disroot.org](https://upload.disroot.org)
Remarques:
Lufi n'est pas un service cloud (les fichiers ne sont stockés en ligne que pendant un certain temps, après quoi ils sont supprimés). Pour les services cloud, vous avez votre [cloud](https//:cloud.disroot.org) fourni par disroot.
C'est différent de PrivateBin. Un Bin peut seulement partager du texte, tandis que Lufi peut être utilisé pour partager et télécharger n'importe quel type de fichier.
----------
# A quel point Lufi est sûr et comment ça marche
Lorsque vous utilisez Lufi pour téléverser des fichiers, "Tous les fichiers sont chifrés par votre navigateur! Cela signifie que vos fichiers ne quittent jamais votre ordinateur sans chiffrement. L'administrateur de l'instance Lufi que vous utilisez ne pourra pas voir ce qu'il y a dans votre fichier, ni votre administrateur réseau, ni votre FAI".
Lorsque quelqu'un télécharge votre fichier, il est décrypté localement dans le navigateur de cette personne après le téléchargement. Autrement dit, l'administrateur réseau ou le FAI ne pourra pas voir ce qu'il y a dans le fichier téléchargé.
Pour en savoir plus [ici](https://git.framasoft.org/luc/lufi).
L'ensemble du processus de chiffrement / déchiffrement est effectué automatiquement par les navigateurs, donc pas besoin de chiffrer manuellement les fichiers avant, ou de déchiffrer manuellement au téléchargement.
La clé de chiffrement (la chose qui permet à quiconque télécharge le fichier de le déchiffrer) fait partie du lien qui vous est présenté par votre navigateur après que vous ayez téléchargé un fichier.
C'est une ancre (Cf. Identificateur de Fragment). Cela signifie que cette partie (la clé de chiffrement) est uniquement traitée côté client (dans votre ordinateur) et n'atteint pas le serveur de votre fournisseur Lufi, ils ne peuvent donc pas déchiffrer le fichier.
**Seules les personnes qui ont le lien complet pourront télécharger et déchiffrer le fichier.**
Par exemple, il s'agit d'un lien vers un fichier dans upload.disroot.org:
[https://upload.disroot.org/r/FA7MHOOL#AgsmqnJEyUZAcybZmOGKljqYRtDhJKsvZC/Qt05N8dE=](https://upload.disroot.org/r/FA7MHOOL#AgsmqnJEyUZAcybZmOGKljqYRtDhJKsvZC/Qt05N8dE=)
Il comporte deux volets:
* A gauche du symbole **#** dans le lien se trouve l'URL du fichier:
"https://upload.disroot.org/r/FA7MHOOL"
* A droite du symbole **#** dans le lien se trouve la clé de chiffrement du fichier:
"#AgsmqnJEyUZAcybZmOGKljqYRtDhJKsvZC/Qt05N8dE="
Si vous essayez juste d'utiliser [https://upload.disroot.org/r/FA7MHOOL](https://upload.disroot.org/r/FA7MHOOL) sans la deuxième partie, vous obtiendrez ce message:
![](en/lufi01.png)
----------
# L'interface
L'interface est assez simple, quand vous téléverser un fichier, vous avez les options suivantes:
* Choisissez combien de jours il reste en ligne. **Le maximum est de 60 jours, (pour les petits fichiers)**
* Choisissez si vous voulez que le fichier soit supprimé après son premier téléchargement.
Dans la partie centrale supérieure du panneau, vous pouvez régler les options mentionnées ci-dessus. Dans la partie en haut à droite vous avez le menu pour aller dans "Mes fichiers" et gérer vos téléversements. Le centre est l'endroit où vous téléversez vos fichiers.
![](en/lufi02.png)
----------
# Taille maximale du fichier
Il n' y a pas de limite de taille pour les fichiers que vous pouvez téléverser. Mais le temps maximum qu'un fichier reste stocké dans Lufi varie en fonction de sa taille. Après ce délai, le fichier est supprimé.
Les fichiers volumineux seront stockés pour une durée plus courte. "Le délai d'expiration de votre fichier sera le minimum entre ce que vous choisissez et les limitations suivantes":
* entre 0 et 48M, le fichier sera conservé 60 jour (s).
* entre 48M et 96M, le dossier sera conservé 30 jour (s).
* entre 96M et 954M, le dossier sera conservé 15 jour (s).
* pour 954M et plus, le dossier sera conservé 2 jour (s)
Vous pouvez également vérifier ces informations à tout moment en appuyant sur le bouton ![](en/lufi03.png?resize=30,24) dans l'interface principale de Lufi.
----------
# Comment téléverser et télécharger un fichier
Pour téléverser un fichier, il vous suffit de choisir les options que vous souhaitez (supprimer après le téléchargement ou non, combien de jours il reste en ligne) et "cliquez pour ouvrir le navigateur de fichiers" au centre de l'écran, et naviguez jusqu'à votre fichier et sélectionnez-le, ou faites simplement glisser votre fichier au centre de l'écran.
Une fois le transfert terminé, votre navigateur vous présentera le lien (URL et clé de chiffrement) du fichier transféré, copiez-le ailleurs.
Vous obtiendrez également le lien de suppression qui vous permet de supprimer le fichier transféré du serveur à tout moment.
![](en/lufi1.gif)
Pour télécharger le fichier, il suffit d'utiliser le lien dans le navigateur:
![](en/lufi2.gif)
----------
# Comment partager un fichier
Eh bien, c'est aussi très simple, vous pouvez soit:
* Copiez le lien manuellement vers votre email ou un fichier texte, ou toute autre option
* l'envoyer directement par email à Lufi
Pour la dernière option (si vous avez un client de messagerie électronique dans votre machine, par exemple Thunderbird, Evolution, etc.) cliquez simplement sur le bouton ![](lufi04.png?resize=200,30), une fois votre fichier téléversé avec succès. Écrivez l'adresse e-mail et le texte, puis appuyez sur ![](lufi05.png?resize=280,30). Votre client de messagerie apparaîtra avec l'email prêt à être envoyé.
![](en/lufi3.gif)
**L'option** ![](en/lufi06.png?resize=180,25) **ne devrait pas être utilisé par principe.**
La raison en est que, si vous utilisez cette option, le lien est envoyé en utilisant un email de votre fournisseur Lufi, pas votre email personnel. Ce qui signifie que les administrateurs de l'instance Lufi peuvent voir le lien complet, et sont donc capables de le télécharger, et de le déchiffrer s'ils le souhaitent.
Disroot est un fournisseur soucieux de la vie privée, mais par principe vous devriez éviter de faire cela.
----------
# Comment gérer/supprimer vos téléversements
Vous pouvez gérer vos envois en appuyant sur le bouton ![](en/lufi07.png?resize=60,40) dans le panneau principal.
Vous y verrez tous vos téléchargements et vous pourrez:
* Voir les liens de téléchargement de tous vos envois
* Voir lesquels ont été effacés après le premier téléchargement
* Choisir les envois que vous voulez supprimer du serveur
Cette liste de téléversements est conservée localement dans votre navigateur dans un fichier. json. Ce qui laisse un enregistrement dans votre navigateur des fichiers que vous avez téléversés. Ainsi, vous ne pourrez pas voir la liste de vos fichiers transférés lorsque vous utilisez un navigateur ou un ordinateur différent.
Si vous le souhaitez, vous pouvez également dans ce panneau:
* Purgez cette information du stockage local de votre navigateur (cela effacera les informations des fichiers envoyés et leurs liens de votre navigateur, mais il ne supprimera pas les fichiers du serveur, et le lien est toujours valide)
* Exportez sur votre ordinateur le fichier json contenant les informations suivantes
* Importez dans votre navigateur un fichier json contenant des informations sur les envois et les liens.
![](en/lufi4.gif)
Une autre façon de supprimer un fichier du serveur à tout moment est d'utiliser le lien de suppression, fourni lorsque vous transférez le fichier pour la première fois. Copiez-le et conservez-le dans un fichier texte pour la prochaine fois où vous voudrez l'utiliser.
Pour l'utiliser, il suffit de le mettre dans votre navigateur et d'appuyer sur Entrée.
![](en/lufi08.png)
Si vous supprimez un fichier ou si la date d'expiration définie est dépassée, tous ceux qui tentent de télécharger le fichier verront un message comme celui-ci:
![](en/lufi09.png)

View file

@ -0,0 +1,104 @@
---
title: Comment utiliser Git pour contribuer aux guides Disroot
published: true
visible: true
taxonomy:
category:
- docs
---
Cet article va essayer d'expliquer les bases de l'utilisation de git pour contribuer aux traductions ainsi que pour soumettre de nouveaux tutoriels.
Afin de suivre tous les changements et de travailler avec plusieurs personnes en même temps, nous avons choisi d'utiliser **git** comme système de contrôle de version. Git est un outil très populaire parmi les développeurs et les administrateurs système, mais ses fonctionnalités peuvent être facilement applicables partout où l'historique des changements et la capacité de soumettre du contenu et de collaborer dans un groupe est nécessaire.
Dans ce tutoriel, nous ne couvrirons pas tous les aspects de l'utilisation de git. C'est un outil très complexe et puissant avec des tonnes de tutoriels approfondis et des livres écrits à son sujet. Ce que nous cherchons est de fournir un moyen court et facile de contribuer aux tutoriels et aux traductions.
# Comment créer un compte sur l'instance git
Tout d'abord, vous avez besoin d'un compte sur l'instance git utilisée par disroot.org. Malheureusement git n'est pas encore un service fédéré donc vous devez avoir un compte. Grâce à nos amis de **FOSS Community India**, nous hébergeons tout notre travail sur leur instance gitlab.
Pour créer un compte, allez sur https://git.fosscommunity.in aet enregistrez-vous. En plus de l'enregistrement d'un nouveau compte, vous pouvez choisir d'utiliser l'un des fournisseurs d'ID tels que gitlab.com, github, twitter, gitbucket, google si vous avez déjà un compte sur l'une de ces plateformes.
# Installer Git
Comme toutes les modifications seront effectuées sur votre machine locale, vous devez [installer git](https://gist.github.com/derhuerst/1b15ff4652a867391f03) pour pouvoir envoyer vos modifications ainsi que les changements de synchronisation des autres. Selon votre plate-forme, les méthodes d'installation de git peuvent varier, alors vérifiez le lien ci-dessus ou consultez la documentation spécifique à votre plate-forme.
# Installer l'éditeur Atom
Si vous ne l'avez pas encore fait, il est temps d'installer [Atom](https://atom.io). Atom est un éditeur de texte riche en fonctionnalités avec une intégration git spéciale. Si votre système d'exploitation n'est pas automatiquement détecté ou répertorié lorsque vous accédez au site [Atoms](https://atom.io), vérifiez [d'autres plateformes](https://github.com/atom/atom/releases/latest). Pour tous les utilisateurs d'Arch, vous pouvez simplement l'installer en utilisant `pacman -S atom` ou un autre gestionnaire de paquets de votre choix.
# Cloner le dépôt
Git est créé avec la collaboration dans son noyau. La première chose que nous devons faire est d'obtenir une copie de tous les fichiers du projet (git repository) sur votre disque dur local. Toutes les modifications sont effectuées sur votre machine locale (vous travaillez hors ligne). Ce n'est qu'une fois les changements décidés (nouveau tutoriel, traduction) terminés que vous pouvez décider de les envoyer/synchroniser (push) vers le référentiel sur le serveur.
La façon la plus simple de cloner le référentiel est d'ouvrir votre terminal, en naviguant vers le répertoire dans lequel vous voulez cloner le référentiel, et d'exécuter la commande `git clone <url>`, où *<url>* est essentiellement l'adresse du dépôt que vous voulez cloner. Dans notre cas, ce serait:
`git clone https://git.fosscommunity.in/disroot/howto`
Une fois que le dépot est copié sur votre disque dur, vous verrez un répertoire `howto` qui contient tous les fichiers que vous pouviez auparavant voir dans votre navigateur lorsque vous êtiez sur l'url de notre dépôt.
Vous pouvez déplacer plus tard ce répertoire à n'importe quel endroit de votre disque dur.
# Demander l'accès au dépôt howto git
Pour pouvoir suggérer des changements dans le dépôt git, vous devez demander l'accès. Une fois que les administrateurs vous accordent l'accès, vous pouvez pousser vos changements sur le serveur (notez que vous pouvez commencer à travailler sans l'accès accordé car tous les changements se produisent sur votre ordinateur local).
![](en/git-request_access.png)
# Maintenant, le travail peut commencer.
Maintenant vous pouvez démarrer Atom et `Ouvrir le dossier` que vous venez de cloner (*howto*). L'interface d'Atom est claire et facile à comprendre. La barre latérale de gauche est l'arborescence de navigation de votre projet, la fenêtre du milieu est l'endroit où vous éditez les fichiers et la barre du bas indique le nombre de fichiers modifiés, la branche courante, pull/push rapidement sur git.
![](en/atom1.png)
Vous pouvez ouvrir et travailler sur plusieurs fichiers dans des onglets ou comme écran divisé côte à côte.
Les fichiers non sauvegardés avec des modifications locales sont marqués d'un point bleu (selon le thème que vous utilisez bien sûr)
Pour enregistrer les modifications de fichier, utilisez le menu *Fichier* ou le raccourci clavier *Ctrl+s*.
Mais avant de commencer à travailler sur les fichiers, vous devez créer votre propre: **branche**
# Branches Git
Les branches sont essentiellement vos propres espaces de travail privés. Chaque projet git a sa propre branche **master**. La branche master est la principale copie *production* du projet. Cette branche est automatiquement synchronisée avec le site Web, de sorte que toute modification apportée à cette branche est immédiatement visible sur le site Web. C'est aussi pourquoi l'ajout de modifications à la branche **master** est limité aux seuls propriétaires du projet.
Afin que vous puissiez commencer à travailler, créez votre propre branche. Ceci fera en fait un clone de la branche **master**.
![](en/atom-branch1.gif)
Il est également possible de passer d'une branche à l'autre à partir de ce menu. La branche de travail actuelle est visible sur la barre inférieure.
![](en/atom-branch2.gif)
Une fois la branche créée et modifiée, vous pouvez créer de nouveaux fichiers, modifier les fichiers existants, etc.
# Valider vos changements
Okay, donc vous travaillez sur votre ordinateur pour créer de nouveaux tutoriels ou traduire ceux qui existent déjà. En plus d'enregistrer les modifications sur votre ordinateur portable, vous pouvez/devriez également valider vos modifications. Le fait d'effectuer des changements synchronise le travail que vous avez fait sur votre branche avec le serveur git. Si la branche n'existe pas sur le serveur, elle sera créée et toutes vos modifications et nouveaux fichiers seront envoyés sur le serveur. Dans ce cas, vous pouvez travailler sur vos fichiers sur plusieurs machines, ou d'autres personnes peuvent prendre la relève, vous aider à travailler sur votre branche.
Pour valider vos changements, voici ce qui doit être fait:
- s'assurer que tous les fichiers sont sauvegardés
- mettre en "stage" tous les fichiers que vous avez modifiés et que vous souhaitez "commit" sur le serveur.
- Ecrire un message de "commit"- écrivez un petit résumé de ce qui a été changé.
- Appuyez sur le bouton Valider
![]()
Une fois les fichiers validés, il est temps de les pousser vers le serveur:
- Ouvrir la fenêtre popup push/pull
- Appuyer sur la touche
# Demande de fusion ("Merge request")
Une fois que vous pensez que votre travail est terminé et prêt à être publié sur le site, il est temps de le fusionner avec la branche **master**.
- Bien sûr, vous devez d'abord vous assurer que tous les changements sont bien effectués.
- Connectez-vous sur https://git.fosscommunity.in
- si vous avez appuyé sur n'importe quel changement au serveur de votre branche, en haut à droite, vous verrez le bouton **"Créer une demande de fusion"**.
- Cela va ouvrir le formulaire de demande de fusion.
- Ajoutez le titre
- Ajoutez une description
- Assurez-vous que la **branche source** est celle sur laquelle depuis laquelle vous voulez fusionner (une branche sur laquelle vous avez travaillée)
- Assurez-vous que la branche **cible** est celle vers laquelle vous voulez fusionner (habituellement la branche "master")
![](en/git-merge_request.gif)
Une fois que vous avez créé la demande de fusion, elle sera examinée par les administrateurs de Disroot. Les administrateurs peuvent alors accepter votre commit ce qui signifie qu'il sera fusionné avec la branche master et donc visible sur le site ou vous demander de corriger quelque chose. Une fois que toutes les corrections sont effectuées et que les *chefs suprêmes* de Disroot sont satisfaits, votre demande de fusion sera ajoutée à la banche "master".
# Récupérer ("pull") les changements du serveur
Si vous voulez garder la branche locale **master** et votre branche locale à jour, vous devez récupérer les modifications du serveur. Chaque fois que quelqu'un voit sa demande de fusion ajoutée à la branche "master", tout le monde devrait aussi ajouter ('pull") les changements dans ses branches locales. Vous pouvez alors voir facilement ce qui est nouveau et ce qui a changé récemment. Sur la branche maître, nous conservons un fichier appelé "CHANGELOG" dans lequel nous notons toutes les modifications importantes apportées à Howtos.
Le tirage ("pull") doit être effectué régulièrement (surtout avant de commencer à travailler sur une nouvelle branche).
- Ouvrir la fenêtre popup push / pull
- Appuyez sur **pull****.
# Un peu de vocabulaire et d'explications
**Dépôt git** - Répertoire qui regroupe tous les fichiers appartenant au projet.