Usage ES

Guía de Uso

Aprende cómo usar Webpify CLI para convertir tus imágenes a formato WebP. Esta guía cubre todos los comandos y opciones disponibles.

📋 Tabla de Contenidos

• Modo Interactivo
• Opciones de Línea de Comandos
• Ejemplos de Uso
• Uso Avanzado
• Consejos y Buenas Prácticas

🖥️ Modo Interactivo

Ejecuta Webpify sin espacios para entrar en modo interactivo:

webpify

Nota: El modo interactivo no está disponible en Docker. Usa --auto o --input en su lugar.

⚙️ Opciones de Línea de Comandos

Entrada y Salida

--input "<ruta>"

Convierte automáticamente todas las imágenes en la carpeta especificada.

Descripción:

• Procesa todos los formatos de imagen soportados en el directorio
• Mantiene la estructura de carpetas en la salida
• Se puede combinar con el flag --output

Ejemplos:

webpify --input "ruta/a/imagenes"
webpify --input "./src/assets"
webpify --input "C:\Users\TuNombre\Imágenes"

--output "<ruta>"

Establece una carpeta personalizada para guardar las imágenes convertidas a WebP.

Descripción:

• Crea el directorio de salida si no existe
• Se puede combinar con:
  • --input
  • --auto
  • Modo interactivo

Ejemplos:

webpify --input "./imagenes" --output "./dist/webp"
webpify --auto --output "./optimizadas"
webpify --output "./exportar-webp"

Automatización

--auto

Convierte automáticamente todas las imágenes en el directorio actual sin mostrar el menú.

Descripción:

• Procesa todas las imágenes en el directorio actual de forma recursiva
• No requiere interacción del usuario
• Perfecto para pipelines CI/CD y procesamiento por lotes

Ejemplos:

webpify --auto
webpify --auto --output "./salida"

Localización

--es

Cambia el idioma de la interfaz a español.

Descripción:

• Cambia todo el texto del menú y los mensajes al español
• Se puede combinar con cualquier otro flag
• Afecta tanto la salida interactiva como la de línea de comandos

Ejemplos:

webpify --es
webpify --input "./imagenes" --es
webpify --auto --es

Información

--about

Muestra información sobre el autor y el proyecto Webpify.

webpify --about

Muestra:

• Información del autor
• Enlace al repositorio del proyecto
• Información de licencia
• Detalles de versión

--version o -V

Muestra la versión instalada actual de Webpify.

webpify --version
webpify -V

--help o -h

Muestra información de ayuda y todos los comandos disponibles.

webpify --help
webpify -h

💡 Ejemplos de Uso

Ejemplos Básicos

Convertir imágenes en una carpeta:

webpify --input "./fotos"

Convertir todas las imágenes en el directorio actual:

webpify --auto

Convertir imágenes de forma interactiva:

webpify

Ejemplos Intermedios

Convertir imágenes con salida personalizada:

webpify --input "./assets/imagenes" --output "./build/webp"

Procesamiento por lotes en modo automático:

webpify --auto --output "./dist/optimizadas"

Modo interactivo en español:

webpify --es

Ejemplos Avanzados

Procesar múltiples directorios:

# Procesamiento primer lote
webpify --input "./fotos/2024" --output "./dist/fotos/2024"

# Procesamiento segundo lote
webpify --input "./fotos/2023" --output "./dist/fotos/2023"

Pipeline automatizado CI/CD:

# En scripts/convertir-imagenes.sh
webpify --auto --output "./public/imagenes/webp"

🚀 Uso Avanzado

Combinando Flags

Puedes combinar múltiples flags en un solo comando:

# Conversión automática con salida personalizada en español
webpify --auto --output "./dist" --es

# Entrada con salida y español
webpify --input "./imagenes" --output "./webp" --es

Usando en Scripts

Script de Bash:

#!/bin/bash
echo "Convirtiendo imágenes..."
webpify --auto --output "./dist/imagenes"
echo "✅ ¡Conversión completada!"

💎 Consejos y Buenas Prácticas

Manejo de Rutas

✅ Haz esto:

# Usa comillas en rutas con espacios
webpify --input "ruta/con espacios/imagenes"

# Usa rutas relativas para portabilidad
webpify --input "./src/assets"

❌ Evita esto:

webpify --input ruta/con espacios/imagenes  # ❌ Fallará
webpify --input C:\ruta\absoluta\windows  # Específico de plataforma

Optimización de Rendimiento

• Usa --auto para procesamiento por lotes - Más rápido que modo interactivo
• Organiza carpetas eficientemente - Agrupa imágenes por tipo/tamaño
• Usa carpetas de salida dedicadas - Evita sobrescrituras accidentales
• Monitorea espacio de disco - Los archivos WebP son más pequeños pero necesitan espacio temporal

Preservación de Calidad

• Webpify optimiza automáticamente calidad/compresión
• Las imágenes originales nunca se modifican
• Todas las conversiones son no destructivas
• Verifica la calidad de salida antes de eliminar los originales

Buenas Prácticas de Automatización

# Bueno: Intención clara, fácil de depurar
webpify --input "./source/imagenes" --output "./dist/imagenes" --auto

# Con manejo de errores
webpify --auto --output "./dist/imagenes" && echo "✅ Éxito" || echo "❌ Falló"

⚠️ Notas Importantes

• Rutas con espacios: Siempre envuelve las rutas en comillas dobles (" ")
• Permisos de archivo: Asegúrate de tener permisos de lectura/escritura en carpetas origen y destino
• Limitación de Docker: El modo interactivo requiere una terminal; usa --auto o --input en su lugar
• Operaciones por lotes: Usa --auto para procesamiento más rápido en scripts
• Preservación de salida: Los archivos existentes se sobrescriben; usa directorios de salida separados por seguridad

🆘 ¿Necesitas Ayuda?

# Muestra todas las opciones disponibles
webpify --help

# Comprueba tu versión instalada
webpify --version

# Conoce más sobre el proyecto
webpify --about