Mappen aanmaken in GitHub is geen hogere wiskunde, maar het heeft wel zo zijn eigenaardigheden. Als je ooit hebt geprobeerd je project te organiseren en hebt gemerkt dat sommige mappen gewoon niet verschijnen, komt dat waarschijnlijk doordat GitHub lege directories weigert te erkennen. Best vervelend, maar niet verrassend: Git registreert bestanden, geen mappen. Dus als je wilt dat een map blijft bestaan, moet er minstens één bestand in staan. Meestal gooien mensen er een `.gitkeep` of een `README.md` in. Zo blijft je map zichtbaar in de repository. Of je nu de webinterface gebruikt of ze lokaal met Git aanmaakt, het kennen van deze trucjes kan je een hoop hoofdpijn besparen.
Hoe maak je een map in GitHub?
Maak een map aan op de GitHub-website
Dit is het makkelijkst voor snelle aanpassingen: er zijn geen ingewikkelde commando’s nodig. Ga gewoon naar je repository en beweeg door de interface. Als je op GitHub bent, navigeer je naar de repository waar je de map wilt toevoegen.
- Open uw GitHub-repository in uw browser.
- Klik op de knop Bestand toevoegen en selecteer vervolgens Nieuw bestand maken.
- Typ in het veld ‘Bestandsnaam’ de naam van je map en voeg een slash toe, zoals
docs/README.md. Dit geeft GitHub het signaal om de map ‘docs’ aan te maken en dat bestand erin te plaatsen. - Voeg wat inhoud toe aan uw bestand (zelfs een eenvoudige regel) — dit is noodzakelijk omdat GitHub een lege map niet herkent — en klik vervolgens op Commit new file.
Voilá, er wordt direct een nieuwe map aangemaakt met daarin een bestand. Bij sommige installaties kan het een of twee keer verversen duren voordat alles zichtbaar is, maar dat is normaal. Onthoud dat het toevoegen van een bestand zoals README.md aan de map de truc is om hem actief te houden.
Maak een map in je lokale repository met Git
Als je liever op je eigen computer werkt, geeft het je veel meer controle om de map lokaal aan te maken en vervolgens naar GitHub te pushen. Dit is hoe het werkt:
- Open uw terminal of opdrachtprompt (of PowerShell als u Windows gebruikt).
- Navigeer naar uw projectmap:
cd path/to/your-repo. - Maak een nieuwe map:
mkdir your-folder-name. - Voeg in die map een bestand toe, zodat deze niet leeg is:
touch your-folder-name/README.md(of maak handmatig een tekstbestand als u Windows gebruikt en Git Bash niet gebruikt). - Voeg uw wijzigingen toe en bevestig ze:
git add.git commit -m "Add new folder" - Duw alles omhoog:
git push
Deze methode geeft je de flexibiliteit om meerdere geneste mappen te maken of bestanden toe te voegen voordat je pusht. Houd er rekening mee dat Git geen lege mappen bijhoudt, dus je moet er altijd minstens één bestand in hebben staan wanneer je pusht.
Mocht je nieuwsgierig zijn of tegen problemen aanlopen, dan is het goed om te weten dat er soms samenvoegingsconflicten ontstaan bij het werken met externe branches. Als je weet hoe je conflicten in Git oplost, voorkom je dat je je zorgen maakt.
Waarom heeft GitHub een bestand in een map nodig?
Dit is een klassieke Git-eigenaardigheid. Omdat Git is ontworpen om bestanden te volgen – geen mappen – negeert het een map als deze leeg is. Om de map zichtbaar te houden, gebruiken ontwikkelaars meestal een tijdelijke aanduiding zoals .gitkeepof README.md. Het is een beetje goedkoop, maar het werkt.
Veelgestelde vragen
Typ gewoon het volledige pad inclusief slashes: src/components/button/index.js. GitHub begrijpt dat en maakt alle benodigde mappen aan als ze nog niet bestaan.
Nee. Git ziet gewoon geen lege mappen. Je moet eerst een bestand toevoegen, anders krijg je de vraag: “Welke map?”
Als je alleen snelle bewerkingen uitvoert, werkt de webmethode prima. Maar als je grotere projecten beheert of meerdere geneste mappen moet gebruiken, is het makkelijker om ze lokaal aan te maken en vervolgens te pushen: je ziet wat er gebeurt in je terminal of IDE.
Ja, verplaats de bestanden gewoon naar een nieuwe map, verwijder de oude en push ze. GitHub heeft geen directe knop om de map te hernoemen, dus dit is de tijdelijke oplossing.
Het afronden
Als je het eenmaal onder de knie hebt, is het aanmaken van mappen in GitHub niet zo moeilijk. De webinterface is snel, lokaal aanmaken biedt meer mogelijkheden voor grotere projecten. Onthoud: voeg altijd een bestand toe, anders verdwijnt de map uit de repository. Het is een beetje vreemd, maar zo werkt Git nu eenmaal: lege mappen zijn niet toegestaan.
Samenvatting
- Gebruik Nieuw bestand maken met een slash om mappen via het web te maken.
- Maak mappen lokaal met mkdiren push met git adden git push.
- Voeg altijd minimaal één bestand toe aan een map, zodat deze zichtbaar blijft in GitHub.
- GitHub biedt geen directe ondersteuning voor lege mappen, dus houd hier rekening mee bij het plannen.
Afronding
Hopelijk bespaart dit iemand een paar pijnlijke seconden. Het is een van die kleine dingen waar mensen over struikelen, maar nu is het duidelijk. Welke methode je ook gebruikt, zorg er gewoon voor dat er een bestand in zit en je kunt aan de slag. Veel succes en ik duim dat dit helpt!