Dic 10 2009

Org-mode : TODO (Tareas)

Tag: basicoverdrive @ 4:01 am

En Org tenemos opcion para almacenar y manejar listas de cosas a realizar (aka TODO), como marcar y mostrar dichas entradas, asignaciones y flujos de trabajos, fechas y notas del progreso, marcar prioridades, division de tareas por partes, etc.

Cualquier headline (a partir de ahora lo llamaremos linea de cabecera) se convertira en una tarea a realizar si se le precede de la palabra TODO:

*** TODO Leer onLisp

Aqui podemos aplicar distintos tipos de keystrokes interesantes:

  • C-c C-t : Rota el estado de TODO (pasando por unmarked, TODO, DONE). La misma rotacion es aplicacada mediante buffers de agenda y lineas de tiempo presionando la tecla t.
  • C-u C-c C-t : selecciona una palabra especifica usando autocompletion. Despues necesitamos asignar teclas a estados de TODO.
  • S–> o S-<- : Selecciona el siguiente o anterior estado de TODO.
  • C-c C-v o C-c / t : Muestra la lista de elementos de TODO en un arbol. Carpetas muestran el buffer entero, y muestra todos los elementos con sus cabeceras de forma jerarquica sobre el mismo. Se puede usar argumentos de prefijo dando una lista tal como KWD1|KWD2|… para listar entradas relacionadas, con prefijos numericos, mostrara el arbol Nth. Con dos prefijos, buscara en todos los TODO y entradas marcadas como DONE.
  • C-c a t : Muestra la lista global de TODO.
  • S-M-INTRO : Inserta una nueva entrada debajo del TODO actual.

Estados

Podemos usar claves de forma *secuencial* para estados de un trabajo en proceso:

(setq org-todo-keywords ‘((sequence «TODO» «FEEDBACK» «VERIFY» «|» «DONE» «DELEGATED»)))

La barra vertical o pipe diferenciaria de estados que requieren accion de los que no necesitan futura accion. Si no se provee de dicho pipe, la tarea estara por defecto ‘terminada’. Aqui podriamos aplicar comandos como:

  • C-c C-t para rotar el estado como explicamos anteriormente, aunque podriamos usarlo con el prefijo para dejarlo en un estado directamente como:
  • C-3 C-c C-t : Rota el estado directamente al tercero

Podemos usar claves para indicar un tipo de trabajo que se realizara a quien se le asignara, y cuando este terminado marcada como DONE, aqui C-c C-t se usara para reasignar la tarea a otra persona, pero si se vuelve a lanzar C-c C-t pasara de cualquier persona directamente al estado DONE, tambien se pueden usar prefijos para saltar directamente a cualquier persona:

(setq org-todo-keywords ‘((type «Fred» «Sara» «Lucy» «|» «DONE»)))

En dicho tipo de lista, podremos ver que tareas tiene asignadas la tercera persona (Lucy) mediante C-3 C-c C-v de dicho buffer, si queremos verlo a modo global podemos usar C-3 C-c t.

Para tener distintas propiedades para una tarea, es decir multiples claves podemos hacer algo asi:

(setq org-todo-keywords
‘((sequence «TODO» «|» «DONE»)
(sequence «REPORT» «BUG» «KNOWNCAUSE» | «FIXED»)
(sequence «|» «CANCELLED»)))

En este caso C-c C-t solo operara entre subsecuencias. Mientras que C-u C-u C-c C-t ó C-S–> saltara entre estados dentro de una subsecuencia. S-<– y S–> se desplazara por todas las propiedades de todas las subsecuencias.

Acceso Rapido

Tambien podemos crear ‘acceso rapido’ o ‘acceso directo’ a los estados mediante el siguiente ejemplo:

(setq org-todo-keywords
‘((sequence «TODO(t)» «|» «DONE(d)»)
(sequence «REPORT(r)» «BUG(b)» «KNOWNCAUSE(k)» «|» «FIXED(f)»)
(sequence «|» «CANCELLED(c)»)))

Presionando C-c C-t <letra> saltara directamente a dicho estado. Con SPC directamente se eliminara cualquier clave TODO de la lista.

Estados espeficios para ficheros individuales

Para ello debemos dejar la primera linea del fichero tal que asi:

#+TODO: TODO FEEDBACK VERYFY | DONE CANCELED

Tambien podemos especificar el tipo de tarea a quien sera asignada de manera especifica asi:

#+TYPE_TODO Fred Sara Lucy Mike | DONE

O bien especificar distintas propiedades en paralelo para una tarea medianta:

#+TODO: TODO | DONE
#+TODO: REPORT BUG KNOWNCAUSE | FIXED
#+TODO: | CANCELED

Si usamos abbrev es decir (M-TAB) cuando escribamos #+ podemos usar el completion para asegurarnos de que lo escribimos correctamente.

Resaltado

Es posible resaltar los elementos dependiendo del estado del elemento. Por ejemplo:

(setq org-todo-keyword-faces
‘((«TODO»        . org-warning)
(«DEFERRED»    . shadow)
(«CANCELED»    . (:foreground «blue» :weight bold))))

Dependencias

Podemos crear estructuras mas complejas con dependencias y con ello crear listas y herencias, creando subtareas (hijos) bloqueando asi la padre u otras hermanas, por ejemplo:

* TODO Blocked until (two) is done
** DONE one
** TODO two

* Parent
:PROPERTIES:
:ORDERED: t
:END:
** TODO a
** TODO b, needs to wait for (a)
** TODO c, needs to wait for (a) and (b)

Para que ello surta efecto es necesario configurar el valor de la variable org-enforce-todo-dependencies. Y con los siguientes keybindings podemos hacer:

  • C-c C-x o : hace toggle de la propiedad ORDERED de la entrada actual. Si se quiere trazar el valor de dicha propiedad con un tag para tener mejor visibilidad debemos configurar la variable org-track-ordered-property-with-tag.
  • C-u C-u C-u C-c C-t : Cambia el estado de la lista de tareas, de cualquier estado a blocante.

Ademas configurando la variable org-agenda-dim-blocked-tasks, la lista de tareas no podra ser cerrado debido a las dependencias y sera invisible o mostrando en la agenda.
Tambien se pueden usar checkboxes para bloquear dicha lista mediante la variable org-enforce-todo-checkbox-dependencies, por lo que bloqueara el poder cambiar el estado a DONE.

Para mas complejidad en dependencias se puede revisar el modulo org-depend.el.

Archivando trabajos por tiempo

Se puede archivar usando la fecha:

(setq org-log-done ‘time)

O bien mediante una nota con dicha fecha (se debe crear una entrada en la cabecera con Closing Note):

(setq org-log-done ‘note)

Trazando cambios de estado

A la hora de ver dichos cambios es posible modificar la vista modificando la variable org-log-into-drawer asignandole el valor LOGBOOK (recomendado) o en forma de subarbol dandole el valor de LOG_INTRO_DRAWER.

Se usan ‘marcas‘ especiales para acortar la configuracion de las tazas, como ‘!‘ para timestamp y ‘@‘ para notas, por ejemplo:

(setq org-todo-keywords
‘((sequence «TODO(t)» «WAIT(w@/!)» «|» «DONE(d!)» «CANCELED(c@)»)))

Tambien podemos usar las mismas preferencias locales a un buffer:

#+TODO: TODO(t) WAIT(w@/!) | DONE(d!) CANCELED(c@)

Para guardar todas estas transiciones podemos usar LOGGING, sin embargo una linea indicando :LOGGING: nil causara que no loguee ninguna transicion:

* TODO Loguear cada estado con su fecha y hora
:PROPERTIES:
:LOGGING: TODO(!) WAIT(!) DONE(!) CANCELED(!)
:END:
* TODO Solo loguear la transicion a WAIT y cuando se repita esta
:PROPERTIES:
:LOGGING: WAIT(@) logrepeat
:END:
* TODO No loguear nada
:PROPERTIES:
:LOGGING: nil
:END:

Tazando los habitos

Para trazar los habitos debemos primero configurar la variable org-modules, el habito es TODO, usando la palabra clave TODO representando el estado de la tarea abierta. La propiedad STYLE debe tener el valor habit. Cada tarea puede ser repetitiva como por ejemplo afeitarse y se puede realizar por ejemplo con un minimo de 2 dias pero no mas de 4, eso lo indicamos con la sintaxis ‘.+2d/4d‘ y ademas queremos guardar un logging cada vez que finalicemos la tarea de forma historica, por ejemplo quedaria asi:

** TODO Afeitarse
SCHEDULED: <2009-10-17 Sat .+2d/4d>
… aqui se iran anadiendo entradas automaticamente …
:PROPERTIES:
:STYLE:    habit
:LAST_REPEAT: [2009-10-19 Mon 00:36]
:END:

Esto usara los siguientes colores:

Azul -> si la tarea se finalizo otro dia
Verde -> Si la tarea se ha finalizado hoy
Amarillo -> Si la tarea es para manana como muy tarde
Rojo -> Si la tarea es para hoy como muy tarde

Se pueden modificar algunas variables interesantes para mostrar los habitos en la agenda:

  • org-habit-graph-column : La columna del buffer con que consistencia debe ser grabado el grafico.
  • org-habit-preceding-days : El historial maximo.
  • org-habit-following-days : Numero de dias que debe seguir apareciendo una tarea despues de ser realizada.
  • org-habit-show-habits-only-for-today : Si no es nil, mostrara solo los habitos de la agenda de hoy.

Ademas presionando K en la agenda, desabilitaremos/habilitaremos temporalmente los habitos.

Prioridades

Es posible prioridad tareas mediante:

*** TODO [#A] Escribir una carta a Richard Stallman

Por defecto Org permite 3 prioridades (A, B y C) siendo A la maxima prioridad. Las prioridades se reflejan solo en la agenda, fuera de ella no tienen efecto.

  • C-c , : Le asigna la prioridad a la tarea actual (A, B o C). Si se pulsa SPC la prioridad es eliminada. Las prioridades tambien pueden ser modificadas remotamente desde la agenda.
  • S-flechaarriba : Incrementa la prioridad.
  • S-flechaabajo : Decrementa la prioridad.

Se pueden modificar la posibles prioridades modificando las variables org-highest-priority, org-lowest-priority y org-default-priority.

Para modificar las prioridades de una tarea de un buffer individual se puede hacer mediante:

#+PRIORITIES: A C B

Rompiendo una tarea en subtareas

Podemos coger una tarea compleja y dividirla en subtareas, viendo asi la progresion respecto al total, para ello usaremos [/] ó [%]. Estas cookies actualizaran su estado cuando una subtarea cambie de estado o bien cuando se pulse C-c C-c en la cookie:

* Organize Party [%]
** TODO Llamar a gente [/]
*** TODO Peter
*** DONE Sarah
** TODO Comprar comida
** DONE Hablar con el vecino

Si queremos guardar las estadisticas de un subarbol de tareas (no directamente del hijo) debemos configurar la variable org-hierarchical-todo-statistics. Para realizar esto en un subarbol simlpe debemos incluir la palabra ‘recursive‘ como valor de la propiedad COOKIE_DATA:

* Parent capturing statistics [/]
:PROPERTIES:
:COOKIE_DATA: todo recursive
:END:

Si queremos cambiar automaticamente a DONE la tarea cuando todas las tareas hijas hayan finalizado:

(defun org-summary-todo (n-done n-not-done)
«Switch entry to DONE when all subentries are done, to TODO otherwise.»
(let (org-log-done org-log-states)
(org-todo (if (= n-not-done 0) «DONE» «TODO»))))

En caso de tener muchas subtareas es conveniente usar checkboxes.

Checkboxes

Cada tarea puede ser mostrada usando un checkbox, tan solo debemos crear [ ]. Para hacer toggle en una tarea de checkbox debemos usar C-c C-c o directamente usar el raton ya que es clickable, aqui un ejemplo de checkbox:

* TODO Organizar fiesta [/]
– [ ] Llamar a gente [/]
– [ ] Peter
– [ ] Sarah
– [ ] Sam
– [ ] Pedir comida
– [ ] Preparar la musica
– [ ] Hablar con los vecinos

Si las tareas deben efectuarse en secuencia obligatoria, los checkboxes deben deshabilitarse para evitar problemas y comportamientos no deseados. Los siguientes comandos funcionan con checkboxes:

  • C-c C-c : Hace toggle de una tarea en checkbox (ademas las estadisticas del headline se actualizaran).
  • C-c C-x C-b : Hace toggle de una tarea en checkbox (tambien funciona para regiones, ademas puede usar argumentos/prefijo en dichas regiones).
  • M-S-RET : Inserta una nueva tarea de tipo checkbox. (realmente es M-Ret).
  • C-c C-x o : Hace toggle de ORDERED si deben ser las tareas ejecutadas en secuencia. Si queremos trazar estos tipos de tareas ademas debemos configurar la variable org-track-ordered-property-with-tag.
  • C-c # : Actualiza las estadisticas de la entrada actual. Si es ejecutada con argumentos/prefijo C-u, actualizara el fichero entero.
  • M-<flecha arriba> : Mueve un elemento de la lista hacia arriba.
  • M-<fleha abajo> : Mueve un elemento de la lista hacia abajo.
  • C-u C-c ! : Anadira un timestamp donde nos escontremos.
  • C-c C-t : Aplicara un timestamp para el headline si incluimos las siguiente linea en nuestro .emacs:

(setq org-log-done ‘time)