Introducir a los estudiantes de ingeniería en el flujo de trabajo GitHub + Google Colab es fundamental para su formación profesional. Esta combinación no solo facilita la entrega de tareas, sino que los introduce al control de versiones desde el primer día.

La siguiente es una guía estructurada, clara y lista para compartir con los alumnos de la Universidad de Sucre.

Guía de Inicio: GitHub y Google Colab para Ingeniería

Esta guía te enseñará a configurar tu entorno de desarrollo en la nube, permitiéndote gestionar tu código en GitHub y ejecutar tus programas en Google Colab.

Parte 1: Creando tu Identidad en GitHub

GitHub es la plataforma líder para alojar proyectos de software. Antes de programar, necesitamos un “contenedor” para tus archivos.

  1. Registro: Ve a github.com y crea una cuenta con tu correo institucional.
  2. Crear un Repositorio:
  • Haz clic en el botón “New” (o el icono + en la parte superior derecha).
  • Repository name: Dale un nombre a tu curso (ej. Programacion_Computadores).
  • Public/Private: Selecciona “Public”.
  • IMPORTANTE: Marca la casilla “Add a README file”. Esto inicializa el repositorio para que sea visible desde otras aplicaciones.
  • Haz clic en “Create repository”.

Parte 2: El Misterio de Google Colab en Drive

Muchos estudiantes se confunden porque al entrar a Google Drive y dar clic en Nuevo > Más, la opción de Google Colaboratory no aparece.

[!NOTE] Dato Clave: Google Colab es una “extensión” de Drive. Si nunca has usado uno, Drive no sabe que quieres usar esa herramienta. La forma más rápida de activarlo es crear tu primer Notebook directamente desde el sitio oficial.

  1. Ve a colab.research.google.com.
  2. Se abrirá una ventana emergente; haz clic en “Bloc de notas nuevo”.
  3. A partir de este momento, si vas a tu Google Drive, ya verás la opción disponible en el menú Nuevo > Más > Google Colaboratory.

Parte 3: Estructura del Notebook (Markdown y LaTeX)

Los Notebooks de Colab permiten mezclar código (celdas de código) con explicaciones formateadas (celdas de texto).

1. Creando un Índice

Para que un Notebook sea profesional, debe estar organizado. Usa los símbolos # para jerarquías:

  • # Título de Primer Nivel (Equivale a un Título Principal).
  • ## Título de Segundo Nivel (Equivale a una sección).

2. Matemáticas con LaTeX

Como futuros ingenieros, necesitaremos escribir fórmulas. Colab utiliza la sintaxis de LaTeX encerrada entre símbolos de dólar $.

  • Ecuación en línea: Escribe $E = mc^2$ para que aparezca dentro de un párrafo.
  • Ecuación centrada: Usa doble símbolo:

3. Enlaces a Recursos

Para insertar el material de apoyo del curso, usa el formato [Texto](URL).

Parte 4: Guardar directamente en GitHub

Una vez que tu Notebook esté listo, no lo descargues a tu PC. Guárdalo directamente en la nube:

  1. En el menú superior de Colab, ve a Archivo > Guardar una copia en GitHub.
  2. Se abrirá una ventana para autorizar a Google a acceder a tu cuenta de GitHub.
  3. Selecciona el repositorio que creaste en la Parte 1.
  4. Escribe un mensaje de confirmación (ej. “Primer notebook con índice y ecuaciones”) y haz clic en Aceptar.