SIstema de MArcado Estructural de Código Fuente
SIMAE es una herramienta de asistencia a la programación para desarrolladores con discapacidad visual, que brinda información contextual mediante el marcado de las estructuras contenidas en el código fuente.
- Descargar la versión más reciente en el apartado de "Releases" del proyecto.
- Ejecutar el archivo .jar.
- Descargar la versión más reciente en el apartado de "Releases" del proyecto.
- Desde una terminal, ejecutar el comando:
java -jar simae<version>.jar <nombreDelArchivoDeEntrada> [parámetros]
Parámetros posibles:
| Parámetro | Nombre completo | Descripción |
|---|---|---|
| [inputFile] | - | Input filename |
| -o | --out=outputFile | Output filename (default is inputFile) |
| -l | --locale=locale | Language used for tagging and messages |
| -u | --untag | Removes SIMAE tags from inputFile |
| -s | --sound | Plays a sound to indicate the result of the process (CLI only) |
| -g | --gui | Shows graphical interface |
| -h | --help | Displays this usage description |
| -v | --version | Version of SIMAE |
Ejemplo: java -jar simae-0.3.0.jar test.py
Desde la materia Algoritmos y Estructuras de Datos se utiliza el IDE Zinjai con las librerías de Windows. Por lo que se añade un instructivo para generar una macro de manera que el código se marque automáticamente con un botón o hotkeys.
- Guardar el jar en un lugar accesible
Se propone como paso cero guardar el .jar generado en el título anterior en C:\Simae o /home/simae con el nombre simae.jar de manera que se pueda acceder fácilmente en la configuración de la macro.
- Agregar hotkey
Dentro de las opciones desplegables en la parte superior:
Archivo->Preferencias...
- En las opciones de la izquierda presionar General
- Presionar Personalizar atajos de teclado
- En el buscador escribir "herramienta"
- Hacer click en el botón "..." a la derecha de "Herramientas -> Herramientas Personalizables -> 0
- Presionar las teclas que se quieran usar como hotkey (se recomienda la combinación Control + Shift + A)
- Presionar aceptar y no salir del menú preferencias
- Agregar al menú las herramientas
- En las opciones de la izquierda presionar Barras de herramientas.
- Activar la opción "Herramientas".
- Presionar modificar, buscar la opción "0:" y activarla si no está activada.
- Aceptar, Aceptar
- Agregar una "Herramienta personalizable"
Dentro de las opciones desplegables en la parte superior:
Herramientas->Herramientas Personalizables->Configurar (generales)...
Y para agregar la macro usamos esta configuración:
Nombre: simae
Comando: java -jar <DirecciónDeSIMAE> "${CURRENT_SOURCE}" "${CURRENT_SOURCE}"
Directorio de trabajo: vacio (no escribir nada)
Acción antes de ejecutar: Guardar el fuente actual
Ejecución asíncrona: NO
Salida (std y err): Ocultas
Acción luego de ejecutar: Recargar fuente actual
Mostrar en la barra de herramientas: SI
IMPORTANTE: reemplazar <DirecciónDeSIMAE> por la dirección donde se encuentra el software. En caso de cumplir el paso 0 será C:/simae/simae.jar o /home/simae/simae.jar
Finalmente, la macro se encuentra agregada al IDE.
- Instalar dependencias
sudo apt install git
sudo apt install openjdk-11-jre-headless
- Clonar proyecto
git clone https://github.com/TIFLO-SF/SIMAE
cd SIMAE
- Ejecutar build
gradle build
- Clonar proyecto
git clone https://github.com/TIFLO-SF/SIMAE
cd SIMAE
- Ejecutar run
gradle run
- Clonar proyecto
git clone https://github.com/TIFLO-SF/SIMAE
cd SIMAE
- Ejecutar shadowJar
gradle shadowJar
El jar se generará en simae/build/libs con el nombre simae-all
- Dentro de un terminal instalar Intellij Idea
sudo snap install intellij-idea-ultimate --classic
- Activar IntelliJ
- Clonar repositorio
git clone https://github.com/TIFLO-SF/SIMAE
cd SIMAE
- Dentro de IntelliJ ir a Open y seleccionar el proyecto
- Abrir proyecto como Gradle Project e indicar que se confía en el mismo.
- Dentro de IntelliJ ir a Add Configuration... y crear una configuración que ejecute el comando "clean run"
- Presionando el botón de play o shift+F10 compilar y ejecutar la herramienta
Una versión alpha está disponible para ser usada dentro de los releases de este repositorio. Se realiza un continuo mantenimiento del software.
Lineas de trabajo:
- Implementar integración continua.
- Traducción a otros lenguajes.
- Mejora de la CLI.
- Re-diseño de módulos de código para facilitar su desarrollo.
- Assenza T., Ballardini C., Marchetti P.A., Golobisky, M.F.. (2021, 13 de Agosto). Herramienta de Soporte para Programadores con Discapacidad Visual mediante el Marcado de Código Fuente. IEEE Xplore. https://ieeexplore.ieee.org/abstract/document/9505334/
- Google group: https://groups.google.com/g/tiflosf-simae