Los nombres de los días y de los meses se establecen en dos variables cada uno, una con el formato abreviado y otra con el nombre completo.

• calendar-day-header-array ... "Do", "Lu", etc.
• calendar-day-name-array ... "domingo", "lunes", etc.
• calendar-month-abbrev-array ... "Ene", "Feb", etc.
• calendar-month-name-array ... "enero", "febrero", etc.

(setq calendar-day-header-array ["Do" "Lu" "Ma" "Mi" "Ju" "Vi" "Sá"])
(setq calendar-day-name-array ["domingo" "lunes" "martes" "miércoles" "jueves" "viernes" "sábado"])
(setq calendar-month-abbrev-array ["Ene" "Feb" "Mar" "Abr" "May" "Jun" "Jul" "Ago" "Sep" "Oct" "Nov" "Dic"])
(setq calendar-month-name-array ["enero" "febrero" "marzo" "abril" "mayo" "junio" "julio" "agosto" "septiembre" "octubre" "noviembre" "diciembre"])

Sólo quiero recordar dos cosas. Una es que estas variables esperan recibir un array y no una lista. Otra es que en castellano, los nombres de los meses y de los días no se escriben con mayúsculas, por eso, aunque sí las utilizo para las abreviaturas no las uso en los nombres completos.

Necesitamos mínimo un fichero. Dos, si utilizamos el diario: uno será para la agenda y otro para el diario. El fichero de diario lo trataré más adelante, aunque es opcional.

Se pueden tener varios ficheros org donde guardar la información de los eventos. Podemos, por ejemplo, tener distintos ficheros para agrupar conceptos como trabajo, ocio, familia, etc. En mi caso utilizo dos, uno de los ficheros donde se guardan los eventos capturados a través del calendario de mi servidor Nextcloud y que se sincroniza con la agenda de Emacs a través del paquete org-caldav. Pero en el ejemplo, sólo utilizaré uno.

Los distintos ficheros se configuran en la variable org-agenda-files y espera una lista de ficheros con el path completo.

(setq org-agenda-files '("~/agenda/agenda.org"))

El fichero debe existir para que funcione la agenda. org-mode se quejará si encuentra en la lista algún fichero que no existe y propondrá eliminarlo de la lista, pues entiende que se ha borrado. No suele ser mala idea el tener varios ficheros, uno dedicado a cada una de nuestras actividades, por ejemplo. Uno para el trabajo, otro para el ocio, etc. Al visualizarse juntos no hay problema con que se solapen las actividades. O por ejemplo, si tenemos que gestionar la agenda de un grupo de trabajo, podemos tener separadas las tareas de cada miembro del grupo. Somos libres de adaptar la lógica de nuestros ficheros a la lógica de trabajo.

Otra forma de configurar varios ficheros separados es juntarlos todos en un directorio y configurar dicho directorio en la variable org-agenda-files, de esta manera, cuando genere la vista de la agenda consultará todos los archivos org que se encuentren en él.

El fichero del diario se configura en la variable diary-file. El diario se puede utilizar para recordatorio de fechas señaladas, cumpleaños, festivos, eventos periódicos. Hay que establecer esa variable y también org-agenda-diary-file.

También hay que configurar si queremos que nos muestre las entradas del diario en la vista de la agenda mediante la variable org-agenda-include-diary puesto a t.

(setq diary-file "~/agenda/diario.org")
(setq org-agenda-diary-file "~/agenda/diario.org")
(setq org-agenda-include-diary t)

Las entradas se pueden cargar mediante dos comandos principalmente:

• Uno con org-anniversary con el formato:

  %%(org-anniversary año mes dia) Texto explicativo
  

• Otro para eventos periódicos flotantes:

  %%(diary-float mes dia orden) Texto explicativo
  

En ambas sintaxis los parámetros de año, mes o día deben ser números. Es decir, nos encontraremos un error si completamos con 0, como me pasó a mí durante la realización del vídeo: Había preparado una entrada de diario para que se visualizara al cargar la agenda y resultó que no funcionó. Después de darle muchas vueltas, resultó, que acostumbrado a escribir las fechas completando con ceros¹, al hacerlo la agenda no lo reconocía como fecha válida. Eso me hizo perder un poco de tiempo, porque repasaba la entrada y para mí estaba correcta... hasta que al crear una entrada de diario desde la vista de la agenda me encontré que la escribía en el fichero sin el cero.

Por otro lado, también se puede configurar la agenda para que ciertas tareas las convierta en periódicas añadiendo en la fecha de schedule o de death un sufijo con su periodicidad. Por ejemplo, si queremos que nos avise semanalmente de alguna tarea rutinaria, podemos añadir a la fecha, el sufijo 1w; si lo queremos quincenal añadiremos 2w; o también, por ejemplo, si lo queremos trimestral: 3m; o 1y para tareas anuales. Estas tareas, cuando se marcan como hechas lo que hace org-mode es añadir un línea con la fecha y hora de la realización de la tarea y modificar la fecha de schedule o death al próximo evento, generando un histórico.

Combinaciones de teclas que suelo utilizar con frecuencia.

;;; Configuración de teclas
(global-set-key (kbd "C-;")   'iedit-mode)
(global-set-key (kbd "C-c a") 'org-agenda)
(global-set-key (kbd "C-c l") 'display-line-numbers-mode)
(global-set-key (kbd "C-c s") 'dired-sidebar-toggle-sidebar)
(global-set-key (kbd "C-c t") 'toggle-truncate-lines)
(global-set-key (kbd "C-c w") 'whitespace-mode)

Aunque últimamente utilizo la combinación C-i para el modo iedit, he configurado C-; porque es la tecla que configura el paquete por defecto. Las demás teclas no necesitan mucha más explicación, aunque en el vídeo la podréis encontrar.