Saltar a contenido

Configuración del Portfolio en GitHub

Contexto

Para documentar y presentar los análisis realizados en la unidad, fue necesario configurar un portafolio en GitHub Pages.
Este portafolio actúa como un sitio web público, donde se centralizan todas las prácticas, reflexiones y evidencias.
El objetivo de esta práctica fue aprender a crear un repositorio, clonar la plantilla base y desplegar el sitio en línea utilizando las herramientas provistas por GitHub.

Objetivos

  • Crear un repositorio en GitHub a partir de la plantilla indicada por el docente.
  • Configurar la estructura inicial del portafolio (carpetas, archivos y rutas).
  • Habilitar GitHub Pages para la publicación en línea.
  • Verificar la correcta visualización del sitio web.
  • Asegurar la trazabilidad de futuras prácticas en un entorno público y reproducible.

Actividades

  • Creación del repositorio en GitHub a partir del template entregado.
  • Clonación del repositorio en local para ajustes iniciales.
  • Configuración del archivo mkdocs.yml con título, navegación y secciones principales.
  • Creación de la carpeta docs/ y archivos base (index.md, portfolio/index.md).
  • Commit y push de la estructura inicial.
  • Configuración de GitHub Pages en la rama principal (main) para desplegar el sitio.
  • Verificación de la URL pública.

Desarrollo

La práctica comenzó creando el repositorio en GitHub a partir del template provisto.
Se verificó la estructura inicial de archivos y se adaptó el archivo mkdocs.yml para personalizar el título y la navegación básica.
Posteriormente, se crearon las carpetas necesarias (docs/portfolio, docs/UT1, etc.) para organizar futuras prácticas.

Se realizaron varios commits iniciales:
- Configuración del mkdocs.yml.
- Creación de la portada (index.md).
- Estructura del portafolio con su índice.

Finalmente, se habilitó GitHub Pages desde la rama main. Tras unos minutos, el sitio quedó desplegado en la URL:
👉 https://agustina-esquibel.github.io/Ingenieria-datos/

Evidencias

  • Captura del repositorio creado en GitHub.
  • Estructura inicial de carpetas (docs/, UT1/, portfolio/).
  • Captura de la página principal publicada en GitHub Pages.

Insights clave

  1. La configuración inicial del portafolio asegura un espacio unificado para documentar y compartir todas las prácticas.
  2. GitHub Pages permite publicar resultados de forma rápida y sin costo, lo que fomenta la transparencia y la reproducibilidad.
  3. El uso de mkdocs.yml facilita la organización y navegación entre prácticas, mejorando la experiencia del lector.

Reflexión

Aunque esta práctica no incluyó análisis de datos, fue crucial para sentar las bases de todo el curso.
Me permitió comprender la importancia de contar con un espacio organizado y reproducible para presentar resultados.
Además, reforzó la disciplina de trabajar con control de versiones (Git) y la ventaja de documentar en un sitio web accesible públicamente.
Este aprendizaje me prepara para futuras prácticas, donde la documentación clara será tan importante como los análisis técnicos.

⬅️ Volver a Unidad Temática 1
➡️ Ir a Práctica 3 – Dataset Netflix
📓 Índice del Portafolio