     [file org-version.inc not included]

Guía de Org Mode
****************

Copyright © 2010-2012 Free Software Foundation

     Se permite la copia, distribución y/o modificación de este documento bajo los términos de la GNU Free Documentation License, Version 1.3 o posteriores versiones publicadas por la Free Software Foundation; sin secciones invariantes, con texto al inicio de la cubierta de portada 'A GNU Manual', y con el texto de contraportada como se muestra abajo (a). Una copia de esta licencia está incluida en la sección titulada 'GNU Free Documentation License''.

     (a) El texto de contraportada de la FSF es: 'Tu tienes la libertad para copiar y modificar este manual GNU, Comprando copias desde la FSF se facilita el desarrollo de GNU y la promoción del software libre'.

     Este documento forma parte de una colección distribuida bajo la GNU Free Documentation License. Si desea distribuir este documento separadamente de la colección, puede hacerlo añadiendo una copia de la licencia al documento, como se describe en la sección 6 de la licencia.

Introducción
************

Prefacio
========

Org es un modo para guardar notas, manteniendo listas TODO (por hacer), y haciendo planes de proyectos con un rápido y efectivo sistema de texto plano. Es además un sistema de publicación y autoría.

This document is a much compressed derivative of the comprehensive Org-mode manual (http://orgmode.org/index.html#sec-4_1).  It contains all basic features and commands, along with important hints for customization.  It is intended for beginners who would shy back from a 200 page manual because of sheer size.

Instalación
===========

Importante: Si se usa una versión de Org que es parte de una distribución de Emacs o un paquete de XEmacs, por favor sáltese esta sección y vaya directamente a Activación.

Si se ha descargado Org de la web, como distribución de ficheros bien .zip, o bien .tar, o como un archivo Git, es preferible ejecutarlo directamente desde el directorio de la distribución. Necesitará añadir los subdirectorios lisp al camino de carga de Emacs. Para hacer esto, añada la siguiente línea al archivo .emacs:

     (setq load-path (cons "~/path/to/orgdir/lisp" load-path))
     (setq load-path (cons "~/path/to/orgdir/contrib/lisp" load-path))

For speed you should byte-compile the Lisp files with the shell comando:

     make smallexample

Activación
==========

Añada las siguientes líneas a su archivo .emacs. Las últimas tres líneas definen las claves global de algunos comandos ---por favor, elija claves apropiadas por sí mismo.

     ;; The following lines are always needed.  Choose your own keys.
     (add-to-list 'auto-mode-alist '("\\.org\\'" . org-mode)) ; not needed since Emacs 22.2
     (add-hook 'org-mode-hook 'turn-on-font-lock) ; not needed when global-font-lock-mode is on
     (global-set-key "\C-cl" 'org-store-link)
     (global-set-key "\C-ca" 'org-agenda)
     (global-set-key "\C-cb" 'org-iswitchb)

Con esta configuración, todos los archivos con extensión .org serán tratados en modo Org.

Realimentación
==============

Si encuentra problemas con Org, o si tiene preguntas, comentarios, u otras ideas acerca de él, por favor envie un correo a la lista de Org emacs-orgmode@gnu.org. Para más información de cómo enviar informes de error, lea el manual principal.

Estructura del documento
************************

Org está basado en el modo Outline y suministra flexibles comandos para editar la estructura de un documento.

Outlines
========

Org está implementado en lo alto del modo outline. Los outlines (ítems de contenido) permiten a un documento estar organizado en una estructura jerárquica, lo cual (al menos para mí) es la mejor forma para representar notas y pensamientos. Una visión preliminar de esta estructura es lograda al encoger (ocultando) grandes partes del documento y mostrar sólo la estructura general del documento y las partes en las que se está trabajando. Org simplifica enormemente el uso de outlines para comprender la funcionalidad completa de mostrar/ocultar en un simple comando, org-cycle, el cual está asignado a la tecla TAB.

Cabeceras
=========

Los cabeceras (Nota del Traductor. Headlines es traducido por cabecera y hace referencia a títulos y subtítulos) definen la estructura del árbol de sangrado (ítems de contenido). Los títulos y subtítulos en Org comienzan con uno o más asteriscos, en el margen izquierdo (Vea la variable org-special-crtl-a/e para configurar el comportamiento de C-a y C-e en los títulos.). Por ejemplo:

     * Top level headline
     ** Second level
     *** 3rd level
         some text
     *** 3rd level
         more text

     * Another top level headline

Some people find the many stars too noisy and would prefer an outline that has whitespace followed by a single star as headline starters. Clean view, describes a setup to realize this.

Visibilidad cíclica
===================

Los outlines hacen posible ocultar partes del texto en el buffer. Org usa solo dos comandos, asignados a TAB y S-TAB, para cambiar la visibilidad en el buffer.

TAB
     Subtree cycling: Rotate current subtree among the states

          ,-> FOLDED -> CHILDREN -> SUBTREE --.
          '-----------------------------------'

     Cuando es llamado con el argumento prefijo (C-u TAB) o con la tecla de desplazamiento (Shift), es invocado el ciclo global.

S-TAB y C-u TAB
     Global cycling: Rotate the entire buffer among the states

          ,-> OVERVIEW -> CONTENTS -> SHOW ALL --.
          '--------------------------------------'

C-u C-u C-u TAB
     Mostrar todo, incluidos los calzoncillos

Cuando Emacs abre por primera vez un archivo Org, pone el estado global a RESUMEN (OVERVIEW) p.e. sólo las cabeceras de nivel superior son visibles. Esto puede ser configurado a través de la variable org-startup-folded, o vía fichero añadiendo una palabra reservada overview, content, showall, como esta:

     #+STARTUP: content

Movimiento
==========

El siguiente comando salta a la siguiente cabecera en el buffer.

C-c C-n
     Siguiente cabecera.

C-c C-p
     Cabecera previa.

C-c C-f
     Siguiente cabecera del mismo nivel.

C-c C-b
     Cabecera previa del mismo nivel.

C-c C-u
     Retroceder a la cabecera de nivel superior.

Edición de estructura
=====================

M-RET
     Inserta una nueva cabecera al mismo nivel que la actual. Si el cursor está en un item de una lista plana, un nuevo item es creado (see Listas planas). Cuando este comando es usado en medio de una línea, la línea es partida y el resto de la línea será una nueva cabecera (Si no desea que la línea sea partida, personalice la variable org-M-RET-may-split-line.).

M-S-RET
     Inserta una nueva entrada TODO con el mismo nivel de la cabecera actual.

TAB en nueva, entrada vacia
     En una nueva entrada sin texto aún, TAB rotará cíclicamente a través de niveles similares.

M-left/right
     Promociona/devalua la cabecera actual en un nivel.

M-S-left/right
     Promociona/devalua el subarbol actual en un nivel.

M-S-up/down
     Mueve el subarbol arriba/abajo (intercambia entre anterior/siguiente subarbol del mismo nivel).

C-c C-w
     Refile entry or region to a different location.  See Refile and copy.

C-x n s/w
     Limitar la memoria intermedia al árbol actual / ocultándolo

Cuando esto es en una región activa (Transient Mark mode), promueve y devalua todas las cabeceras en la región.

Árboles poco densos
===================

Una importante característica de Org-mode es su posibilidad para construir árboles poco densos para la información seleccionada en un arbol de outline, así que el documento entero es manejado como es posible, pero la información seleccionada es hecha visible con la estructura de cabaceras de encima (Vea además las variables org-show-hierarchy-above, org-show-following-heading, org-show-siblings y org-show-entry-below para controlar los detalles de cómo el contexto se muestra en cada coincidencia.). Inténtelo ahora y verá inmediatamente como funciona.

Org-mode contiene varios comandos para crear árboles, todos estos comandos pueden ser accedidos a través del despachador:

C-c /
     Este prompt es una clave especial para seleccionar un comando de creación de un árbol poco denso.

C-c / r
     Occur.  Prompts for a regexp and shows a sparse tree with all matches.  Each match is also highlighted; the highlights disappear by pressing C-c C-c.

Otros comandos de árbol poco denso seleccionan las cabeceras basadas en la palabra reservada TODO, etiquetas o propiedades y serán discutidos posteriormente en este manual.

Listas planas
=============

Sin una entrada en el árbol de outline, listas formateadas a mano pueden suministrar una estructura adicional. Ello también proporciona una forma de crear listas de cajas de chequeo (see Cajas de chequeo). Org soporta la edición de tales listas, y el conversor HTML (see Exportando) los analiza y formatea.

Org permite listas ordenadas, desordenadas y describirlas.

  * Desordenada los items de la lista comienzan con -, + o * como marcas.

  * Ordenada los items de la lista comienzan con 1. o 1).

  * Descripción la lista usa  ::  para separar el término de la descripción.

Los items subsiguientes de la misma lista deben tener el mismo sangrado en la primera línea. Un item que termine antes de la siguiente línea será sangrado como bola/número, o no. Una lista termina cuando todos los items están cerrados, o antes de dos líneas en blanco. Un ejemplo:

     ** Lord of the Rings
        My favorite scenes are (in this order)
        1. The attack of the Rohirrim
        2. Eowyn's fight with the witch king
           + this was already my favorite scene in the book
           + I really like Miranda Otto.
        Important actors in this film are:
        - Elijah Wood :: He plays Frodo
        - Sean Austin :: He plays Sam, Frodo's friend.

Los siguientes comandos actuan en items cuando el cursor está en la primera límea de un item (la línea con la bola o el número).

TAB
     Los items pueden ser manejados como cabeceras de niveles.

M-RET
     Inserta un nuevo item al nivel actual. Con el argumento de prefijo, fuerza a una nueva cabecera (see Edición de estructura).

M-S-RET
     Inserta un nuevo item con una caja de chequeo (see Cajas de chequeo).

M-S-up/down
     Mueve el item incluyendo los subitems arriba/abajo (intercambia con el item previo/siguiente del mismo sangrado. Si la lista es ordenada, la renumeración es automática.

M-left/M-right
     Decrementa/incrementa el sangrado del item, dejando los hijos sueltos.

M-S-left/right
     Decrementa/incrementa el sangrado del item. incluyendo los subitems.

C-c C-c
     Si es una caja de chequeo (see Cajas de chequeo) en una línea item, cambia el estado de la caja de chequeo. Además verifica las bolas y el sangrado consistente en la lista completa.

C-c -
     Rota la lista entera a través de diferentes bolas de numeración/marcado (-, +, *, 1., 1)).

Notas al pie
============

Una Nota al pie es definida como un párrafo que comienza con una nota al pie marcada entre corchetes en la columna 0, sin ningún sangrado. La referencia a la nota al pie es simplemente una marcha de corchetes, texto incluido. Por ejemplo:

     The Org homepage[fn:1] now looks a lot better than it used to.
     ...
     [fn:1] The link is: http://orgmode.org

The following commands handle footnotes:

C-c C-x f
     The footnote action command.  When the cursor is on a footnote reference, jump to the definition.  When it is at a definition, jump to the (first) reference.  Otherwise, create a new footnote.  When this command is called with a prefix argument, a menu of additional options including renumbering is offered.

C-c C-c
     Jump between definition and reference.

Capítulo 2 del manual de Org-mode (http://orgmode.org/manual/Document-Structure.html#Document-Structure)
Tutorial de Sacha Chua (http://sachachua.com/wp/2008/01/outlining-your-notes-with-org/)

Tablas
******

Org comes with a fast and intuitive table editor.  Spreadsheet-like calculations are supported in connection with the Emacs calc package (see Calc (Gnu Emacs Calculator Manual)).

Org hace fácil formatear tablas en ASCII plano. Cualquier línea con | como primer carácter no-espacio es considerado parte de una tabla. | es además el separador de columnas. Una tabla puede parecer algo así:

     | Name  | Phone | Age |
     |-------+-------+-----|
     | Peter |  1234 |  17 |
     | Anna  |  4321 |  25 |

Una tabla es realineada automáticamente cada vez que se presione TAB o RET o C-c C-c dentro de la tabla. TAB además mueve al siguiente campo (RET a la siguiente fila) y crea una nueva tabla de filas al final de la tabla o antes de las líneas horizontales. El sangrado de la tabla es puesto por la primera línea. Cualquier línea comenzando con |- es considerada como un separador horizontal de línea y será expandido en la siguiente realineación para expandirse al ancho completo de la tabla. Así, para crear una tabla dentro, debe sólo introducir

     |Nombre|Teléfono|Edad|
     |-

and then press TAB to align the table and start filling in fields.  Even faster would be to type |Name|Phone|Age followed by C-c RET.

Cuando se introduce texto en un campo, Org trata DEL, Backspace y todas las teclas de forma especial, para que la inserción y el borrado eviten desplazarse a otros campos. Por tanto, cuando se introduce inmediatamente después de que el cursor se haya movido dentro de un nuevo campo con TAB, S-TAB o RET, el campo es automáticamente puesto en blanco.

Creación y conversión
.....................

C-c |
Convert the active region to table.  If every line contains at least one TAB character, the function assumes that the material is tab separated.  If every line contains a comma, comma-separated values (CSV) are assumed.  If not, lines are split at whitespace into fields.
 If there is no active region, this command creates an empty Org table.  But it's easier just to start typing, like |Name|Phone|Age C-c RET.

Realineación y movimiento
.........................

C-c C-c
Realinea la tabla sin mover el cursor.
TAB
Realinea la tabla, se mueve al siguiente campo. Crea una nueva fila si es necesario.
S-TAB
Realinea, moverse al campo anterior.
RET
Realinea la tabla y se mueve abajo a la siguiente fila. Crea una nueva fila si es necesario.

Edición de filas y columnas
...........................

M-left
M-right
Mueve el cursor a la columna izquierda/derecha.
M-S-left
Elimina la columna actual.
M-S-right
Inserta una nueva columna a la izquierda de la posición del cursor.
M-up
M-down
Mueve la actual fila arriba/abajo.
M-S-up
Elimina la fila o línea horizontal actual.
M-S-down
Inserta una nueva fila sobre la fila actual. Con prefijo argumento, la línea es creada debajo de la actual.
C-c -
Inserta una línea horizontal bajo la fila actual. Con prefijo argumento, la línea es creada sobre la línea actual.
C-c RET
Inserta una línea horizontal bajo la fila actual, y mueve el cursor a la fila bajo la línea.
C-c ^
Ordena las líneas de una tabla en una región. La posición del punto indica la columna usada para la ordenación, y el rango de líneas es el rango entre el separador de líneas más próximo, o la tabla completa.

 Capítulo 3 del manual de Org (http://orgmode.org/manual/Tables.html#Tables)

Tutorial de tablas de Bastien (http://orgmode.org/worg/org-tutorials/tables.php)

Tutorial de hojas de cálculo de Bastien (http://orgmode.org/worg/org-tutorials/org-spreadsheet-intro.php)

Tutorial de gráficos de Eric (http://orgmode.org/worg/org-tutorials/org-plot.php)

Hiperenlaces
************

Al igual que HTML, Org permite enlaces dentro de archivos, enlaces externos a otros archivos, artículos de Usenet, correos electrónicos y mucho más.

Formato de enlace
=================

Org reconocerá enlaces de texto tipo URL y los activará como enlaces en los que se puede hacer click. El formato de enlace general, sin embargo, se ve de la siguiente manera:

     [[link][description]]       or alternatively           [[link]]

Once a link in the buffer is complete (all brackets present), Org will change the display so that description is displayed instead of [[link][description]] and link is displayed instead of [[link]].  To edit the invisible link part, use C-c C-l with the cursor on the link.

Enlaces internos
================

Si el enlace no parece una URL, puede ser debido a que es un enlace interno en el fichero actual. El caso más importante en un enlace como [[#mi-id-personal]] que enlazará a la entrada con la propiedad CUSTOM_ID como [[#mi-id-personal]].

Links such as [[My Target]] or [[My Target][Find my target]] lead to a text search in the current file for the corresponding target which looks like <<My Target>>.

Enlaces externos
================

Org tiene soporte para enlaces a ficheros, sitios web, mensajes de correo electrónico y de News, entradas de bases de datos BBDB y enlaces a conversaciones de IRC y sus logs. Enlaces externos son identificadores tipo URL. Estos empiezan con una breve cadena de identificación seguida por dos puntos. Sin espacio después de los dos puntos. Aquí se presentan algunos ejemplos:

     http://www.astro.uva.nl/~dominik          on the web
     file:/home/dominik/images/jupiter.jpg     file, absolute path
     /home/dominik/images/jupiter.jpg          same as above
     file:papers/last.pdf                      file, relative path
     file:projects.org                         another Org file
     docview:papers/last.pdf::NNN              open file in doc-view mode at page NNN
     id:B7423F4D-2E8A-471B-8810-C40F074717E9   Link to heading by ID
     news:comp.emacs                           Usenet link
     mailto:adent@galaxy.net                   Mail link
     vm:folder                                 VM folder link
     vm:folder#id                              VM message link
     wl:folder#id                              WANDERLUST message link
     mhe:folder#id                             MH-E message link
     rmail:folder#id                           RMAIL message link
     gnus:group#id                             Gnus article link
     bbdb:R.*Stallman                          BBDB link (with regexp)
     irc:/irc.com/#emacs/bob                   IRC link
     info:org:External%20links                 Info node link (with encoded space)

Un enlace debe ser encerrado entre corchetes y puede tener un texto descriptivo que será mostrado en vez de la URL (see Formato de enlace), por ejemplo:

     [[http://www.gnu.org/software/emacs/][GNU Emacs]]

If the description is a file name or URL that points to an image, HTML export (see HTML export) will inline the image as a clickable button. If there is no description at all and the link points to an image, that image will be inlined into the exported HTML file.

Manejando enlaces
=================

Org provee métodos para crear un enlace con la sintaxis correcta, para insertarlo en un fichero Org, y poder seguir el enlace.

C-c l
     Almacena un enlace desde la posición actual. Éste es un comando global (debes crear el atajo de teclado por tí mismo) el cual puede ser usado en cualquier buffer para crear un enlace. El enlace será almacenado para posteriores inserciones dentro de un buffer Org (ver más abajo).

C-c C-l
     Inserta un enlace. Esto sugiere un enlace que será insertado dentro del buffer. Se puede escribir un enlace, o usar la teclas del historial arriba y abajo para acceder a los enlaces almacenados. También será consultado por la parte de descripción del enlace. Cuando es llamado con el prefijo C-u, se usa el autocompletado del nombre del fichero para enlazar a un fichero.

C-c C-l (con el cursor en un enlace existente)
     Cuando el cursor está en enlace existente, C-c C-l permite editar el enlace y las partes de descripción del enlace.

C-c C-o o mouse-1 o mouse-2
     Abre el enlace en el que está el cursor.

C-c &
     Salta a una posición grabada. Una posición es grabada por los siguientes comandos de enlaces internos, y por C-c %. Usando este comando varias veces se mueve a través de un anillo de posiciones previamente grabadas en una sucesión directa.

Destinos enlazados
==================

Los enlaces de ficheros pueden contener información adicional para hacer que Emacs salte a una posición particular en el fichero cuando se sigue un enlace. Esto puede ser un número de línea o una opción de búsqueda después de dos puntos dobles.

Aquí está la sintaxis de los diferentes caminos para adjuntar una búsqueda a un enlace de fichero, junto con una explicación:

     [[file:~/code/main.c::255]]                 Find line 255
     [[file:~/xx.org::My Target]]                Find <<My Target>>
     [[file:~/xx.org::#my-custom-id]]            Find entry with custom id

 Capítulo 4 del manual (http://orgmode.org/manual/Hyperlinks.html#Hyperlinks)

Items TODO
**********

El modo Org no mantiene listas TODO (tareas por hacer) como documentos separados (De acuerdo, puede crear un documento que contenga solo largas listas de ítems TODO, pero esto no se requiere.). En vez de eso, los ítems TODO son una parte integral de los ficheros de notas, porque ¡los ítems TODO normalmente aparecen mientras tomas notas!. De este modo, la información no está duplicada, y el contexto entero desde el que el ítem TODO emergió está siempre presente.

De acuerdo, esta técnica sirve para gestionar ítems TODO esparcidos a través de tu fichero de notas. Org mode compensa esto proveyendo métodos para darte una visión de alto nivel de todas las cosas que tu tienes que hacer.

Usando los estados TODO
=======================

Cualquier título o subtítulo puede llegar a ser un ítem TODO cuando empieza con la palabra TODO, por ejemplo:

     *** TODO Write letter to Sam Fortune

The most important commands to work with TODO entries are:

C-c C-t
     Rotate the TODO state of the current item among

          ,-> (unmarked) -> TODO -> DONE --.
          '--------------------------------'

     La misma rotación puede también ser hecha ``de manera remota'' desde los buffers de agenda y línea de tiempo con la tecla t (see Comandos de la agenda).

S-derecha/izquierda
     Seleccionar el siguiente/precedente estado TODO, similar a rotar.

C-c / t
     Ver ítems TODO en un árbol poco denso (see Árboles poco densos). Encoge el buffer, pero muestra todos los ítems y la jerarquía de títulos y subtítulos por encima de ellos.

C-c a t
     Show the global TODO list.  Collects the TODO items from all agenda files (see Agenda Views) into a single buffer.  See Global TODO list, for more information.

S-M-RET
     Inserta una nueva entrada TODO debajo del ítem actual.

Changing a TODO state can also trigger tag changes.  See the docstring of the option org-todo-state-tags-triggers for details.

Flujos de trabajo multi-estado
==============================

Se pueden usar palabras reservadas TODO para indicar diferentes estados secuenciales en el proceso de trabajo con respecto a un ítem, por ejemplo:

     (setq org-todo-keywords
       '((sequence "TODO" "FEEDBACK" "VERIFY" "|" "DONE" "DELEGATED")))

La barra vertical separa las palabras reservadas TODO (estados que necesitan acción) de los estados DONE (realizados, que no necesitan más acción). Si no se proporciona la barra separadora, el último estado es usado como estado DONE. Con esta configuración, el comando C-c C-t rotará una entrada desde TODO a FEEDBACK, después a VERIFY y finalmente a DONE y DELEGATED.

Algunas veces se puede querer usar diferentes configuraciones de palabras reservadas TODO en paralelo. Por ejemplo, se puede querer tener el básico TODO/DONE, pero también un flujo de trabajo para la corrección de errores, y un estado separando el estado que indica que un ítem ha sido cancelado (así no está DONE, pero tampoco requiere acción). La configuración sería la siguiente:

     (setq org-todo-keywords
           '((sequence "TODO(t)" "|" "DONE(d)")
             (sequence "REPORT(r)" "BUG(b)" "KNOWNCAUSE(k)" "|" "FIXED(f)")
             (sequence "|" "CANCELED(c)")))

Las palabras reservadas son todas diferentes, esto ayuda a Org mode a guardar la traza de que subsecuencia debería ser usada para una entrada dada. El ejemplo también muestra cómo definir teclas para un rápido acceso a un estado particular, añadiendo una letra entre paréntesis después de cada palabra reservada - se preguntará por la letra después de C-c C-t.

Para definir palabras reservadas TODO que son válidas únicamente en un solo fichero, use el siguiente texto en cualquier lugar del fichero.

     #+TODO: TODO(t) | DONE(d)
     #+TODO: REPORT(r) BUG(b) KNOWNCAUSE(k) | FIXED(f)
     #+TODO: | CANCELED(c)

Después de cambiar una de estas líneas, use C-c C-c con el cursor todavía en la línea para que Org mode reconozca los cambios.

Proceso de acceso
=================

Org mode puede grabar automáticamente un timestamp y posiblemente una nota cuando se marca un ítem TODO como DONE, ó incluso cada vez que se cambia el estado de un ítem TODO. Este sistema es altamente configurable, las configuraciones pueden seguir una lógica por tecla y pueden afectar a un fichero o incluso a un subárbol. Para más información de cómo fijar fecha y hora de una tareas, lea Estableciendo tiempo de trabajo.

Cerrando items
--------------

El registro más básico es guardar cuando un ítem TODO se finalizó. Esto se logra con (La correspondiente configuración en el buffer es #+STARTUP: logdone).

     (setq org-log-done 'time)

Then each time you turn an entry from a TODO (not-done) state into any of the DONE states, a line CLOSED: [timestamp] will be inserted just after the headline.  If you want to record a note along with the timestamp, use (The corresponding in-buffer setting is: #+STARTUP: lognotedone)

     (setq org-log-done 'note)

You will then be prompted for a note, and that note will be stored below the entry with a Closing Note heading.

Trazando los estados TODO
-------------------------

Se podría querer guardar la traza de cambios de estado TODO. Se puede o bien registrar solo una marca de tiempo (timestamp), o bien una nota con una estampa de tiempo para un cambio. Estos registros serán insertados después de la cabecera como una lista de ítems. Cuando se toman un montón de notas, se podría querer tener las notas fuera de la vista dentro de un "cajón" (drawer) Drawers en el Capítulo 2 del manual (http://www.gnu.org/software/emacs/manual/html_node/org/Drawers.html#Drawers)

For state logging, Org mode expects configuration on a per-keyword basis. This is achieved by adding special markers ! (for a timestamp) and @ (for a note) in parentheses after each keyword.  For example:

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

will define TODO keywords and fast access keys, and also request that a time is recorded when the entry is set to DONE, and that a note is recorded when switching to WAIT or CANCELED.  The same syntax works also when setting org-todo-keywords.

Prioridades
===========

Si usa Org mode intensamente, puede acabar con suficientes ítems TODO que empiece a tener sentido priorizarlos. Priorizar puede ser hecho poniendo una marca de prioridad en la cabecera de un ítem TODO, como esta

     *** TODO [#A] Write letter to Sam Fortune

Org mode supports three priorities: A, B, and C. A is the highest, B the default if none is given.  Priorities make a difference only in the agenda.

C-c ,
     Set the priority of the current headline.  Press A, B or C to select a priority, or SPC to remove the cookie.

S-up
S-down
     Incremente/decrementa la prioridad de la cabecera actual

Partiendo tareas en subtareas
=============================

Es a menudo ventajoso dividir grandes tareas en pequeñas y manejables subtareas. Puede realizar esto creando un árbol de outline bajo un item TODO, el cual detalla las subtareas en el árbol. Para poner la vista sobre la fracción de subtareas que están ya completadas, inserte un [/] o [%] en cualquier lugar de la cabecera. Estas marcas serán actualizadas cada vez que el estado TODO de algún hijo cambie, o presionando C-c C-c en la marca. Por ejemplo:

     * Organize Party [33%]
     ** TODO Call people [1/2]
     *** TODO Peter
     *** DONE Sarah
     ** TODO Buy food
     ** DONE Talk to neighbor

Cajas de chequeo
================

Cada item en una lista plana (see Listas planas) puede ser un cuadro de chequeo comenzando con la cadena []. Los cuadros de chequeo nos están incluidos en la lista TODO global, así a menudo es preferible dividir la tarea en un número reducido de pasos.

     * TODO Organize party [1/3]
       - [-] call people [1/2]
         - [ ] Peter
         - [X] Sarah
       - [X] order food
       - [ ] think about what music to play

Las cajas de chequeo funcionan jerárquicamente, si un item es caja de chequeo y tiene hijos que son cajas de chequeo, marcando las cajas de chequeo hijos se marcará la caja de chequeo del padre para reflejar si ninguno, alguno o todos los hijos están marcados.

The following commands work with checkboxes:

C-c C-c
     Cambia el estado de la caja de chequeo o (con prefijo) añade una caja de chequeo.

M-S-RET
     Insert a new item with a checkbox.  This works only if the cursor is already in a plain list item (see Plain lists).

 Capítulo 5 del manual (http://orgmode.org/manual/TODO-Items.html#TODO-Items)

Tutorial de introducción de David O'Toole (http://orgmode.org/worg/org-tutorials/ orgtutorial_dto.php)

Configuración de GTD de Charles Cave (http:// members.optusnet.com.au/~charles57/GTD/gtd_workflow.html)

Etiquetas
*********

Una excelante forma de nombrar y contextualizar información interrelacionada es asignar etiquetas a las cabeceras. Org mode tiene un amplio soporte para etiquetas.  (Nota del Traductor: Tanto label como tag se traduce como etiqueta. En general, label se utiliza más como nombre que se le asigna a algo y tag como palabra clave, si bien ambas suelen traducirse como etiqueta. Así, he decidido traducir implement label como nombrar y tag como etiqueta.)

Cada cabecera puede contener una lista de etiquetas; se introducen al final de una cabecera. Las etiquetas son palabras normales conteniendo letras, números, _ y @. Las etiquetas deben estar precedidas y seguidas por dos puntos, por ejemplo, :trabajo:. Es posible asignar varias etiquetas, como en :trabajo:urgente:. Las etiquetas por defecto estarán en negrilla con el mismo color que la cabecera.

Marca de herencia
=================

Las etiquetas hacen uso de la estructura jerárquica de los árboles de org-mode. Si una cabecera tiene una cierta etiqueta, todas las subcabeceras heredarán la etiqueta también. Por ejemplo, en la lista

     * Meeting with the French group      :work:
     ** Summary by Frank                  :boss:notes:
     *** TODO Prepare slides for him      :action:

the final heading will have the tags :work:, :boss:, :notes:, and :action: even though the final heading is not explicitly marked with those tags.  You can also set tags that all entries in a file should inherit just as if these tags were defined in a hypothetical level zero that surrounds the entire file.  Use a line like this (As with all these in-buffer settings, pressing C-c C-c activates any changes in the line.):

     #+FILETAGS: :Pedro:Jefe:Secreto:

Poniendo marcas
===============

Las etiquetas pueden simplemente ser escritas en un bufer al final de una cabecera. Después de los dos puntos, M-TAB autocompleta etiquetas. Hay también un comando para insertar etiquetas:

C-c C-q
     Enter new tags for the current headline.  Org mode will either offer completion or a special single-key interface for setting tags, see below. After pressing RET, the tags will be inserted and aligned to org-tags-column.  When called with a C-u prefix, all tags in the current buffer will be aligned to that column, just to make things look nice.

C-c C-c
     Cuando el cursor está en una cabecera, hace lo mismo que C-c C-q.

Org soporta inserción de etiquetas basado en una lista de etiquetas. Por defecto esta lista es construida dinámicamente, conteniendo todas las etiquetas actualmente usadas en el buffer. También se puede especificar globalmente una lista dura de etiquetas con la variable org-tag-alist. Finalmente se puede asignar las etiquetas por defecto para un fichero dado con líneas como

     #+TAGS: @work @home @tennisclub
     #+TAGS: laptop car pc sailboat

Por defecto, Org mode usa las facilidades de compleción del minibuffer para introducir etiquetas. Sin embargo, también implementa otro rápido método de selección de etiquetas llamado fast tag selection. Este permite que tu selecciones y dejes de seleccionar etiquetas con solo presionar una sola tecla. Para que esto funcione bien se debe asignar letras únicas para las etiquetas más usadas. Se puede hacer esto de manera global configurando la variable org-tag-alist en el fichero .emacs. Por ejemplo, se puede encontrar la necesidad de etiquetar muchos ítems en diferentes ficheros con :@casa:. En este caso se puede hacer algo como:

     (setq org-tag-alist '(("@work" . ?w) ("@home" . ?h) ("laptop" . ?l)))

If the tag is only relevant to the file you are working on, then you o bien establecer en la línea TAGS una opción como:

     #+TAGS: @trabajo(t)  @casa(c)  @futbol(f)  servidor(s)  pc(p)

Buscando marcas
===============

Una vez que un sistema de etiquetas ha sido configurado, puede ser usado para recoger información dentro de listas especiales.

C-c \
C-c / m
     Crear un árbol expandido con todas las cabeceras coincidentes con la etiqueta (tag) buscada. Con el prefijo C-u, ignora las cabeceras que no son TODO.

C-c a m
     Crea una lista global de marcas coincidentes de todos los archivos de la agenda. See Coincidiendo marcas y propiedades.

C-c a M
     Create a global list of tag matches from all agenda files, but check only TODO items and force checking subitems (see variable org-tags-match-list-sublevels).

Estos comandos buscan coincidencias de cadenas que permiten una lógica básica como +jefe+urgente-proyecto1, para encontrar entradas con marcas jefe y urgente, pero sin proyecto1, o José|Juan para encontrar ambas entradas, tanto José como Juan. La sintáxis completa de las cadenas de búsqueda es rica y permite además coincidencias con todas las palabras clave TODO, entradas de nivel y propiedades. Para una completa descripción con muchos ejemplos, vea Coincidiendo marcas y propiedades.

 Capítulo 6 del manual (http://orgmode.org/manual/Tags.html#Tags)

artículo de Sacha Chua acerca de etiquetado en Org-mode (http://sachachua.com/wp/2008/01/tagging-in-org-plus-bonus-code-for-timeclocks-and-tags/)

Propiedades
***********

Las propiedades son pares clave valor asociados con una entrada. Estos se encuentran en un lugar especial con el nombre PROPERTIES. Cada propiedad se especifica en una línea simple, con la clave (rodeada por dos puntos) primero, y el valor después de ésta.

     * CD collection
     ** Classic
     *** Goldberg Variations
         :PROPERTIES:
         :Title:     Goldberg Variations
         :Composer:  J.S. Bach
         :Publisher: Deutsche Grammophon
         :NDisks:    1
         :END:

Se pueden definir los valores permitidos para una propiedad particular :Xyz: asignando un propiedad :Xyz_ALL:. Esta propiedad especial es heredada, así si se asigna en una entrada de nivel 1, se aplicará al árbol entero. Cuando los valores permitidos están definidos, asignar la propiedad correspondiente llega a ser fácil y es menos propensa a errores. Para el ejemplo de la colección de CDs, se pueden predefinir las discográficas y el número de discos en una caja como esta:

     * CD collection
       :PROPERTIES:
       :NDisks_ALL:  1 2 3 4
       :Publisher_ALL: "Deutsche Grammophon" Philips EMI
       :END:

o globalmente usando org-global-properties, o un fichero amplio como este:

     #+PROPERTY: Discos_ALL 1 2 3 4

C-c C-x p
     Asigna una propiedad. Se solicitará un nombre y un valor para la propiedad.

C-c C-c d
     Elimina una propiedad de la entrada actual.

Para crear árboles expandidos y listas especiales con selección basada en propiedades, los mismos comandos son usados para buscar marcas (see Buscando marcas). La sintaxis completa para la búsqueda de cadenas es descrita en Coincidiendo marcas y propiedades.

Chapter 7 of the manual (http://orgmode.org/manual/Properties-and-Columns.html#Properties-and-Columns)

Bastien Guerry's column view tutorial (http://orgmode.org/worg/org-tutorials/org-column-view-tutorial.php)

Fechas y horas
**************

To assist project planning, TODO items can be labeled with a date and/or a time.  The specially formatted string carrying the date and time information is called a timestamp in Org mode.

Instante en el tiempo
=====================

A timestamp is a specification of a date (possibly with a time or a range of times) in a special format, either <2003-09-16 Tue> or <2003-09-16 Tue 09:39> or <2003-09-16 Tue 12:00-12:30>.  A timestamp can appear anywhere in the headline or body of an Org tree entry. Its presence causes entries to be shown on specific dates in the agenda (see Weekly/daily agenda).  We distinguish:

Plain timestamp; Event; Appointment

A simple timestamp just assigns a date/time to an item.  This is just like writing down an appointment or event in a paper agenda.

     * Meet Peter at the movies
       <2006-11-01 Wed 19:15>
     * Discussion on climate change
       <2006-11-02 Thu 20:00-22:00>

Timestamp with repeater interval

A timestamp may contain a repeater interval, indicating that it applies not only on the given date, but again and again after a certain interval of N days (d), weeks (w), months (m), or years (y).  The following will show up in the agenda every Wednesday:

     * Pick up Sam at school
       <2007-05-16 Wed 12:30 +1w>

Diary-style sexp entries

For more complex date specifications, Org mode supports using the special sexp diary entries implemented in the Emacs calendar/diary package.  For example

     * The nerd meeting on every 2nd Thursday of the month
       <%%(diary-float t 4 2)>

Time/Date range

Two timestamps connected by -- denote a range.

     ** Meeting in Amsterdam
        <2004-08-23 Mon>--<2004-08-26 Thu>

Inactive timestamp

Just like a plain timestamp, but with square brackets instead of angular ones.  These timestamps are inactive in the sense that they do not trigger an entry to show up in the agenda.

     * Gillian comes late for the fifth time
       [2006-11-01 Wed]

Creando instantes de tiempo
===========================

For Org mode to recognize timestamps, they need to be in the specific format.  All commands listed below produce timestamps in the correct format.

C-c .
     Prompt for a date and insert a corresponding timestamp.  When the cursor is at an existing timestamp in the buffer, the command is used to modify this timestamp instead of inserting a new one.  When this command is used twice in succession, a time range is inserted.  With a prefix, also add the current time.

C-c !
     Like C-c ., but insert an inactive timestamp that will not cause an agenda entry.

S-left/right
     Change date at cursor by one day.

S-up/down
     Change the item under the cursor in a timestamp.  The cursor can be on a year, month, day, hour or minute.  When the timestamp contains a time range like 15:30-16:30, modifying the first time will also shift the second, shifting the time block with constant length.  To change the length, modify the second time.

When Org mode prompts for a date/time, it will accept any string containing some date and/or time information, and intelligently interpret the string, deriving defaults for unspecified information from the current date and time.  You can also select a date in the pop-up calendar.  See the manual for more information on how exactly the date/time prompt works.

Fecha límite y planificación
============================

A timestamp may be preceded by special keywords to facilitate planning:

DEADLINE

Meaning: the task (most likely a TODO item, though not necessarily) is supposed to be finished on that date.

C-c C-d
     Insert DEADLINE keyword along with a stamp, in the line following the headline.

On the deadline date, the task will be listed in the agenda.  In addition, the agenda for today will carry a warning about the approaching or missed deadline, starting org-deadline-warning-days before the due date, and continuing until the entry is marked DONE.  An example:

     *** TODO write article about the Earth for the Guide
         The editor in charge is [[bbdb:Ford Prefect]]
         DEADLINE: <2004-02-29 Sun>

SCHEDULED

Meaning: you are planning to start working on that task on the given date (This is quite different from what is normally understood by scheduling a meeting, which is done in Org-mode by just inserting a time stamp without keyword.).

C-c C-s
     Insert SCHEDULED keyword along with a stamp, in the line following the headline.

The headline will be listed under the given date (It will still be listed on that date after it has been marked DONE.  If you don't like this, set the variable org-agenda-skip-scheduled-if-done.).  In addition, a reminder that the scheduled date has passed will be present in the compilation for today, until the entry is marked DONE.  I.e. the task will automatically be forwarded until completed.

     *** TODO Call Trillian for a date on New Years Eve.
         SCHEDULED: <2004-12-25 Sat>

Some tasks need to be repeated again and again.  Org mode helps to organize such tasks using a so-called repeater in a DEADLINE, SCHEDULED, or plain timestamp.  In the following example

     ** TODO Pay the rent
        DEADLINE: <2005-10-01 Sat +1m>

the +1m is a repeater; the intended interpretation is that the task has a deadline on <2005-10-01> and repeats itself every (one) month starting from that time.

Estableciendo tiempo de trabajo
===============================

Org mode allows you to clock the time you spend on specific tasks in a project.

C-c C-x C-i
     Start the clock on the current item (clock-in).  This inserts the CLOCK keyword together with a timestamp.  When called with a C-u prefix argument, select the task from a list of recently clocked tasks.

C-c C-x C-o
     Stop the clock (clock-out).  This inserts another timestamp at the same location where the clock was last started.  It also directly computes the resulting time in inserts it after the time range as => HH:MM.

C-c C-x C-e
     Update the effort estimate for the current clock task.

C-c C-x C-x
     Cancel the current clock.  This is useful if a clock was started by mistake, or if you ended up working on something else.

C-c C-x C-j
     Jump to the entry that contains the currently running clock.  With a C-u prefix arg, select the target task from a list of recently clocked tasks.

C-c C-x C-r
     Insert a dynamic block containing a clock report as an Org-mode table into the current file.  When the cursor is at an existing clock table, just update it.

          #+BEGIN: clocktable :maxlevel 2 :emphasize nil :scope file
          #+END: clocktable

     For details about how to customize this view, see the manual (http://orgmode.org/manual/Clocking-work-time.html#Clocking-work-time).

C-c C-c
     Update dynamic block at point.  The cursor needs to be in the #+BEGIN line of the dynamic block.

La tecla l puede ser usada en la línea de tiempo (see Línea de tiempo) y en la agenda (see Agenda semanal/diaria) para mostrar las tareas en las que se trabajará o cerrarán durante el día.

Chapter 8 of the manual (http://orgmode.org/manual/Dates-and-Times.html#Dates-and-Times)

Charles Cave's Date and Time tutorial (http://members.optusnet.com.au/~charles57/GTD/org_dates/)

Bernt Hansen's clocking workflow (http://doc.norang.ca/org-mode.html#Clocking)

Capture - Refile - Archive
**************************

An important part of any organization system is the ability to quickly capture new ideas and tasks, and to associate reference material with them. Org defines a capture process to create tasks.  It stores files related to a task (attachments) in a special directory.  Once in the system, tasks and projects need to be moved around.  Moving completed project trees to an archive file keeps the system compact and fast.

Capturar
========

Org's method for capturing new items is heavily inspired by John Wiegley excellent remember package.  It lets you store quick notes with little interruption of your work flow.  Org lets you define templates for new entries and associate them with different targets for storing notes.

Setting up a capture location
-----------------------------

...............  (Usando plantillas de capturas .......Plantillas de capturas.) .............

     (setq org-default-notes-file (concat org-directory "/notes.org"))
     (define-key global-map "\C-cc" 'org-capture)

Usando capturas
---------------

C-c c
     Start a capture process.  You will be placed into a narrowed indirect buffer to edit the item.

C-c C-c
     Once you are done entering information into the capture buffer, C-c C-c will return you to the window configuration before the capture process, so that you can resume your work without further distraction.

C-c C-w
     Finalize by moving the entry to a refile location (see Refile and copy).

C-c C-k
     Abort the capture process and return to the previous state.

Plantillas de capturas
----------------------

You can use templates to generate different types of capture notes, and to store them in different places.  For example, if you would like to store new tasks under a heading Tasks in file TODO.org, and journal entries in a date tree in journal.org you could use:

     (setq org-capture-templates
      '(("t" "Todo" entry (file+headline "~/org/gtd.org" "Tasks")
             "* TODO %?\n  %i\n  %a")
        ("j" "Journal" entry (file+datetree "~/org/journal.org")
             "* %?\nEntered on %U\n  %i\n  %a")))

In these entries, the first string is the key to reach the template, the second is a short description.  Then follows the type of the entry and a definition of the target location for storing the note. Finally, the template itself, a string with %-escapes to fill in information based on time and context.

When you call M-x org-capture, Org will prompt for a key to select the template (if you have more than one template) and then prepare the buffer like

     * TODO
       [[file:LINK TO WHERE YOU WERE WHEN INITIATING CAPTURE]]

During expansion of the template, special %-escapes (If you need one of these sequences literally, escape the % with a backslash.) allow dynamic insertion of content.  Here is a small selection of the possibilities, consult the manual for more.

     %a          annotation, normally the link created with org-store-link
     %i          initial content, the region when remember is called with C-u.
     %t          timestamp, date only
     %T          timestamp with date and time
     %u, %U      like the above, but inactive timestamps

Refile and copy
===============

When reviewing the captured data, you may want to refile or copy some of the entries into a different list, for example into a project.  Cutting, finding the right location, and then pasting the note is cumbersome.  To simplify this process, you can use the following special command:

C-c M-x
     Copy the entry or region at point.  This command behaves like org-refile, except that the original note will not be deleted.

C-c C-w
     Refile the entry or region at point.  This command offers possible locations for refiling the entry and lets you select one with completion.  The item (or all items in the region) is filed below the target heading as a subitem.
      By default, all level 1 headlines in the current buffer are considered to be targets, but you can have more complex definitions across a number of files.  See the variable org-refile-targets for details.

C-u C-c C-w
     Use the refile interface to jump to a heading.

C-u C-u C-c C-w
     Jump to the location where org-refile last moved a tree to.

Archivando
==========

When a project represented by a (sub)tree is finished, you may want to move the tree out of the way and to stop it from contributing to the agenda. Archiving is important to keep your working files compact and global searches like the construction of agenda views fast.  The most common archiving action is to move a project tree to another file, the archive file.

C-c C-x C-a
     Archive the current entry using the command specified in the variable org-archive-default-command.

C-c C-x C-s or short  C-c $
     Archive the subtree starting at the cursor position to the location given by org-archive-location.

The default archive location is a file in the same directory as the current file, with the name derived by appending _archive to the current file name.  For information and examples on how to change this, see the documentation string of the variable org-archive-location.  There is also an in-buffer option for setting this variable, for example

     #+ARCHIVE: %s_done::

Chapter 9 of the manual (http://orgmode.org/manual/Capture-_002d-Refile-_002d-Archive.html#Capture-_002d-Refile-_002d-Archive)

Charles Cave's remember tutorial (http://members.optusnet.com.au/~charles57/GTD/remember.html)

Sebastian Rose's tutorial for capturing from a web browser (http://orgmode.org/worg/org-tutorials/org-protocol-custom-handler.php)

Vistas de la Agenda
*******************

Due to the way Org works, TODO items, time-stamped items, and tagged headlines can be scattered throughout a file or even a number of files.  To get an overview of open action items, or of events that are important for a particular date, this information must be collected, sorted and displayed in an organized way.  There are several different views, see below.

......................Comandos de la agenda.

Archivos de agenda
==================

The information to be shown is normally collected from all agenda files, the files listed in the variable org-agenda-files.

C-c [
     Add current file to the list of agenda files.  The file is added to the front of the list.  If it was already in the list, it is moved to the front.  With a prefix argument, file is added/moved to the end.

C-c ]
     Remove current file from the list of agenda files.

C-,
     Cycle through agenda file list, visiting one file after the other.

The agenda dispatcher
=====================

............................. (see Instalación). .....

a
     La agenda como calendario (see Agenda semanal/diaria).

t / T
     Una lista de todos los items TODO (see Lista global TODO).

m / M
     Una lista de titulares coincidentes con la expresi'on TAGS (see Coincidiendo marcas y propiedades).

L
     La vista de la línea de tiempo para el buffer actual see Línea de tiempo).

s
     A list of entries selected by a boolean expression of keywords and/or regular expressions that must or must not occur in the entry.

Las vistas internas de la agenda
================================

The weekly/daily agenda
-----------------------

The purpose of the weekly/daily agenda is to act like a page of a paper agenda, showing all the tasks for the current week or day.

C-c a a
     Compile an agenda for the current week from a list of Org files.  The agenda shows the entries for each day.

Emacs contains the calendar and diary by Edward M. Reingold.  Org-mode understands the syntax of the diary and allows you to use diary sexp entries directly in Org files:

     * Birthdays and similar stuff
     #+CATEGORY: Holiday
     %%(org-calendar-holiday)   ; special function for holiday names
     #+CATEGORY: Ann
     %%(diary-anniversary  5 14 1956) (Note that the order of the arguments (month, day, year) depends on the setting of calendar-date-style.) Arthur Dent is %d years old
     %%(diary-anniversary 10  2 1869) Mahatma Gandhi would be %d years old

Org can interact with Emacs appointments notification facility.  To add all the appointments of your agenda files, use the command org-agenda-to-appt.  See the docstring for details.

The global TODO list
--------------------

..............Comandos de la agenda.

C-c a t
     Muestra la lista global TODO. Esta colección de items TODO de todos los archivos de la agenda (see Vistas de la Agenda) en un único buffer.

C-c a T
     Like the above, but allows selection of a specific TODO keyword.

Coincidiendo marcas y propiedades
---------------------------------

................................ (see Etiquetas), ....... ....... .... (see Propiedades), ..,.... .. .... ...... ...... Comandos de la agenda.

C-c a m
     Produce a list of all headlines that match a given set of tags.  The command prompts for a selection criterion, which is a boolean logic expression with tags, like +work+urgent-withboss or work|home (see Tags). If you often need a specific search, define a custom command for it (see Agenda dispatcher).

C-c a M
     Like C-c a m, but only select headlines that are also TODO items.

Match syntax
............

A search string can use Boolean operators & for AND and | for OR.  & binds more strongly than |.  Parentheses are currently not implemented.  Each element in the search is either a tag, a regular expression matching tags, or an expression like PROPERTY OPERATOR VALUE with a comparison operator, accessing a property value.  Each element may be preceded by -, to select against it, and + is syntactic sugar for positive selection.  The AND operator & is optional when + or - is present.  Here are some examples, using only tags.

+work-boss
     Select headlines tagged :work:, but discard those also tagged :boss:.

work|laptop
     Selects lines tagged :work: or :laptop:.

work|laptop+night
     Like before, but require the :laptop: lines to be tagged also :night:.

You may also test for properties at the same time as matching tags, see the manual for more information.

Línea de tiempo para un simple archivo
--------------------------------------

The timeline summarizes all time-stamped items from a single Org mode file in a time-sorted view.  The main purpose of this command is to give an overview over events in a project.

C-c a L
     Show a time-sorted view of the Org file, with all time-stamped items.  When called with a C-u prefix, all unfinished TODO entries (scheduled or not) are also listed under the current date.

Vista de búsqueda
-----------------

This agenda view is a general text search facility for Org mode entries.  It is particularly useful to find notes.

C-c a s
     This is a special search that lets you select entries by matching a substring or specific words using a boolean logic.

For example, the search string computer equipment will find entries that contain computer equipment as a substring.  Search view can also search for specific keywords in the entry, using Boolean logic.  The search string +computer +wifi -ethernet -{8\.11[bg]} will search for note entries that contain the keywords computer and wifi, but not the keyword ethernet, and which are also not matched by the regular expression 8\.11[bg], meaning to exclude both 8.11b and 8.11g.

Note that in addition to the agenda files, this command will also search the files listed in org-agenda-text-search-extra-files.

Commands in the agenda buffer
=============================

Entries in the agenda buffer are linked back to the Org file or diary file where they originate.  Commands are provided to show and jump to the original entry location, and to edit the Org files ``remotely'' from the agenda buffer.  This is just a selection of the many commands, explore the Agenda menu and the manual for a complete list.

Motion
......

n
Next line (same as up and C-p).
p
Previous line (same as down and C-n).  View/Go to
Org file
mouse-3
SPC
Display the original location of the item in another window.  With prefix arg, make sure that the entire entry is made visible in the outline, not only the heading.
TAB
Go to the original location of the item in another window.  Under Emacs 22, mouse-1 will also work for this.
RET
Go to the original location of the item and delete other windows.

Change display
..............

o
Delete other windows.
d / w
Switch to day/week view.
f and b
Go forward/backward in time to display the following org-agenda-current-span days.  For example, if the display covers a week, switch to the following/previous week.
.
Go to today.
j
Prompt for a date and go there.
v l  or short  l
Toggle Logbook mode.  In Logbook mode, entries that were marked DONE while logging was on (variable org-log-done) are shown in the agenda, as are entries that have been clocked on that day.  When called with a C-u prefix, show all possible logbook entries, including state changes.
r or g
Recreate the agenda buffer, to reflect the changes.
s
Save all Org buffers in the current Emacs session, and also the locations of IDs.

Secondary filtering and query editing
.....................................

/
Filter the current agenda view with respect to a tag.  You are prompted for a letter to select a tag.  Press - first to select against the tag.

\
Narrow the current agenda filter by an additional condition.

Remote editing (see the manual for many more commands)
......................................................

0-9
Digit argument.
t
Change the TODO state of the item, in the agenda and in the org file.
C-k
Delete the current agenda item along with the entire subtree belonging to it in the original Org file.
C-c C-w
Refile the entry at point.
C-c C-x C-a  or short  a
Archive the subtree corresponding to the entry at point using the default archiving command set in org-archive-default-command.
C-c C-x C-s  or short  $
Archive the subtree corresponding to the current headline.
C-c C-s
Schedule this item, with prefix arg remove the scheduling timestamp
C-c C-d
Set a deadline for this item, with prefix arg remove the deadline.
S-right and S-left
Change the timestamp associated with the current line by one day.
I
Start the clock on the current item.
O / X
Stop/cancel the previously started clock.

J
Jump to the running clock in another window.

Vistas de agenda personalizadas
===============================

The main application of custom searches is the definition of keyboard shortcuts for frequently used searches, either creating an agenda buffer, or a sparse tree (the latter covering of course only the current buffer). Custom commands are configured in the variable org-agenda-custom-commands.  You can customize this variable, for example by pressing C-c a C.  You can also directly set it with Emacs Lisp in .emacs.  The following example contains all valid search types:

     (setq org-agenda-custom-commands
           '(("w" todo "WAITING")
             ("u" tags "+boss-urgent")
             ("v" tags-todo "+boss-urgent")))

The initial string in each entry defines the keys you have to press after the dispatcher command C-c a in order to access the command.  Usually this will be just a single character.  The second parameter is the search type, followed by the string or regular expression to be used for the matching.  The example above will therefore define:

C-c a w
     as a global search for TODO entries with WAITING as the TODO keyword

C-c a u
     as a global tags search for headlines marked :boss: but not :urgent:

C-c a v
     as the same search as C-c a u, but limiting the search to headlines that are also TODO items

 Chapter 10 of the manual (http://orgmode.org/manual/Agenda-Views.html#Agenda-Views)

Mat Lundin's tutorial about custom agenda commands (http://orgmode.org/worg/org-tutorials/org-custom-agenda-commands.php)

John Wiegley's setup (http://www.newartisans.com/2007/08/using-org-mode-as-a-day-planner.html)

Marcas para enriquecer la exportación
*************************************

When exporting Org-mode documents, the exporter tries to reflect the structure of the document as accurately as possible in the backend.  Since export targets like HTML, LaTeX, or DocBook allow much richer formatting, Org mode has rules on how to prepare text for rich export.  This section summarizes the markup rules used in an Org-mode buffer.

Elementos del marcado estructural
=================================

Título de documento
-------------------

The title of the exported document is taken from the special line

     #+TITLE: This is the title of the document

Encabezados y secciones
-----------------------

................ ........... Estructura del documento, ....... ...

     #+OPTIONS: H:4

Tabla de contenidos
-------------------

The table of contents is normally inserted directly before the first headline of the file.

     #+OPTIONS: toc:2          (only to two levels in TOC)
     #+OPTIONS: toc:nil        (no TOC at all)

Paragraphs, line breaks, and quoting
------------------------------------

Paragraphs are separated by at least one empty line.  If you need to enforce a line break within a paragraph, use \\ at the end of a line.

To keep the line breaks in a region, but otherwise use normal formatting, you can use this construct, which can also be used to format poetry.

     #+BEGIN_VERSE
      Great clouds overhead
      Tiny black birds rise and fall
      Snow covers Emacs

          -- AlexSchroeder
     #+END_VERSE

When quoting a passage from another document, it is customary to format this as a paragraph that is indented on both the left and the right margin.  You can include quotations in Org-mode documents like this:

     #+BEGIN_QUOTE
     Everything should be made as simple as possible,
     but not any simpler -- Albert Einstein
     #+END_QUOTE

If you would like to center some text, do it like this:

     #+BEGIN_CENTER
     Everything should be made as simple as possible, \\
     but not any simpler
     #+END_CENTER

Énfasis y monoespacio
---------------------

You can make words *bold*, /italic/, _underlined_, =code= and ~verbatim~, and, if you must, +strike-through+.  Text in the code and verbatim string is not processed for Org-mode specific syntax, it is exported verbatim.  To insert a horizontal rules, use a line consisting of only dashes, and at least 5 of them.

Líneas de comentarios
---------------------

Lines starting with zero or more whitespace characters followed by # are treated as comments and will never be exported.  Also entire subtrees starting with the word COMMENT will never be exported.  Finally, regions surrounded by #+BEGIN_COMMENT ... #+END_COMMENT will not be exported.

C-c ;
     Toggle the COMMENT keyword at the beginning of an entry.

Images and Tables
=================

For Org mode tables, the lines before the first horizontal separator line will become table header lines.  You can use the following lines somewhere before the table to assign a caption and a label for cross references, and in the text you can refer to the object with \ref{tab:basic-data}:

     #+CAPTION: This is the caption for the next table (or link)
     #+LABEL:   tbl:basic-data
        | ... | ...|
        |-----|----|

Some backends (HTML, LaTeX, and DocBook) allow you to directly include images into the exported document.  Org does this, if a link to an image files does not have a description part, for example [[./img/a.jpg]]. If you wish to define a caption for the image and maybe a label for internal cross references, you sure that the link is on a line by itself precede it with:

     #+CAPTION: This is the caption for the next figure link (or table)
     #+LABEL:   fig:SED-HR4049
     [[./img/a.jpg]]

You may also define additional attributes for the figure.  As this is backend-specific, see the sections about the individual backends for more information.

Literal examples
================

You can include literal examples that should not be subjected to markup. Such examples will be typeset in monospace, so this is well suited for source code and similar examples.

     #+BEGIN_EXAMPLE
     Some example from a text file.
     #+END_EXAMPLE

For simplicity when using small examples, you can also start the example lines with a colon followed by a space.  There may also be additional whitespace before the colon:

     Here is an example
        : Some example from a text file.

For source code from a programming language, or any other text that can be marked up by font-lock in Emacs, you can ask for it to look like the fontified Emacs buffer

     #+BEGIN_SRC emacs-lisp
     (defun org-xor (a b)
        "Exclusive or."
        (if a (not b) b))
     #+END_SRC

To edit the example in a special buffer supporting this language, use C-c ' to both enter and leave the editing buffer.

Archivos Include
================

During export, you can include the content of another file.  For example, to include your .emacs file, you could use:

     #+INCLUDE: "~/.emacs" src emacs-lisp

The optional second and third parameter are the markup (e.g. quote, example, or src), and, if the markup is src, the language for formatting the contents.  The markup is optional, if it is not given, the text will be assumed to be in Org mode format and will be processed normally. C-c ' will visit the included file.

LaTeX embebido
==============

For scientific notes which need to be able to contain mathematical symbols and the occasional formula, Org-mode supports embedding LaTeX code into its files.  You can directly use TeX-like macros for special symbols, enter formulas and entire LaTeX environments.

     Angles are written as Greek letters \alpha, \beta and \gamma.  The mass if
     the sun is M_sun = 1.989 x 10^30 kg.  The radius of the sun is R_{sun} =
     6.96 x 10^8 m.  If $a^2=b$ and $b=2$, then the solution must be either
     $a=+\sqrt{2}$ or $a=-\sqrt{2}$.

     \begin{equation}
     x=\sqrt{b}
     \end{equation}

With special setup (http://orgmode.org/manual/LaTeX-fragments.html#LaTeX-fragments), LaTeX snippets will be included as images when exporting to HTML.

 Chapter 11 of the manual (http://orgmode.org/manual/Markup.html#Markup)

Exportando
**********

Org-mode documents can be exported into a variety of other formats: ASCII export for inclusion into emails, HTML to publish on the web, LaTeX/PDF for beautiful printed documents and DocBook to enter the world of many other formats using DocBook tools.  There is also export to iCalendar format so that planning information can be incorporated into desktop calendars.

Opciones de exportación
=======================

The exporter recognizes special lines in the buffer which provide additional information.  These lines may be put anywhere in the file.  The whole set of lines can be inserted into the buffer with C-c C-e t.

C-c C-e t
     Insert template with export options, see example below.

     #+TITLE:       the title to be shown (default is the buffer name)
     #+AUTHOR:      the author (default taken from user-full-name)
     #+DATE:        a date, fixed, of a format string for format-time-string
     #+EMAIL:       his/her email address (default from user-mail-address)
     #+DESCRIPTION: the page description, e.g. for the XHTML meta tag
     #+KEYWORDS:    the page keywords, e.g. for the XHTML meta tag
     #+LANGUAGE:    language for HTML, e.g. en (org-export-default-language)
     #+TEXT:        Some descriptive text to be inserted at the beginning.
     #+TEXT:        Several lines may be given.
     #+OPTIONS:     H:2 num:t toc:t \n:nil @:t ::t |:t ^:t f:t TeX:t ...
     #+LINK_UP:     the ``up'' link of an exported page
     #+LINK_HOME:   the ``home'' link of an exported page
     #+LATEX_HEADER: extra line(s) for the LaTeX header, like \usepackage{xyz}

El dispensador de exportación
=============================

All export commands can be reached using the export dispatcher, which is a prefix key that prompts for an additional key specifying the command. Normally the entire file is exported, but if there is an active region that contains one outline tree, the first heading is used as document title and the subtrees are exported.

C-c C-e
     Dispatcher for export and publishing commands.

Exportación ASCII/Latin-1/UTF-8
===============================

ASCII export produces a simple and very readable version of an Org-mode file, containing only plain ASCII.  Latin-1 and UTF-8 export augment the file with special characters and symbols available in these encodings.

C-c C-e a
     Export as ASCII file.

C-c C-e n   and   C-c C-e N
     Like the above commands, but use Latin-1 encoding.

C-c C-e u   and   C-c C-e U
     Like the above commands, but use UTF-8 encoding.

HTML export
===========

C-c C-e h
     Export as HTML file myfile.html.

C-c C-e b
     Export as HTML file and immediately open it with a browser.

To insert HTML that should be copied verbatim to the exported file use either

     #+HTML: Literal HTML code for export

or

     #+BEGIN_HTML
     All lines between these markers are exported literally
     #+END_HTML

Exportar LaTeX y PDF
====================

C-c C-e l
     Export as LaTeX file myfile.tex.

C-c C-e p
     Exportando a LaTeX y procesando a PDF

C-c C-e d
     Export as LaTeX and then process to PDF, then open the resulting PDF file.

By default, the LaTeX output uses the class article.  You can change this by adding an option like #+LaTeX_CLASS: myclass in your file.  The class must be listed in org-export-latex-classes.

........ LaTeX embebido, .....

Exportar DocBook
================

C-c C-e D
     Export as DocBook file.

Similarly to the HTML exporter, you can use #+DOCBOOK: and #+BEGIN_DOCBOOK ... #+END_DOCBOOK construct to add verbatim LaTeX code.

Exportar iCalendar
==================

C-c C-e i
     Create iCalendar entries for the current file in a .ics file.

C-c C-e c
     Create a single large iCalendar file from all files in org-agenda-files and write it to the file given by org-combined-agenda-icalendar-file.

 Chapter 12 of the manual (http://orgmode.org/manual/Exporting.html#Exporting)

Sebastian Rose's image handling tutorial (http://orgmode.org/worg/org-tutorials/images-and-xhtml-export.php)

Thomas Dye's LaTeX export tutorial (http://orgmode.org/worg/org-tutorials/org-latex-export.php)
Eric Fraga's BEAMER presentation tutorial (http://orgmode.org/worg/org-tutorials/org-beamer/tutorial.php)

Publicación
***********

Org includes a publishing management system that allows you to configure automatic HTML conversion of projects composed of interlinked org files.  You can also configure Org to automatically upload your exported HTML pages and related attachments, such as images and source code files, to a web server.  For detailed instructions about setup, see the manual.

Here is an example:

     (setq org-publish-project-alist
           '(("org"
              :base-directory "~/org/"
              :publishing-directory "~/public_html"
              :section-numbers nil
              :table-of-contents nil
              :style "<link rel=\"stylesheet\"
                     href=\"../other/mystyle.css\"
                     type=\"text/css\"/>")))

C-c C-e C
     Prompt for a specific project and publish all files that belong to it.

C-c C-e P
     Publish the project containing the current file.

C-c C-e F
     Publish only the current file.

C-c C-e E
     Publish every project.

Org uses timestamps to track when a file has changed.  The above functions normally only publish changed files.  You can override this and force publishing of all files by giving a prefix argument to any of the commands above.

 Chapter 13 of the manual (http://orgmode.org/manual/Publishing.html#Publishing)

Sebastian Rose's publishing tutorial (http://orgmode.org/worg/org-tutorials/org-publish-html-tutorial.php)

Ian Barton's Jekyll/blogging setup (http://orgmode.org/worg/org-tutorials/org-jekyll.php)

Trabajando con código fuente
****************************

Org-mode provides a number of features for working with source code, including editing of code blocks in their native major-mode, evaluation of code blocks, tangling of code blocks, and exporting code blocks and their results in several formats.

Structure of Code Blocks
------------------------

The structure of code blocks is as follows:

     #+NAME: <name>
     #+BEGIN_SRC <language> <switches> <header arguments>
       <body>
     #+END_SRC

Where <name> is a string used to name the code block, <language> specifies the language of the code block (e.g. emacs-lisp, shell, R, python, etc...), <switches> can be used to control export of the code block, <header arguments> can be used to control many aspects of code block behavior as demonstrated below, and <body> contains the actual source code.

Editando código fuente
----------------------

Use C-c ' to edit the current code block.  This brings up a language major-mode edit buffer containing the body of the code block.  Saving this buffer will write the new contents back to the Org buffer.  Use C-c ' again to exit the edit buffer.

Evaluating code blocks
----------------------

Use C-c C-c to evaluate the current code block and insert its results in the Org-mode buffer.  By default, evaluation is only turned on for emacs-lisp code blocks, however support exists for evaluating blocks in many languages.  For a complete list of supported languages see the manual.  The following shows a code block and its results.

     #+BEGIN_SRC emacs-lisp
       (+ 1 2 3 4)
     #+END_SRC

     #+RESULTS:
     : 10

Extrayendo código fuente
------------------------

Use C-c C-v t to create pure source code files by extracting code from source blocks in the current buffer.  This is referred to as ``tangling''---a term adopted from the literate programming community. During ``tangling'' of code blocks their bodies are expanded using org-babel-expand-src-block which can expand both variable and ``noweb'' style references.  In order to tangle a code block it must have a :tangle header argument, see the manual for details.

Library of Babel
----------------

Use C-c C-v l to load the code blocks from an Org-mode files into the ``Library of Babel'', these blocks can then be evaluated from any Org-mode buffer.  A collection of generally useful code blocks is distributed with Org-mode in contrib/library-of-babel.org.

Header Arguments
----------------

Many aspects of the evaluation and export of code blocks are controlled through header arguments.  These can be specified globally, at the file level, at the outline subtree level, and at the individual code block level.  The following describes some of the header arguments.

:var
     The :var header argument is used to pass arguments to code blocks. The values passed to arguments can be literal values, values from org-mode tables and literal example blocks, or the results of other named code blocks.

:results
     The :results header argument controls the collection, type, and handling of code block results.  Values of output or value (the default) specify how results are collected from a code block's evaluation.  Values of vector, scalar file raw html latex and code specify the type of the results of the code block which dictates how they will be incorporated into the Org-mode buffer.  Values of silent, replace, prepend, and append specify handling of code block results, specifically if and how the results should be inserted into the Org-mode buffer.

:session
     A header argument of :session will cause the code block to be evaluated in a persistent interactive inferior process in Emacs.  This allows for persisting state between code block evaluations, and for manual inspection of the results of evaluation.

:exports
     Any combination of the code or the results of a block can be retained on export, this is specified by setting the :results header argument to code results none or both.

:tangle
     A header argument of :tangle yes will cause a code block's contents to be tangled to a file named after the filename of the Org-mode buffer.  An alternate file name can be specified with :tangle filename.

:cache
     A header argument of :cache yes will cause associate a hash of the expanded code block with the results, ensuring that code blocks are only re-run when their inputs have changed.

:noweb
     A header argument of :noweb yes will expand ``noweb'' style references on evaluation and tangling.

:file
     Code blocks which output results to files (e.g. graphs, diagrams and figures)  can accept a :file filename header argument in which case the results are saved to the named file, and a link to the file is inserted into the Org-mode buffer.

Chapter 11.3 of the manual (http://orgmode.org/manual/Literal-examples.html#Literal-examples)

The Babel site on Worg (http://orgmode.org/worg/org-contrib/babel/index.php)

Misceláneos
***********

Terminación
===========

Org supports in-buffer completion with M-TAB.  This type of completion does not make use of the minibuffer.  You simply type a few letters into the buffer and use the key to complete text right there.  For example, this command will complete TeX symbols after \, TODO keywords at the beginning of a headline, and tags after : in a headline.

A cleaner outline view
======================

Some people find it noisy and distracting that the Org headlines start with a potentially large number of stars, and that text below the headlines is not indented.  While this is no problem when writing a book-like document where the outline headings are really section headings, in a more list-oriented outline, indented structure is a lot cleaner:

     * Top level headline             |    * Top level headline
     ** Second level                  |      * Second level
     *** 3rd level                    |        * 3rd level
     some text                        |          some text
     *** 3rd level                    |        * 3rd level
     more text                        |          more text
     * Another top level headline     |    * Another top level headline

If you are using at least Emacs 23.1.50.3 and version 6.29 of Org, this kind of view can be achieved dynamically at display time using org-indent-mode, which will prepend intangible space to each line. You can turn on org-indent-mode for all files by customizing the variable org-startup-indented, or you can turn it on for individual files using

     #+STARTUP: indent

If you want a similar effect in earlier version of Emacs and/or Org, or if you want the indentation to be hard space characters so that the plain text file looks as similar as possible to the Emacs display, Org supports you by helping to indent (with TAB) text below each headline, by hiding leading stars, and by only using levels 1, 3, etc to get two characters indentation for each level.  To get this support in a file, use

     #+STARTUP: hidestars odd

Org móvil
=========

MobileOrg is the name of the mobile companion app for Org mode, currently available for iOS and for Android.  MobileOrg offers offline viewing and capture support for an Org mode system rooted on a ``real'' computer.  It does also allow you to record changes to existing entries.

The iOS implementation (http://mobileorg.ncogni.to/) for the iPhone/iPod Touch/iPad series of devices, was developed by Richard Moreland. Android users should check out MobileOrg Android (http://wiki.github.com/matburt/mobileorg-android/) by Matt Jones.  The two implementations are not identical but offer similar features.

 Chapter 15 of the manual (http://orgmode.org/manual/Miscellaneous.html#Miscellaneous)

Appendix B of the manual (http://orgmode.org/manual/MobileOrg.html#MobileOrg)
 Key reference card (http://orgmode.org/orgcard.pdf)