Mini Proyecto con GitHub

Este ejercicio está diseñado para introducir a los estudiantes a Git y GitHub de manera sencilla y práctica. ¡Vamos paso a paso!

  1. Crea una cuenta en GitHub
  2. Crea un nuevo repositorio
  3. Clona el repositorio en tu computadora
  4. Crea un archivo README.md
  5. Añade contenido
  6. Haz commit y push
  7. Verifica los cambios en GitHub

Usando Windows

Tutorial para Windows, incluyendo cómo instalar y usar las herramientas necesarias para trabajar con Git y GitHub:

1. Crea una cuenta en GitHub (10 minutos)

  1. Ve a github.com.
  2. Haz clic en Sign up o Regístrate.
  3. Completa los campos requeridos:
    • Nombre de usuario, correo electrónico y contraseña.
  4. Confirma tu correo electrónico siguiendo las instrucciones.
  5. Accede a tu perfil en GitHub y familiarízate con la interfaz.

2. Instala Git para Windows (15 minutos)

  1. Ve a git-scm.com y descarga la versión para Windows.
  2. Abre el instalador y sigue estos pasos clave:
    • En la configuración de PATH, selecciona la opción: "Git from the command line and also from 3rd-party software".
    • Usa las configuraciones predeterminadas para el resto de las opciones.
  3. Verifica que Git se instaló correctamente:
    • Abre Git Bash (búscalo en el menú Inicio).
    • Escribe: 
      git --version

      Si ves algo como git version 2.x.x, todo está listo.

3. Configura Git en tu computadora (5 minutos)

  1. Abre Git Bash y configura tu nombre y correo electrónico para identificar tus cambios: 
    git config --global user.name "Tu Nombre"
git config --global user.email "tuemail@ejemplo.com"

4. Crea un nuevo repositorio en GitHub (10 minutos)

  1. Ve a tu cuenta de GitHub y haz clic en el botón verde New.
  2. Llena los campos:
    • Repository name: Por ejemplo, primer-repositorio.
    • Description: Algo breve como "Mi primer proyecto en GitHub".
    • Selecciona la opción Initialize this repository with a README.
  3. Haz clic en Create repository.

5. Clona el repositorio en tu computadora (15 minutos)

  1. En la página del repositorio, haz clic en el botón verde Code y copia la URL (por ejemplo: https://github.com/tuNombre123/primer-repositorio.git).
  2. Abre Git Bash en la carpeta donde quieras clonar tu proyecto (por ejemplo, en tu carpeta Documentos).
  3. Escribe: 
    git clone https://github.com/tuNombre123/primer-repositorio.git
  4. Ve a la carpeta del repositorio clonado: 
    cd primer-repositorio

6. Crea y edita el archivo README.md (10 minutos)

  1. Abre la carpeta del repositorio en un editor de texto como Bloc de notas, Notepad++ o Visual Studio Code.

  2. Crea un archivo llamado README.md (si no existe ya) y escribe lo siguiente:

    # Mi Primer Repositorio
Este es mi primer proyecto usando Git y GitHub en Windows. ¡Estoy aprendiendo!

  3. Guarda los cambios.

7. Haz commit y push (15 minutos)

  1. Regresa a Git Bash y añade el archivo al área de preparación: 
    git add README.md
  2. Haz un commit para registrar los cambios: 
    git commit -m "Añadí contenido inicial al README"
  3. Sube los cambios al repositorio remoto en GitHub: 
    git push origin main

8. Verifica los cambios en GitHub (5 minutos)

  1. Ve a tu repositorio en GitHub (https://github.com/tuNombre123/primer-repositorio).
  2. Abre el archivo README.md y verifica que los cambios realizados en tu computadora se reflejan en el repositorio remoto.

9. Opcional: Personaliza y experimenta (10 minutos)

  • Crea más archivos en el repositorio:
    • Por ejemplo, un archivo index.html con contenido básico: 
      <h1>Hola, mundo</h1>
<p>Este es mi primer archivo HTML en mi repositorio.</p>
  • Repite los pasos add, commit y push para subirlos al repositorio.

Notas pedagógicas para la sesión

  • Asegúrate de explicar cada comando y su propósito:
    • git add: Prepara los archivos para ser registrados.
    • git commit: Guarda los cambios localmente con un mensaje.
    • git push: Envía los cambios al repositorio remoto en GitHub.
  • Haz demostraciones en vivo para mostrar cómo funciona cada paso.
  • Recomendación: Usa una proyección de tu pantalla mientras los estudiantes replican los pasos.

Usando Linux o directamente en el servidor con SSH

1. Crea una cuenta en GitHub (10 minutos)

  1. Ve a github.com.
  2. Haz clic en Sign up o Regístrate.
  3. Completa los campos requeridos:
    • Nombre de usuario: Único y relacionado contigo (ejemplo: tuNombre123).
    • Correo electrónico: Preferiblemente uno que uses para proyectos.
    • Contraseña: Elige una segura.
  4. Sigue las instrucciones para confirmar tu correo.
  5. Una vez registrado, explora tu perfil. Aquí es donde estarán tus repositorios.

2. Crea un nuevo repositorio (10 minutos)

  1. En tu cuenta de GitHub, haz clic en el botón verde New en la esquina superior derecha.
  2. Llena los campos:
    • Repository name: Pon un nombre significativo, por ejemplo, primer-repositorio.
    • Description: Describe brevemente el propósito del repositorio, como "Mi primer proyecto en GitHub".
    • Public/Private: Elige si quieres que sea público (visible para todos) o privado.
    • Marca la casilla que dice Initialize this repository with a README.
  3. Haz clic en Create repository.

3. Clona el repositorio en tu computadora (15 minutos)

  1. Instala Git si no lo tienes:
    • Ve a git-scm.com y sigue las instrucciones para tu sistema operativo.
  2. Abre una terminal o consola (Git Bash, Terminal, etc.).
  3. Ve a la página de tu repositorio en GitHub y haz clic en el botón verde Code.
  4. Copia la URL que aparece (por ejemplo: https://github.com/tuNombre123/primer-repositorio.git).
  5. En tu terminal, navega hasta la carpeta donde quieras guardar el proyecto y escribe: 
    git clone https://github.com/tuNombre123/primer-repositorio.git
  6. Verifica que se creó una carpeta con el nombre del repositorio.

4. Crea un archivo README.md (10 minutos)

  1. Navega a la carpeta del repositorio: 
    cd primer-repositorio
  2. Crea un archivo llamado README.md:
    • En la terminal: 
      echo "# Mi Primer Repositorio" > README.md
    • O crea el archivo con tu editor de texto favorito (Bloc de notas, VS Code, etc.).
  3. Abre el archivo README.md y añade texto como: 
    # Mi Primer Repositorio
Este es mi primer proyecto usando Git y GitHub. ¡Estoy aprendiendo!

5. Añade contenido (5 minutos)

Modifica el archivo README.md para agregar más información, por ejemplo:

## Objetivo
- Aprender a usar Git y GitHub.
- Crear y gestionar proyectos de forma colaborativa.

## Autor
- [Tu Nombre](https://github.com/tuNombre123)

6. Haz commit y push (15 minutos)

  1. Agrega los cambios al área de preparación: 
    git add README.md
  2. Haz un commit:
    • Un commit es como una "foto" de los cambios que hiciste. 
      git commit -m "Añadí contenido inicial al README"
  3. Sube los cambios a GitHub (push):
    • Esto enviará los cambios locales al repositorio en GitHub. 
      git push origin main

7. Verifica los cambios en GitHub (5 minutos)

  1. Ve a tu repositorio en GitHub (https://github.com/tuNombre123/primer-repositorio).
  2. Abre el archivo README.md y verifica que los cambios se reflejen.
  3. ¡Felicidades! Has creado, modificado y subido tu primer repositorio.

Recuerda presionar Ctrl+F5 para refrescar la caché.

Opcional: Experimenta más

  • Crea un nuevo archivo: Añade otro archivo, como index.html o notas.txt, siguiendo los mismos pasos.
  • Colabora con un amigo: Invita a alguien a tu repositorio para trabajar juntos.

Este mini proyecto es una excelente introducción para que los estudiantes se sientan cómodos usando Git y GitHub. ¿Quieres que amplíe algún paso o agregue imágenes? 😊