====== espanso ======

Herramienta de sustitución de texto (//text expansion//)

<WRAP center round info 60%>
Una herramienta de sustitución de texto (//text expander//) detecta cuándo escribes una palabra (o sucesión de caracteres) en concreto y la reemplaza por otra cosa.
</WRAP>


  * [[https://espanso.org/|Web oficial]]
  * [[https://github.com/federico-terzi/espanso|Repositorio oficial]] (GitHub)
  * [[https://espanso.org/docs/get-started/|Documentación oficial]]

Versión para Linux, Windows y macOS

===== Uso =====

Lanzamos el demonio:

<code>
espanso start
</code>

<WRAP center round info 60%>
En Windows, en la versión portable, espanso se ejecuta a través del fichero ''START_ESPANSO.bat''.
</WRAP>


Podemos verificar que está funcionando con:

<code>
espanso status
</code>

==== Configuración ====

  * Linux: ''$HOME/.config/espanso''
  * Windows: ''%APPDATA%\espanso''

<WRAP center round info 60%>
En la versión portable de Windows, la configuración se guarda en el directorio ''.espanso''
</WRAP>


En el fichero ''match/base.yml'' añadimos las reglas de sustitución:

<code yaml>
matches:
  - trigger: ":saludo"
    replace: "Muy buenas, amigos,"
</code>

Cuando escribamos '':saludo'', **espanso** lo sustituirá automáticamente por //Muy buenas, amigos,//

Si queremos escribir varias líneas, lo más cómodo es usar la siguiente sintaxis:

<code yaml>
  - trigger: ":lineas"
    replace: |
      Esto es una línea,
      y esta otra,
      y otra más
</code>

Si queremos que el cursor se coloque en una determinada posición tras la sustitución utilizaremos ''$|$'':

<code yaml>
  - trigger: ":sql"
    replace: |
      SELECT $|$
      FROM 
</code>

Al escribir '':sql'', **espanso** lo sustituirá por el texto indicado y colocará el cursor después de ''SELECT''.
==== Instalación de paquetes ====

Podemos instalar fácilmente configuraciones creadas por otros usuarios y disponibles desde https://hub.espanso.org/.

Para instalar:

<code>
espanso install <NOMBRE_PAQUETE>
</code>

Y reinicamos espanso:

<code>
espanso restart
</code>

Por ejemplo, el paquete de emojis:

<code>
espanso install all-emojis
espanso restart
</code>

==== Deshabilitar temporalmente ====

Si queremos alternar entre la ejecución o pausa de espanso, pulsamos dos veces seguidas la tecla <key>A</key>. Veremos una notificación que nos indicará el estado de espanso.

==== Múltiples líneas ====

Si queremos hacer una sustitución por un texto que ocupa varias líneas:

<code yaml>
- trigger: ":test"
    replace: |
      test
      multiline
      and
      another line
</code>

  * [[https://espanso.org/docs/matches/|Matches]] (documentación oficial de espanso)

==== Search bar ====

Espanso incluye una barra de búsqueda para buscar rápidamente, e insertar, tus coincidencias (//matches//).

Para abrirla, hay dos formas:

  * <kbd>A-Espacio</kbd>
  * Pulsando en el icono de espanso, en la barra de tareas, y eligiendo **Open search bar** (no disponible en Linux)

Si queremos personalizar el atajo de teclado para abrirla, editaremos el fichero ''config/default.yml'':

<code yaml>
search_shortcut: ALT+SHIFT+SPACE
</code>

  * [[https://espanso.org/docs/configuration/options/#customizing-the-search-shortcut|Listado de teclas soportadas]]