Fix link
[worg.git] / org-tutorials / orgtutorial_dto-es.org
blob56ef7e7ea95286d71ea561295c3362e68d856a69
1 #+OPTIONS:    H:3 num:nil toc:t \n:nil ::t |:t ^:t -:t f:t *:t tex:t d:(HIDE) tags:not-in-toc
2 #+STARTUP:    align fold nodlcheck hidestars oddeven lognotestate
3 #+SEQ_TODO:   TODO(t) INPROGRESS(i) WAITING(w@) | DONE(d) CANCELED(c@)
4 #+TAGS:       Write(w) Update(u) Fix(f) Check(c) 
5 #+TITLE:      David O'Toole Org tutorial (Spanish Translation)
6 #+AUTHOR:     David Arroyo Menéndez
7 #+EMAIL:      davidam AT es DOT gnu DOT org
8 #+LANGUAGE:   es
9 #+PRIORITIES: A C B
10 #+CATEGORY:   worg
12 # This file is the default header for new Org files in Worg.  Feel free
13 # to tailor it to your needs.
15 Esta página es una traducción al español hecha por [[http://www.davidam.com][David Arroyo Menéndez]] del [[http://dto.freeshell.org/notebook/OrgTutorial.html][tutorial original]] de
16 [[http://dto.freeshell.org/notebook/][David O'Toole]].
18 Realizado el día: <24-09-2011>
20 [[file:../index.org][{Volver al índice de Worg}]]
22 * Introducción
24 Org-mode es un gestor de información personal y una herramienta de
25 resúmenes para Emacs. Este documento pretende dar al lector una
26 primera impresión de org-mode y enseñar el uso básico con
27 instrucciones paso a paso y mediante pantallazos. No se pretende
28 reemplazar el [[http://orgmode.org/org.html][manual]], ya que solo se cubre un subconjunto de las
29 funcionalidades de org-mode.
31 Este documento también está traducido en [[file:orgtutorial_dto-fr.org][Francés]], [[http://hpcgi1.nifty.com/spen/index.cgi%3FOrgMode%2fOrgTutorial][Japonés]], [[http://hokmen.chan.googlepages.com/OrgTutorial.en-cn.html][Chino]], and
32 [[http://jmjeong.com/index.php?display=Emacs/OrgMode"][Coreano]]. Agradecimientos especiales a los traductores
34 ** Obteniendo org-mode
36 Org-mode es parte de Emacs 22 y 23, así si tiene una versión moderna
37 de Emacs, entonces ya lo tiene.
39 Si no, se puede descargar desde [[http://orgmode.org/][la web de org-mode]], se descomprime y
40 se enlaza el load path de Emacs al directorio lisp de dicha
41 distribución de Org-mode:
43 : (add-to-list 'load-path "PATH_TO_WHERE_YOU_UNPACKED_ORGMODE/lisp")
45 ** Activación
47 Añade lo siguiente a tu .emacs:
49 : (require 'org)
50 : (define-key global-map "\C-cl" 'org-store-link)
51 : (define-key global-map "\C-ca" 'org-agenda)
52 : (setq org-log-done t)
54 Esto asegurará la carga de org y la definición de algunas
55 combinaciones de teclas. Se mostrará qué hacen "org-store-link" y
56 "org-agenda" más adelante en este mismo documento
58 Una cosa más ---es mejor definir un directorio separado dónde tus
59 ficheros org se almacenarán. Yo recomiendo usar ~/org.
61 * Lo básico
63 Esta sección ilustra el uso básico de org-mode mostrando cómo yo usé
64 org-mode para crear este documento.
66 ** Creando un nuevo fichero
68 Si se configuró el fichero de inicialización de Emacs como se sugería
69 arriba, Emacs debería entrar en org-mode siempre y cuando se visite o
70 cree un fichero con la extensión ".org"
72 Yo cree un nuevo fichero llamado "OrgTutorial.org" y ví el indicador
73 "Org" en el modeline, mostrando que había entrado en org-mode.
75 ** Lista simple de tareas 
77 Primero introduje un *headline* llamado "Tasks" (/Tareas/) para
78 almacenar la tareas dentro. Esto no es necesario pero, con frecuencia,
79 es conveniente, especialmente si se quiere almacenar tareas separadas
80 del cuerpo del documento que se está escribiendo
82 Los títulos de primer nivel empiezan con una estrella; los de segundo
83 nivel con dos estrellas, y así.
85 En org-mode, los ítems TODO (/tareas no hechas/) son siempre títulos. Se
86 introdujo un ítem TODO para "Start new org file for tutorial" (/Empezar
87 un nuevo fichero org tutorial/).   
89 file:../images/dto/tutorial-1.png
91 Esto es un poco tonto, porque ya se ha iniciado un nuevo fichero. Así,
92 márquese el ítem TODO como ítem DONE (/tarea ya realizada/) moviendo el
93 cursor a esta esa línea y pulsando *C-c C-t*, que ejecuta el comando
94 *org-todo*. 
96 Aquí está el resultado:
98 file:../images/dto/tutorial-2.png
100 Nótese cómo org-mode usa una marca de tiempo para grabar cuando un
101 ítem TODO fué cerrado.
103 Permítase añadir algunos ítems TODO más. Posicione el cursor en la
104 siguiente línea y pulse *M-shift-RET* para llamar a
105 *org-insert-todo-heading*. Se puede pulsar varias veces y añadir
106 varios TODOs.
108 file:../images/dto/tutorial-3.png
111 ** Usando títulos para estructurar un documento
113 Con frecuencia el mejor camino para organizar las ideas es un
114 esquema. El siguiente paso es hacer un esquema de los diferentes
115 asuntos del tutorial. Haciendo esto, se rompe la intimidatoria página
116 en blanco en una serie de pequeños trozos menos
117 intimidatorios. Llegando entonces, a ser sencillos de rellenar.
119 Recuerda que una estrella da comienzo a una cabecera de primer nivel,
120 y dos estrellas dan comienzo a una cabecera de segundo nivel. Si se
121 necesita un anidamiento más profundo, ¡usa tres o más estrellas!
123 Aquí está lo que se ve después de hacer un esquema del documento:
125 file:../images/dto/tutorial-4.png
127 Nótese que se marcó "Outline document" (/Esquematizar el documento/)
128 como DONE después de finalizar.
130 ** Rellenando secciones
132 Fácilmente se puede añadir texto un cuerpo de texto debajo de
133 cualquier título.
135 file:../images/dto/tutorial-5.png
137 ** Enlaces a otros lugares
139 En la sección "Obteniendo org-mode" se necesita proveer un enlace al
140 sitio web de org-mode. Una sintaxis especial de corchetes es usada al
141 enlazar:
143 : [[enlace][descripción]]
145 Observa cómo se escribió el enlace y descripción, dejando abierto el
146 último corchete:
148 file:../images/dto/tutorial-6.png
150 Entonces cuando yo escribo el último corchete, el enlace "se encoge" y
151 simplemente muestra la descripción.
153 file:../images/dto/tutorial-7.png
155 Pruebe a mover el cursor hasta el enlace y presione *C-c C-o* para
156 *org-open-at-point* (/Abrir el enlace/),
158 También se puede enlazar a ficheros locales. Pruebe visitando otro
159 fichero ---por ejemplo, su fichero de inicialización de
160 emacs. Entonces pulse *C-c l* para llamar a *org-store-link*. Se verá
161 un mensaje acerca de que un enlace fué almacenado para la posición
162 actual en el fichero que se está visitando.
164 Entonces vuelva a su buffer org-mode y pegue el enlace usando *C-c
165 C-l* para llamar a *org-insert-link*. (Puede necesitar presionar las
166 teclas de flechas para mover el scroll hasta encontrar el enlace
167 grabado.)
169 ** Visión de conjunto del documento
171 En este momento, el documento es largo y no se puede ver entero en una
172 sola pantalla. Org-mode hace fácil tener una visión de conjunto del
173 documento presionando *shift-TAB*.
175 file:../images/dto/tutorial-9.png
177 Nótese que solo se muestran los títulos de primer nivel. Se puede
178 pulsar *shift-TAB* de nuevo para mostrar *todos* los títulos o
179 cabeceras, incluyento ítems TODO:
181 file:../images/dto/tutorial-10.png
183 Pulsa de nuevo para mostrar una vista normal del documento, con los
184 cuerpos de cada sección:
186 file:../images/dto/tutorial-11.png
188 ** Añadiendo notas a una tarea
190 Se puede poner tanto texto como se quiera bajo una cabecera de un ítem
191 TODO. De hecho, se puede tener incluso subcabecera bajo un TODO, ¡y
192 TODOs con TODOs!
194 Siendo capaz de anotar tareas hace fácil recoger enlaces relacionados
195 y pensamientos asociados a una tarea. Siendo capaz de anidar tarear es
196 bueno para modelar flujos de trabajo --- con bastante frecuencia, una
197 tarea larga is dividida en pequeñas subtareas que se pretende marchar
198 según se hagan.
200 * Saboreando funcionalidades avanzadas
202 Antes de finalizar, se verá brevemente las funcionalidades de org-mode
203 relativas a lista global de TODOs, planificación y agenda. Éstas son
204 usadas para combinar ítems TODO desde diferentes ficheros org
205 mostrándose de un modo priorizado y cronológico. También puede usarse
206 para ver qué tareas se completaron y cuando.
208 ** Configuración
210 Primero debe asignarse la variable *org-agenda-files* de tal modo que
211 org-mode conocerá qué ficheros buscar para TODOs e ítems planificados
213 Imagínese que ya tiene varios ficheros org ---por ejemplo, uno para
214 trabajar, uno para casa y uno para clase.
216 En tal caso, se añadiría lo siguiente al fichero de inicialización de
217 emacs: 
219 : (setq org-agenda-files (list "~/org/trabajo.org"
220 :                              "~/org/clase.org" 
221 :                              "~/org/casa.org"))
223 ** La lista TODO global
225 Presione *C-c a t* para introducir la lista global todo. Org-mode
226 escaneará los ficheros en *org-agenda-files* y presentará un listado
227 de todas los ítems TODO abiertos:
229 file:../images/dto/tutorial-16.png
231 Se puede mover el cursor alrededor de diferentes ítems todo, y púlsese
232 "t" para marcar un ítem como DONE (/hecho/), o pulse *RET* para saltar
233 al fichero fuente donde el TODO está localizado.
235 ** Planificando tareas y usando la agenda
237 Imagine que se quiere planificar "Finish document" (/Finalizar
238 documento/) para hoy. Entonces, se mueve el cursor a la línea de
239 después del ítem TODO llamado "Finish document" y se pulsa *C-c C-s*
240 para ejecutar *org-schedule*. El calendario aparece, y se puede
241 introducir o hacer click en la fecha deseada:
243 file:../images/dto/tutorial-12.png
245 Una vez se selecciona la fecha, org-mode inserta una marca de fecha
246 planificada después del ítem TODO:
248 file:../images/dto/tutorial-13.png
250 Ahora se guarda el fichero y se pulsa *C-c a a* para *org-agenda*. Se
251 mostrará una vista de los ítems planificados para esa semana:
253 file:../images/dto/tutorial-14.png
255 Ahora presione "l" (minúscula L) para activar la vista de log. Esto
256 muestra por pantalla todas las tareas finalizadas y sus fechas de
257 terminación.
259 file:../images/dto/tutorial-15.png
261 * Despedida
263 Éste ha sido solo un breve paseo por org-mode. Más excitantes
264 funcionalidades aguardan en el [[http://orgmode.org/manual/index.html][manual online de org-mode]].