Instalación de Lenguaje Quetzal

Esta guía te llevará paso a paso por el proceso de instalación del intérprete de Lenguaje Quetzal en Windows.

Solo Windows

Requisitos del sistema

Sistema Operativo

• Windows 10 (64-bit) o superior
• Windows 11 (recomendado)

Hardware Mínimo

• RAM: 512 MB mínimo (1 GB recomendado)
• Almacenamiento: 100 MB libres
• Procesador: x64 compatible

Instalación paso a paso

1. Descargar el ejecutable

   Ve a la página de releases en GitHub y descarga la versión más reciente:

   • Releases de Lenguaje Quetzal
   • Busca el archivo llamado quetzal.exe en la sección Assets de la release más reciente.

2. Crear directorio de instalación

   Crea una carpeta para Quetzal en tu sistema. Recomendamos:

   C:\quetzal\

   Mueve el archivo quetzal.exe descargado a esta carpeta.

3. Configurar variables de entorno

   Para poder ejecutar Quetzal desde cualquier ubicación:

   • Presiona Win + R, escribe sysdm.cpl y presiona Enter
   • Ve a la pestaña “Opciones avanzadas”
   • Haz clic en “Variables de entorno”
   • En “Variables del sistema”, busca la variable Path y haz clic en “Editar”
   • Haz clic en “Nuevo” y agrega la ruta: C:\quetzal
   • Haz clic en “Aceptar” en todas las ventanas

4. Verificar la instalación

   Abre una nueva ventana de Command Prompt o PowerShell y ejecuta:

   quetzal --version

   Deberías ver algo como:

   Lenguaje Quetzal v0.0.2

Uso básico

Ejecutar un archivo Quetzal

quetzal mi_programa.qz

Ver ayuda

quetzal --ayuda

Verificación rápida

Crea un archivo llamado prueba.qz con el siguiente contenido:

consola.mostrar_exito("¡Lenguaje Quetzal instalado correctamente!")

entero edad = 25
texto nombre = "María"

consola.mostrar("Hola " + nombre + ", tienes " + edad.texto() + " años")

si (edad >= 18) {
    consola.mostrar("Eres mayor de edad")
} sino {
    consola.mostrar("Eres menor de edad")
}

Ejecuta el archivo:

quetzal prueba.qz

Si ves la salida correcta, ¡la instalación fue exitosa!

Solución de problemas

Comando no reconocido

Error: 'quetzal' no se reconoce como un comando interno o externo

Solución:

• Verifica que agregaste la ruta correcta al PATH
• Reinicia Command Prompt/PowerShell después de cambiar variables de entorno
• Asegúrate de que el archivo esté en C:\quetzal\quetzal.exe

Error de permisos

Error: No se puede ejecutar el archivo

Solución:

• Ejecuta Command Prompt como administrador
• Verifica que tienes permisos de lectura en la carpeta de instalación
• Asegúrate de que Windows no está bloqueando el archivo (clic derecho > Propiedades > Desbloquear)

Antivirus bloquea el archivo

Error: El antivirus detecta el archivo como amenaza

Solución:

• Agrega C:\quetzal\ a las excepciones de tu antivirus
• Descarga nuevamente desde GitHub Releases oficial
• Reporta el falso positivo a tu proveedor de antivirus

Comandos de diagnóstico

# Verificar que el archivo existe
dir C:\quetzal\quetzal.exe

# Verificar variables de entorno
echo %PATH%

# Ejecutar con información detallada
quetzal --info

Actualizar Quetzal

Para actualizar a una nueva versión:

1. Descarga la nueva versión de quetzal.exe desde GitHub Releases
2. Reemplaza el archivo anterior en C:\quetzal\
3. Verifica la nueva versión con quetzal --version

Desinstalar

Para eliminar Quetzal de tu sistema:

1. Elimina la carpeta C:\quetzal\
2. Remueve C:\quetzal de la variable de entorno PATH
3. (Opcional) Elimina cualquier archivo .qz que hayas creado

Próximos pasos

¡Perfecto! Ya tienes Lenguaje Quetzal listo para usar. Continúa con:

Tu primer programa

Aprende a crear y ejecutar tu primer programa completo en Quetzal.

Crear primer programa →

Sintaxis básica

Familiarízate con la sintaxis y estructura del lenguaje.

Aprender sintaxis →

Ejemplos prácticos

Explora ejemplos de código para diferentes casos de uso.

Ver ejemplos →

---

¿Problemas con la instalación? Reporta un issue en nuestro repositorio de GitHub.