En un principio, instalando el paquete yasnippet sería suficiente. Sin embargo, recomiendo instalar algunos paquetes auxiliares que nos facilitarán el uso de snippets:

• yasnippet, proporciona la funcionalidad principal.
• yasnippet-snippets, proporciona una larga lista de snippets para multitud de modos y lenguajes de programación.
• ivy-yassnipet, proporciona integración de yasnippet con ivy. También existe un paquete helm-yasnippet, si utilizas helm para proporcionarte menús interactivos.

La instalación de los paquetes es la habitual. Por ejemplo, para el principal de yasnippet:

M-x package-install <RET> yasnippet

Con eso ya tendríamos toda la funcionalidad de los snippets, pero no adelantamos nada si no tenemos plantillas que utilizar. Tenemos que crearlas, lo que puede ser un trabajo arduo y aburrido haciéndolo desde cero. Para ahorrarnos ese tedioso trabajo, el paquete yasnippet-snippets nos proporciona decenas (si no, cientos), de plantillas ya preparadas y revisadas para multitud de modos. Incluso, para aquellos que no utilizas, por lo que el paquete ocupará más espacio en disco del estrictamente necesario, aunque no tanto como para que te debas preocupar por ello.

En cualquier momento, podemos consultar qué snippets tenemos disponibles según el modo en el que estemos con el comando

M-x yas-describe-tables

No es necesario que nos aprendamos toda la tabla, pero si trabajamos habitualmente con este sistema podemos aprendernos el key del snippet y luego utilizar el comando yas-expand (que yo lo tengo mapeado a la combinación s-y, luego explicaré cómo). Con eso sólo, es decir, tecleando el key y una combinación de teclas nos expandirá toda la plantilla. Nos podremos mover por los puntos de tabulador pulsando <TAB> para ir hacia adelante y <S-TAB> para ir hacia atrás, como ya vimos antes.

Ahora que tenemos instalado el modo, vamos a configurarlo un poco.

Al activar el modo yasnippet por defecto nos activa tres combinaciones de teclas para lanzar sus comandos principales. Figuran en la tabla del apartado anterior. Esos tres comandos son:

• Crear un snippet (C-c & C-n)
• Editar un snippet que ya existe (C-c & C-v)
• Insertar en el buffer de edición un snippet (C-c & C-s)

Por supuesto, si utilizas estas funciones de manera habitual, sería buena idea cambiar la combinación de teclas por algo más sencillo y rápido de teclear. En mi caso las he dejado así porque normalmente utilizo la funcionalidad de ivy-yasnippet o la expansión directa de la clave (las pocas que me sé).

Vamos a ver cómo es un snippet por dentro par hacernos una idea. Por ejemplo, si tecleamos:

C-c & C-v current-date

nos abrirá un buffer con el siguiente contenido

# -*- mode: snippet -*-
# name: current-date
# key: dd
# contributor : Kristof Molnar-Tatai <kristof.mlnr@gmail.com>
# --
`(format-time-string "%Y-%m-%d")`       

De ese código podemos extraer alguna información interesante:

• Los ficheros que guardan los snippets se suelen guardar sin extensión, por eso se añade la primera línea de mode seguida de la cabecera del mismo que está dividida en etiquetas o campos.
• La cabecera se separa del texto del snippet mediante la línea # --
• Se pueden introducir formas lisp que devuelvan una cadena.

Para ilustrarlo mejor, vamos a crear un nuevo snippet. Imagina que tienes que hacer muchos informes psicológicos, como puede ser mi caso, sobre los tests que van haciendo los clientes y el encabezado de todos ellos es muy similar o repetitivo, por lo que decides crear una plantilla de encabezado para incrustarla cuando escribes tus informes con Emacs.

Al pulsar C-c & C-n nos abrirá un buffer con el siguiente contenido:

# -*- mode: snippet -*-
# name:
# key:
# --

El cursor aparece en la línea # name:. Atentos, porque lo que hace es crear un buffer y añadir un snippet con la estructura del mismo. Lo único que tenemos que hacer es rellenar los datos y avanzar pulsando <TAB>.

Para no liarme mucho más con las explicaciones muestro el contenido final y luego lo explicamos:

# -*- mode: snippet -*-
# name: informe-cabecera
# key: inf-cab
# --
INFORME que realiza /D. Fulanito de Tal/ con D.N.I. nº 123456789Z
sobre los resultados obtenidos en la prueba ${1:test psicológico}
por D/ña. ${2:Menganito de Cual}, con D.N.I. nº ${3:987654321A}, a
petición del interesado.

El texto es lo de menos, puede ser cualquier otro, lo importante es que nos fijemos dónde lo guarda yasnippet. Por defecto, al hacerlo nos sugerirá un directorio llamado:

~/.emacs.d/snippets/[nombre-del-modo]

En el caso anterior, lo queremos para hacer es tener un snipper para insertar una cabecera. En la mayoría de los casos lo único que cambiará será el test que se pasó y los datos, el nombre y el DNI, del cliente:

• ${1:test psicológico}
• ${2:Menganito de Cual}
• ${3:987654321A}

Como se puede apreciar, las paradas de tabulador se denotan por ${...}. En este caso se han tenido en cuenta textos por defecto, pero los campos podrían haber sido, por ejemplo ${1:}. No hay necesidad de incluir ese texto, con los números es suficiente para establecer las paradas, pero puede venir muy bien cuando además hay algún contenido frecuente, para ahorrar aún más tecleos.

Por último, si ya tenemos nuestro snippet creado y lo que queremos es cambiar o corregir algún aspecto de él, utilizaremos la combinación C-c & C-v o utilizaremos el comando M-x yas-visit-snippet-file para modificarlo.

Esta es una entrada cortita, porque esta herramienta es muy sencilla de utilizar, pero con una gran utilidad, especialmente para programación. Nos ahorrará bastante trabajo de escritura repetitiva, aparte de evitar errores tontos como meter «;» donde corresponde «:» en una expresión y que el programa tarde un poco más en compilar, dándonos de cabezazos hasta descubrir el sutil error de tecleo.

Para otros menesteres nos viene bien para introducir algunos tipos de información repetitiva en textos. No lo suelo utilizar en org-mode, pero sí me es muy útil en html para no olvidarme de cerrar ninguna etiqueta. Cada uno decidirá cómo puede adecuar la herramienta a su modo de trabajar, cuándo le es útil y cuando no.