Saltar a contenido

🚀 Práctica 3: Publicar tu Portafolio con GitHub Pages

Lee antes (5 min)

  • GitHub Pages (overview): https://docs.github.com/en/pages/getting-started-with-github-pages
  • GitHub Actions (workflows): https://docs.github.com/en/actions/quickstart

0. Resultado esperado

Al final de la práctica tendrás:

  • Un repo personal creado desde el template.
  • GitHub Pages activado con Build and deployment -> GitHub Actions.
  • Tu sitio online en una URL del tipo: https://<tu-usuario>.github.io/<nombre-del-repo>/
  • Las secciones del día completadas (mínimo un borrador).

1. Crear tu repo desde el template (5–10 min)

  1. Abrí el template: https://github.com/ucudal/ia-portfolio-template
  2. Clic en Use this template → Create a new repository.
  3. Completa:
  4. Owner: tu usuario personal.
  5. Repository name: algo simple, p. ej. ia-portfolio o portfolio-ia.
  6. Public.
  7. Clic en Create repository.

🧠 Nota: No hagas fork. Debe ser “Use this template”.

Pistas:

  • Elegí un nombre corto y sin espacios; activá Public para poder publicar Pages.
  • Agregá una descripción breve del repo; no hace falta licencias adicionales si el template ya las trae.

2. Activar GitHub Pages (5 min)

  1. En tu nuevo repo, ve a Settings → Pages
  2. En Build and deployment:
  3. Source: GitHub Actions.
  4. Guardá.
  5. En Actions (pestaña del repo), verificá que corra el workflow de deploy (tarda 1–3 min).

La URL quedará como: https://<tu-usuario>.github.io/<tu-repo>/ (aparece en la sección Pages cuando termina el deploy).

Pistas:

  • Si ves 404, esperá unos minutos y recargá; confirmá que la rama y ruta de deploy sean las del workflow.
  • Recordá que la URL incluye el nombre del repo (/<tu-repo>/).

3. Completar el contenido mínimo hoy

Editá el contenido del repo (README y/o las páginas indicadas en el template). Sugerencias concretas:

A. Portada / About

  • Nombre, breve bio (2–3 líneas), links (LinkedIn/GitHub).
  • Objetivo del curso en tus palabras (1–2 líneas).

B. Prácticas relacionadas

Pistas:

  • Usá links relativos entre prácticas: [Iris](01-exploracion-iris.md).
  • Estructurá con encabezados (##), listas y tablas simples cuando ayude.

C. Visualizaciones e insights de Iris

  • Incluye 1–2 visualizaciones destacadas de tu EDA (ej.: pairplot y heatmap)
  • Redacta 2–3 observaciones concretas por gráfico
  • Lista breve de próximos pasos/mejoras para el análisis

D. “Próximos pasos” (backlog personal)

Tip: El template trae secciones prediseñadas, y de ejemplo, usalas para ayudarte.

4. Publicar cambios (5 min)

  1. Hacé commit + push de tus cambios.
  2. Verificá que corra el workflow de GitHub Actions.
  3. Probá tu sitio: https://<tu-usuario>.github.io/<tu-repo>/.

Pistas:

  • Mensaje de commit sugerido: feat: publicar estructura inicial del portafolio.
  • Si el deploy falla, abrí el job en Actions y buscá errores de permisos o rutas.

5. Entrega en WebAsignatura (2 min)

  • En la tarea “Portafolio – Práctica 3”, pega la URL pública de tu portafolio (la de GitHub Pages).
  • Asegurate de que cualquier persona con el link pueda verlo.

Pistas:

  • Confirmá que el repo sea público y que la URL corresponda a Pages (no a la del repo).

✅ Checklist

  • Repo creado desde template (no fork)
  • Pages activado por Actions y deploy exitoso
  • Secciones mínimas completadas y visibles
  • Links a la práctica de exploración de Iris funcionan

🧯 Errores comunes

  • El deploy falla → abre la pestaña Actions y mira el log del workflow.
  • No ves el sitio → revisá la configuración de Pages y esperá 2–3 minutos.

Resultado de ejemplo (en el repo)

En examples/UT1/02-portafolio-github-pages/ encontrarás un README_template.md con una estructura mínima sugerida para tu sitio y contenido de referencia para completar hoy.