Créer des dossiers sur GitHub n’est pas sorcier, mais cela comporte ses inconvénients. Si vous avez déjà essayé d’organiser votre projet et remarqué que certains dossiers n’apparaissent pas, c’est probablement parce que GitHub refuse de reconnaître les répertoires vides. C’est un peu embêtant, mais pas surprenant : Git suit les fichiers, pas les dossiers. Donc, pour qu’un dossier reste visible, il doit contenir au moins un fichier. Généralement, on ajoute un fichier «.gitkeep » ou un fichier « README.md ».Ainsi, votre dossier reste visible dans le dépôt. Que vous utilisiez l’interface web ou que vous les créiez localement avec Git, connaître ces petites astuces peut vous éviter bien des soucis.
Comment créer un dossier dans GitHub ?
Créer un dossier sur le site Web GitHub
C’est la méthode la plus simple pour des ajustements rapides ; aucune commande sophistiquée n’est requise. Accédez simplement à votre dépôt et parcourez l’interface. Une fois sur GitHub, accédez au dépôt où vous souhaitez ajouter le dossier.
- Ouvrez votre référentiel GitHub dans votre navigateur.
- Cliquez sur le bouton Ajouter un fichier, puis sélectionnez Créer un nouveau fichier.
- Dans le champ Nom de fichier, saisissez le nom de votre dossier, puis ajoutez une barre oblique (par exemple, )
docs/README.md. Cela indique à GitHub de créer le dossier « docs » et d’y ajouter ce fichier. - Ajoutez du contenu à votre fichier (même une simple ligne) — c’est nécessaire car GitHub ne reconnaîtra pas un dossier vide — puis cliquez sur Valider le nouveau fichier.
Voilà, un nouveau dossier est créé instantanément, contenant un fichier. Sur certaines configurations, une ou deux actualisations peuvent être nécessaires pour que tout apparaisse, mais c’est normal. N’oubliez pas : ajouter un fichier comme README.md dans le dossier est essentiel pour le maintenir actif.
Créer un dossier dans votre dépôt local à l’aide de Git
Si vous préférez travailler sur votre propre machine, créer le dossier localement puis le transférer sur GitHub vous offre un contrôle accru. Voici comment procéder :
- Ouvrez votre terminal ou votre invite de commande (ou PowerShell si vous êtes sous Windows).
- Accédez au répertoire de votre projet :
cd path/to/your-repo. - Créer un nouveau dossier :
mkdir your-folder-name. - Dans ce dossier, ajoutez un fichier pour éviter qu’il soit vide :
touch your-folder-name/README.md(ou créez un fichier texte manuellement si vous êtes sous Windows et n’utilisez pas Git Bash). - Ajoutez et validez vos modifications :
git add.git commit -m "Add new folder" - Poussez tout vers le haut :
git push
Cette méthode vous offre la possibilité de créer plusieurs dossiers imbriqués ou d’ajouter des fichiers selon vos besoins avant de les envoyer. Attention, Git ne suit pas les dossiers vides ; il est donc essentiel d’y inclure au moins un fichier lors de l’envoi.
Et juste au cas où vous seriez curieux ou rencontreriez des problèmes, il convient de noter que des conflits de fusion surviennent parfois lorsque vous travaillez avec des branches distantes. Par conséquent, savoir comment résoudre les conflits dans Git permet d’éviter les maux de tête.
Pourquoi GitHub a-t-il besoin d’un fichier dans un dossier ?
C’est une particularité classique de Git. Comme Git est conçu pour suivre les fichiers, et non les dossiers, il ignore un dossier vide. Pour que le dossier reste visible, les développeurs ajoutent généralement un fichier fictif comme .gitkeepou README.md. C’est un peu ringard, mais ça marche.
FAQ
Tapez simplement le chemin complet avec des barres obliques : src/components/button/index.js. GitHub comprend cela et créera tous les dossiers nécessaires s’ils n’existent pas.
Non. Git ne voit tout simplement pas les dossiers vides. Il faut d’abord ajouter un fichier, sinon on se retrouve avec un message du genre : « Quel dossier ? »
Si vous effectuez simplement des modifications rapides, la méthode web fonctionne bien. En revanche, si vous gérez des projets plus importants ou devez gérer plusieurs dossiers imbriqués, les créer localement puis les transférer est plus fluide : vous pouvez voir ce qui se passe dans votre terminal ou votre IDE.
Oui, déplacez simplement les fichiers dans un nouveau dossier, supprimez l’ancien et cliquez. GitHub ne propose pas de bouton « Renommer le dossier » ; voici donc la solution.
Pour conclure
Une fois que vous avez pris le coup de main, créer des dossiers dans GitHub n’est pas si compliqué. L’interface web est rapide, et la création locale offre plus de puissance pour les projets plus importants. N’oubliez pas : ajoutez toujours un fichier à l’intérieur, sinon le dossier disparaîtra du dépôt. C’est un peu étrange, mais c’est comme ça que Git fonctionne : aucun répertoire vide n’est autorisé.
Résumé
- Utilisez Créer un nouveau fichier avec une barre oblique pour créer des dossiers via le Web.
- Créez des dossiers localement avec mkdiret poussez avec git addet git push.
- Ajoutez toujours au moins un fichier dans le dossier pour le garder visible dans GitHub.
- GitHub ne prend pas directement en charge les dossiers vides, alors planifiez en conséquence.
Conclure
J’espère que cela vous fera gagner quelques secondes pénibles. C’est un de ces petits détails qui peuvent faire trébucher les gens, mais maintenant c’est clair. Quelle que soit la méthode, assurez-vous simplement qu’il y a un fichier à l’intérieur et vous pourrez continuer. Bonne chance et croisons les doigts pour que ça vous aide !