Crear carpetas en GitHub no es tan complicado, pero tiene sus particularidades. Si alguna vez has intentado organizar tu proyecto y has notado que algunas carpetas no aparecen, probablemente se deba a que GitHub no reconoce los directorios vacíos. Es un poco molesto, pero no sorprendente: Git registra archivos, no carpetas. Por lo tanto, si quieres que una carpeta se mantenga, debe contener al menos un archivo. Normalmente, se incluye un archivo `.gitkeep` o `README.md`.De esta forma, tu carpeta permanece visible en el repositorio. Tanto si usas la interfaz web como si las creas localmente con Git, conocer estos pequeños trucos puede ahorrarte algún que otro dolor de cabeza.
¿Cómo crear una carpeta en GitHub?
Crear una carpeta en el sitio web de GitHub
Esta es la opción más sencilla para ajustes rápidos, sin necesidad de comandos complejos. Simplemente ve a tu repositorio y explora la interfaz. En GitHub, navega al repositorio donde quieras añadir la carpeta.
- Abra su repositorio de GitHub en su navegador.
- Haga clic en el botón Agregar archivo y luego seleccione Crear nuevo archivo.
- En el campo de nombre de archivo, escribe el nombre de tu carpeta y añade una barra diagonal, como
docs/README.md. Esto indica a GitHub que cree la carpeta “docs” y añada ese archivo. - Agrega algo de contenido a tu archivo (incluso una línea simple); es necesario porque GitHub no reconocerá una carpeta vacía, y luego haz clic en Confirmar nuevo archivo.
¡Listo! Se crea una nueva carpeta al instante con un archivo dentro. En algunas configuraciones, puede que se necesiten una o dos actualizaciones para que todo aparezca, pero es normal. Recuerda: añadir un archivo como README.md dentro de la carpeta es la clave para mantenerla activa.
Crea una carpeta en tu repositorio local usando Git
Si prefieres trabajar en tu propio equipo, crear la carpeta localmente y luego subirla a GitHub te da mucho más control. Así es como funciona:
- Abra su terminal o símbolo del sistema (o PowerShell si está en Windows).
- Navegue hasta el directorio de su proyecto:
cd path/to/your-repo. - Crear una nueva carpeta:
mkdir your-folder-name. - Dentro de esa carpeta, agrega un archivo para evitar que quede vacía:
touch your-folder-name/README.md(o crea un archivo de texto manualmente si estás en Windows y no usas Git Bash). - Añade y confirma tus cambios:
git add.git commit -m "Add new folder" - Empuja todo hacia arriba:
git push
Este método te da la flexibilidad de crear varias carpetas anidadas o añadir archivos según sea necesario antes de enviar. Ten en cuenta que Git no registra las carpetas vacías, por lo que siempre necesitas tener al menos un archivo en ellas al enviar.
Y en caso de que tengas curiosidad o te encuentres con problemas, vale la pena señalar que a veces surgen conflictos de fusión cuando se trabaja con ramas remotas, por lo que saber cómo resolver conflictos en Git ayuda a evitar dolores de cabeza.
¿Por qué GitHub necesita un archivo dentro de una carpeta?
Esta es una peculiaridad clásica de Git. Dado que Git está diseñado para rastrear archivos, no carpetas, ignorará una carpeta si está vacía. Para mantener la carpeta visible, los desarrolladores suelen incluir un archivo de marcador de posición como .gitkeepo README.md. Es un poco cursi, pero funciona.
Preguntas frecuentes
Simplemente escribe la ruta completa con barras diagonales: src/components/button/index.js. GitHub lo entiende y creará todas las carpetas necesarias si no existen.
No. Git simplemente no detecta carpetas vacías. Primero tienes que añadir un archivo, o simplemente te preguntarás: “¿Qué carpeta?”.
Si solo realizas ediciones rápidas, el método web funciona bien. Pero si gestionas proyectos más grandes o necesitas varias carpetas anidadas, crearlas localmente y luego enviarlas es más sencillo: puedes ver lo que sucede en tu terminal o IDE.
Sí, simplemente mueve los archivos a una nueva carpeta, elimina la anterior y luego envíalos. GitHub no tiene un botón directo para cambiar el nombre de la carpeta, así que esta es la solución alternativa.
Envolviéndolo
Una vez que le coges el truco, crear carpetas en GitHub no es tan complicado. La interfaz web es rápida y la creación local da más potencia para proyectos más grandes. Solo recuerda: siempre añade un archivo dentro, o la carpeta desaparecerá del repositorio. Es un poco raro, pero así funciona Git: no se permiten directorios vacíos.
Resumen
- Utilice Crear nuevo archivo con una barra para crear carpetas a través de la web.
- Crea carpetas localmente con mkdiry envíalas con git addy git push.
- Siempre agregue al menos un archivo dentro de la carpeta para mantenerla visible en GitHub.
- GitHub no admite directamente carpetas vacías, por lo que debes planificar en consecuencia.
Resumen
Ojalá esto le ahorre a alguien unos segundos de incomodidad. Es una de esas pequeñas cosas que confunden a la gente, pero ahora está claro. Sea cual sea el método, solo asegúrate de que haya un archivo dentro y listo.¡Mucha suerte y crucemos los dedos para que esto ayude!