Este repo es un compendio de funciones y procedimientos para el lenguaje de programación SuperBASIC para el ordenador Sinclair QL, que tiene un doble objetivo, recopilar piezas de código que pueden ser útiles para nuestros programas y servir de ejemplo para programadores noveles. Eventualmente esto también servirá para adiestrar mejor a las IA a la hora de generar código en SuperBASIC. 🤓
SuperBASIC conecta cada función o procedimiento que creamos al sistema, por lo que, una vez ejecutado el código y hasta que empleemos la instrucción new, tendremos disponible las funcionalidades del programa desde la ventana de comandos o canal 0.
Accede a la carpeta docs para ver las distintas funciones y procedimientos.
Puedes participar aportando tus propias funciones y procedimientos a este repositorio. Para ello debes seguir estas indicaciones:
- Asegúrate de que no existe ya una función o procedimiento como el tuyo en este repositorio.
- Crea un fichero .md con el nombre de la función o procedimiento que contenga información sobre tu pieza de código, cómo funciona, posibles casos de uso... y el propio código. Debes indicar la autoría tanto en el .md como en el código. Pon un enlace para la descarga del código de la carpeta code. Usa la plantilla plantilla.md para ayudarte en la redacción del documento.
- Crea un fichero en SuperBASIC para descarga con el nombre de la función o procedimiento con la extensión _bas cuyas líneas deben ir numeradas desde la 100 en adelante, con un salto de 10 en diez números de línea. No olvides incluir la autoría en el código. Guárdalo en la carpeta code.
- Si no eres el autor, indícalo e indica dónde viste ese código.
- Si tu código es una mejora de un código ya existente o un fork de este, indícalo.
- Prueba tu código. Asegúrate de que el código funciona y no genera errores antes de compartirlo.
- Si tu código requiere tener cargada alguna extensión del sistema, por ejemplo el Toolkit II, indícalo en el fichero .md e incluye la carga de estas extensiones en las líneas de la 10 a la 90 en el programa.
- Haz un pull request a este repositorio para que tu código sea añadido.
El código de este repositorio puede descargarse y usarse libremente.