GUÍA PARA LA CREACIÓN DE NOTEBOOKS EN GOOGLE COLAB

Dirigida a: estudiantes de Programación y Estadística Aplicada

Referencia: Apuntes de LaTeX (L. M. Molina, 2009)

Marco académico: Resolución No. 50 de 2025 — Universidad de Sucre

1 · Estructura general del Notebook

  1. Celda de portada (Markdown)

    # Título del trabajo  
**Asignatura:** Fundamentos de Programación  
**Programa:** Ingeniería Agroindustrial
**Autor(es):** Nombres completos  
**Fecha:** Agosto 2025

  2. Índice o Tabla de Contenido Se recomienda incluirlo al inicio del Notebook. Puede generarse manualmente o mediante el índice automático de Colab (ver sección 2).

  3. Secciones sugeridas del Notebook

    1. Introducción  
2. Objetivos  
3. Marco Teórico  
4. Desarrollo y Cálculos  
5. Resultados y Discusión  
6. Conclusiones  
7. Referencias

    Cada sección debe comenzar con una celda de texto Markdown y, cuando sea necesario, seguida de una celda de código Python o R con ejemplos o cálculos.

2 · Índice automático (Tabla de contenido)

En Google Colab hay dos maneras complementarias de generar el índice:

A) Índice manual en Markdown

Permite controlar los nombres y vínculos de cada sección. Ejemplo:

## Índice  
1. [Introducción](#introducción)  
2. [Objetivos](#objetivos)  
3. [Marco teórico](#marco-teórico)  
4. [Desarrollo y cálculos](#desarrollo-y-cálculos)  
5. [Resultados y discusión](#resultados-y-discusión)  
6. [Conclusiones](#conclusiones)

Antes de cada título de sección se agrega un ancla:

<a name="introducción"></a>  
## 1 Introducción

✅ Ventajas: control total sobre el formato, útil al exportar a PDF o Word. ⚙️ Recomendado cuando: el índice debe verse directamente al abrir el notebook.

B) Índice automático de Colab

El sistema genera un panel lateral de navegación a partir de los títulos Markdown.

Pasos:

  1. Usa encabezados con #, ##, ### en cada sección.

  2. Activa el panel lateral:

    • Menú Ver → Tabla de contenido, o
    • Haz clic en el ícono de lista numerada del margen izquierdo.

  3. El índice se actualiza automáticamente al modificar los títulos.

✅ Ventajas: no requiere mantenimiento manual. ⚙️ Recomendado cuando: el notebook se usará de forma interactiva dentro de Colab.

💡 Sugerencia: puedes usar ambos métodos. El manual para exportar y el automático para navegar.

3 · Formato de celdas de texto (Markdown + LaTeX)

Google Colab interpreta Markdown con soporte para LaTeX. A continuación se resumen los comandos más usados del manual Apuntes de LaTeX:

Tipo de expresión Sintaxis en Markdown Resultado
Ecuación en línea $ax+by+c=0$ \(ax+by+c=0\)
Ecuación destacada $$E=mc^2$$ \[E=mc^2\]
Fracciones $\frac{a}{b}$ \(\frac{a}{b}\)
Superíndice/Subíndice $x_i^2$ \(x_i^2\)
Raíz n-ésima $\sqrt[n]{x}$ \(\sqrt[n]{x}\)
Sumatoria/Integral $\sum_{i=1}^n x_i$ , $\int_0^\infty f(x)\,dx$ \(\sum_{i=1}^n x_i\),\(\int_0^\infty f(x)\,dx\)
Matriz $\begin{bmatrix}a&b\\c&d\end{bmatrix}$ \(\begin{bmatrix}a&b\\c&d\end{bmatrix}\)
Texto en ecuación $\text{si } x>0$ \(\text{si } x>0\)
Color $\color{blue}{x^2+y^2}$ \(\color{blue}{x^2+y^2}\)

4 · Enlaces, imágenes y referencias internas

  • Hipervínculo externo:

    [Documentación de Python](https://docs.python.org/3/)

  • Referencia a otra sección del notebook:

    [Volver al inicio](#índice)

  • Insertar imagen:

    ![Diagrama](https://ruta/imagen.png)

    o subir archivo local y usar ![Figura 1](figura1.png).

5 · Buenas prácticas de formato

  1. Usa encabezados jerárquicos: #, ##, ###.
  2. Combina texto descriptivo con código funcional.
  3. Añade comentarios explicativos dentro del código (# comentario).
  4. Emplea listas (1., -, *) y bloques de cita (> texto).
  5. Inserta separadores (---) para dividir secciones.
  6. Agrega enlaces de referencia a fuentes, repositorios o documentación.

6 · Ejemplo de estructura completa

# Análisis de Regresión Lineal Simple — Dataset Soils

## Índice
1. [Introducción](#introducción)
2. [Objetivos](#objetivos)
3. [Marco Teórico](#marco-teórico)
4. [Resultados y Discusión](#resultados-y-discusión)
5. [Conclusiones](#conclusiones)

<a name="introducción"></a>
## 1 Introducción
El presente notebook analiza la relación entre la densidad del suelo y el pH utilizando Python.

<a name="marco-teórico"></a>
## 3 Marco Teórico
La ecuación de una recta es:
$$y=\beta_0+\beta_1x+\varepsilon$$

<a name="resultados-y-discusión"></a>
## 4 Resultados y Discusión
```python
import pandas as pd, statsmodels.api as sm
soils = sm.datasets.get_rdataset("Soils", "carData").data
modelo = sm.OLS(soils['pH'], sm.add_constant(soils['Exch'])).fit()
modelo.summary()

5 Conclusiones

El modelo explica la variación del pH del suelo a partir del contenido de calcio intercambiable.

```

7 · Prompts sugeridos para usar IA en Colab (Gemini o ChatGPT)

  • “Explica cómo escribir ecuaciones con LaTeX en Colab.”
  • “Genera ejemplos de delimitadores y con explicación.”
  • “Crea una tabla en Markdown con operadores matemáticos y sus símbolos LaTeX.”
  • “Corrige el formato de ecuaciones y agrega un índice Markdown al notebook.”

8 · Entrega y evaluación final

Cada estudiante deberá entregar su notebook con: - Índice funcional (manual o automático).
- Ecuaciones y símbolos correctamente formateados.
- Comentarios claros en las celdas de código.
- Enlaces y referencias bibliográficas al final.
- Archivo .ipynb publicado en GitHub o Moodle, conforme al calendario académico 2025-2.

Guia_Colab_Notebook_Modelo.ipynb