fixing bugs transforming to html

[worg.git] / orgguide / orgguide.es.texi

\input texinfo
@c ===========================================================================
@c
@c This file was generated with po4a. Translate the source file.
@c
@c ===========================================================================
@c %**start of header
@setfilename ../../info/orgguide
@settitle La Gu@'{@dotless{i}}a compacta de Org-mode

@include org-version.inc

@c Use proper quote and backtick for code sections in PDF output
@c Cf. Texinfo manual 14.2
@set txicodequoteundirected
@set txicodequotebacktick

@c Version and Contact Info
@set MAINTAINERSITE @uref{http://orgmode.org,maintainers webpage}
@set AUTHOR Carsten Dominik
@set MAINTAINER Carsten Dominik
@set MAINTAINEREMAIL @email{carsten at orgmode dot org}
@set MAINTAINERCONTACT @uref{mailto:carsten at orgmode dot org,contact the maintainer}
@c %**end of header
@finalout

@c Macro definitions
@iftex
@c @hyphenation{time-stamp time-stamps time-stamp-ing time-stamp-ed}
@end iftex

@c Subheadings inside a table.
@macro tsubheading{text}
@ifinfo
@subsubheading \text\
@end ifinfo
@ifnotinfo
@item @b{\text\}
@end ifnotinfo
@end macro

@macro seealso{text}
@noindent @b{Further reading}@*@noindent \text\
@end macro
@copying

Copyright @copyright{} 2010-2012 Free Software Foundation

@quotation
Se permite la copia, distribuci@'on y/o modificaci@'on de este
documento bajo los t@'erminos 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@'a incluida
en la secci@'on 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@'on del software
libre'.

Este documento forma parte de una colecci@'on distribuida bajo la GNU
Free Documentation License. Si desea distribuir este documento
separadamente de la colecci@'on, puede hacerlo a@~nadiendo una copia de
la licencia al documento, como se describe en la secci@'on 6 de la
licencia.
@end quotation
@end copying

@dircategory Emacs
@direntry
* Gu@'{@dotless{i}}a de Org-mode: (orgguide).  Manual de Org-mode Abreviado
@end direntry

@titlepage
@title La Gu@'{@dotless{i}}a compacta de Org-mode

@subtitle Versi@'on @value{VERSION}
@author por Carsten Dominik

@c The following two commands start the copyright page.
@page
@vskip 0pt plus 1filll
@insertcopying
@end titlepage

@c Output the table of contents at the beginning.
@shortcontents

@ifnottex
@node Top, Introducci@'on, (dir), (dir)
@top Gu@'{@dotless{i}}a de Org Mode

@insertcopying
@end ifnottex

@menu
* Introducci@'on::           Comenzando
* Estructura del documento::  Un @'arbol funciona como tu cerebro
* Tablas::                   Pura magia para formatear r@'apido
* Hiperenlaces::             Notas en contexto
* Items TODO::               Cada rama del @'arbol puede ser un 
                               @'{@dotless{i}}tem TODO
* Etiquetas::                Etiquetando cabeceras y encontrando grupos de 
                               etiquetas
* Propiedades::              Propiedades
* Fechas y horas::           Creando @'{@dotless{i}}tems @'utiles para 
                               planificar
* Capture - Refile - Archive::  Las entradas y salidas para proyectos
* Vistas de la Agenda::      Recolectando informaci@'on en vistas
* Marcado::                  Preparar texto para exportaci@'on enriquecida
* Exportando::               Compartici@'on y publicaci@'on de notas
* Publicaci@'on::            Crear un sitio web de ficheros Org enlazados
* Trabajando con C@'odigo Fuente::  Trozos de c@'odigo fuente embebidos en 
                                      Org
* Miscel@'anea::             El resto de cosas que no tienen otro lugar

@detailmenu
 --- El Listado Detallado de Nodos ---



Introducci@'on



* Prefacio::                 Bienvenida
* Instalaci@'on::            C@'omo instalar una versi@'on descargada de Org
* Activaci@'on::             C@'omo activar Org para ciertos buffers
* Realimentaci@'on::         Informes de error, ideas, parches, etc.

Estructura del documento



* Outlines::                 Org est@'a basado en el modo Outline
* Cabeceras::                C@'omo escribir un @'arbol de cabeceras Org
* Visibilidad c@'{@dotless{i}}clica::  Mostrar y ocultar, muy simplificado
* Movimiento::               Saltando a otras cabeceras
* Edici@'on de estructura::  Cambiando la secuencia y el nivel de cabeceras
* @'Arboles poco densos::    Correspondencias embebidas en contexto
* Listas planas::            Estructura adicional con una entrada
* Notas al pie::             C@'omo las notas al pie est@'an definidas en 
                               sintaxis Org

Hiperenlaces



* Formato de enlace::        C@'omo los enlaces son formateados en Org
* Enlaces internos::         Enlaces a otros lugares en el fichero actual
* Enlaces externos::         Enlaces tipo URL para el mundo
* Manejando enlaces::        Creando, insertando y siguiendo
* Destinos enlazados::       Apuntando a una localizaci@'on en un archivo

Items TODO



* Usando los estados TODO::  Poniendo y cambiado estados
* Flujos de trabajo multi-estado::  M@'as que ahora si/no
* Proceso de acceso::        Fechas y notas para el progreso
* Prioridades::              Algunas cosas son m@'as importantes que otras
* Rompiendo tareas::         Partiendo una tarea en piezas manejables
* Cajas de chequeo::         Listas de marcas

Proceso de acceso



* Cerrando items::           ¿Cu@'ando fu@'e marcada esta entrada a DONE?
* Trazando los estados TODO::  ¿Cuando cambia el estado?

Etiquetas



* Marca de herencia::        Las marcas usan el @'arbol de estructura de la 
                               idea general
* Poniendo marcas::          C@'omo asignar etiquetas a una cabecera
* Buscando marcas::          Buscando combinaciones de etiquetas

Fechas y horas



* Instante en el tiempo::    Asignaci@'on de tiempo a una entrada de @'arbol
* Creando instantes de tiempo::  Comandos para insertar instantes de tiempo
* Fecha l@'{@dotless{i}}mite y planificaci@'on::  Planificando tu trabajo
* Estableciendo tiempo de trabajo::  Llevando la cuenta de cuanto se gasta 
                                       en una tarea

Capture - Refile - Archive



* Capturar::                 
* Rellenar y copiar::        Moviendo un @'arbol de un lugar a otro
* Archivando::               Qu@'e se hace con los proyectos terminados

Capturar



* Poniendo una posici@'on de captura::  Donde ser@'an almacenadas las notas
* Usando capturas::          Comandos para invocar y finalizar capturas
* Plantillas de capturas::   Define la idea general de diferentes tipos de 
                               notas

Vistas de la Agenda



* Archivos de agenda::       Archivos buscados para la informaci@'on de la 
                               agenda
* El disparador de la agenda::  Acceso a las vistas de la agenda con teclado
* Vistas de agenda internas::  ¿Qu@'e hay fuera de la caja?
* Comandos de la agenda::    Edici@'on remota de @'arboles Org
* Vistas de agenda personalizadas::  Definiendo b@'usquedas y vistas 
                                       especiales

Las vistas internas de la agenda



* Agenda semanal/diaria::    La p@'agina del calendario con las tareas 
                               actuales
* Lista global TODO::        Todas las acciones de @'{@dotless{i}}tems no 
                               finalizados
* Coincidiendo marcas y propiedades::  Informaci@'on estructurada con 
                                         b@'usquedas afinadas
* L@'{@dotless{i}}nea de tiempo::  Vista ordenada en el tiempo de un simple 
                                     archivo
* Vista de b@'usqueda::      Encontrando entradas buscando texto

Marcas para enriquecer la exportaci@'on



* Elementos del marcado estructural::  La estructura b@'asica es vista por 
                                         el exportador
* Im@'agenes y tablas::      Tablas e im@'agenes ser@'an incluidas
* Ejemplos literales::       Ejemplos de c@'odigo fuente con formato 
                               especial
* Archivos Include::         Archivos adicionales Include dentro de un 
                               documento
* @LaTeX{} embebido::        @LaTeX{} puede usarse libremente dentro de los 
                               documentos Org

Elementos del marcado estructural



* T@'{@dotless{i}}tulo de documento::  Desde donde el t@'{@dotless{i}}tulo 
                                         es tomado
* Encabezados y secciones::  La estructura del documento es vista por el 
                               exportador
* Tabla de contenidos::      El si y el donde de la tabla de contenidos
* P@'arrafos::               P@'arrafos
* @'Enfasis y monoespacio::  Negrilla, it@'alica, etc.
* L@'{@dotless{i}}neas de comentarios::  Qu@'e *no* ser@'a exportado

Exportando



* Opciones de exportaci@'on::  Configuraci@'ones del perf@'{@dotless{i}}l de 
                                 exportaci@'on
* El dispensador de exportaci@'on::  Como acceder a los comandos del 
                                       exportador
* Exportaci@'on ASCII/Latin-1/UTF-8::  Exportando a ficheros planos con 
                                         codificaci@'on
* HTML export::              Exportando a HTML
* Exportar @LaTeX{} y PDF::  Exportando a @LaTeX{}, y procesando a PDF
* Exportar DocBook::         Exportando a DocBook
* Exportar iCalendar::                  

Miscel@'anea



* Terminaci@'on::            M-TAB sabe qu@'e necesita
* Vista limpia::             Eliminaci@'on de los asteriscos iniciales en el 
                               outline
* Org m@'ovil::              Org-mode en el iPhone

@end detailmenu
@end menu

@node Introducci@'on, Estructura del documento, Top, Top
@chapter Introducci@'on

@menu
* Prefacio::                 Bienvenida
* Instalaci@'on::            C@'omo instalar una versi@'on descargada de Org
* Activaci@'on::             C@'omo activar Org para ciertos buffers
* Realimentaci@'on::         Informes de error, ideas, parches, etc.
@end menu

@node Prefacio, Instalaci@'on, Introducci@'on, Introducci@'on
@section Prefacio

Org es un modo para guardar notas, manteniendo listas TODO (por
hacer), y haciendo planes de proyectos con un r@'apido y efectivo
sistema de texto plano. Es adem@'as un sistema de publicaci@'on y
autor@'{@dotless{i}}a.

@i{Este documento es un resumen derivado del
@uref{http://orgmode.org/index.html#sec-4-1, manual completo de
Org-mode}. Contiene todas las funcionalidades b@'asicas y comandos,
junto con importantes detalles de personalizaci@'on. Se recomienda
para principiantes que se asustan con manuales de 200 p@'aginas solo
por su tama@~no.}

@node Instalaci@'on, Activaci@'on, Prefacio, Introducci@'on
@section Instalaci@'on

@b{Importante:} @i{Si se usa una versi@'on de Org que es parte de una
distribuci@'on de Emacs o un paquete de XEmacs, por favor s@'altese
esta secci@'on y vaya directamente a @ref{Activaci@'on}.}

Si se ha descargado Org de la web, como distribuci@'on de ficheros
bien @file{.zip}, o bien @file{.tar}, o como un archivo Git, es
preferible ejecutarlo directamente desde el directorio de la
distribuci@'on. Necesitar@'a a@~nadir los subdirectorios @file{lisp}
al camino de carga de Emacs. Para hacer esto, a@~nada la siguiente
l@'{@dotless{i}}nea al archivo @file{.emacs}:

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

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

@smallexample
make@end smallexample

@node Activaci@'on, Realimentaci@'on, Instalaci@'on, Introducci@'on
@section Activaci@'on

A@~nada las siguientes l@'{@dotless{i}}neas a su archivo
@file{.emacs}. Las @'ultimas tres l@'{@dotless{i}}neas definen las
claves @emph{global} de algunos comandos ---por favor, elija claves
apropiadas por s@'{@dotless{i}} mismo.

@smalllisp
;; Las siguientes l@'{@dotless{i}}neas son siempre necesarias.
;; Elija sus propias claves.
(add-to-list 'auto-mode-alist '(".org'" . org-mode))
(add-hook 'org-mode-hook 'turn-on-font-lock)
;; no es necesario cuando global-font-lock-mode est@'a activado
(global-set-key "\C-cl" 'org-store-link)
(global-set-key "\C-ca" 'org-agenda)
(global-set-key "\C-cb" 'org-iswitchb)
@end smalllisp

Con esta configuraci@'on, todos los archivos con extensi@'on
@samp{.org} ser@'an tratados en modo Org. 

@node Realimentaci@'on, , Activaci@'on, Introducci@'on
@section Realimentaci@'on

Si encuentra problemas con Org, o si tiene preguntas, comentarios, u
otras ideas acerca de @'el, por favor envie un correo a la lista de
Org @email{emacs-orgmode@@gnu.org}. Para m@'as informaci@'on de c@'omo
enviar informes de error, lea el manual principal.

@node Estructura del documento, Tablas, Introducci@'on, Top
@chapter Estructura del documento

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

@menu
* Outlines::                 Org est@'a basado en el modo Outline
* Cabeceras::                C@'omo escribir un @'arbol de cabeceras Org
* Visibilidad c@'{@dotless{i}}clica::  Mostrar y ocultar, muy simplificado
* Movimiento::               Saltando a otras cabeceras
* Edici@'on de estructura::  Cambiando la secuencia y el nivel de cabeceras
* @'Arboles poco densos::    Correspondencias embebidas en contexto
* Listas planas::            Estructura adicional con una entrada
* Notas al pie::             C@'omo las notas al pie est@'an definidas en 
                               sintaxis Org
@end menu

@node Outlines, Cabeceras, Estructura del documento, Estructura del documento
@section Outlines

Org est@'a implementado en lo alto del modo outline. Los outlines
(@'{@dotless{i}}tems de contenido) permiten a un documento organizarse
en una estructura jer@'arquica, lo cual (al menos para
m@'{@dotless{i}}) es la mejor forma para representar notas y
pensamientos. Una visi@'on preliminar de esta estructura se logra al
encoger (ocultar) grandes partes del documento y mostrar s@'olo la
estructura general del documento y las partes en las que se est@'a
trabajando. Org simplifica enormemente el uso de outlines para
comprender la funcionalidad completa de mostrar/ocultar en un simple
comando, @command{org-cycle}, el cual est@'a asignado a la tecla
@key{TAB}.

@node Cabeceras, Visibilidad c@'{@dotless{i}}clica, Outlines, Estructura del documento
@section Cabeceras

Los cabeceras@footnote{Nota del Traductor. Headlines es traducido por
cabecera y hace referencia a t@'{@dotless{i}}tulos y
subt@'{@dotless{i}}tulos}
definen la estructura del @'arbol de sangrado (@'{@dotless{i}}tems de
contenido). Los t@'{@dotless{i}}tulos y subt@'{@dotless{i}}tulos en
Org comienzan con uno o m@'as asteriscos, en el margen
izquierdo@footnote{Vea la variable @code{org-special-crtl-a/e} para
configurar el comportamiento de @kbd{C-a} y @kbd{C-e} en los
t@'{@dotless{i}}tulos.}. Por ejemplo:

@smallexample
* Cabecera de nivel superior
** Segundo nivel
*** Tercer nivel
    cualquier texto
*** Tercer nivel
    m@'as texto

* Otro t@'{@dotless{i}}tulo de nivel superior
@end smallexample

@noindent Some people find the many stars too noisy and would prefer an
La idea general que tiene un espacio en blanco seguido por un
asterisco es el comienzo de un subt@'{@dotless{i}}tulo o
cabecera. @ref{Vista limpia}, describe una configuraci@'on para
realizar esto.

@node Visibilidad c@'{@dotless{i}}clica, Movimiento, Cabeceras, Estructura del documento
@section Visibilidad c@'{@dotless{i}}clica

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

@table @kbd
@item @key{TAB}
@emph{Sub@'arbol c@'{@dotless{i}}clico}: Rotaci@'on en el sub@'arbol
entre los estados

@smallexample
,-> ENCOGIDO -> HIJO -> SUB@'ARBOL --.
'------------------------------------'@end smallexample

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

@item S-@key{TAB} @r{y} C-u @key{TAB}
@emph{Ciclo global}: Rotar el buffer entero entre los estados

@smallexample
,-> RESUMEN -> CONTENIDO -> MOSTRAR TODO --.
'------------------------------------------'@end smallexample

@item C-u C-u C-u @key{TAB}
Mostrar todo, incluidos los calzoncillos
@end table

Cuando Emacs abre por primera vez un archivo Org, pone el estado
global a RESUMEN (OVERVIEW) p.e.@: s@'olo las cabeceras de nivel
superior son visibles. Esto puede configurarse a trav@'es de la
variable @code{org-startup-folded}, o v@'{@dotless{i}}a fichero
a@~nadiendo una palabra reservada @code{overview}, @code{content},
@code{showall}, como esta:

@smallexample
#+STARTUP: content
@end smallexample


@node Movimiento, Edici@'on de estructura, Visibilidad c@'{@dotless{i}}clica, Estructura del documento
@section Movimiento
El siguiente comando salta a la siguiente cabecera en el buffer.

@table @kbd
@item C-c C-n
Siguiente cabecera.
@item C-c C-p
Cabecera previa.
@item C-c C-f
Siguiente cabecera del mismo nivel.
@item C-c C-b
Cabecera previa del mismo nivel.
@item C-c C-u
Retroceder a la cabecera de nivel superior.
@end table

@node Edici@'on de estructura, @'Arboles poco densos, Movimiento, Estructura del documento
@section Edici@'on de estructura

@table @kbd
@item M-@key{RET}
Inserta una nueva cabecera al mismo nivel que la actual. Si el cursor
est@'a en un item de una lista plana, un nuevo item es creado
(@pxref{Listas planas}). Cuando este comando es usado en medio de una
l@'{@dotless{i}}nea, la l@'{@dotless{i}}nea es partida y el resto de
la l@'{@dotless{i}}nea ser@'a una nueva cabecera@footnote{Si no desea
que la l@'{@dotless{i}}nea sea partida, personalice la variable
@code{org-M-RET-may-split-line}.}.
@item M-S-@key{RET}
Inserta una nueva entrada TODO con el mismo nivel de la cabecera actual.
@item @key{TAB} @r{en nueva, entrada vacia}
En una nueva entrada sin texto a@'un, @key{TAB} rotar@'a
c@'{@dotless{i}}clicamente a trav@'es de niveles similares.
@item M-@key{left}@r{/}@key{right}
Promociona/devalua la cabecera actual en un nivel.
@item M-S-@key{left}@r{/}@key{right}
Promociona/devalua el subarbol actual en un nivel.
@item M-S-@key{up}@r{/}@key{down}
Mueve el subarbol arriba/abajo (intercambia entre anterior/siguiente
subarbol del mismo nivel).
@item C-c C-w
Mueve la entrada o regi@'on en una lozalizaci@'on
diferente. @xref{Rellenar y copiar}.
@item C-x n s/w
Limitar la memoria intermedia al @'arbol actual / ocult@'andolo
@end table

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

@node @'Arboles poco densos, Listas planas, Edici@'on de estructura, Estructura del documento
@section @'Arboles poco densos

Una importante caracter@'{@dotless{i}}stica de Org-mode es su
posibilidad para construir @emph{@'arboles poco densos} para la
informaci@'on seleccionada en un arbol de outline, as@'{@dotless{i}}
que el documento entero es manejado como es posible, pero la
informaci@'on seleccionada es hecha visible con la estructura de
cabaceras de encima@footnote{Vea adem@'as las variables
@code{org-show-hierarchy-above}, @code{org-show-following-heading},
@code{org-show-siblings} y @code{org-show-entry-below} para controlar
los detalles de c@'omo el contexto se muestra en cada
coincidencia.}. Int@'entelo ahora y ver@'a inmediatamente como
funciona.

Org-mode contiene varios comandos para crear @'arboles, todos estos
comandos pueden ser accedidos a trav@'es del despachador:

@table @kbd
@item C-c /
Este prompt es una clave especial para seleccionar un comando de
creaci@'on de un @'arbol poco denso.
@item C-c / r
Ocurrencia. Prompt para una expresi@'on regular y muestra un @'arbol
poco denso con todas sus coincidencias. Cada coincidencia ser@'a
sobresaltada; El sobresaltado desaparecer@'a presionando @kbd{C-c
C-c}.
@end table

Otros comandos de @'arbol poco denso seleccionan las cabeceras basadas
en la palabra reservada TODO, etiquetas o propiedades y ser@'an discutidos
posteriormente en este manual.

@node Listas planas, Notas al pie, @'Arboles poco densos, Estructura del documento
@section Listas planas

Sin una entrada en el @'arbol de outline, listas formateadas a mano
pueden suministrar una estructura adicional. Ello tambi@'en
proporciona una forma de crear listas de cajas de chequeo
(@pxref{Cajas de chequeo}). Org soporta la edici@'on de tales listas,
y el conversor HTML (@pxref{Exportando}) los analiza y formatea.

Org permite listas ordenadas, desordenadas y describirlas.
@itemize @bullet
@item
@emph{Desordenada} los items de la lista comienzan con @samp{-},
@samp{+} o @samp{*} como marcas.
@item
@emph{Ordenada} los items de la lista comienzan con @samp{1.} o
@samp{1)}.
@item
@emph{Descripci@'on} la lista usa @samp{ :: } para separar el
@emph{t@'ermino} de la descripci@'on.
@end itemize

Los items subsiguientes de la misma lista deben tener el mismo
sangrado en la primera l@'{@dotless{i}}nea. Un item que termine antes
de la siguiente l@'{@dotless{i}}nea ser@'a sangrado como
bola/n@'umero, o no. Una lista termina cuando todos los items est@'an
cerrados, o antes de dos l@'{@dotless{i}}neas en blanco. Un ejemplo:

@smallexample
@group
** El Se@~nor de los Anillos
   Mis escenas favoritas son (en este orden)
   1. El ataque de Rohirrim
   2. Combate de Eowyn con el rey
      + Esta es tambi@'en mi escena favorita en el libro
      + Es realmente como Miranda Otto.
   Actores importantes es esta pel@'{@dotless{i}}cula:
   - @b{Elijah Wood} :: En el papel de Frodo
   - @b{Sean Austin} :: En el papel de Sam, amigo de Frodo.@end group
@end smallexample

Los siguientes comandos actuan en items cuando el cursor est@'a en la
primera l@'{@dotless{i}}mea de un item (la l@'{@dotless{i}}nea con la
bola o el n@'umero). 

@table @kbd
@item @key{TAB}
Los items pueden ser manejados como cabeceras de niveles.
@item M-@key{RET}
Inserta un nuevo item al nivel actual. Con el argumento de prefijo,
fuerza a una nueva cabecera (@pxref{Edici@'on de estructura}).
@item M-S-@key{RET}
Inserta un nuevo item con una caja de chequeo (@pxref{Cajas de chequeo}).
@item M-S-@key{up}@r{/}@key{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@'on es autom@'atica.
@item M-@key{left}@r{/}M-@key{right}
Decrementa/incrementa el sangrado del item, dejando los hijos sueltos.
@item M-S-@key{left}@r{/}@key{right}
Decrementa/incrementa el sangrado del item. incluyendo los subitems.
@item C-c C-c
Si es una caja de chequeo (@pxref{Cajas de chequeo}) en una
l@'{@dotless{i}}nea item, cambia el estado de la caja de
chequeo. Adem@'as verifica las bolas y el sangrado consistente en la
lista completa.
@item C-c -
Rota la lista entera a trav@'es de diferentes bolas de
numeraci@'on/marcado (@samp{-}, @samp{+}, @samp{*}, @samp{1.},
@samp{1)}).
@end table

@node Notas al pie, , Listas planas, Estructura del documento
@section Notas al pie

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

@smallexample
La p@'agina web de Org[fn:1] ahora parece un poco mejor que cuando la
usaba.
...
[fn:1] El enlace es: http://orgmode.org@end smallexample

@noindent The following commands handle footnotes:

@table @kbd
@item C-c C-x f
El comando de acci@'on de Nota al pie. Cuando el cursor est@'a en una
referencia a un nota al pie, salta a su definici@'on. Cuando est@'a en
la definici@'on, salta a la (primera) referencia. En otro caso, crea
una nueva nota al pie. Cuando este comando es llamado con un
arguimento como prefijo, aparecer@'a un men@'u adicional incluyendo
opciones de renumeraci@'on.

@item C-c C-c
Salta entre definici@'on y referencia.
@end table

@seealso{@uref{http://orgmode.org/manual/Document-Structure.html#Document-Structure,
Cap@'{@dotless{i}}tulo 2 del manual de
Org-mode}@*@uref{http://sachachua.com/wp/2008/01/outlining-your-notes-with-org/,
Tutorial de Sacha Chua}}


@node Tablas, Hiperenlaces, Estructura del documento, Top
@chapter Tablas

Org viene con un r@'apido e intuitivo editor de tablas. C@'alculos
similares a los de una hoja de c@'alculo son soportados en conexi@'on
con el paquete Emacs @file{calc}
@ifinfo
(@pxref{Top,Calc,,Calc,Gnu Emacs Calculator Manual}).
@end ifinfo
@ifnotinfo
(vea el manual de Emacs Calculator para m@'as informaci@'on sobre la
calculadora de Emacs).
@end ifnotinfo

Org hace f@'acil formatear tablas en ASCII plano. Cualquier
l@'{@dotless{i}}nea con @samp{|} como primer car@'acter no-espacio es
considerado parte de una tabla. @samp{|} es adem@'as el separador de
columnas. Una tabla puede parecer algo as@'{@dotless{i}}:

@smallexample
| Nombre  | Tel@'efono | Edad |
|---------+----------+------|
| Pedro   | 12345678 |  17  |
| Ana     | 87654321 |  25  |
@end smallexample

Una tabla es realineada autom@'aticamente cada vez que se presione
@key{TAB} o @key{RET} o @kbd{C-c C-c} dentro de la tabla. @key{TAB}
adem@'as mueve al siguiente campo (@key{RET} a la siguiente fila) y
crea una nueva tabla de filas al final de la tabla o antes de las
l@'{@dotless{i}}neas horizontales. El sangrado de la tabla es puesto
por la primera l@'{@dotless{i}}nea. Cualquier l@'{@dotless{i}}nea
comenzando con @samp{|-} es considerada como un separador horizontal
de l@'{@dotless{i}}nea y ser@'a expandido en la siguiente
realineaci@'on para expandirse al ancho completo de la
tabla. As@'{@dotless{i}}, para crear una tabla dentro, debe s@'olo
introducir 

@smallexample
|Nombre|Tel@'efono|Edad|
|-
@end smallexample

@noindent and then press @key{TAB} to align the table and start filling in
entonces presione @key{TAB} para alinear la tabla y comenzar a
introducir datos. M@'as r@'apido debe ser introducir
@code{|Nombre|Tel@'efono|Edad} seguido de @kbd{C-c @key{RET}}.

Cuando se introduce texto en un campo, Org trata @key{DEL},
@key{Backspace} y todas las teclas de forma especial, para que la
inserci@'on y el borrado eviten desplazarse a otros campos. Por tanto,
cuando se introduce @emph{inmediatamente despu@'es de que el cursor se
haya movido dentro de un nuevo campo con @kbd{@key{TAB}},
@kbd{S-@key{TAB}} o @kbd{@key{RET}}}, el campo es autom@'aticamente
puesto en blanco.

@table @kbd
@tsubheading{Creaci@'on y conversi@'on}
@item C-c |
Convierte la regi@'on activa en tabla. Si cada l@'{@dotless{i}}nea
contiene al menos un car@'acter TAB, la funci@'on asume que la
informaci@'on est@'a separada por tabuladores. Si cada
l@'{@dotless{i}}nea contiene una coma, se asumen valores separados por
coma (CSV). Si no, las l@'{@dotless{i}}neas son partidas en campos por
los espacios. @* Si no hay regi@'on activa, este comando crea una
tabla Org vacia. Pero es f@'acil justo ahora comenzar a introducir
algo como @kbd{|Nombre|Tel@'efono|Edad C-c @key{RET}}.

@tsubheading{Realineaci@'on y movimiento}
@item C-c C-c
@c
Realinea la tabla sin mover el cursor.
@item @key{TAB}
@c
Realinea la tabla, se mueve al siguiente campo. Crea una nueva fila si
es necesario.
@item S-@key{TAB}
@c
Realinea, moverse al campo anterior.
@item @key{RET}
Realinea la tabla y se mueve abajo a la siguiente fila. Crea una nueva
fila si es necesario.

@tsubheading{Edici@'on de filas y columnas}
@item M-@key{left}
@itemx M-@key{right}
@c
Mueve el cursor a la columna izquierda/derecha.
@item M-S-@key{left}
@c
Elimina la columna actual.
@item M-S-@key{right}
@c
Inserta una nueva columna a la izquierda de la posici@'on del cursor.
@item M-@key{up}
@itemx M-@key{down}
@c
Mueve la actual fila arriba/abajo.
@item M-S-@key{up}
@c
Elimina la fila o l@'{@dotless{i}}nea horizontal actual.
@item M-S-@key{down}
@c
Inserta una nueva fila sobre la fila actual. Con prefijo argumento, la
l@'{@dotless{i}}nea es creada debajo de la actual.
@item C-c -
@c
Inserta una l@'{@dotless{i}}nea horizontal bajo la fila actual. Con
prefijo argumento, la l@'{@dotless{i}}nea es creada sobre la
l@'{@dotless{i}}nea actual.
@item C-c @key{RET}
@c
Inserta una l@'{@dotless{i}}nea horizontal bajo la fila actual, y
mueve el cursor a la fila bajo la l@'{@dotless{i}}nea.
@item C-c ^
Ordena las l@'{@dotless{i}}neas de una tabla en una regi@'on. La
posici@'on del punto indica la columna usada para la ordenaci@'on, y
el rango de l@'{@dotless{i}}neas es el rango entre el separador de
l@'{@dotless{i}}neas m@'as pr@'oximo, o la tabla completa.

@end table

@seealso{ @uref{http://orgmode.org/manual/Tables.html#Tables,
Cap@'{@dotless{i}}tulo 3 del manual de Org }@*
@uref{http://orgmode.org/worg/org-tutorials/tables.php, Tutorial de
tablas de Bastien}@*
@uref{http://orgmode.org/worg/org-tutorials/org-spreadsheet-intro.php,
Tutorial de hojas de c@'alculo de Bastien}@*
@uref{http://orgmode.org/worg/org-tutorials/org-plot.php, Tutorial de
gr@'aficos de Eric}}

@node Hiperenlaces, Items TODO, Tablas, Top
@chapter Hiperenlaces

Al igual que HTML, Org permite enlaces dentro de archivos, enlaces
externos a otros archivos, art@'{@dotless{i}}culos de Usenet, correos
electr@'onicos y mucho m@'as.

@menu
* Formato de enlace::        C@'omo los enlaces son formateados en Org
* Enlaces internos::         Enlaces a otros lugares en el fichero actual
* Enlaces externos::         Enlaces tipo URL para el mundo
* Manejando enlaces::        Creando, insertando y siguiendo
* Destinos enlazados::       Apuntando a una localizaci@'on en un archivo
@end menu

@node Formato de enlace, Enlaces internos, Hiperenlaces, Hiperenlaces
@section Formato de enlace

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

@smallexample
[[enlace][descripcion]]   @r{o de manera alternativa}    [[enlace]]
@end smallexample

@noindent
Una vez que un enlace en el b@'uffer est@'a completo (con todos los
corchetes presentes), Org cambiar@'a la vista de tal manera que la
@samp{descripci@'on} se mostrar@'a en vez de
@samp{[[enlace][descripci@'on]]} y @samp{enlace} ser@'a mostrado en
vez de @samp{[[enlace]]}. Para editar la parte invisible de
@samp{enlace}, use @kbd{C-c C-l} con el cursor en el enlace.

@node Enlaces internos, Enlaces externos, Formato de enlace, Hiperenlaces
@section 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@'as importante en un enlace
como @samp{[[#mi-id-personal]]} que enlazar@'a a la entrada con la
propiedad @code{CUSTOM_ID} como @samp{[[#mi-id-personal]]}.

Enlaces tales como @samp{[[Mi Objetivo]]} o @samp{[[Mi
Objetivo][Encuentra mi objetivo]]} conduce a una b@'usqueda de texto
en el fichero actual para el correspondiente objetivo se parezca a
@samp{<<Mi objetivo>>}

@node Enlaces externos, Manejando enlaces, Enlaces internos, Hiperenlaces
@section Enlaces externos

Org tiene soporte para enlaces a ficheros, sitios web, mensajes de
correo electr@'onico 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@'on seguida por dos puntos. Sin espacio despu@'es de los
dos puntos. Aqu@'{@dotless{i}} se presentan algunos ejemplos:

@smallexample
http://www.astro.uva.nl/~dominik          @r{en la web}
file:/home/dominik/images/jupiter.jpg     @r{fichero, ruta absoluta}
/home/dominik/images/jupiter.jpg          @r{lo mismo que arriba}
file:papers/last.pdf                      @r{fichero, ruta relativa}
file:projects.org                         @r{otro fichero org}
docview:papers/last.pdf::NNN              @r{fichero abierto en modo doc-view en la p@'agina NNN}
id:B7423F4D-2E8A-471B-8810-C40F074717E9   @r{Enlace a un identificador}
news:comp.emacs                           @r{Enlace a un grupo de news}
mailto:adent@@galaxy.net                  @r{Enlace de Correo}
vm:folder                                 @r{Enlace a una carpeta de VM}
vm:folder#id                              @r{Enlace a un mensaje de VM}
wl:folder#id                              @r{Enlace a un mensaje de WANDERLUST}
mhe:folder#id                             @r{Enlace a un mensaje de MH-E}
rmail:folder#id                           @r{Enlace a un mensaje de RMAIL}
gnus:group#id                             @r{Enlace a un mensaje de GNUS}
bbdb:R.*Stallman                          @r{enlace a una entrada de BBDB (con expresi@'on regular)}
irc:/irc.com/#emacs/bob                   @r{enlace de IRC}
info:org:External%20links                 @r{Enlace a un nodo Info
(con el espacio en blaco codificado)}
@end smallexample

Un enlace debe ser encerrado entre corchetes y puede tener un texto
descriptivo que ser@'a mostrado en vez de la URL (@pxref{Formato de
enlace}), por ejemplo:

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

@noindent
Si la descripci@'on es un nombre de fichero o URL que apunta a una
imagen, la exportaci@'on HTML (@pxref{HTML export}) introducir@'a la
imagen como un bot@'on al que se puede hacer click. Si no hay
descripci@'on y el enlace apunta a una imagen, esta imagen se
incrustar@'a dentro del fichero HTML exportado.

@node Manejando enlaces, Destinos enlazados, Enlaces externos, Hiperenlaces
@section Manejando enlaces

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

@table @kbd
@item C-c l
@c
Almacena un enlace desde la posici@'on actual. @'Este es un comando
@emph{global} (debes crear el atajo de teclado por t@'{@dotless{i}}
mismo) el cual puede ser usado en cualquier buffer para crear un
enlace. El enlace ser@'a almacenado para posteriores inserciones
dentro de un buffer Org (ver m@'as abajo).
@item C-c C-l
@c
Inserta un enlace. Esto sugiere un enlace que ser@'a insertado dentro
del buffer. Se puede escribir un enlace, o usar la teclas del
historial @key{arriba} y @key{abajo} para acceder a los enlaces
almacenados. Tambi@'en ser@'a consultado por la parte de descripci@'on
del enlace. Cuando es llamado con el prefijo @kbd{C-u}, se usa el
autocompletado del nombre del fichero para enlazar a un fichero.
@item C-c C-l @r{(con el cursor en un enlace existente)}
@c
Cuando el cursor est@'a en enlace existente, @kbd{C-c C-l} permite
editar el enlace y las partes de descripci@'on del enlace.
@item C-c C-o @r{o} mouse-1 @r{o} mouse-2
Abre el enlace en el que est@'a el cursor.
@item C-c &
@c
Salta a una posici@'on grabada. Una posici@'on es grabada por los
siguientes comandos de enlaces internos, y por @kbd{C-c %}. Usando
este comando varias veces se mueve a trav@'es de un anillo de
posiciones previamente grabadas en una sucesi@'on directa.
@end table

@node Destinos enlazados, , Manejando enlaces, Hiperenlaces
@section Destinos enlazados

Los enlaces de ficheros pueden contener informaci@'on adicional para
hacer que Emacs salte a una posici@'on particular en el fichero cuando
se sigue un enlace. Esto puede ser un n@'umero de l@'{@dotless{i}}nea
o una opci@'on de b@'usqueda despu@'es de dos puntos dobles.

Aqu@'{@dotless{i}} est@'a la sintaxis de los diferentes caminos para
adjuntar una b@'usqueda a un enlace de fichero, junto con una explicaci@'on:

@smallexample
[[file:~/code/main.c::255]]                 @r{Encontrar l@'{@dotless{i}}nea 255}
[[file:~/xx.org::Mi Objetivo]]              @r{Encontrar @samp{<<Mi Objetivo>>}}
[[file:~/xx.org::#mi-id-personal]]          @r{Encontrar entrada con
id personal}
@end smallexample

@seealso{ @uref{http://orgmode.org/manual/Hyperlinks.html#Hyperlinks,
Cap@'{@dotless{i}}tulo 4 del manual}}

@node Items TODO, Etiquetas, Hiperenlaces, Top
@chapter Items TODO

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

De acuerdo, esta t@'ecnica sirve para gestionar @'{@dotless{i}}tems
TODO esparcidos a trav@'es de tu fichero de notas. Org mode compensa
esto proveyendo m@'etodos para darte una visi@'on de alto nivel de
todas las cosas que tu tienes que hacer.

@menu
* Usando los estados TODO::  Poniendo y cambiado estados
* Flujos de trabajo multi-estado::  M@'as que ahora si/no
* Proceso de acceso::        Fechas y notas para el progreso
* Prioridades::              Algunas cosas son m@'as importantes que otras
* Rompiendo tareas::         Partiendo una tarea en piezas manejables
* Cajas de chequeo::         Listas de marcas
@end menu

@node Usando los estados TODO, Flujos de trabajo multi-estado, Items TODO, Items TODO
@section Usando los estados TODO

Cualquier t@'{@dotless{i}}tulo o subt@'{@dotless{i}}tulo puede llegar
a ser un @'{@dotless{i}}tem TODO cuando empieza con la palabra
@samp{TODO}, por ejemplo:

@smallexample
*** TODO Escribir carta a la Caba@~na del T@'{@dotless{i}}o Sam.
@end smallexample

@noindent
Los comandos m@'as importantes para trabajar con entradas TODO son:

@table @kbd
@item C-c C-t
Rotar el estado TODO del @'{@dotless{i}}tem actual

@smallexample
,-> (no marcado) -> TODO -> DONE --.
'----------------------------------'
@end smallexample

La misma rotaci@'on puede tambi@'en ser hecha ``de manera remota''
desde los buffers de agenda y l@'{@dotless{i}}nea de tiempo con la
tecla @kbd{t} (@pxref{Comandos de la agenda}).

@item S-@key{derecha}@r{/}@key{izquierda}
Seleccionar el siguiente/precedente estado TODO, similar a rotar.
@item C-c / t
Ver @'{@dotless{i}}tems TODO en un @emph{@'arbol poco denso}
(@pxref{@'Arboles poco densos}). Encoge el buffer, pero muestra todos
los @'{@dotless{i}}tems y la jerarqu@'{@dotless{i}}a de
t@'{@dotless{i}}tulos y subt@'{@dotless{i}}tulos por encima de ellos.
@item C-c a t
Muestra la lista global TODO. Esta colecci@'on de @'{@dotless{i}}tems
TODO de todos los archivos de la agenda (@pxref{Vistas de la Agenda})
en un @'unico buffer.
@item S-M-@key{RET}
Inserta una nueva entrada TODO debajo del @'{@dotless{i}}tem actual.
@end table

@noindent
Al cambiar el estado de un @'{@dotless{i}}tem TODO se puede tambi@'en
activar cambios de etiqueta. Ver el docstring de la opci@'on
@code{org-todo-state-tags-triggers} para m@'as detalles.

@node Flujos de trabajo multi-estado, Proceso de acceso, Usando los estados TODO, Items TODO
@section Flujos de trabajo multi-estado

Se pueden usar palabras reservadas TODO para indicar diferentes
estados @emph{secuenciales} en el proceso de trabajo con respecto a un
@'{@dotless{i}}tem, por ejemplo:

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

La barra vertical separa las palabras reservadas TODO (estados que
@emph{necesitan acci@'on}) de los estados DONE (realizados, que
@emph{no necesitan m@'as acci@'on}). Si no se proporciona la barra
separadora, el @'ultimo estado es usado como estado DONE. Con esta
configuraci@'on, el comando @kbd{C-c C-t} rotar@'a una entrada desde
TODO a FEEDBACK, despu@'es 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@'asico @code{TODO}/@code{DONE}, pero tambi@'en un flujo de
trabajo para la correcci@'on de errores, y un estado separando el
estado que indica que un @'{@dotless{i}}tem ha sido cancelado
(as@'{@dotless{i}} no est@'a DONE, pero tampoco requiere acci@'on). La
configuraci@'on ser@'{@dotless{i}}a la siguiente:

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

Las palabras reservadas son todas diferentes, esto ayuda a Org mode a
guardar la traza de que subsecuencia deber@'{@dotless{i}}a ser usada
para una entrada dada. El ejemplo tambi@'en muestra c@'omo definir
teclas para un r@'apido acceso a un estado particular, a@~nadiendo una
letra entre par@'entesis despu@'es de cada palabra reservada - se
preguntar@'a por la letra despu@'es de @kbd{C-c C-t}.

Para definir palabras reservadas TODO que son v@'alidas @'unicamente
en un solo fichero, use el siguiente texto en cualquier lugar del
fichero.

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

Despu@'es de cambiar una de estas l@'{@dotless{i}}neas, use @kbd{C-c
C-c} con el cursor todav@'{@dotless{i}}a en la l@'{@dotless{i}}nea
para que Org mode reconozca los cambios.

@node Proceso de acceso, Prioridades, Flujos de trabajo multi-estado, Items TODO
@section Proceso de acceso

Org mode puede grabar autom@'aticamente un timestamp y posiblemente
una nota cuando se marca un @'{@dotless{i}}tem TODO como DONE, @'o
incluso cada vez que se cambia el estado de un @'{@dotless{i}}tem
TODO. Este sistema es altamente configurable, las configuraciones
pueden seguir una l@'ogica por tecla y pueden afectar a un fichero o
incluso a un sub@'arbol. Para m@'as informaci@'on de c@'omo fijar
fecha y hora de una tareas, lea @ref{Estableciendo tiempo de trabajo}.

@menu
* Cerrando items::           ¿Cu@'ando fu@'e marcada esta entrada a DONE?
* Trazando los estados TODO::  ¿Cuando cambia el estado?
@end menu

@node Cerrando items, Trazando los estados TODO, Proceso de acceso, Proceso de acceso
@unnumberedsubsec Cerrando items

El registro m@'as b@'asico es guardar @emph{cuando} un
@'{@dotless{i}}tem TODO se finaliz@'o. Esto se logra con@footnote{La
correspondiente configuraci@'on en el buffer es @code{#+STARTUP:
logdone}}.

@smalllisp
(setq org-log-done 'time)
@end smalllisp

@noindent
As@'{@dotless{i}}, cada vez que se cambia una entrada desde un estado
TODO (no DONE) a cualquiera de los estados DONE, una
l@'{@dotless{i}}nea @samp{CLOSED: [timestamp]} ser@'a insertada justo
despu@'es de la cabecera. Si quieres grabar una nota con una marca de
tiempo (timestamp) usa@footnote{La correspondiente configuraci@'on en
el buffer es: @code{#+STARTUP: lognotedone}} 

@smalllisp
(setq org-log-done 'note)
@end smalllisp

@noindent
Entonces, se preguntar@'a por la nota, y la nota ser@'a almacenada
debajo de la entrada con una cabercera @samp{Closing Note} (Cerrando Nota).

@node Trazando los estados TODO, , Cerrando items, Proceso de acceso
@unnumberedsubsec Trazando los estados TODO

Se podr@'{@dotless{i}}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@'an insertados despu@'es de la cabecera como una lista
de @'{@dotless{i}}tems. Cuando se toman un mont@'on de notas, se
podr@'{@dotless{i}}a querer tener las notas fuera de la vista dentro
de un "@i{caj@'on}" (drawer)
@seealso{@uref{http://www.gnu.org/software/emacs/manual/html_node/org/Drawers.html#Drawers,
Drawers en el Cap@'{@dotless{i}}tulo 2 del manual}}

Para el registro de estados, Org mode conf@'{@dotless{i}}a en una
configuraci@'on basada en palabras reservadas. Esto se logra
a@~nadiendo marcas especiales @samp{!} (para una marca de tiempo) y
@samp{@@} (para una nota) entre par@'entesis despu@'es de cada palabra
reservada. Por ejemplo:
@smallexample
#+TODO: TODO(t) WAIT(w@@/!) | DONE(d!) CANCELED(c@@)
@end smallexample
@noindent
definir@'a las palabras reservadas TODO y el acceso a los atajos de
teclado, y tambi@'en solicita que se grabe el momento en el que la
entrada se estableci@'o como DONE, y que una nota es grabada cuando se
cambie a WAIT o CANCELED. La misma sintaxis funciona tambi@'en cuando
se define @code{org-todo-keywords}.

@node Prioridades, Rompiendo tareas, Proceso de acceso, Items TODO
@section Prioridades

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

@smallexample
*** TODO [#A] Escribir carta a Santa Fortuna@end smallexample

@noindent
Org mode soporta tres prioridades: @samp{A}, @samp{B},
@samp{C}. @samp{A} es la m@'as alta, por defecto ser@'a @samp{B} si
ninguna es dada. Las prioridades marcan diferencia s@'olo en la
agenda.

@table @kbd
@item @kbd{C-c ,}
@c
Pone una prioridad a la actual cabecera. Presionando @samp{A},
@samp{B} o @samp{C} se selecciona la prioridad, o @key{SPC} para
eliminar la marca.
@item S-@key{up}
@itemx S-@key{down}
Incremente/decrementa la prioridad de la cabecera actual
@end table

@node Rompiendo tareas, Cajas de chequeo, Prioridades, Items TODO
@section Partiendo tareas en subtareas

Es a menudo ventajoso dividir grandes tareas en peque@~nas y
manejables subtareas. Puede realizar esto creando un @'arbol de
outline bajo un item TODO, el cual detalla las subtareas en el
@'arbol. Para poner la vista sobre la fracci@'on de subtareas que
est@'an ya completadas, inserte un @samp{[/]} o @samp{[%]} en
cualquier lugar de la cabecera. Estas marcas ser@'an actualizadas cada
vez que el estado TODO de alg@'un hijo cambie, o presionando @kbd{C-c
C-c} en la marca. Por ejemplo:

@smallexample
* Organizar Fiesta [33%]
** TODO Llamar a la gente [1/2]
*** TODO Pedro
*** DONE Sara
** TODO Comprar comida
** DONE Hablar con el vecino@end smallexample

@node Cajas de chequeo, , Rompiendo tareas, Items TODO
@section Cajas de chequeo

Cada item en una lista plana (@pxref{Listas planas}) puede ser un
cuadro de chequeo comenzando con la cadena @samp{[]}. Los cuadros de
chequeo nos est@'an incluidos en la lista TODO global,
as@'{@dotless{i}} a menudo es preferible dividir la tarea en un
n@'umero reducido de pasos.

@smallexample
* TODO Organizar Fiesta [1/3]
  - [-] Llamar a la gente [1/2]
    - [ ] Pedro
    - [X] Sara
  - [X] Comprar comida
  - [ ] pensar qu@'e m@'usica escuchar
@end smallexample

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

@noindent The following commands work with checkboxes:

@table @kbd
@item C-c C-c
Cambia el estado de la caja de chequeo o (con prefijo) a@~nade una
caja de chequeo.
@item M-S-@key{RET}
Inserta un nuevo @'{@dotless{i}}tem con un cuadro de chequeo. Esto
funciona solo si el cursor est@'a en un @'{@dotless{i}}tem de la lista
plana (@pxref{Listas planas}).
@end table

@seealso{ @uref{http://orgmode.org/manual/TODO-Items.html#TODO-Items,
Cap@'{@dotless{i}}tulo 5 del manual}@*
@uref{http://orgmode.org/worg/org-tutorials/
orgtutorial_dto.php, Tutorial de introducci@'on de David O'Toole}@*
@uref{http://
members.optusnet.com.au/~charles57/GTD/gtd_workflow.html,
Configuraci@'on de GTD de Charles Cave}}

@node Etiquetas, Propiedades, Items TODO, Top
@chapter Etiquetas

Una excelante forma de nombrar y contextualizar informaci@'on
interrelacionada es asignar @i{etiquetas} a las cabeceras. Org mode
tiene un amplio soporte para etiquetas. @footnote{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@'{@dotless{i}}, he
decidido traducir @i{implement label} como nombrar y @i{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, @samp{_} y @samp{@@}. Las etiquetas deben estar
precedidas y seguidas por dos puntos, por ejemplo,
@samp{:trabajo:}. Es posible asignar varias etiquetas, como en
@samp{:trabajo:urgente:}. Las etiquetas por defecto estar@'an en
negrilla con el mismo color que la cabecera.

@menu
* Marca de herencia::        Las marcas usan el @'arbol de estructura de la 
                               idea general
* Poniendo marcas::          C@'omo asignar etiquetas a una cabecera
* Buscando marcas::          Buscando combinaciones de etiquetas
@end menu

@node Marca de herencia, Poniendo marcas, Etiquetas, Etiquetas
@section Marca de herencia

Las @i{etiquetas} hacen uso de la estructura jer@'arquica de los
@'arboles de org-mode. Si una cabecera tiene una cierta etiqueta,
todas las subcabeceras heredar@'an la etiqueta tambi@'en. Por ejemplo,
en la lista

@smallexample
* Encuentro con franceses                  :trabajo:
** Resumen para Carolina                   :jefa:notas:
*** TODO Preparar presentaciones para ella :actividad:
@end smallexample

@noindent
la cabecera final tendr@'a las etiquetas @samp{:trabajo:},
@samp{:jefa:}, @samp{:notas:} y @samp{:actividad:} incluso aunque la
cabecera final no est@'e expl@'{@dotless{i}}citamente marcada con
estas etiquetas. Se puede tambi@'en asignar etiquetas para que todas
las entradas en un fichero hereden si estas etiquetas fueron definidas
en un hipot@'etico nivel cero alrededor del fichero entero. Usa una
l@'{@dotless{i}}nea como esta@footnote{Como siempre estas
configuraciones de buffer se activan presionando @kbd{C-c C-c}.}:

@smallexample
#+FILETAGS: :Pedro:Jefe:Secreto:
@end smallexample

@node Poniendo marcas, Buscando marcas, Marca de herencia, Etiquetas
@section Poniendo marcas

Las etiquetas pueden simplemente ser escritas en un bufer al final de
una cabecera. Despu@'es de los dos puntos, @kbd{M-@key{TAB}}
autocompleta etiquetas. Hay tambi@'en un comando para insertar etiquetas:

@table @kbd
@item C-c C-q
Introduce nuevas etiquetas para la cabecera actual. Org mode
ofrecer@'a autocompletado o una interfaz especial de una sola tecla
para asignar etiquetas, ver m@'as abajo. Despu@'es de presionar
@key{RET}, las etiquetas ser@'an insertadas y alineadas para
@code{org-tags-column}. Cuando se llama con el prefijo @kbd{C-u},
todas las etiquetas en el buffer actual ser@'an alineadas a esta
columna, solo para que las cosas se vean bien.
@item C-c C-c
Cuando el cursor est@'a en una cabecera, hace lo mismo que @kbd{C-c
C-q}.
@end table

Org soporta inserci@'on de etiquetas basado en una @emph{lista de
etiquetas}. Por defecto esta lista es construida din@'amicamente,
conteniendo todas las etiquetas actualmente usadas en el
buffer. Tambi@'en se puede especificar globalmente una lista dura de
etiquetas con la variable @code{org-tag-alist}. Finalmente se puede
asignar las etiquetas por defecto para un fichero dado con
l@'{@dotless{i}}neas como

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

Por defecto, Org mode usa las facilidades de compleci@'on del
minibuffer para introducir etiquetas. Sin embargo, tambi@'en
implementa otro r@'apido m@'etodo de selecci@'on de etiquetas llamado
@emph{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 @'unicas para las
etiquetas m@'as usadas. Se puede hacer esto de manera global
configurando la variable @code{org-tag-alist} en el fichero
@file{.emacs}. Por ejemplo, se puede encontrar la necesidad de
etiquetar muchos @'{@dotless{i}}tems en diferentes ficheros con
@samp{:@@casa:}. En este caso se puede hacer algo como:

@smalllisp
(setq org-tag-alist '(("@@trabajo" . ?t) ("@@casa" . ?c) ("portatil" . ?p)))
@end smalllisp

@noindent If the tag is only relevant to the file you are working on, then you
o bien establecer en la l@'{@dotless{i}}nea TAGS una opci@'on como:

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

@node Buscando marcas, , Poniendo marcas, Etiquetas
@section Buscando marcas

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

@table @kbd
@item C-c \
@itemx C-c / m
Crear un @'arbol expandido con todas las cabeceras coincidentes con la
etiqueta (tag) buscada. Con el prefijo @kbd{C-u}, ignora las cabeceras
que no son TODO.
@item C-c a m
Crea una lista global de marcas coincidentes de todos los archivos de la
agenda. @xref{Coincidiendo marcas y propiedades}.
@item C-c a M
Crea una lista global de marcas coincidentes de todos los archivos de la
agenda. @xref{Coincidiendo marcas y propiedades}.
@end table

Estos comandos buscan coincidencias de cadenas que permiten una
l@'ogica b@'asica como @samp{+jefe+urgente-proyecto1}, para encontrar
entradas con marcas @samp{jefe} y @samp{urgente}, pero sin
@samp{proyecto1}, o @samp{Jos@'e|Juan} para encontrar ambas entradas,
tanto @samp{Jos@'e} como @samp{Juan}. La sint@'axis completa de las
cadenas de b@'usqueda es rica y permite adem@'as coincidencias con
todas las palabras clave TODO, entradas de nivel y propiedades. Para
una completa descripci@'on con muchos ejemplos, vea @ref{Coincidiendo marcas
y propiedades}.

@seealso{ @uref{http://orgmode.org/manual/Tags.html#Tags,
Cap@'{@dotless{i}}tulo 6 del manual}@*
@uref{http://sachachua.com/wp/2008/01/tagging-in-org-plus-bonus-code-for-timeclocks-and-tags/,
art@'{@dotless{i}}culo de Sacha Chua acerca de etiquetado en Org-mode}}

@node Propiedades, Fechas y horas, Etiquetas, Top
@chapter Propiedades

Las propiedades son pares clave valor asociados con una entrada. Estos
se encuentran en un lugar especial con el nombre
@code{PROPERTIES}. Cada propiedad se especifica en una
l@'{@dotless{i}}nea simple, con la clave (rodeada por dos puntos)
primero, y el valor despu@'es de @'esta.

@smallexample
* Colecci@'on de CDs 
** Cl@'asica
*** Variaciones de Goldberg 
    :PROPERTIES:
    :T@'{@dotless{i}}tulo:     Goldberg Variations
    :Compositor:  J.S. Bach
    :Discogr@'afica: Deutsche Grammophon
    :Discos:    1
    :END:
@end smallexample

Se pueden definir los valores permitidos para una propiedad particular
@samp{:Xyz:} asignando un propiedad @samp{:Xyz_ALL:}. Esta propiedad
especial es @emph{heredada}, as@'{@dotless{i}} si se asigna en una
entrada de nivel 1, se aplicar@'a al @'arbol entero. Cuando los
valores permitidos est@'an definidos, asignar la propiedad
correspondiente llega a ser f@'acil y es menos propensa a
errores. Para el ejemplo de la colecci@'on de CDs, se pueden
predefinir las discogr@'aficas y el n@'umero de discos en una caja
como esta:

@smallexample
* Colecci@'on de CDs
   :PROPERTIES:
   :Discos_ALL: 1 2 3 4
   :Discogr@'afica_ALL: "Deutsche Grammophon" Philips EMI
   :END:
@end smallexample
o globalmente usando @code{org-global-properties}, o un fichero amplio
como este:
@smallexample
#+PROPERTY: Discos_ALL 1 2 3 4
@end smallexample

@table @kbd
@item C-c C-x p
Asigna una propiedad. Se solicitar@'a un nombre y un valor para la
propiedad.
@item C-c C-c d
Elimina una propiedad de la entrada actual.
@end table

Para crear @'arboles expandidos y listas especiales con selecci@'on
basada en propiedades, los mismos comandos son usados para buscar
marcas (@pxref{Buscando marcas}). La sintaxis completa para la
b@'usqueda de cadenas es descrita en @ref{Coincidiendo marcas y
propiedades}.

@table @kbd
@end table

@seealso{
@uref{http://orgmode.org/manual/Properties-and-Columns.html#Properties-and-Columns,
Chap@'{@dotless{i}}tulo 7 del manual}@*
@uref{http://orgmode.org/worg/org-tutorials/org-column-view-tutorial.php,Bastien
Guerry's column view tutorial}}

@node Fechas y horas, Capture - Refile - Archive, Propiedades, Top
@chapter Fechas y horas

Para tener una planificaci@'on de un proyecto, los @'{@dotless{i}}tems
TODO pueden ser etiquetados con una fecha y/o con una hora. La cadena
con este formato especial que trae la informaci@'on de fecha y hora es
llamado @emph{timestamp} en Org mode.

@menu
* Instante en el tiempo::    Asignaci@'on de tiempo a una entrada de @'arbol
* Creando instantes de tiempo::  Comandos para insertar instantes de tiempo
* Fecha l@'{@dotless{i}}mite y planificaci@'on::  Planificando tu trabajo
* Estableciendo tiempo de trabajo::  Llevando la cuenta de cuanto se gasta 
                                       en una tarea
@end menu


@node Instante en el tiempo, Creando instantes de tiempo, Fechas y horas, Fechas y horas
@section Instante en el tiempo

Una marca de tiempo (@emph{timestamp}) es una especificaci@'on de una fecha
(posiblemente con un tiempo o un rango de tiempos) en un formato
especial. Como @samp{<2003-09-16 Jue>} o @samp{<2003-09-16 Jue 09:39>}
o @samp{<2003-09-16 Jue 12:00-12:30>}. Una marca de tiempo puede
aparecer en cualquier lugar, titular o cuerpo de una entrada del
@'arbol Org. Su presencia causa que la entrada sea mostrada en una
fecha espec@'{@dotless{i}}fica de la agenda (@pxref{Agenda
semanal/diaria}). Distinguimos:

@noindent @b{Plain timestamp; Event; Appointment}@*
Una marca de tiempo simple solo asigna una fecha/hora a un
@'{@dotless{i}}tem. Esto es solo como escribir una cita o evento en
una agenda en papel.

@smallexample
* Ver pelis con Pedro
  <2006-11-01 Wed 19:15>
* Discusi@'on acerca del cambio clim@'atico
  <2006-11-02 Thu 20:00-22:00>
@end smallexample

@noindent @b{Timestamp with repeater interval}@*
Una marca de tiempo puede contener un @emph{intervalo de
repetici@'on}, indicando que se aplica no solo en la fecha dada, pero
de nuevo y de nuevo despu@'es de un cierto intervalo de N
d@'{@dotless{i}}as (d), semanas @emph{weeks} (w), meses (m), o a@~nos
@emph{years} (y). Lo siguiente muestra en la agenda cada Mi@'ercoles:
@smallexample
* Recoger a Samuel en el colegio
  <2007-05-16 Wed 12:30 +1w>@end smallexample

@noindent @b{Diary-style sexp entries}@*
Para especificaciones de fecha m@'as complejas, Org mode da soporte
usando las entradas diarias sexp implementadas en el paquete Emacs
calendar/diary. Por ejemplo:
@smallexample
* El encuentro nerd los segundos jueves del mes
  <%%(diary-float t 4 2)>
@end smallexample

@noindent @b{Time/Date range}@*
Dos marcas de tiempo conectadas por @samp{--} denotan un rango.
@smallexample
** Encuentro en Amsterdam
   <2004-08-23 Mon>--<2004-08-26 Thu>
@end smallexample

@noindent @b{Inactive timestamp}@*
Como una marca de tiempo @emph{timestamp}, pero con par@'entesis
cuadrados en vez de angulares. Estas marcas de tiempo son inactivas en
el sentido de que @emph{no} aparecen como entrada en la agenda.

@smallexample
* Julia lleg@'o tarde por quinta vez
  [2006-11-01 Wed]
@end smallexample


@node Creando instantes de tiempo, Fecha l@'{@dotless{i}}mite y planificaci@'on, Instante en el tiempo, Fechas y horas
@section Creando instantes de tiempo

Para que Org mode reconozca marcas de tiempo, necesitan estar en el
formato espec@'{@dotless{i}}fico. Todos los comandos listado debajo
producen marcas de tiempo en el formato correcto.

@table @kbd
@item C-c .
@c
Crea un di@'alogo para una fecha e inserta la correspondiente marca de
tiempo. Cuando el cursor est@'a en una marca de tiempo existente en el
buffer, el comando es usado para modificar esta marca de tiempo en vez
de insertar una nueva. Cuando este comando es usado dos veces
seguidas, un rango de tiempo es insertado. Con un prefijo, tambi@'en
a@~nade la hora actual. 
@item C-c !
@c
Como @kbd{C-c .}, pero inserta una marca de tiempo inactiva que no
causar@'a una entrada en la agenda.
@item S-@key{left}@r{/}@key{right}
@c
Cambia la fecha en el cursor por un d@'{@dotless{i}}a.
@item S-@key{up}@r{/}@key{down}
Cambia el @'{@dotless{i}}tem bajo el cursor en una marca de tiempo. El
cursor puede ser en un a@~no, mes, d@'{@dotless{i}}a, hora, o
minuto. Cuando la marca de tiempo contiene un rango de tiempo como
@samp{15:30-16:30}, modificando la primera vez dividir@'a los
segundos, dividiendo el bloque del momento con el tama@~no
constante. Para cambiar el tama@~no, modifica una segunda vez.
@end table

Cuando Org mode pregunta por una fecha u hora, aceptar@'a cualquier
cadena conteniendo alguna fecha y/o informaci@'on, e inteligentemente
interpretar@'a la cadena, sacando alguna por defecto, para la
informaci@'on no especificada desde la actual fecha y hora. Tambi@'en
se puede seleccionar una fecha en un calendario pop-up. Ver el manual
para m@'as informaci@'on de c@'omo funciona la fecha/hora.

@node Fecha l@'{@dotless{i}}mite y planificaci@'on, Estableciendo tiempo de trabajo, Creando instantes de tiempo, Fechas y horas
@section Fecha l@'{@dotless{i}}mite y planificaci@'on

Una marca de tiempo puede ser precedida por palabras clave especiales
para facilitar la planificaci@'on.

@noindent @b{DEADLINE}@*
Significa: la tarea (normalmente un @'{@dotless{i}}tem TODO, aunque no
necesariamente) se supone que finalizar@'a en tal fecha.
@table @kbd
@item C-c C-d
Inserta la palabra clave @samp{DEADLINE} con una marca, en la
l@'{@dotless{i}}nea siguiente a la cabecera o titular @emph{headline}.
@end table

En la fecha de finalizaci@'on @emph{deadline}, la tarea ser@'a listada
en la agenda. Adem@'as la agenda para @emph{hoy} traer@'a un aviso
acerca de la fecha de finalizaci@'on pasada, empezando
@code{org-deadline-warning-days} antes de la fecha y continuando hasta
que la entrada es marcada como realizada @emph{DONE}. Un ejemplo:

@smallexample
*** TODO escribir art@'{@dotless{i}}culo acerca de la Tierra para la Gu@'{@dotless{i}}a.
    El editor encargado es [[bbdb:Ford Prefect]]
    DEADLINE: <2004-02-29 Sun>
@end smallexample


@noindent @b{SCHEDULED}@*
Significa: est@'as @i{planificando empezar trabajando} en esta tarea
en la fecha dada@footnote{Esto es bastante diferente, ya que es
normalmente comprendido por @i{planificar un encuentro}, que es hecho
en Org-mode insertando una marca de tiempo sin palabra clave.}

@table @kbd
@item C-c C-s
Insertar la palabra clave @samp{SCHEDULED} con una marca, en la
l@'{@dotless{i}}nea despu@'es de la cabecera.
@end table

La cabecera ser@'a listada bajo la fecha
dada@footnote{Todav@'{@dotless{i}}a ser@'a listada en esta fecha
despu@'es de que ha sido marcado como DONE. Si no gusta esto, se debe
establecer la variable
@code{org-agenda-skip-scheduled-if-done}.}. Adem@'as, un recordatorio
de que la fecha introducida en la agenda que ha pasado estar@'a
presente en la compilaci@'on para @emph{hoy}, hasta que la entrada es
marcada como DONE. Por ejemplo, la tarea autom@'aticamente ser@'a
reenviada hasta ser completada.

@smallexample
*** TODO Llamar a Trillian para una cita en A@~no Nuevo.
    SCHEDULED: <2004-12-25 Sat>
@end smallexample

Algunas tareas necesitan ser repetidas de nuevo y de nuevo. Org mode
ayuda a organizar tales tareas usando un repetidor en una fecha
l@'{@dotless{i}}mite @emph{DEADLINE}, @emph{SCHEDULED}, o una marca de
tiempo en texto plano. En el siguiente ejemplo
@smallexample
** TODO Pagar el alquiler
   DEADLINE: <2005-10-01 Sat +1m>
@end smallexample
@noindent
el @code{+1m} es un repetidor; la interpretaci@'on que se pretende es
que la tarea tiene una fecha l@'{@dotless{i}}mite en <2005-10-01> y
repite por s@'{@dotless{i}} mismo cada mes empezando desde este momento.

@node Estableciendo tiempo de trabajo, , Fecha l@'{@dotless{i}}mite y planificaci@'on, Fechas y horas
@section Estableciendo tiempo de trabajo

Org mode permite contabilizar el tiempo que tu gastas en tareas
espec@'{@dotless{i}}ficas en un proyecto.

@table @kbd
@item C-c C-x C-i
@c
Empieza el reloj en el @'{@dotless{i}}tem actual
(@emph{clock-in}). Esto inserta la palabra clave CLOCK junto con una
marca de tiempo. Cuando se llama con un argumento prefijo @kbd{C-u},
selecciona la tarea desde una lista de las tareas recientemente
medidas con reloj.
@item C-c C-x C-o
Para el reloj (@emph{clock-out}. Esto inserta otra marca de tiempo en
la misma localizaci@'on donde el reloj fu@'e iniciado por @'ultima
vez. Eso tambi@'en directamente computa el tiempo resultante en
insertarlo despu@'es el rango de tiempo como @samp{=> HH:MM}.
@item C-c C-x C-e
Actualiza el esfuerzo de estimar la tarea para la actual medici@'on de
reloj.
@item C-c C-x C-x
Cancela la medici@'on de reloj actual. Esto es @'util si el reloj
fu@'e iniciado por error, o si se ya se finaliz@'o el trabajo.
@item C-c C-x C-j
Salta a la entrada que contiene el reloj actualmente en
ejecuci@'on. Con un prefijo @kbd{C-u}, selecciona la tarea objetivo
desde una lista de tareas recientemente cronometradas.
@item C-c C-x C-r
Inserta un bloque din@'amico conteniendo un informe de tiempo de reloj
como una tabla de Org-mode dentro del fichero actual. Cuando el cursor
es una tabla de reloj existente, lo actualiza.
@smallexample
#+BEGIN: clocktable :maxlevel 2 :emphasize nil :scope file
#+END: clocktable
@end smallexample
@noindent
Para detalles acerca de c@'omo personalizar esta vista, ver
@uref{http://orgmode.org/manual/Clocking-work-time.html#Clocking-work-time,
el manual}.
@item C-c C-c
Actualiza el bloque din@'amico a punto. El cursor necesita estar en la
l@'{@dotless{i}}nea @code{#+BEGIN} del bloque din@'amico.
@end table

La tecla @kbd{l} puede ser usada en la l@'{@dotless{i}}nea de tiempo
(@pxref{L@'{@dotless{i}}nea de tiempo}) y en la agenda (@pxref{Agenda
semanal/diaria}) para mostrar las tareas en las que se trabajar@'a o
cerrar@'an durante el d@'{@dotless{i}}a.

@seealso{
@uref{http://orgmode.org/manual/Dates-and-Times.html#Dates-and-Times,
Cap@'{@dotless{i}}tulo 8 del manual}@*
@uref{http://members.optusnet.com.au/~charles57/GTD/org_dates/,
Tutorial de Fechas y Horas de Charles Cave}@*
@uref{http://doc.norang.ca/org-mode.html#Clocking, Flujo de trabajo de
cronomentrar de Bernt Hansen}}

@node Capture - Refile - Archive, Vistas de la Agenda, Fechas y horas, Top
@chapter Capture - Refile - Archive

Una parte importante de cualquier organizaci@'on de sistemas es la
habilidad para r@'apidamente capturar nuevas ideas y tareas, y asociar
material de referencia con ellas. Org define un proceso de captura
para crear tareas. Esto almacena ficheros relacionados a una tarea
(@i{adjuntos}) en un directorio especial. Una vez en el sistema,
tareas y proyectos necesitan ser movidos alrededor. Moviendo @'arboles
de proyectos completados a un fichero de archivo guarda el sistema
compacto y r@'apido.

@menu
* Capturar::                 
* Rellenar y copiar::        Moviendo un @'arbol de un lugar a otro
* Archivando::               Qu@'e se hace con los proyectos terminados
@end menu

@node Capturar, Rellenar y copiar, Capture - Refile - Archive, Capture - Refile - Archive
@section Capturar

El m@'etodo de Org para capturar nuevo @'{@dotless{i}}tems est@'a
fuertemente inspirado por el excelente paquete John Wiegley. Esto
permite almacenar r@'apidas notas con peque@~nas interrupciones de tu
flujo de trabajo. Org te permite definir plantillas para nuevas
entradas y asociarlas con diferentes objetivo para almacenar notas.

@menu
* Poniendo una posici@'on de captura::  Donde ser@'an almacenadas las notas
* Usando capturas::          Comandos para invocar y finalizar capturas
* Plantillas de capturas::   Define la idea general de diferentes tipos de 
                               notas
@end menu

@node Poniendo una posici@'on de captura, Usando capturas, Capturar, Capturar
@unnumberedsubsec Poniendo una posici@'on de captura

La siguiente personalizaci@'on configura un fichero objetivo por
defecto@footnote{Usando plantillas de captura, se pueden definir
localizaciones de grano m@'as fino, ver @ref{Plantillas de
capturas}.} para notas y define un atajo global@footnote{Por favor,
selecciona tu propio atajo, @kbd{C-c c} es solo una sugerencia.} para
capturar nuevas cosas.

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

@node Usando capturas, Plantillas de capturas, Poniendo una posici@'on de captura, Capturar
@unnumberedsubsec Usando capturas

@table @kbd
@item C-c c
Comienza un proceso de captura. Ser@'a emplazado dentro de un estrecho
buffer para editar el @'{@dotless{i}}tem.
@item C-c C-c
Una vez que tu has introducido informaci@'on dentro del buffer de
captura, @kbd{C-c C-c} devolver@'a a la ventana de configuraci@'on
antes de que el proceso capture, as@'{@dotless{i}} tu puedes resumir
tu trabajo sin distracci@'on.
@item C-c C-w
Finaliza moviendo la entrada a una nueva localizaci@'on
(@pxref{Rellenar y copiar}). 
@item C-c C-k
Abortar el proceso de captura y devolver el estado previo.
@end table

@node Plantillas de capturas, , Usando capturas, Capturar
@unnumberedsubsec Plantillas de capturas

Se pueden usar plantillas para generar diferentes formas de capturar
notas y almacenarlas en diferentes lugares. Por ejemplo, si le
gustar@'{@dotless{i}}a almacenar nuevas tareas bajo una cabecera
@samp{Tareas} en el fichero @file{TODO.org}, y art@'{@dotless{i}}culos
de revistas en un @'arbol de fechas en @file{journal.org} se
podr@'{@dotless{i}}a usar:

@smallexample
(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")))
@end smallexample

@noindent In these entries, the first string is the key to reach the
plantilla, la segunda es una corta descripci@'on. Entonces sigue el
tipo de la entrada y una definici@'on del objetivo de la
localizaci@'on para almacenar la nota. Finalmente, la plantilla en
s@'{@dotless{i}} misma, una cadena con %-escapes para rellenar la
informaci@'on basado en tiempo y contexto.

Cuando se llama a @kbd{M-x org-capture}, Org pregunta por una clave
para seleccionar la plantilla (si tu tienes m@'as de una plantilla) y
entonces prepara el buffer como
@smallexample
* TODO
  [[file:@var{enlace a d@'onde tu estabas inicializando la captura}]]
@end smallexample

@noindent
Durante la expansi@'on de la plantilla, especiales
@kbd{%}-escapes@footnote{Si se necesita una de estas secuencias
literalmente, escapa el @kbd{%} con una barra invertida.} permite la
inserci@'on din@'amica de contenido. Aqu@'{@dotless{i}} una peque@~na
selecci@'on de las posibilidades, consulta el manual para m@'as.
@smallexample
%a          @r{anotaci@'on, normalmente el enlace creado con @code{org-store-link}}
%i          @r{contenido inicial, la regi@'on recordada se llama con C-u.}
%t          @r{marca de tiempo, solo fecha}
%T          @r{marca de tiempo con fecha y tiempo}
%u, %U      @r{como el de debajo, pero con marcas de tiempo inactivas}@end smallexample

@node Rellenar y copiar, Archivando, Capturar, Capture - Refile - Archive
@section Rellenar y copiar

Cuando se revisa el dato capturado, se puede querer rellenar o copiar
algunas de las entradas dentro de una lista diferente, por ejemplo,
dentro de un proyecto. Cortando, encontrando la localizaci@'on
correcta y entonces pegando la nota es complejo. Para simplificar este
proceso, se puede usar el siguiente comando especial:

@table @kbd
@item C-c M-x
Copiar la entrada o regi@'on. Este comando se comporta como
@code{org-refile}, excepto que el original no ser@'a borrado.
@item C-c C-w
Reajusta la entrada o regi@'on al punto. Este comando ofrece posibles
localizaciones para reajustar la entrada y permite seleccionar una con
autocompletado. El @'{@dotless{i}}tem (o todos los @'{@dotless{i}}tems
en la regi@'on) est@'a bajo el objetivo rellenado debajo del objetivo
encabezado como un sub@'{@dotless{i}}tem. @* Por defecto, todas las
cabeceras 1 en el actual buffer son considerados para ser objetivos,
pero puedes tener definiciones m@'as complejas a trav@'es de un
n@'umero de ficheros. Ver la variable @code{org-refile-targets} para
detalles.
@item C-u C-c C-w
Usa el interfaz de reajuste para saltar a un encabezado.
@item C-u C-u C-c C-w
Salta a la localizaci@'on d@'onde el @'ultimo @code{org-refile}
movi@'o un @'arbol.
@end table

@node Archivando, , Rellenar y copiar, Capture - Refile - Archive
@section Archivando

Cuando un proyecto represent@'o por un (sub)@'arbol est@'a finalizado,
tu puedes querer mover el @'arbol fuera del camino y p@'aralo desde la
contribuci@'on a la agenda. El archivo es importante para guardar tus
ficheros de trabajo b@'usquedas como la construcci@'on de vistas de
agenda r@'apidas. La acci@'on de archivaci@'on m@'as com@'un es mover
un @'arbol de proyecto a otro fichero, el fichero archivo.

@table @kbd
@item C-c C-x C-a
Archivar la actual entrada usando el comando especificado en la
variable @code{org-archive-default-command}.
@item C-c C-x C-s@ @r{or short} @ C-c $
Archiva el sub@'arbol empezando en la posici@'on del cursor a la
localizaci@'on dada por @code{org-archive-location}.
@end table

La localizaci@'on del archivo por defecto es un fichero en el mismo
directorio como el actual fichero, con el nombre derivado por el
sufijo @file{_archive} al actual nombre de fichero. Para informaci@'on
y ejemplos de c@'omo cambiar esto, ver la cadena de documentaci@'on de
la variable @code{org-archive-location}. Hay tambi@'en una opci@'on de
buffer para la configuraci@'on esta variable, por ejemplo

@smallexample
#+ARCHIVE: %s_done::
@end smallexample

@seealso{
@uref{http://orgmode.org/manual/Capture-_002d-Refile-_002d-Archive.html#Capture-_002d-Refile-_002d-Archive,
Cap@'{@dotless{i}}tulo 9 del manual}@*
@uref{http://members.optusnet.com.au/~charles57/GTD/remember.html,
Tutorial remember de Charles Cave}@*
@uref{http://orgmode.org/worg/org-tutorials/org-protocol-custom-handler.php,
tutorial para capturar desde un navegador web de Sebastian Rose}}@uref{}@*

@node Vistas de la Agenda, Marcado, Capture - Refile - Archive, Top
@chapter Vistas de la Agenda

Debido a que Org funciona, los @'{@dotless{i}}tems TODO, los
@'{@dotless{i}}tems de marca de tiempo y cabeceras pueden dispersarse
a trav@'es de un fichero o incluso un n@'umero de ficheros. Para tener
una visi@'on de @'{@dotless{i}}tems de acciones abiertas, o de eventos
que son importantes para una fecha particular, esta informaci@'on debe
ser recogida, ordenada y mostrada en un camino organizado. Hay vistas
varias vistas diferentes, ver debajo.

La informaci@'on extraida es mostrada en un @emph{buffer de agenda}
especial. Este buffer es de solo lectura, pero proporciona comandos
para visitar las localizaciones correspondientes en los ficheros Org
originales, e incluso para editar estos ficheros remotamente. La
edici@'on remota desde los buffer de agenda significa, por ejemplo,
que tu puedes cambiar las fechas de entrega y citas desde el buffer de
agenda. Los comandos disponibles en el buffer de Ageda son listados en
@ref{Comandos de la agenda}.

@menu
* Archivos de agenda::       Archivos buscados para la informaci@'on de la 
                               agenda
* El disparador de la agenda::  Acceso a las vistas de la agenda con teclado
* Vistas de agenda internas::  ¿Qu@'e hay fuera de la caja?
* Comandos de la agenda::    Edici@'on remota de @'arboles Org
* Vistas de agenda personalizadas::  Definiendo b@'usquedas y vistas 
                                       especiales
@end menu

@node Archivos de agenda, El disparador de la agenda, Vistas de la Agenda, Vistas de la Agenda
@section Archivos de agenda

La informaci@'on para ser mostrada est@'a normalmente recogida desde
todos los @emph{ficheros de agenda}, los ficheros listados en la
variable @code{org-agenda-files}.

@table @kbd
@item C-c [
A@~nade el fichero actual a la lista de ficheros de agenda. El fichero
est@'a a@~nadido al frente de la lista. Si esto ya estuvo en la lista,
esto est@'a movido al frente. Con un argumento de prefijo, el fichero
est@'a a@~nadido/movido al final.
@item C-c ]
Borra el fichero actual desde la lista de ficheros de agenda.
@item C-,
Cambia a trav@'es de la lista de ficheros de agenda, visitando un
fichero despu@'es del otro.
@end table

@node El disparador de la agenda, Vistas de agenda internas, Archivos de agenda, Vistas de la Agenda
@section El disparador de la agenda
Las vistas son creadas a trav@'es de un disparador, que debería ser
emparejado a una tecla global --- por ejemplo @kbd{C-c a}
(@pxref{Instalaci@'on}). Despu@'es de presionar @kbd{C-c a}, una carta
adicional se necesita ejecutar una comando:
@table @kbd
@item a
La agenda como calendario (@pxref{Agenda semanal/diaria}).
@item t @r{/} T
Una lista de todos los items TODO (@pxref{Lista global TODO}).
@item m @r{/} M
Una lista de titulares coincidentes con la expresi'on TAGS
(@pxref{Coincidiendo marcas y propiedades}).
@item L
La vista de la l@'{@dotless{i}}nea de tiempo para el buffer actual
@pxref{L@'{@dotless{i}}nea de tiempo}).
@item s
Una lista de entradas seleccionadas por una expresi@'on boleana de
palabras clave y/o expresiones regulares que debe o no debe ocurrir en
la entrada.
@end table

@node Vistas de agenda internas, Comandos de la agenda, El disparador de la agenda, Vistas de la Agenda
@section Las vistas internas de la agenda

@menu
* Agenda semanal/diaria::    La p@'agina del calendario con las tareas 
                               actuales
* Lista global TODO::        Todas las acciones de @'{@dotless{i}}tems no 
                               finalizados
* Coincidiendo marcas y propiedades::  Informaci@'on estructurada con 
                                         b@'usquedas afinadas
* L@'{@dotless{i}}nea de tiempo::  Vista ordenada en el tiempo de un simple 
                                     archivo
* Vista de b@'usqueda::      Encontrando entradas buscando texto
@end menu

@node Agenda semanal/diaria, Lista global TODO, Vistas de agenda internas, Vistas de agenda internas
@subsection Agenda semanal/diaria

El prop@'osito de la @emph{agenda} semanal/diaria es actuar como una
p@'agina de una agenda de papel, mostrando todas las tareas para la
actual semana o d@'{@dotless{i}}a.

@table @kbd
@item C-c a a
Compila una agenda para la semana actual desde una lista de fichero
Org. La agenda muestra las entradas para cada d@'{@dotless{i}}a.
@end table

Emacs contiene el calendario y el diario por Edward
M. Reingold. Org-mode comprende la sintaxis del diario y te permite
usar las entradas sexp directamente en ficheros Org:

@smallexample
* Cumplea@~nos y cosas similares
#+CATEGORY: Vacaciones
%%(org-calendar-holiday)   ; fuciones especiales para nombres de
fiestas
#+CATEGORY: Aniversario
%%(diary-anniversary  5 14 1956)@footnote{N@'otese que el orden de los
argumentos (mes, d@'{@dotless{i}}a, a@~no) depende de la
configuraci@'on de @code{calendar-date-style}.} Arthur Dent tiene %d
a@~nos
%%(diary-anniversary 10  2 1869) Mahatma Gandhi tendr@'{@dotless{i}}a
%d a@~nos.@end smallexample

Org puede interactuar con la funcionalidad de notificaciones de citas
de Emacs. Para a@~nadir todas la citas de tus ficheros de agenda, usa
el comando @code{org-agenda-to-appt}. Ver el docstring para detalles.

@node Lista global TODO, Coincidiendo marcas y propiedades, Agenda semanal/diaria, Vistas de agenda internas
@subsection La lista global TODO

La lista global TODO contiene todos los @'{@dotless{i}}tems TODO
formateado y recogido en un lugar simple. La edici@'on remota de
@'{@dotless{i}}tems TODO te permite cambiar el estado de una entrada
TODO con una simple tecla presionada. Los comandos disponible en la
lista TODO est@'an descritos en @ref{Comandos de la agenda}.

@table @kbd
@item C-c a t
Muestra la lista global TODO. Esta colecci@'on de @'{@dotless{i}}tems
TODO de todos los archivos de la agenda (@pxref{Vistas de la Agenda})
en un @'unico buffer.
@item C-c a T
Como abajo, pero permite la selecci@'on de una palabra clave
TODO espec@'{@dotless{i}}fica. 
@end table

@node Coincidiendo marcas y propiedades, L@'{@dotless{i}}nea de tiempo, Lista global TODO, Vistas de agenda internas
@subsection Coincidiendo marcas y propiedades

Si las l@'{@dotless{i}}neas de cabecera en los ficheros de agenda
est@'an marcados con @emph{etiquetas} (@pxref{Etiquetas}), o tienen
propiedades (@pxref{Propiedades}), se pueden seleccionar
l@'{@dotless{i}}neas de cabecera basadas en estos metadatos y los
recogen dentro del b@'uffer de agenda. El emparejamiento de sintaxis
descrito aqu@'{@dotless{i}} tambi@'en se aplica cuando se crean
@'arboles encogidos con @kbd{C-c / m}. Los comandos disponibles en la
lista de etiquetas est@'an descritos en @ref{Comandos de la agenda}.

@table @kbd
@item C-c a m
Producir una lista de todas las cabeceras que emparejan un conjunto
dado de etiquetas. El comando pregunta por un criterio de selecci@'on,
que es una expresi@'on de l@'ogica booleana con etiquetas, como
@samp{+work+urgent-withboss} o @samp{work|home}
(@pxref{Etiquetas}). Si con frecuencia se necesita una b@'usqueda
espec@'{@dotless{i}}fica, define un comando personalizado para ello
(@pxref{El disparador de la agenda}).
@item C-c a M
Como @kbd{C-c a m}, pero solo selecciona cabeceras que son tambi@'en
@'{@dotless{i}}tems TODO.
@end table

@subsubheading Emparejar sintaxis

Una cadena de b@'usqueda puede usar operadores booleanos @samp{&} para
AND y @samp{|} para OR. @samp{&} liga con m@'as fuerte que
@samp{|}. Par@'entesis est@'an actualmente no implementados. Cada
elemento en la b@'usqueda es una etiqueta, o una expresi@'on regular
como @code{PROPIEDAD OPERADOR VALOR} con un operador de comparaci@'on,
accediendo un valor de propiedad. Cada elemento puede ser precedido
por @samp{-}, para seleccionar contra ello, y @samp{+} es sint@'actico
puede ser precedido por @samp{-}, para seleccionarlo, y @samp{+} es
az@'ucar sint@'actico para selecci@'on positiva. El operador AND
@samp{&} es opcional cuando @samp{+} o @samp{-} est@'a
presente. Aqu@'{@dotless{i}} est@'an algunos ejemplos, usando solo
etiquetas.

@table @samp
@item +work-boss
Selecciona las l@'{@dotless{i}}neas de cabeza etiquetadas como
@samp{:trabajo:}, pero descarta estas tambi@'en etiquetadas como
@samp{:jefe:}.
@item trabajo|port@'atil
Selecciona l@'{@dotless{i}}neas etiquetadas como @samp{:trabajo:} o
@samp{:port@'atil}.
@item trabajo|escritorio+noche
Como antes, pero requiere las l@'{@dotless{i}}neas @samp{:portátil:}
para ser etiquetado tambi@'en como @samp{:noche:}.
@end table

Tu puedes tambi@'en testear para propiedades al mismo tiempo que
emparejando etiquetas, ver el manual para m@'as informaci@'on.

@node L@'{@dotless{i}}nea de tiempo, Vista de b@'usqueda, Coincidiendo marcas y propiedades, Vistas de agenda internas
@subsection L@'{@dotless{i}}nea de tiempo para un simple archivo

La l@'{@dotless{i}}nea de tiempo resume todos los @'{@dotless{i}}tems
de marca de tiempo desde un simple fichero Org mode en una @emph{vista
de tiempo ordenada}. El prop@'osito principal de este comando es dar
una vista general a trav@'es de eventos en un proyecto.

@table @kbd
@item C-c a L
Muestra una vista de tiempo ordenada del fichero Org, con todas los
@'{@dotless{i}}tems de marcas de tiempo. Cuando se llamaba con un
prefijo @kbd{C-u}, todas las entradas TODO no finalizadas
(planificadas o no) son tambi@'en listadas bajo la cita actual.
@end table

@node Vista de b@'usqueda, , L@'{@dotless{i}}nea de tiempo, Vistas de agenda internas
@subsection Vista de b@'usqueda

Esta vista de agenda es una facilidad de b@'usqueda general de texto
para entradas Org mode. Eso es particularmente @'util para encontrar notas.

@table @kbd
@item C-c a s
Esto es una b@'usqueda especial que te permite seleccionar entradas
emparejando una subcadena o palabras espec@'{@dotless{i}}ficas usando
l@'ogica booleana.
@end table
Por ejemplo, la cadena de b@'usqueda @samp{equipamiento del ordenador}
encontrar@'a entradas que contienen @samp{equipamiento del ordenador}
como una subcadena. La b@'usqueda tambi@'en puede encontrar palabras
clave espec@'{@dotless{i}}ficas en la entrada, usando l@'ogica
booleana. La cadena de b@'usqueda @samp{+ordenador +wifi -ethernet
-@{8\.11[bg]@}} encontrar@'a entradas que contengan las palabras
clave @code{ordenador} y @code{wifi}, pero no las palabras clave
@code{ethernet}, y que tambi@'en no concuerdan con la expresi@'on
regular @code{8\.11[bg]}, significado para excluir ambos 8.11b y
8.11g. 

N@'otese que adem@'as a los ficheros de agenda, este comando tambi@'en
buscar@'a los ficheros listados en
@code{org-agenda-text-search-extra-files}.

@node Comandos de la agenda, Vistas de agenda personalizadas, Vistas de agenda internas, Vistas de la Agenda
@section Comandos en el b@'uffer de agenda

Las entradas en el b@'uffer de agenda est@'an enlazadas al fichero Org
o el fichero de diario d@'onde ellos lo originan. Los comandos est@'an
provistos para mostrar y saltar a la localizaci@'on de la entrada
original, y editar los ficheros Org ``remotamente'' desde el buffer de
la agenda. Esto es solo una selecci@'on de los muchos comandos,
explora el men@'u de la @code{Agenda} y el manual para una lista completa.

@table @kbd
@tsubheading{Movimiento}
@item n
Siguiente l@'{@dotless{i}}nea (igual que @key{arriba} y @kbd{C-p}).
@item p
La l@'{@dotless{i}}nea previa (igual que @key{abajo} y
@kbd{C-n}. @tsubheading{Vista/Ir al fichero Org}
@item mouse-3
@itemx @key{SPC}
@c
Muestra la localizaci@'on original del @'{@dotless{i}}tem en otra
ventana. Con prefijo arg, aseg@'urate que la entrada entera es hecha
visible en el outline, no solo la cabecera.
@itemx @key{TAB}
@c
Ir a la localizaci@'on original de los @'{@dotless{i}}tems en otra
ventana. Bajo Emacs 22 @kbd{mouse-1} tambi@'en funciona para esto.
@itemx @key{RET}
@c
Ir a la localizaci@'on original del @'{@dotless{i}}tem y borra otras
ventanas.

@tsubheading{Cambiar la visualizaci@'on}
@item o
@c
Borra otras ventanas.
@item d @r{/} w
@c
Cambiar a la vista de d@'{@dotless{i}}a/semana. 
@item f @r{y} b
@c
Ir hacia delante o hacia atr@'as en el tiempo para mostrar los
siguientes d@'{@dotless{i}}as @code{org-agenda-current-span}. Por
ejemplo, si el display cubre una semana, cambia la siguiente o previa
semana.
@item .
@c
Ir a hoy.
@item j
@c
Pregunta por una fecha y va all@'{@dotless{i}}.
@item v l @ @r{u ordena} @ l
@c
Cambia al modo Logbook. En modo Logbook, las entradas que fueron
marcadas como DONE mientras se entro en (variable @code{org-log-done}
son mostradas en la agenda, como son entradas han sido organizadas en
este d@'{@dotless{i}}a. Cuando se llamo con un prefijo @kbd{C-u},
muestra todas las posibles entradas logbook, incluyendo cambios estado.
@item r @r{o} g
Recrear el buffer de agenda, para reflejar los cambios.
@item s
Salva todos los buffers Org en la sesi@'on Emacs actual, y tambi@'en
las localizaciones de IDs.

@tsubheading{Filtro secundario y buscar la edici@'on}

@item /
Filtra la vista de agenda actual con respecto a una etiqueta. Se
pregunta por una letra para seleccionar una etiqueta. Presiona
@samp{-} primero para seleccionar la etiqueta.

@item \
Minimiza el filtro de la agenda actual por una condici@'on adicional.

@tsubheading{Edici@'on remota (ver el manual para muchos m@'as comandos)}

@item 0-9
@c
Argumento d@'{@dotless{i}}gito.
@item t
@c
Cambia el estado TODO del @'{@dotless{i}}tem, en la agenda en el
fichero org.
@item C-k
@c
Borra el @'{@dotless{i}}tem de la agenda actual a lo largo con el
sub@'arbol perteneciente a ello en el fichero Org original. 
@item C-c C-w
@c
Rellena la entrada a punto.
@item C-c C-x C-a @ @r{u ordena} @ a
@c
Archivar el sub@'arbol correspondiente a la entrada a punto usando el
comando de archivaci@'on establecido en @code{org-archive-default-command}.
@item C-c C-x C-s @ @r{u ordena} @ $
@c
Archiva el sub@'arbol correspondiente a la actual cabecera.
@item C-c C-s
@c
Planifica este @'{@dotless{i}}tem, con argumento prefijo borra la
marca de tiempo planificada.
@item C-c C-d
@c
Asigna una fecha l@'{@dotless{i}}mite para este @'{@dotless{i}}tem,
con el argumento prefijo elimina la fecha l@'{@dotless{i}}mite.
@item S-@key{derecha}@r{/}@key{izquierda}
@c
Cambia la marca de tiempo asociada con la l@'{@dotless{i}}nea actual
por un d@'{@dotless{i}}a.
@item I
@c
Empieza el cron@'ometro en el @'{@dotless{i}}tem actual.
@item O / X
Para/cancela el reloj previamente iniciada.

@item J
Salta al reloj en ejecuci@'on en otra ventana.
@end table

@node Vistas de agenda personalizadas, , Comandos de la agenda, Vistas de la Agenda
@section Vistas de agenda personalizadas

La principal aplicaci@'on de las b@'usquedas personalizadas es la
definici@'on de atajos de teclado para b@'usquedas usadas
frecuentemente, bien creando un b@'uffer de agenda, o un @'arbol
disperso (el @'ultimo que cubre de acuerdo solo al b@'uffer
actual). Los comandos personalizados son configurados en la variable
@code{org-agenda-custom-commands}. Se puede personalizar esta
variable, por ejemplo, presionando @kbd{C-c a C}. Se puede tambi@'en
directamente establecerlo con Emacs Lisp en @file{.emacs}. El
siguiente ejemplo contiene todos los tipos de b@'usqueda v@'alida:

@smalllisp
@group
(setq org-agenda-custom-commands
      '(("w" todo "ESPERANDO")
        ("u" tags "+jefe-urgente")
        ("v" tags-todo "+jefe-urgente")))
@end group
@end smalllisp

@noindent
La cadena inicial en cada entrada define las claves que tu tienes para
presionar despu@'es el comando disparador @kbd{C-c a} en orden para
acceder el comando. Usualmente esto ser@'a solo un car@'acter. El
segundo par@'ametro es el tipo de b@'usqueda, seguida por la cadena o
expresi@'on regular para ser usada por el emparejamiento. El ejemplo
de arriba adem@'as definir@'a:

@table @kbd
@item C-c a w
como una b@'usqueda global para entradas TODO con @samp{ESPERANDO}
como la palabra clave TODO
@item C-c a u
como una b@'usqueda global de etiquetas para l@'{@dotless{i}}neas de
cabecera @samp{:jefe:} pero no @samp{:urgente:}
@item C-c a v
como la misma b@'usqueda @kbd{C-c a u}, pero limitando la b@'usqueda
para l@'{@dotless{i}}neas de cabecera est@'an tambi@'en
@'{@dotless{i}}tems TODO
@end table

@seealso{
@uref{http://orgmode.org/manual/Agenda-Views.html#Agenda-Views,
Cap@'{@dotless{i}}tulo 10 del manual}@*
@uref{http://orgmode.org/worg/org-tutorials/org-custom-agenda-commands.php,
El tutorial de Mat Lundin acerca de comandos personalizados de
agenda}@*
@uref{http://www.newartisans.com/2007/08/using-org-mode-as-a-day-planner.html,
Configuraci@'on de John Wiegley}}

@node Marcado, Exportando, Vistas de la Agenda, Top
@chapter Marcas para enriquecer la exportaci@'on

Cuando la exportaci@'on documentos Org-mode, el exportador intenta
reflejar la estructura del documento tan precisamente como sea posible
en el backend. Desde exportar a formatos como HTML, @LaTeX{}, o DocBook
permite muchos formatos enriquecidos, Org mode tiene reglas en c@'omo
preparar texto para exportar riqueza. Esta secci@'on resume las reglas
de marcado usados en un buffer Org-mode.

@menu
* Elementos del marcado estructural::  La estructura b@'asica es vista por 
                                         el exportador
* Im@'agenes y tablas::      Tablas e im@'agenes ser@'an incluidas
* Ejemplos literales::       Ejemplos de c@'odigo fuente con formato 
                               especial
* Archivos Include::         Archivos adicionales Include dentro de un 
                               documento
* @LaTeX{} embebido::        @LaTeX{} puede usarse libremente dentro de los 
                               documentos Org
@end menu

@node Elementos del marcado estructural, Im@'agenes y tablas, Marcado, Marcado
@section Elementos del marcado estructural

@menu
* T@'{@dotless{i}}tulo de documento::  Desde donde el t@'{@dotless{i}}tulo 
                                         es tomado
* Encabezados y secciones::  La estructura del documento es vista por el 
                               exportador
* Tabla de contenidos::      El si y el donde de la tabla de contenidos
* P@'arrafos::               P@'arrafos
* @'Enfasis y monoespacio::  Negrilla, it@'alica, etc.
* L@'{@dotless{i}}neas de comentarios::  Qu@'e *no* ser@'a exportado
@end menu

@node T@'{@dotless{i}}tulo de documento, Encabezados y secciones, Elementos del marcado estructural, Elementos del marcado estructural
@subheading T@'{@dotless{i}}tulo de documento

@noindent
El t@'{@dotless{i}}tutlo del documento exportado es tomado desde la
l@'{@dotless{i}}nea especial

@smallexample
#+TITLE: Este es el t@'{@dotless{i}}tulo del documento
@end smallexample

@node Encabezados y secciones, Tabla de contenidos, T@'{@dotless{i}}tulo de documento, Elementos del marcado estructural
@subheading Encabezados y secciones

La estructura de contorno del documento como se describe en
@ref{Estructura del documento}, forma las bases para las secciones de
definici@'on de los documentos exportados. Sin embargo, desde la
estructura de contorno est@'a tambi@'en usada para (por ejemplo)
listas de tareas, solo los primeros niveles del @'arbol de contorno
ser@'an usadas como cabeceras. Los niveles profundos llegar@'an a ser
listas de @'{@dotless{i}}tems. Se puede cambiar la localizaci@'on de
este cambio globalmente configurando la variable
@code{org-export-headline-levels}, o en una base por fichero con una
l@'{@dotless{i}}nea.

@smallexample
#+OPTIONS: H:4
@end smallexample

@node Tabla de contenidos, P@'arrafos, Encabezados y secciones, Elementos del marcado estructural
@subheading Tabla de contenidos

La tabla de contenidos est@'a normalmente insertados directamente
antes de la primera l@'{@dotless{i}}nea de cabecera del fichero.

@smallexample
#+OPTIONS: toc:2          (solo a dos niveles en TOC)
#+OPTIONS: toc:nil        (no TOC en todo)
@end smallexample

@node P@'arrafos, @'Enfasis y monoespacio, Tabla de contenidos, Elementos del marcado estructural
@subheading P@'arrafos, l@'{@dotless{i}}neas rotas y citaci@'on

Los p@'arrafos est@'an separados por al menos una l@'{@dotless{i}}nea
vac@'{@dotless{i}}a. Si tu necesitas forzar una l@'{@dotless{i}}nea
rota con un p@'arrafo, usa @samp{\\} al fin de una l@'{@dotless{i}}nea.

Para guardar la l@'{@dotless{i}}nea rota en una regi@'on, pero de otro
modo usa formateo normal se puede usar este constructo, que puede
tambi@'en ser usado para poes@'{@dotless{i}}a de formato.

@smallexample
#+BEGIN_VERSE
 Grandes nubes sobre cabezas
 Muy peque@~nos p@'ajaros aparecen y caen
 Nieve cubre Emacs 
     -- AlexSchroeder
#+END_VERSE
@end smallexample

Cuando cita un pasaje desde otro documento, ello es un libro de usos y
costumbres para formatear esto como un p@'arrafo que se pretende en
ambos la izquierda y el margen derecho. Se puede incluir citas en
documentos Org-mode como este:

@smallexample
#+BEGIN_QUOTE
Cada cosa ser@'{@dotless{i}}a hecha tan simple como posible,
pero no cualquiera -- Albert Einstein
#+END_QUOTE
@end smallexample

Si te gustar@'{@dotless{i}}a centrar alg@'un texto, hacerlo como esto:
@smallexample
#+BEGIN_CENTER
Cada cosa deber@'{@dotless{i}}a hecha tan simple como posible \\
pero no simple cualquier manera
#+END_CENTER
@end smallexample

@node @'Enfasis y monoespacio, L@'{@dotless{i}}neas de comentarios, P@'arrafos, Elementos del marcado estructural
@subheading @'Enfasis y monoespacio

Se pueden crear palabras @b{*bold*}, @i{/italic/}, _underlined_,
@code{=code=} and @code{~verbatim~}, y, se debe,
@samp{+strike-through+}.
Texto en el c@'odigo y cadena verbatim no est@'a procesada para una
sintaxis espec@'{@dotless{i}}fica de Org-mode, ella es una copia
literal exportada. Para insertar reglas horizontales, usan un
l@'{@dotless{i}}nea que consista de solo dashes, y al menos 5 de ellos.

@node L@'{@dotless{i}}neas de comentarios, , @'Enfasis y monoespacio, Elementos del marcado estructural
@subheading L@'{@dotless{i}}neas de comentarios

Las l@'{@dotless{i}}neas empezando cero o m@'as car@'acteres de
espacios en blanco seguidos por @samp{#} son tratados como comentarios
y nunca ser@'an exportados. Tambi@'en sub@'arboles enteros empezando
con la palabra @samp{COMMENT} nunca ser@'an exportados. Finalmente,
regiones alrededor por @samp{#+BEGIN_COMMENT} ... @samp{#+END_COMMENT}
no ser@'an exportados.

@table @kbd
@item C-c ;
Cambia la palabra clave COMMENT al principio de una entrada.
@end table

@node Im@'agenes y tablas, Ejemplos literales, Elementos del marcado estructural, Marcado
@section Im@'agenes y Tablas

Para tablas Org mode, las l@'{@dotless{i}}neas antes de la primera
l@'{@dotless{i}}nea de separador horizontal llegar@'a a ser una tabla
de l@'{@dotless{i}}neas cabecera. Tu puedes usar las siguientes
l@'{@dotless{i}}neas en alg@'un lugar antes de la tabla para asignar
un caption y una etiqueta para referencias cruzadas, y en el texto se
puede referir para el objeto con @code{\\ref@{tab:basic-data@}}:

@smallexample
#+CAPTION: Este es el t@'{@dotless{i}}tulo para la siguiente tabla (o enlace)
#+LABEL:   tbl:basic-data
   | ... | ...|
   |-----|----|
@end smallexample

Algunos backends (HTML, @LaTeX{}, y Docbook) te permiten directamente
incluir im@'agenes dentro del documento exportado. Org hace esto, si
un enlace a ficheros de im@'agenes no tiene una parte de
descripci@'on, por ejemplo @code{[[./img/a.jpg]]}. Si deseas definir
una caption para la imagen y puede ser una etiqueta para referencias
cruzadas, tu asegura que el enlace est@'a en una l@'{@dotless{i}}nea
por s@'{@dotless{i}} misma prec@'edelo con:

@smallexample
#+CAPTION: Este es el t@'{@dotless{i}}tulo para la siguiente enlace
#figura (o tabla)
#+LABEL:   fig:SED-HR4049
[[./img/a.jpg]]
@end smallexample

Se pueden tambi@'en definir atributos adicionales para la figura. Como
esta es un backend espec@'{@dotless{i}}fico, mira las secciones acerca
de los backends individuales para m@'as informaci@'on.


@node Ejemplos literales, Archivos Include, Im@'agenes y tablas, Marcado
@section Ejemplos literales

Se pueden incluir ejemplos literales que no deber@'{@dotless{i}}an ser
asunto de marcado. Tales ejemplos ser@'an tipografiados en monospacio,
as@'{@dotless{i}} est@'a bien situado para el c@'odigo fuente y
ejemplos similares.

@smallexample
#+BEGIN_EXAMPLE
Alg@'un ejemplo desde un fichero de texto.
#+END_EXAMPLE
@end smallexample

Por simplicidad cuando se usan ejemplos peque@~nos, se puede tambi@'en
empezar l@'{@dotless{i}}neas con dos puntos seguidos por un
espacio. Tambi@'en puede haber espacios en blanco adicionales antes de
los dos puntos:

@smallexample
Aqu@'{@dotless{i}} est@'a un ejemplo
    : Alg@'un ejemplo desde un fichero de texto.@end smallexample

Para c@'odigo fuente desde un lenguaje de programaci@'on, o cualquier
otro texto que puede ser marcado por bloque de fuentes en Emacs, se
puede preguntar para ello para mirar como el b@'uffer de Emacs fontificado.

@smallexample
#+BEGIN_SRC emacs-lisp
(defun org-xor (a b)
   "or exclusiva."
   (if a (not b) b))
#+END_SRC
@end smallexample

Para editar el ejemplo en un b@'uffer especial soportando este
lenguaje, usa @kbd{C-c '} para ambos entrar y dejar el b@'uffer de
edici@'on.

@node Archivos Include, @LaTeX{} embebido, Ejemplos literales, Marcado
@section Archivos Include

Durante la exportaci@'on, se pueden incluir el contenido de otro
fichero. Por ejemplo, para incluir tu fichero @file{.emacs}, se
podr@'{@dotless{i}}a usar:

@smallexample
#+INCLUDE: "~/.emacs" src emacs-lisp
@end smallexample
@noindent
El segundo opcional y tercer par@'ametro son la marca (e.g.@:
@samp{cita}, @samp{ejemplo}, o @samp{fuente}), y, si la marca es
@samp{fuente}, el lenguaje para el formatear los contenidos. La marca
es opcional, si no est@'a dado, el texto ser@'a asumido para estar en
el formato de Org mode y ser@'a procesado normalmente. @kbd{C-c '}
visitar@'a el fichero incluido.

@node @LaTeX{} embebido, , Archivos Include, Marcado
@section @LaTeX{} embebido

Para notas cient@'{@dotless{i}}ficas que necesitan ser capaces de
contener s@'{@dotless{i}}mbolos matem@'aticos y la f@'ormula
ocasional, Org-mode soporte embebiendo c@'odigo @LaTeX{} dentro de sus
ficheros. Se puede directamente usar Tex como macros para
s@'{@dotless{i}}mbolos especiales, introduce f@'ormulas y entornos @LaTeX{}.

@smallexample
Los @'angulos son escritos como letras Griegas \alpha, \beta y
\gamma. La masa si el sol es M_sol = 1.989 x 10^30 kg. El radio del
sol es R_@{sol@} = 6.96 x 10^8 m. Si $a^2=b$ y $b=2$, entonces la
soluci@'on debe ser $a=+\sqrt@{2@}$ o $a=-\sqrt@{2@}$.\begin@{equation@}
x=\sqrt@{b@}
\end@{equation@}
@end smallexample
@noindent With
@uref{http://orgmode.org/manual/LaTeX-fragments.html#LaTeX-fragments,
configuraci@'on especial}, trozos de @LaTeX{} ser@'an incluidos como
im@'agenes cuando se exporta a HTML.

@seealso{ @uref{http://orgmode.org/manual/Markup.html#Markup,
Cap@'{@dotless{i}}tulo 11 del manual}}

@node Exportando, Publicaci@'on, Marcado, Top
@chapter Exportando

Los documentos Org-mode pueden exportarse a una variedad de otros
formatos: ASCII para su inclusi@'on en correos electr@'onicos,
HTML para su publicaci@'on en la web, @LaTeX{}/PDF para bellos documentos
impresos y DocBook para entrar a un mundo de muchos otros formatos
usando herramientas DocBook. Adem@'as puede exportarse al
formato iCalendar, as@'{@dotless{i}} la informaci@'on de
planificaci@'on puede ser incorporada a calendarios de escritorio.

@menu
* Opciones de exportaci@'on::  Configuraci@'ones del perf@'{@dotless{i}}l de 
                                 exportaci@'on
* El dispensador de exportaci@'on::  Como acceder a los comandos del 
                                       exportador
* Exportaci@'on ASCII/Latin-1/UTF-8::  Exportando a ficheros planos con 
                                         codificaci@'on
* HTML export::              Exportando a HTML
* Exportar @LaTeX{} y PDF::  Exportando a @LaTeX{}, y procesando a PDF
* Exportar DocBook::         Exportando a DocBook
* Exportar iCalendar::                  
@end menu

@node Opciones de exportaci@'on, El dispensador de exportaci@'on, Exportando, Exportando
@section Opciones de exportaci@'on

El exportador reconoce l@'{@dotless{i}}neas especiales en el buffer
que proporciona informaci@'on adicional. Estas l@'{@dotless{i}}neas
pueden ser puestas en cualquier lugar en el fichero. El conjunto
completo de l@'{@dotless{i}}neas que pueden ser insertadas dentro del
buffer con @kbd{C-c C-e t}.

@table @kbd
@item C-c C-e t
Inserta plantilla con opciones de exportaciones, ver ejemplo de debajo.
@end table

@smallexample
#+TITLE:       el t@'{@dotless{i}}tulo que ser@'a mostrado (por defecto es el nombre del b@'uffer)
#+AUTHOR:      el autor (por defecto tomado desde @code{user-full-name})
#+DATE:        una fecha, fija, de una cadena de formato para @code{format-time-string}
#+EMAIL:       su direcci@'on de correo (por defecto @code{user-mail-address})
#+DESCRIPTION: la descripci@'on de la p@'agina e.g.@: para la meta etiqueta XHTML
#+KEYWORDS:    la p@'agina keywords, e.g.@: para la meta etiqueta XHTML
#+LANGUAGE:    lenguaje para HTML, por ej.@: @samp{en} (@code{org-export-default-language})
#+TEXT:        Alg@'un texto descriptivo para ser insertado al principio.
#+TEXT:        Varias l@'{@dotless{i}}neas pueden ser dadas.
#+OPTIONS:     H:2 num:t toc:t \n:nil @@:t ::t |:t ^:t f:t TeX:t ...
#+LINK_UP:     el enlace ``up'' de una p@'agina exportada.
#+LINK_HOME:   el enlace ``home'' de una p@'agina exportada.
#+LATEX_HEADER: l@'{@dotless{i}}neas extra para la cabecera @LaTeX{}, como \usepackage@{xyz@}
@end smallexample

@node El dispensador de exportaci@'on, Exportaci@'on ASCII/Latin-1/UTF-8, Opciones de exportaci@'on, Exportando
@section El dispensador de exportaci@'on

Todos los comandos de exportaci@'on pueden ser logrados usando el
disparador de exportaci@'on, que es una clave prefija que pronto para
una clave adicional especificando el comando.
Normalmente el fichero entero est@'a exportado, pero si hay una
regi@'on activa que contiene un @'arbol de perfil, la primera cabecera
est@'a usado como t@'{@dotless{i}}tulo de documento y los sub@'arboles
est@'an exportados.

@table @kbd
@item C-c C-e
Disparador para exportar y publicar comandos.
@end table

@node Exportaci@'on ASCII/Latin-1/UTF-8, HTML export, El dispensador de exportaci@'on, Exportando
@section Exportaci@'on ASCII/Latin-1/UTF-8

La exportaci@'on ASCII produce un simple y muy legible versi@'on de un
fichero Org-mode, conteniendo solo ASCII plano. Latin-1 y UTF-8
exporta aumentar el fichero con car@'acteres especiales y
s@'{@dotless{i}}mbolos disponibles en estas codificaciones.

@table @kbd
@item C-c C-e a
Exportar como un fichero ASCII
@item C-c C-e n @ @ @r{y} @ @ C-c C-e N
Como comandos de debajo, pero usa codificaci@'on Latin-1.
@item C-c C-e u @ @ @r{y} @ @ C-c C-e U
Como los comandos de arriba, pero usa codificaci@'on UTF-8.
@end table

@node HTML export, Exportar @LaTeX{} y PDF, Exportaci@'on ASCII/Latin-1/UTF-8, Exportando
@section HTML export

@table @kbd
@item C-c C-e h
Exportar como un fichero HTML @file{myfile.html}.
@item C-c C-e b
Exportar como fichero HTML e inmediatamente lo abre con un navegador.
@end table

Para insertar HTML que deber@'{@dotless{i}}a ser copia lateral para el
fichero exportado usa otro

@smallexample
#+HTML: C@'odigo Literal HTML para exportar
@end smallexample
@noindent or
@smallexample
#+BEGIN_HTML
Todas las l@'{@dotless{i}}neas entre estos marchadores son exportados
literalmente
#+END_HTML
@end smallexample

@node Exportar @LaTeX{} y PDF, Exportar DocBook, HTML export, Exportando
@section Exportar @LaTeX{} y PDF

@table @kbd
@item C-c C-e l
Exporta como fichero @LaTeX{} @file{myfile.tex}.
@item C-c C-e p
Exportando a @LaTeX{} y procesando a PDF
@item C-c C-e d
Exportando a @LaTeX{} y procesando a PDF, entonces se abre el fichero PDF
resultante.
@end table

Por defecto, la salida @LaTeX{}] usa la clase @code{article}. Se puede
cambiar esto para a@~nadir una opci@'on como @code{#+LaTeX_CLASS:
myclass} en su fichero. La clase debe ser listado en
@code{org-export-latex-classes}.

El @LaTeX{} embebido como se describe en @ref{@LaTeX{} embebido},
ser@'a correctamente insertado dentro del fichero @LaTeX{}. De manera
similar, al exportador HTML, se puede usar @code{#+LaTeX:} y la
construcci@'on @code{#+BEGIN_LaTeX ... #+END_LaTeX} para a@~nadir
c@'odigo @LaTeX{} literal.

@node Exportar DocBook, Exportar iCalendar, Exportar @LaTeX{} y PDF, Exportando
@section Exportar DocBook

@table @kbd
@item C-c C-e D
Exportando como un fichero DocBook
@end table

De forma similar al exportador HTML, se puede emplear los
constructores @code{#+DOCBOOK:} y @code{#+BEGIN_DOCBOOK
... #+END_DOCBOOK} para a@~nadir c@'odigo @LaTeX{}.

@node Exportar iCalendar, , Exportar DocBook, Exportando
@section Exportar iCalendar

@table @kbd
@item C-c C-e i
Crea entradas iCalendar para el fichero actual en un fichero @file{.ics}.
@item C-c C-e c
Crea un fichero simple y largo iCalendar desde todos los ficheros en
@code{org-agenda-files} y lo escribe al fichero dado por
@code{org-combined-agenda-icalendar-file}.
@end table

@seealso{ @uref{http://orgmode.org/manual/Exporting.html#Exporting,
Cap@'{@dotless{i}}tulo 12 del manual}@*
@uref{http://orgmode.org/worg/org-tutorials/images-and-xhtml-export.php,
Tutorial de Sebastian Rose de manejo de im@'agenes}@*
@uref{http://orgmode.org/worg/org-tutorials/org-latex-export.php,
Tutorial de exportaci@'on de LaTeX de Thomas Dye}
@uref{http://orgmode.org/worg/org-tutorials/org-beamer/tutorial.php,
Tutorial de presentaciones de BEAMER de Eric Fraga}}

@node Publicaci@'on, Trabajando con C@'odigo Fuente, Exportando, Top
@chapter Publicaci@'on

Org incluye un sistema de gesti@'on de publicaci@'on que permite
configurar conversi@'on HTML de @emph{proyectos} compuestos de
ficheros org entrelazados. Se puede tambi@'en configurar Org para
autom@'aticamente subir tus p@'aginas HTML y adjuntos relacionados,
tales como im@'agenes y ficheros de c@'odigo fuente, para un servidor
web. Para instrucciones detalladas acerca de la configuraci@'on, ver
el manual.

Aqu@'{@dotless{i}} hay un ejemplo:

@smalllisp
(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\"/>")))
@end smalllisp

@table @kbd
@item C-c C-e C
Pregunta por un proyecto espec@'{@dotless{i}}fico y publica todos los
ficheros que pertenecen a él.
@item C-c C-e P
Publica el proyecto que contiene el fichero actual.
@item C-c C-e F
Elimina la columna actual.
@item C-c C-e E
Publica cada proyecto
@end table

Org usa marcas de tiempo para trazar cuando un fichero ha
cambiado. Las funciones de debajo normalmente solo publican ficheros
cambiados. Se puede sobreescribir esto y forzar la publicaci@'on de
todos los ficheros dando un argumento prefijo para cualquiera de los
comandos de debajo.

@seealso{ @uref{http://orgmode.org/manual/Publishing.html#Publishing,
Cap@'{@dotless{i}}tulo 13 del manual}@*
@uref{http://orgmode.org/worg/org-tutorials/org-publish-html-tutorial.php,
Tutorial de publicaci@'on de Sebastian Rose}@*
@uref{http://orgmode.org/worg/org-tutorials/org-jekyll.php,
Configuraci@'on de Jekyll de Ian Barton}}

@node Trabajando con C@'odigo Fuente, Miscel@'anea, Publicaci@'on, Top
@chapter Trabajando con c@'odigo fuente
Org-mode proporciona un n@'umero de funcionalidades para trabajar con
c@'odigo fuente, incluyendo editando de bloques c@'odigo en sus modo
mayor nativo, evaluaci@'on de bloques c@'odigo, enredo de bloques de
c@'odigo, y exportando bloques de c@'odigo y sus resultados en varios
formatos.

@subheading Estructura de C@'odigos de Bloques
La estructura de c@'odigos de bloques es como sigue:

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

Donde @code{<name>} es una cadena usada para nombrar el bloque de
c@'odigo @code{<language>} especifica el lenguaje del bloque de
c@'odigo (por ej.@: @code{emacs-lisp}, @code{shell}, @code{R},
@code{python}, etc..., @code{<switches>} puede ser usado para
controlar la exportaci@'on  del bloque de c@'odigo, @code{<header
arguments>} puede ser usado para controlar muchos aspectos del
comportamiento de bloques de c@'odigo como se demuesta debajo, y el
@code{<body>} contiene el c@'odigo fuente actual.

@subheading Editando c@'odigo fuente
Usa @kbd{C-c '} para editar el actual bloque de c@'odigo. Esto trae un
lenguaje en modo mayor edita el buffer conteniendo el cuerpo del
bloque de c@'odigo. Salvando este buffer escribir@'a los nuevos
contenidos atr@'as al buffer de Org. Usa @kbd{C-c '} atr@'as para
salir del buffer de edici@'on.

@subheading Evaluando c@'odigos de bloques
Usa @kbd{C-c C-c} para evaluar el actual bloque c@'odigo e inserta sus
resultados en el b@'uffer Org-mode. Por defecto, la evaluaci@'on solo
cambia para bloques de c@'odigo @code{emacs-lisp}, sin embargo, el
soporte existe para evaluar bloques en muchos lenguajes. Para una
lista completa de lenguajes ver el manual. Lo siguiente muestra un
bloque de c@'odigo y sus resultados.

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

#+RESULTS:
: 10
@end example

@subheading Extrayendo c@'odigo fuente
Usa @kbd{C-c C-v t} para crear ficheros de c@'odigo fuente puro para
extrayendo c@'odigo desde bloques fuente en el b@'uffer actual. Esto
es referido como ``enredo''--- un t@'ermino adoptado desde la
comunidad de programaci@'on literal. Durante ``el enredo'' de bloques
c@'odigo sus cuerpos est@'an expandidas usando
@code{org-babel-expand-src-block} que puede expandir ambas variables y
referencias de estilo ``noweb''. En orden para enredar un bloque de
c@'odigo ello debe tener un argumento de cabecera de @code{:enredo},
ver el manual para detalles.

@subheading Librer@'{@dotless{i}}a de Babel
Usa @kbd{C-c C-v l} para cargar los bloques de c@'odigo desde ficheros
Org-mode dentro de la ``Librer@'{@dotless{i}}a de Babel'', estos
bloques puede entonces ser evaluado desde cualquier b@'uffer
Org-mode. Una colecci@'on de generalmente bloques de c@'odigo @'utiles
est@'an distribuidos con Org-mode en @code{contrib/library-of-babel.org}.

@subheading Argumentos de Cabecera
Muchos aspectos de la evaluaci@'on y exportaci@'on de bloques c@'odigo
est@'an controlados a trav@'es de argumentos de cabecera. Estos pueden
ser especificados globalmente, en el nivel de fichero, en el nivel de
perfil de sub@'arbol, y en el nivel de c@'odigo bloque individual. Lo
siguiente describe algunos de los argumentos de cabecera.
@table @code
@item :var
El argumento de cabecera @code{:var} es usado para pasar argumentos a
bloques de c@'odigo. Los valores pasados a argumentos pueden ser
valores literales, valores desde tablas org-mode y ejemplos de bloque
literales, o los resultados de otros bloques de c@'odigo nombrados.
@item :results
El argumento de cabecera @code{:results} controla el
@emph{collection}, @emph{type}, y @emph{handling} de resultados de
bloques de c@'odigo. Valores de @code{output} o @code{value} (por
defecto) especifican como los resultados son recogidos desde la
evaluaci@'on de bloques de c@'odigo. Valores de @code{vector},
@code{scalar} @code{file} @code{raw} @code{html} @code{latex} and
@code{code} especifican el tipo de resultados del bloque c@'odigo que
dicta c@'omo ser@'an incorporados dentro del buffer Org-mode. Valores
de @code{silent}, @code{replace}, @code{prepend}, y @code{append}
especifica el manejo de resultados de bloques de c@'odigo,
espec@'{@dotless{i}}ficamente si y c@'omo los resultados
deber@'{@dotless{i}}an ser insertados dentro del b@'uffer Org-mode.
@item :session
Un argumento de cabecera de @code{:sesi@'on} causar@'a el bloque de
c@'odigo para ser evaluada en un proceso inferior persistente en
Emacs. Esto permite el estado persistente entre evaluaciones de bloque
de c@'odigo, y para inspecci@'on de manual de los resultados de
evaluaci@'on.
@item :exporta
Cualquier combinaci@'on del @emph{code} @'o los @emph{resultados} de
un bloque puede ser retenido en exportar, esto est@'a
espec@'{@dotless{i}}ficado por configuraci@'on de los
@code{:resultados} de argumentos de cabecera para @code{c@'odigo}
@code{resultados} @code{ninguno} @'o @code{ambos}.
@item :tangle
Un argumento de cabecera de @code{:tangle yes} causar@'a de bloques de
c@'odigo para estar enredado a un fichero llamado despu@'es del nombre
del fichero del b@'uffer Org-mode. Un nombre de fichero alternativo
puede ser especificado con @code{:tangle filename}.
@item :cache
Un argumento de cabecera de @code{:cache yes} causar@'a asociar un
hash del bloque c@'odigo expandido con los resultados, asegurando que
los bloques de c@'odigo est@'an solo rearrancados con sus entradas han
cambiado.
@item :noweb
Un argumento de cabecera de @code{:noweb sí} expandir@'a ``noweb''
referencias de estilo en evaluaci@'on y enredando.
@item :file
Los bloques de c@'odigo cuya salida resulta a ficheros (por ej.@:
grafos, diagramas y figuras) puede aceptar un @code{:file nombre de
fichero} argumento de cabecera en cuyo caso los resultados est@'an a
salvo para el fichero nombrado, y un enlace al fichero es insertado
dentro del b@'uffer Org-mode.
@end table

@seealso{
@uref{http://orgmode.org/manual/Literal-examples.html#Literal-examples,
Cap@'{@dotless{i}}tulo 11.3 del manual}@*
@uref{http://orgmode.org/worg/org-contrib/babel/index.php, El sitio
Babel en Worg}}

@node Miscel@'anea, , Trabajando con C@'odigo Fuente, Top
@chapter Miscel@'anea

@menu
* Terminaci@'on::            M-TAB sabe qu@'e necesita
* Vista limpia::             Eliminaci@'on de los asteriscos iniciales en el 
                               outline
* Org m@'ovil::              Org-mode en el iPhone
@end menu

@node Terminaci@'on, Vista limpia, Miscel@'anea, Miscel@'anea
@section Terminaci@'on

Org soporta autocompleci@'on en b@'uffer con @kbd{M-@key{TAB}}. Este
tipo completado no hace uso del minib@'uffer. Tu simplemente escribe
unas pocas letras dentro del b@'uffer y usa la clave para completar
texto correctamente. Por ejemplo, este comando completar@'a
s@'{@dotless{i}}mbolos @TeX{} despu@'es @samp{\}, palabras clave TODO
al principio de la l@'{@dotless{i}}nea de cabeza, y etiquetas
despu@'es de @samp{:} en una l@'{@dotless{i}}nea de cabeza.

@node Vista limpia, Org m@'ovil, Terminaci@'on, Miscel@'anea
@section Una vista del contorno de limpieza

Algunas personas encuentran ruidoso y distraido que las cabeceras Org
empiecen con un n@'umero potencialmente largo de estrellas, y que el
texto de debajo las l@'{@dotless{i}}neas de cabecera no est@'an
indentadas. Mientras esto no es problema cuando se escribe un
documento @emph{tipo libro} donde el contorno de cabeceras son
realmente cabeceras de secci@'on, en una idea general @emph{orientada
a listas}, estructura indentada es muy limpio:

@smallexample
@group
* Cabecera de alto nivel         |    * Cabecera de alto nivel
** Segundo nivel                 |      * Segundo nivel
*** Tercer nivel                 |        * Tercer nivel
alg@'un texto                    |          alg@'un texto
*** Tercer nivel                 |        * Tercer nivel
m@'as texto                      |          m@'as texto
* Otra cabecera de alto nivel    |    * Otra cabecera de alto nivel
@end group
@end smallexample

@noindent
Si est@'as usando al menos Emacs 23.1.50.3 y la versi@'on 6.29 de Org,
este tipo de vista puede ser lograda din@'amicamente 

@smallexample
#+STARTUP: indentar
@end smallexample

Si quieres un efecto similar en una versi@'on temprana de Emacs y/o
Org, o si quieres la indentaci@'on para endurecer caracteres de
espacio, as@'{@dotless{i}} que el texto plano del fichero vea tan
similar como posible para la visualizaci@'on de Emacs, Org soporta
ayudar a indentar texto (con @key{TAB}) debajo de cada cabecera,
ocultando estrellas destacadas, y solo usando niveles 1, 3, etc. para
obtener dos caracteres de indentaci@'on para cada nivel. Para tener
este soporte en un fichero, usa

@smallexample
#+STARTUP: oculta estrellas impares
@end smallexample

@node Org m@'ovil, , Vista limpia, Miscel@'anea
@section Org m@'ovil

@i{MobileOrg} es el nombre de la compa@~n@'{@dotless{i}}a de m@'oviles
para Org mode actualmente disponible para iOS y para
Android. @i{MobileOrg} ofrece una vista offline y soporta captura para
un sistema Org mode ruteado en un ordenador ``real''. Ello te permite
grabar cambios a entradas existentes.

La @uref{http://mobileorg.ncogni.to/, implementaci@'on iOS} para la
serie de dispositivos @i{iPhone/iPod Touch/iPad}, fu@'e por Richard
Moreland. Los usuarios de Android deber@'{@dotless{i}}an descargar
@uref{http://wiki.github.com/matburt/mobileorg-android/, MobileOrg
Android} hecho por Matt Jones. Las dos implementaciones no son
id@'enticas pero ofrecen funcionalidades similares.

@seealso{
@uref{http://orgmode.org/manual/Miscellaneous.html#Miscellaneous,
Cap@'{@dotless{i}}tulo 15 del manual}@*
@uref{http://orgmode.org/manual/MobileOrg.html#MobileOrg, Ap@'endice B
del manual}@* @uref{http://orgmode.org/orgcard.pdf,tarjeta de referencia}}

@bye

@c Local variables:
@c fill-column: 77
@c End:


@c  LocalWords:  webdavhost pre