Entrada de Familiarización - Proyecto inicial¶
📖
Tiempo de lectura: ~2 min
(387 palabras)
Contexto¶
Primera actividad práctica del curso de Ingeniería de Datos, diseñada para familiarizarse con las herramientas y metodologías que utilizaremos durante todo el semestre. Esta entrada marca el inicio del portfolio académico que documentará mi progreso y aprendizajes.
Objetivos¶
- Configurar correctamente el entorno de desarrollo local con MkDocs y Python
- Familiarizarme con el flujo de trabajo Git y GitHub Pages
- Establecer la estructura base del portfolio académico
Actividades (con tiempos estimados)¶
- Configurar el repositorio y entorno local — 45 min
- Instalar dependencias (MkDocs, Material Theme) — 15 min
- Crear estructura de directorios y archivos base — 30 min
- Configurar GitHub Actions para despliegue automático — 20 min
- Personalizar tema y estilos — 40 min
- Crear primera entrada de prueba — 30 min
- Documentar proceso y reflexionar — 20 min
Total estimado: 3 horas
Desarrollo¶
Configuración del Entorno¶
- Creación del repositorio en GitHub con nombre
portafolio_ia_ucu
- Clonado local y configuración de Git
- Instalación de MkDocs Material y plugins necesarios
📁 Estructura del Proyecto¶
portafolio_ia_ucu/
├── docs/
│ ├── index.md # Página principal
│ ├── acerca.md # Información personal
│ ├── recursos.md # Enlaces útiles
│ ├── assets/ # Imágenes y recursos
│ └── portfolio/ # Entradas del portfolio
├── mkdocs.yml # Configuración del sitio
└── requirements.txt # Dependencias Python
Personalización¶
- Tema Material con colores personalizados
- Logo personalizado con iconos seleccionados
- Navegación optimizada con secciones claras
- Favicon personalizado para identidad visual
- Diseño responsive para múltiples dispositivos
Despliegue Automático¶
- Configuración de GitHub Actions
- Despliegue automático en GitHub Pages con cada push
- URL final:
https://valerodma.github.io/portafolio_ia_ucu/
Evidencias¶
- Repositorio funcionando: GitHub Repository
- Sitio web desplegado: Portfolio en vivo
- Entorno local configurado: Servidor de desarrollo en
http://127.0.0.1:8000
- Workflow de GitHub Actions: Despliegue automático funcionando
- Estructura base completa: Todas las secciones principales creadas
Reflexión¶
Lo más valioso¶
- Herramientas profesionales: MkDocs Material, me permite obtener un portfolio profesional.
- Base sólida: La estructura creada servirá para todo el curso
Lo más desafiante¶
- Configuración inicial de dependencias: Resolver conflictos de versiones de Python
- GitHub Actions debugging: Entender los errores de despliegue y modo strict
- Personalización de CSS: Lograr el diseño deseado sin romper el diseño responsive de la web
- Gestión de rutas: Resolver problemas de paths