Fichiers
Accéder aux fichiers et les organiser
Accéder aux fichiers et les organiser
Sur cette page, vous pouvez apprendre comment contribuer à Fichiers. Si vous êtes intéressé par des informations générales sur cette application, veuillez visiter la page des applications pour GNOME.
Le texte original des applications est généralement rédigé en anglais américain. La traduction dans d’autres langues peut être ajoutée séparément par des traducteurs. La traduction englobe généralement l’interface utilisateur des applications ainsi que les métadonnées affichées à des endroits tels que dans Logiciels ou apps.gnome.org. Les abréviations courantes utilisées dans ce contexte sont l10n (« localization » ou régionalisation) et i18n (« internationalization »).
Cette application est traduite via le système de traduction GNOME appelé Damnés Mensonges.
Lorsque vous signalez un problème ou suggérez une fonctionnalité, il peut être utile de baser le rapport sur la dernière version de l’application. À cette fin, vous pouvez consulter les méthodes d’installation ci-dessous.
Si vous avez trouvé un problème ou souhaitez proposer un changement, vous devez vous assurer que vous avez essayé la dernière version de Fichiers. Vous pouvez vérifier la version actuelle dans la section « À propos » de l’application.
La dernière version publiée sur Flathub est la version 49.4.
Cette application permet d’installer une version de son état de développement actuel. De telles installations étaient traditionnellement générées chaque nuit, ce qui leur a valu le nom de « version nightly ». De nos jours, elles sont généralement régénérées à chaque fois que la version de développement principale change.
Avertissement : Les versions nightly des applications ne doivent être utilisées qu’à des fins de test et non pour des tâches réelles. Vous pouvez identifier les versions nightly de l’application sur votre système grâce aux rayures dans l’icône de l’application et aux rayures dans la barre d’en-tête de l’application. Elles utilisent généralement une configuration différente de celle des autres installations de l’application. Cependant, il n’y a aucune garantie que l’installation de ces applications fonctionnera comme prévu. Ne travaillez jamais sur des données avec des versions nightly d’applications sans disposer de sauvegardes.
La version nightly peut également être installée via Console si le dépôt nightly est déjà configuré.
$ flatpak install gnome-nightly org.gnome.Nautilus.Devel
$ flatpak run org.gnome.Nautilus.Devel
Détecter les problèmes et les régressions avant qu’ils ne se retrouvent dans une version stable est très utile pour un projet. Vous pouvez y contribuer en essayant une version à venir.
This is especially helpful during the feature freeze period which is dedicated to finding and fixing bugs.
Vous pouvez le faire en essayant la version de nuit de l’application.
En tant qu’application fondamentale, elle est également préinstallée dans GNOME OS Nightly que vous pouvez installer en tant que machine virtuelle.
Pour de nombreuses applications, le système de suivi de problèmes est un lieu central pour la coordination du développement de l’application. Il sert non seulement à suivre tous les problèmes existants, mais aussi à planifier les nouvelles fonctionnalités et d’autres tâches diverses.
Le signalement des problèmes rencontrés lors de l’utilisation de l’application peut s’avérer très utile pour les responsables de l’application. Cependant, le traitement des rapports de problèmes peut également prendre un temps considérable. Vous pouvez prendre en charge une partie du travail en suivant les étapes suivantes :
Effectuez une recherche dans le système de suivi des problèmes pour savoir si le problème a déjà été signalé.
Vérifier si le problème existe aussi dans la dernière version de l’application.
Le cas échéant, essayez de déterminer dans quelles circonstances exactes le problème se produit.
Signalez toutes les informations potentiellement pertinentes, comme la version de l’application qui expose le comportement.
Retrouver la cause exacte d’un problème peut être une tâche très importante. En particulier pour les problèmes étiquetés avec des labels tels que « Needs Diagnosis » ou « Needs Information ». Si vous pouvez reproduire, c’est-à-dire déclencher vous-même le problème signalé, vous pouvez essayer d’aller plus loin. Cela peut aller de la recherche des conditions exactes dans lesquelles le problème apparaît, à l’exécution de l’application avec la sortie de débogage activée, en passant par l’ajout de sorties de débogage dans le code qui permettent d’affiner le problème.
La plupart des applications traitent également les demandes de fonctionnalités via le système de suivi des problèmes. Notez que la mise en œuvre de fonctionnalités et leur maintien dans la base de code à l’avenir peuvent nécessiter une quantité importante de travail supplémentaire. Par conséquent, vous devez vous demander si une nouvelle fonctionnalité peut être suffisamment pertinente pour faire partie de cette application.
Lorsque vous proposez une nouvelle fonctionnalité, il est utile de se concentrer sur le problème pratique qu’elle devrait résoudre. Pas sur la façon dont l’application devrait résoudre le problème ou sur une éventuelle mise en œuvre précise. De préférence, vous pouvez également donner un exemple pratique où vous avez eu besoin de la fonctionnalité.
Le système de suivi des problèmes peut également vous aider à trouver des tâches ouvertes auxquelles vous pourriez vous atteler. Avant d’implémenter une nouvelle fonctionnalité, il est généralement conseillé de vérifier auprès des responsables si les demandes de fusion pour cette fonctionnalité sont acceptées.
Cette application propose également des tâches qui sont étiquetées « Newcomer ». Ces tâches requièrent généralement moins de connaissances préalables ou sont moins complexes.
Que vous souhaitiez corriger une coquille, modifier l’interface utilisateur ou travailler sur le code de l’application, les informations suivantes peuvent vous aider à démarrer. La première étape consistera à construire l’application sur votre ordinateur, ce qui vous permettra de jouer avec vos modifications. Ensuite, vous pouvez consulter la documentation fournie sur la manière d’effectuer les tâches respectives. La section suivante vous montrera comment soumettre vos modifications.
Si vous prévoyez une modification ou un ajout plus important à l’application, il est souvent judicieux de vérifier auprès des responsables de l’application si cette modification pourrait être acceptée. Pour cela, vous devez d’abord vous convaincre que vous pouvez vous attaquer à la tâche en question en réalisant les toutes premières étapes de l’implémentation, puis vérifier auprès des responsables via le système de suivi des problèmes. C’est également un bon moyen de vérifier si le projet a un responsable actif qui peut accepter votre contribution. Malgré tous nos efforts, tous les projets ne sont pas toujours maintenus en permanence.
Notez que si de nombreux membres de la communauté sont heureux de vous aider lorsque vous êtes bloqué, les responsables n’ont souvent pas les ressources nécessaires pour vous guider dans une contribution.
Si vous vous sentez dépassé par l’idée de travailler sur une application GNOME existante, vous pouvez également d’abord envisager de développer votre propre application à des fins d’apprentissage.
Lorsque vous apportez des modifications à une application, vous souhaitez généralement construire et tester l’application avec ses modifications sur votre ordinateur. Pour la plupart des applications, ce processus peut être simplifié en utilisant l’application Builder.
Après avoir démarré Builder, vous pouvez choisir de cloner un projet. L’application sera alors téléchargée sur votre ordinateur.
Vous devez saisir l’emplacement du dépôt. L’URL correcte peut être copiée ci-dessous.
En fonction de votre connexion Internet et de la taille du projet, le clonage du projet peut prendre un certain temps. Une fois que Builder a terminé cette étape, la fenêtre du projet devrait s’ouvrir. Il se peut que vous deviez confirmer l’installation de certaines dépendances requises. Pour essayer de construire et de démarrer l’application avec succès, vous pouvez maintenant cliquer sur le bouton « Exécuter projet ».
Si tout se passe bien, l’application devrait être construite. Une fois la construction terminée, l’application construite devrait démarrer automatiquement.
Cette application est développée avec le langage de programmation C.
Pour commencer à développer des applications GNOME avec C, nous vous recommandons le Tutoriel pour débutants qui couvre également le langage C. Vous trouverez d’autres ressources importantes ci-dessous.
Après avoir apporté des modifications à un projet, vous pouvez les soumettre pour examen. Notre objectif est de créer ce que l’on appelle une demande de fusion (« merge request ») ou une demande de tirage (« pull request »). Cela signifie suggérer un changement au code et aux données d’un projet.
Nous commençons par quelques préparatifs sur GitLab de GNOME, où le projet est hébergé. Ce processus peut sembler assez complexe si vous le suivez pour la première fois, mais vous vous y habituerez avec le temps.
La première étape consiste à créer un nouveau compte GitLab de GNOME si vous n’en possédez pas déjà un. Pour ce faire, il vous suffit d’utiliser le formulaire en ligne.
Next, we want to make sure that git on your computer can also use your GitLab de GNOME account. For this, you need an SSH key. If you don't have an SSH key yet you can generate a new one using Console. Alternatively, you can generate one using the Passwords and Keys app.
Vous devez maintenant ajouter votre clé publique SSH dans les paramètre des « clés SSH » sur GitLab de GNOME. Les clés SSH publiques sont stockées dans le dossier .ssh de votre répertoire personnel sous forme de fichiers se terminant par .pub. Vous pouvez afficher toutes vos clés SSH publiques via la commande cat ~/.ssh/*.pub. Vous pouvez également visualiser les clés SSH publiques en utilisant l’application Mots de passe et clés.
Pour suggérer des modifications à un projet, vous devez d’abord créer votre propre copie du projet sur GitLab de GNOME. La création de cette copie est également appelé bifurcation. Vous aurez besoin de votre propre copie (ou bifurcation) du projet pour téléverser vos modifications sur cette copie.
Note: To fork a repository, you need to have added an SSH key to your GitLab accout as described above. After adding the SSH key, it can take up to 20 minutes before forking becomes available.
Tout d’abord, vous pouvez bifurquer Fichiers via la page GitLab de GNOME. Vous n’avez qu’à le faire une seule fois pour chaque projet sur lequel vous travaillez.
Maintenant, nous devons faire savoir à git dans votre projet local que vous avez une copie personnelle sur GitLab de GNOME via cette URL. Pour cela, nous devons retourner à la ligne de commande. Tout d’abord, vous devez (cd) dans le projet sur lequel vous avez travaillé. Ensuite, vous pouvez utiliser la commande
$ git remote add my-copy <ssh-fork-url>
où <ssh-fork-url> doit être remplacé par l’URL SSH que vous avez trouvé dans l’étape précédente.
Nous arrivons maintenant à des tâches plus régulières lorsque l’on travaille avec git.
Tout d’abord, nous voulons passer à ce que l’on appelle une branche différente. Les branches sont des variantes du code original où vous pouvez, par exemple, développer une fonctionnalité, jusqu’à ce qu’elle soit prête à être intégrée dans le code réellement utilisé. Pour ce faire, vous pouvez appeler
$ git checkout -b my-changes
où my-changes est une courte description de ce sur quoi vous travaillez, sans espaces.
Ensuite, nous voulons sauvegarder les changements que vous avez faits avec git. C’est ce qu’on appelle généralement créer un commit. Vous pouvez le faire avec la commande
$ git commit -am "Commit Message"
Les messages de commit doivent décrire vos modifications. Vous pouvez en savoir plus sur le choix d’un message de commit approprié.
Maintenant, nous devons transférer vos modifications sauvegardées sur GitLab. Heureusement, nous avons déjà fait toute la configuration en utilisant git remote add dans la section précédente. Tout ce qu’il reste à faire est d’appeler
$ git push my-copy
Nous en sommes finalement à la dernière étape. Si vous vérifiez la sortie dans Console après notre commande git push précédente, vous verrez probablement déjà un lien vers un site web vous montrant comment créer une demande de tirage (« pull request ») ou de fusion (« merge request »). Vous pouvez l’ouvrir en appuyant sur la touche Ctrl tout en cliquant dessus. Il ne vous reste plus qu’à suivre le site web pour finaliser la soumission de vos modifications.