Idioma

Ver el código de Configuración de mads con vscode

Este pequeño apunte te guiara en instalar el editor visual studio code con el ensamblador más famoso de atari MADS

===Software necesario===

  1. ((https://mads.atari8.info MADS)) (Ensamblador ATARI)
  2. ((https://atari800.github.io Atari800)) y ((http://www.virtualdub.org/altirra.html Altirra)) (Emuladores)
  1. ((https://code.visualstudio.com Visual Studio Code)) (Editor versátil y liviano)
  1. ((https://git-scm.com Git)) (si quieres trabajar con control de versiones)
 
===Instalación===

  * **Mads :** Se descomprime la carpeta en un directorio por ejemplo C:/MADS para ((https://github.com/tebe6502/Mad-Assembler/releases Windows)), en Linux deberás ((/Guías/Compilarmadsenlinux compilar)).
  * **VSCode :** Se baja el instalador ya sea para Windows, Mac o Linux.
  * **Git :** También se baja el instalador para Windows, Mac o Linux.

===Configuraciones===

Una vez instalado el vscode, vamos a agregar una extensión para colorear la sintaxis del código

((https://www.atariware.cl/archivos/mads/vsc01.png))

Para ello hacemos clic en el icono de extensiones (!!1!!) después escribimos MADS en la caja de texto de búsqueda de extensiones (!!2!!) y por ultimo clic en instalar (!!3!!). Cuando se instala se cambiara la palabra instalar por un icono de engranaje.

Ahora veremos cómo configurar el ensamblador y emulador con tareas centro de nuestro proyecto en vscode, dentro de un nuevo proyecto

((https://www.atariware.cl/archivos/mads/vsc02.png))

Para crear la tarea "no olvide estar en un directorio de trabajo" nos vamos al menú principal en **Terminal**  > **Configure Tasks** o presionamos **CONTROL+SHIFT+B**

((https://www.atariware.cl/archivos/mads/vsc03.png))

Como se ve nos dará una opción en la caja de texto a escoger que no existe tarea creada la pinchamos, después nos tirara otra pregunta si queremos usar la plantilla base la marcamos y por ultimo nos preguntara el tipo y seleccionamos la última que es otras para ejecutar comandos externos al vscode.

((https://www.atariware.cl/archivos/mads/vsc04.png))

La tarea creada quedara dentro de nuestro proyecto en el directorio .vscode y el archivo tasks.json que es donde se configura los comandos externos a ejecutar. El ejemplo que hace automático es un mensaje hola, en consola lo puede ejecutar la tarea con **CONTROL+SHIFT+B**

Ahora viene lo importante que es agregar el mads y los emuladores a la tarea, que sería copiar y pegar este código. Importante si usa otras rutas tiene que agregarlas.

%%(hl javascript) {
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Compiler Mads",
            "type": "shell",
            "command": "mads",
            "args": [ "${file}","-o:${fileBasenameNoExtension}.xex","-l:${fileBasenameNoExtension}.lst","-ml:100","-v"],
            "problemMatcher": []
        },{
            "label": "Run Atari800",
            "type": "shell",
            "command": "atari800",
            "args": [ "${fileBasenameNoExtension}.xex"],
            "problemMatcher": []
        },{
            "label": "Run Altirra",
            "type": "shell",
            "command": "wine",
            "args": [ "/opt/Altirra/Altirra64.exe","${fileBasenameNoExtension}.xex"],
            "problemMatcher": []
        },{
            "label": "Run Altirra Win",
            "type": "shell",
            "command": "C:/Program Files/Altirra/Altirra64.exe",
            "args": [ "${fileBasenameNoExtension}.xex"],
            "problemMatcher": []            
        }
    ]
}%%
Explicación rápida etiqueta **label :** nombre de la tarea para vscode, **type :** tipo de comando consola, **command :** ejecutable a ejecutar, **args :** argumentos de entrada del ejecutable. Recordar si tiene configurado los path bien en el sistema operativo que usa no tiene necesitabas de poner la ubicación a mano del programa a ejecutar.
%%(info type="note" title="Muy importante")
  * Para Windows agrege el **mads.exe** en el directorio en **C:\Windows**
  * Para Linux agregar el **mads** en el directorio **/usr/bin/**
%%
===Teclas rápidas===

Ahora vamos asignar las tareas al presionar una combinación de teclas para ello presionamos **CONTROL+K+S** para que aparezca la configuración de teclas del vscode

((https://www.atariware.cl/archivos/mads/vsc05.png))

Hacemos clic en el icono de la hoja

((https://www.atariware.cl/archivos/mads/vsc06.png))

Nos aparecerá una página en blanco para agregar en json nuestra configuración personalizada, copiamos y pegamos 
%%(hl javascript)[
    {
        "key": "ctrl+alt+4",
        "command": "workbench.action.tasks.runTask",
        "args": "Run Altirra Win"
    },{
        "key": "ctrl+alt+3",
        "command": "workbench.action.tasks.runTask",
        "args": "Run Altirra"
    },{
        "key": "ctrl+alt+2",
        "command": "workbench.action.tasks.runTask",
        "args": "Run Atari800"
    },{
        "key": "ctrl+alt+1",
        "command": "workbench.action.tasks.runTask",
        "args": "Compiler Mads"
    }
]%%

  * Ahora ya puede ensamblar con **CONTROL+ALT+1** para Linux y Windows
  * Ejecutar atari800 con **CONTROL+ALT+2** para Linux.
  * Ejecutar altirra con **CONTROL+ALT+3** para Linux. 
  * Ejecutar altirra con **CONTROL+ALT+4** para Windows.

Si compilamos y ejecutamos con altirra deberías ver lo siguiente en el emulador

((https://www.atariware.cl/archivos/mads/vsc07.png))