Crear un archivo de inicio para Emacs desde Org

Tangle es el nombre con que en Org se conoce la acción de extraer el contenido de uno (o varios) bloques de código y de generar con ese material los ficheros necesarios que incorporen el tipo de extensión según el lenguaje de código. Naturalmente, podemos controlar muchos parámetros a nivel global o ajustados a cada bloque: el nombre del archivo resultante (por defecto, será el mismo que el del archivo *.org contenedor, pero con la nueva extensión), el directorio donde se ubicará, si exportamos el contenido de nuestro documento Org como comentarios al código generado, etc.

La acción org-babel-tangle (C-c C-v t) se ejecuta sobre la totalidad de nuestro fichero Org, y rastreará todos los bloques de código que éste contenga. Pero para que sean debidamente «entrelazados», debemos añadir el header-argument :tangle yes o :tangle nombre-de-archivo-resultante (si queremos que sea uno distintinto al de nuestro *.org), ya que esta funcionalidad no viene activa por defecto. Si todos los bloques que tenemos en el archivo pertenecen a un mismo lenguaje de programación, se creará un sólo fichero fuente. Si deseamos evitar la inclusión de algún bloque, simplemente indicaremos el header-argument :tangle no en su lugar correspondiente. Para lo que aquí nos ocupa, la creación de un archivo de configuración de Emacs, partiremos de un único archivo Org.

En principio, es indiferente qué nombre le demos y dónde ubicarlo, aunque por convención no estaría de más situarlo en el directorio ~/.emacs.d/. Podemos, también, albergarlo en un repositorio Git y crear un archivo simbólico que apunte a él. Eso ya al gusto de cada cuál. En cuanto al nombre, el mío se llama mi-emacs-conf.org, y sólo consta de esta simple cabecera:

#+TITLE:Archivo de configuración general para Emacs
#+AUTHOR: Juan Manuel Macías
#+PROPERTY: header-args :tangle yes :comments org

Las dos primeras líneas también son por seguir la convención. La que realmente tiene efecto es la tercera, donde añado dos header-arguments a nivel global: la activación de la propiedad tangle y la que pasa el contenido textual de mi documento Org a comentarios en el archivo fuente de salida. A partir de ahí, sólo queda ir escribiendo como en cualquier otro archivo Org, con nuestros habituales encabezados y sub-encabezados, texto, enlaces, notas al pie, etc. Si se nos antoja, podemos meter hasta un poema. Lo importante, claro, es ir entreverando aquí y allá los bloques de código que precisamos. Podemos también añadir lemas TODO a nuestros encabezados, algo muy práctico para código por añadir o aquél que aún se encuentra en fase de trasteo. Nos quedará, en fin, un documento bastante legible y, sobre todo, ordenado y navegable (el aspecto que tiene el mío se puede apreciar en la fig. 1).

Ahora bien, hemos dicho más arriba que para generar el archivo de configuración (en este caso, se generará uno en el mismo directorio con el nombre de nuestro documento Org y la extensión *.el), es necesario invocar la función org-babel-tangle. ¿Tenemos que hacerlo cada vez que añadamos contenido a nuestro archivo Org o lo modifiquemos? Veremos en el siguiente apartado que podemos desentendernos sin problemas de eso.

Para que esto sea posible, debemos conservar un archivo ~/.emacs, pero esta vez con un contenido mínimo. Basta con que se incluyan allí las siguientes líneas² (la primera es necesaria si usamos package.el como gestor de paquetes y actualizaciones):

(package-initialize)

(setq custom-file "~/.emacs.d/mi-emacs-conf.el")
(when (file-exists-p custom-file) (load custom-file))

(require 'org)
(org-babel-load-file
 (expand-file-name "mi-emacs-conf.org"
                   user-emacs-directory))

Una vez hecho esto, Org-Babel regenerará nuestro archivo de configuración mi-emacs-conf.el cada vez que iniciemos Emacs.