Un snippet ejemplar

Este es el primer snippet diseñado para automatizar el encabezado de las paginas hechas en restructuredText, para facilitarme la escritura de este blog. Hay mucha ayuda en la página de Capitao Morte (supongo que es su autor).

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

# -*- mode: snippet; require-final-newline: nil -*-
# name: encabezado
# key: enc
# expand-env: ((yas-indent-line 'fixed))
# --

:---
title: "${1:titulo}"
:date: ${2:2014}-{3:10}-{4:31} {5:10:00}
:category: ${6:$$(yas-choose-value '("blog" "politica" "salud" "tecnicismos"))}
:tags: $7
---
:author: Diego Efe
:excerpt: $1

$0

En la linea 14 la instrucción $0 se agregó porque en algún lado decía que suele ponerse para indicar el lugar de salida cuando se termina de ejecutar el snippet.

La linea 4 está para que la indentación aparezca correcta al ejecutarse el snippet, ya que sin esta linea aparecían unas tabulaciones erróneas.

¿Dónde guardar el archivo?

No conviene guardar el snippet nuevo en el directorio donde se almacena automáticamente el paquete yasnippets porque al actualizar este paquete se perderá nuestra creación.

Se puede verificar el valor de la variable donde se almacenan los directorios para los snippets personalizados mediante M-x customize-variable yas-snippet-dirs).

Para agregar un directorio personal al lugar donde Emacs busca los snippets, podemos colocar el siguiente código:

1
2

(setq yas-snippet-dirs (append yas-snippet-dirs
                               '("~/directorio-equis/snippets")))

Dentro de ese directorio se deberán organizar los nuevos snippets siguiendo la estructura de un subdirectorio para alojar los que correspondan a cada modo:

snippets/markdown-mode

snippets/org-mode

snippets/rst-mode

Por lo tanto, para mi ultra magnífico snippet de restructuredText, corresponde guardarlo así (sin ninguna extensión):

~/directorio-equis/snippets/rst-mode/encabezado

Números de linea (rst-mode)

• debajo del .. code-block:: se debe incluir la directiva :linenos:. No se si es un bug, pero esa directiva debe estar alineada con la palabra code para que funcione, y todo el bloque de código debe también respetar esta alineación. Para tabular un bloque de texto manteniendo las indentaciones que ya tiene se puede usar M-x indent-rigidly.
• el nombre del lenguaje en .. code-block:: parece que debe ir en minúsculas, para que sea reconocido y funcione el coloreado con pygments. En el caso de restructuredText la palabra clave que funcionó (por prueba y error) es rest. (Editado: luego encontré la página con los "lexers" válidos: Available lexers, y vi que también eran válidos rst y restructuredtext).