¡Crea tu primer repositorio en GitHub! Guía completa desde la inicialización hasta el push

En los artículos anteriores completamos la creación de una cuenta de GitHub y la instalación de Git, y finalmente estás listo para empezar a usar GitHub de verdad. Como primer paso, vamos a crear un "hogar" para guardar tu código, un repositorio.

En este artículo, explicaremos detalladamente todo el proceso, desde el concepto básico de "¿qué es un repositorio?", los pasos concretos para crear un repositorio en GitHub, hasta subir (hacer push) por primera vez un archivo creado en tu ordenador (entorno local) a GitHub, todo ello acompañado de los comandos correspondientes. Este flujo de trabajo es una operación básica que repetirás muchas veces en tu futuro como desarrollador, ¡así que asegúrate de dominarlo aquí!

Para empezar, ¿qué es un repositorio? Es un "contenedor" para tu proyecto

Un Repositorio (Repository), en su traducción literal, significa "almacén" o "depósito". En el mundo de la programación, puedes pensar en él como un "contenedor" para guardar todos los archivos relacionados con tu proyecto (HTML, CSS, JavaScript, imágenes, etc.) junto con todo su historial de cambios (el registro de commits).

Existen, a grandes rasgos, dos tipos de repositorios:

• Repositorio local: Es el repositorio que se crea en tu propio ordenador. El trabajo diario se realiza aquí.
• Repositorio remoto: Es el que se crea en un servidor de internet, como GitHub. Funciona como un centro para compartir código con los miembros del equipo y como una copia de seguridad de tu código personal.

El flujo de desarrollo básico consiste en un ciclo de trabajar en el repositorio local, guardar el progreso en puntos clave (hacer commit), y subir esos cambios al repositorio remoto (hacer push).

Pasos para crear un repositorio remoto en GitHub

Primero, vamos a crear un repositorio remoto en GitHub que será el lugar donde guardaremos nuestro código. El procedimiento es muy sencillo.

Paso 1: Ve a la página de creación de un nuevo repositorio
Inicia sesión en GitHub y haz clic en el icono "+" de la esquina superior derecha, o pulsa el botón "New" en el lado izquierdo de tu panel de control.

[Imagen: El botón "New" en el panel de control de GitHub resaltado.]

Paso 2: Rellena la información del repositorio
Aparecerá una página titulada "Create a new repository". Rellena la información necesaria.

[Imagen: El formulario "Create a new repository" con explicaciones para cada campo.]

• Repository name: El nombre de tu repositorio. Elige un nombre conciso en inglés que describa el contenido del proyecto (ej: `my-portfolio-site`).
• Description: Una breve descripción del repositorio (opcional). Escribir de qué trata el proyecto te ayudará a recordarlo más tarde.
• Public / Private: Elige la visibilidad. "Public" si quieres que cualquiera en el mundo pueda verlo, o "Private" si quieres que solo tú o las personas que invites puedan verlo. Para practicar, "Private" está bien.
• Initialize this repository with:: Puedes elegir qué archivos incluir automáticamente al crear el repositorio.
  • Add a README file: Es el archivo de instrucciones del proyecto. Se recomienda encarecidamente marcar esta casilla.
  • Add .gitignore: Es un archivo de configuración para especificar los archivos que quieres que Git ignore. Por ahora, puedes dejarlo en "None".
  • Choose a license: Elige una licencia para el código fuente. Para uso personal, no es necesario configurarla por ahora.

Paso 3: Crea el repositorio
Cuando hayas rellenado todo, haz clic en el botón "Create repository". ¡Con esto, tu nuevo repositorio remoto ha sido creado en GitHub!

[Imagen: La página principal de un repositorio recién creado y vacío.]

Prepara el proyecto en tu PC local y conéctalo a GitHub

A continuación, vamos a preparar un proyecto en tu PC (local) y a subir tu primer archivo al repositorio remoto que acabamos de crear.

Paso 1: Crea una carpeta de proyecto en tu PC
Primero, crea una carpeta de trabajo en el lugar que prefieras de tu PC. Aquí lo haremos usando la terminal (o Git Bash si estás en Windows).

mkdir my-first-repo

Entra en la carpeta que acabas de crear.

cd my-first-repo

Paso 2: Inicializa un repositorio de Git
Para poner esta carpeta bajo el control de Git, ejecuta el comando de inicialización. Esto creará una carpeta oculta llamada `.git` dentro de la carpeta.

git init

Paso 3: Crea un archivo para subir
Vamos a crear un archivo HTML simple para probar.

echo "Hello, GitHub!" > index.html

Paso 4: Haz commit del archivo (guárdalo)
Registra el archivo creado en Git. Primero, con `git add`, selecciónalo para incluirlo en el guardado (staging).

git add index.html

Luego, con `git commit`, crea un punto de guardado.

git commit -m "Añadir archivo HTML inicial"

Paso 5: Conecta con el repositorio remoto
Vincula el repositorio local con el repositorio remoto que creaste antes en GitHub. Ve a la página de tu repositorio en GitHub, haz clic en el botón "Code" y copia la URL de SSH.

[Imagen: Haciendo clic en el botón "Code" de GitHub y copiando la URL de SSH.]

git remote add origin git@github.com:tu-nombre-de-usuario/my-first-repo.git

Paso 6: Haz push a GitHub (súbelo)
Llegamos al paso final. Sube el commit que creaste localmente al repositorio remoto. A esto se le llama "hacer push".

git push -u origin main

Verificación: ¡Comprobemos si el archivo se ha subido a GitHub!

Una vez que el push se haya completado, prueba a recargar la página de tu repositorio de GitHub en el navegador. ¡Deberías ver el archivo `index.html` que acabas de crear! Si haces clic en el nombre del archivo, también podrás ver su contenido.

[Imagen: La página del repositorio de GitHub mostrando el archivo index.html recién añadido en la lista de archivos.]

¡Felicidades! Acabas de dominar el flujo de trabajo más básico e importante: subir un archivo local a GitHub.