Update documentation scripts and workflows

Author: GitHub Actions

.github/scripts/build_docs.py

@@ -0,0 +1,67 @@
+#!/bin/bash
+
+# Script para ejecutar el proceso de copia de documentación de hardware
+# Ubicación: .github/scripts/build_docs.sh
+# Uso: .github/scripts/build_docs.sh
+
+set -e  # Salir si hay algún error
+
+echo " Iniciando construcción de documentación..."
+
+# Obtener la ruta del directorio del proyecto (3 niveles arriba desde .github/scripts)
+PROJECT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+cd "$PROJECT_DIR"
+
+echo " Directorio del proyecto: $PROJECT_DIR"
+
+# Verificar que Python está disponible
+if ! command -v python3 &> /dev/null; then
+    echo " Python3 no está instalado"
+    exit 1
+fi
+
+# Crear directorio temporal para el entorno virtual
+TEMP_VENV=$(mktemp -d)
+echo " Creando entorno virtual temporal en: $TEMP_VENV"
+
+# Crear entorno virtual
+python3 -m venv "$TEMP_VENV"
+
+# Activar entorno virtual
+echo " Activando entorno virtual..."
+source "$TEMP_VENV/bin/activate"
+
+# Instalar dependencias
+echo " Instalando dependencias..."
+pip install --upgrade pip --quiet
+pip install Jinja2 --quiet
+
+# Ejecutar script de copia
+echo " Ejecutando script de copia..."
+python3 .github/scripts/copy_hardware_docs.py
+
+# Limpiar entorno virtual temporal
+echo " Limpiando entorno virtual temporal..."
+deactivate
+rm -rf "$TEMP_VENV"
+
+# Verificar que los archivos se generaron correctamente
+if [ -f "docs/index.html" ]; then
+    echo " Documentación generada exitosamente!"
+    echo " Archivos generados:"
+    echo "   - docs/index.html (página principal)"
+    echo "   - docs/hardware/ (archivos copiados)"
+    
+    # Mostrar estadísticas
+    if [ -d "docs/hardware" ]; then
+        file_count=$(find docs/hardware -type f | wc -l)
+        echo " Total de archivos copiados: $file_count"
+    fi
+    
+else
+    echo " Error: No se pudo generar la documentación"
+    exit 1
+fi
+
+echo " ¡Proceso completado!"
+echo " Para ver la documentación, abre docs/index.html en tu navegador"

.github/scripts/build_docs.sh

@@ -0,0 +1,54 @@
+#!/bin/bash
+
+# Script para limpiar archivos generados de documentación
+# Ubicación: .github/scripts/clean_docs.sh
+# Uso: .github/scripts/clean_docs.sh
+
+set -e  # Salir si hay algún error
+
+echo " Limpiando documentación generada..."
+
+# Obtener la ruta del directorio del proyecto (3 niveles arriba desde .github/scripts)
+PROJECT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+cd "$PROJECT_DIR"
+
+echo " Directorio del proyecto: $PROJECT_DIR"
+
+# Verificar que el directorio docs existe
+if [ ! -d "docs" ]; then
+    echo "  Directorio docs no existe, no hay nada que limpiar"
+    exit 0
+fi
+
+# Eliminar todo el contenido del directorio docs excepto archivos específicos
+echo " Eliminando contenido del directorio docs..."
+
+# Contar archivos antes de limpiar
+files_before=$(find docs -type f | wc -l)
+dirs_before=$(find docs -type d | wc -l)
+
+# Eliminar todos los archivos y subdirectorios generados
+# Mantener solo: .gitkeep, README.md (si existen)
+find docs -mindepth 1 -maxdepth 1 ! -name ".gitkeep" ! -name "README.md" -exec rm -rf {} +
+
+# Contar archivos después de limpiar
+files_after=$(find docs -type f | wc -l)
+dirs_after=$(find docs -type d | wc -l)
+
+# Mostrar estadísticas
+files_deleted=$((files_before - files_after))
+dirs_deleted=$((dirs_before - dirs_after))
+
+echo "  Eliminados: $files_deleted archivo(s) y $dirs_deleted directorio(s)"
+
+# Verificar el estado final
+if [ -d "docs" ]; then
+    remaining_files=$(find docs -mindepth 1 -type f ! -name ".gitkeep" ! -name "README.md" | wc -l)
+    if [ "$remaining_files" -eq 0 ]; then
+        echo " Directorio docs limpiado completamente"
+    else
+        echo "ℹ  Quedan $remaining_files archivo(s) protegidos en docs"
+    fi
+fi
+
+echo " Limpieza completada!"