GitHub è uno strumento essenziale per gli sviluppatori, poiché fornisce una piattaforma per archiviare, condividere e collaborare sul codice. Una domanda comune tra gli utenti è come creare una directory o una cartella vuota in un repository GitHub. GitHub non supporta la creazione diretta di directory vuote. Tuttavia, esiste una soluzione alternativa a questo utilizzando un file fittizio, solitamente un file .gitkeep. In questo articolo esploreremo i passaggi e il ragionamento alla base di questo metodo
Perché GitHub non supporta le directory vuote?
Git, il sistema di controllo della versione sottostante su cui si basa GitHub, tiene traccia delle modifiche ai file. Le directory vuote non contengono file, quindi Git non ne tiene traccia. Pertanto, se dovessi creare una directory vuota sul tuo computer locale e provare a inviarla a GitHub, la directory verrebbe ignorata.
La convenzione .gitkeep
Il file .gitkeep non è una funzionalità ufficiale di Git, ma è una convenzione ampiamente accettata all’interno della comunità. Questo file non ha proprietà o funzionalità speciali. Il suo unico scopo è quello di essere un segnaposto, consentendo agli sviluppatori di impegnarsi e inviare directory altrimenti vuote ai loro repository. Il nome .gitkeep è stato scelto perché comunica chiaramente lo scopo del file: “mantenere” la directory in Git.
Crea una directory vuota tramite la riga di comando
Ecco una guida passo passo per creare una directory vuota in un repository GitHub utilizzando il file .gitkeep metodo:
Crea la directory e il file .gitkeep: ad esempio, vuoi aggiungere un file vuoto “log”. directory nel tuo progetto:
mkdir logstouch logs/.gitkeep
Impegna e implementa le modifiche:
git add .git commit -m "Added empty directory"git push origin master
Nota: se il tuo ramo predefinito ha un nome diverso, come main, sostituisci master con il nome del ramo predefinito nel comando git push.
Crea una directory vuota tramite Github Dashboard
Per creare una directory vuota direttamente tramite il dashboard web di GitHub (l’interfaccia utente che vedi quando visiti un repository su GitHub.com), in genere crei un nuovo file e utilizzi una barra (/) per implicare una directory. Sfortunatamente, GitHub non consente di creare directory puramente vuote senza aggiungervi un file.
Ecco una guida passo passo per creare una directory (con un file fittizio) tramite la dashboard di GitHub:
- Passa al tuo repository:
- Apri il repository GitHub in cui desideri creare la nuova directory.
- Aggiungi un nuovo file:
- Fare clic sul pulsante Aggiungi file e quindi selezionare Crea nuovo file.
- Assegna un nome al file:
- Nel campo del nome, digita il nome della tua nuova directory, seguito da a “/”. Ad esempio, se desideri creare una directory denominata “log”.tipo “log/”.. Noterai che GitHub lo riconosce come directory.
- Dopo il “/”, digita il nome di un nuovo file che risiederà all’interno di quella directory. Molte persone usano `.gitkeep` (anche se questo nome non ha alcun significato speciale per Git o GitHub; è solo una convenzione). Quindi potresti dargli un nome `logs/.gitkeep`.
- Salva il nuovo file:
- Scorri fino alla fine della pagina, inserisci il messaggio di commit e decidi se vuoi impegnarti direttamente nel ramo principale o creare un nuovo ramo e avviare una richiesta pull.
- Clicca su “Conferma modifiche…”.
Ora il tuo repository avrà una nuova directory denominata “log”. con un singolo file al suo interno denominato .gitkeep.
Verificare su GitHub
- Passare al repository su GitHub.
- Ora dovresti vedere la tua directory elencata e al suo interno ci sarà il file `.gitkeep` file.
Nomi di file alternativi
Mentre `.gitkeep` è una convenzione popolare, alcuni sviluppatori utilizzano altri nomi di file segnaposto come `.segnaposto`. Non importa quale nome scegli; ciò che è essenziale è che ci sia un file all’interno della directory in modo che Git possa monitorarlo.
Conclusione
Sebbene GitHub non supporti la creazione diretta di directory vuote, il file `.gitkeep` La convenzione offre una soluzione efficace. Aggiungendo semplicemente un file segnaposto alla tua directory, puoi assicurarti che Git lo tenga traccia e lo visualizzi nel tuo repository GitHub. Questa pratica, sebbene non ufficiale, è ampiamente riconosciuta nella comunità degli sviluppatori, rendendola un metodo affidabile per strutturare i tuoi progetti secondo necessità.
