give me attribution
[worg.git] / org-tutorials / orgtutorial_dto-es.org
1 #+OPTIONS:    H:3 num:nil toc:t \n:nil @:t ::t |:t ^:t -:t f:t *:t TeX:t LaTeX:t skip:nil 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
11
12 # This file is the default header for new Org files in Worg.  Feel free
13 # to tailor it to your needs.
14
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]].
17
18 Realizado el día: <24-09-2011>
19
20 [[file:../index.org][{Volver al índice de Worg}]]
21
22 * Introducción
23
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.
30
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
33
34 ** Obteniendo org-mode
35
36 Org-mode es parte de Emacs 22 y 23, así si tiene una versión moderna
37 de Emacs, entonces ya lo tiene.
38
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:
42
43 : (add-to-list 'load-path "PATH_TO_WHERE_YOU_UNPACKED_ORGMODE/lisp")
44
45 ** Activación
46
47 Añade lo siguiente a tu .emacs:
48
49 : (require 'org-install)
50 : (add-to-list 'auto-mode-alist '("\\.org$" . org-mode))
51 : (define-key global-map "\C-cl" 'org-store-link)
52 : (define-key global-map "\C-ca" 'org-agenda)
53 : (setq org-log-done t)
54
55 Esto asegurará la carga de org y la definición de algunas
56 combinaciones de teclas. Se mostrará qué hacen "org-store-link" y
57 "org-agenda" más adelante en este mismo documento
58
59 Una cosa más ---es mejor definir un directorio separado dónde tus
60 ficheros org se almacenarán. Yo recomiendo usar ~/org.
61
62 * Lo básico
63
64 Esta sección ilustra el uso básico de org-mode mostrando cómo yo usé
65 org-mode para crear este documento.
66
67 ** Creando un nuevo fichero
68
69 Si se configuró el fichero de inicialización de Emacs como se sugería
70 arriba, Emacs debería entrar en org-mode siempre y cuando se visite o
71 cree un fichero con la extensión ".org"
72
73 Yo cree un nuevo fichero llamado "OrgTutorial.org" y ví el indicador
74 "Org" en el modeline, mostrando que había entrado en org-mode.
75
76 ** Lista simple de tareas 
77
78 Primero introduje un *headline* llamado "Tasks" (/Tareas/) para
79 almacenar la tareas dentro. Esto no es necesario pero, con frecuencia,
80 es conveniente, especialmente si se quiere almacenar tareas separadas
81 del cuerpo del documento que se está escribiendo
82
83 Los títulos de primer nivel empiezan con una estrella; los de segundo
84 nivel con dos estrellas, y así.
85
86 En org-mode, los ítems TODO (/tareas no hechas/) son siempre títulos. Se
87 introdujo un ítem TODO para "Start new org file for tutorial" (/Empezar
88 un nuevo fichero org tutorial/).   
89
90 file:../images/dto/tutorial-1.png
91
92 Esto es un poco tonto, porque ya se ha iniciado un nuevo fichero. Así,
93 márquese el ítem TODO como ítem DONE (/tarea ya realizada/) moviendo el
94 cursor a esta esa línea y pulsando *C-c C-t*, que ejecuta el comando
95 *org-todo*. 
96
97 Aquí está el resultado:
98
99 file:../images/dto/tutorial-2.png
100
101 Nótese cómo org-mode usa una marca de tiempo para grabar cuando un
102 ítem TODO fué cerrado.
103
104 Permítase añadir algunos ítems TODO más. Posicione el cursor en la
105 siguiente línea y pulse *M-shift-RET* para llamar a
106 *org-insert-todo-heading*. Se puede pulsar varias veces y añadir
107 varios TODOs.
108
109 file:../images/dto/tutorial-3.png
110
111
112 ** Usando títulos para estructurar un documento
113
114 Con frecuencia el mejor camino para organizar las ideas es un
115 esquema. El siguiente paso es hacer un esquema de los diferentes
116 asuntos del tutorial. Haciendo esto, se rompe la intimidatoria página
117 en blanco en una serie de pequeños trozos menos
118 intimidatorios. Llegando entonces, a ser sencillos de rellenar.
119
120 Recuerda que una estrella da comienzo a una cabecera de primer nivel,
121 y dos estrellas dan comienzo a una cabecera de segundo nivel. Si se
122 necesita un anidamiento más profundo, ¡usa tres o más estrellas!
123
124 Aquí está lo que se ve después de hacer un esquema del documento:
125
126 file:../images/dto/tutorial-4.png
127
128 Nótese que se marcó "Outline document" (/Esquematizar el documento/)
129 como DONE después de finalizar.
130
131 ** Rellenando secciones
132
133 Fácilmente se puede añadir texto un cuerpo de texto debajo de
134 cualquier título.
135
136 file:../images/dto/tutorial-5.png
137
138 ** Enlaces a otros lugares
139
140 En la sección "Obteniendo org-mode" se necesita proveer un enlace al
141 sitio web de org-mode. Una sintaxis especial de corchetes es usada al
142 enlazar:
143
144 : [[enlace][descripción]]
145
146 Observa cómo se escribió el enlace y descripción, dejando abierto el
147 último corchete:
148
149 file:../images/dto/tutorial-6.png
150
151 Entonces cuando yo escribo el último corchete, el enlace "se encoge" y
152 simplemente muestra la descripción.
153
154 file:../images/dto/tutorial-7.png
155
156 Pruebe a mover el cursor hasta el enlace y presione *C-c C-o* para
157 *org-open-at-point* (/Abrir el enlace/),
158
159 También se puede enlazar a ficheros locales. Pruebe visitando otro
160 fichero ---por ejemplo, su fichero de inicialización de
161 emacs. Entonces pulse *C-c l* para llamar a *org-store-link*. Se verá
162 un mensaje acerca de que un enlace fué almacenado para la posición
163 actual en el fichero que se está visitando.
164
165 Entonces vuelva a su buffer org-mode y pegue el enlace usando *C-c
166 C-l* para llamar a *org-insert-link*. (Puede necesitar presionar las
167 teclas de flechas para mover el scroll hasta encontrar el enlace
168 grabado.)
169
170 ** Visión de conjunto del documento
171
172 En este momento, el documento es largo y no se puede ver entero en una
173 sola pantalla. Org-mode hace fácil tener una visión de conjunto del
174 documento presionando *shift-TAB*.
175
176 file:../images/dto/tutorial-9.png
177
178 Nótese que solo se muestran los títulos de primer nivel. Se puede
179 pulsar *shift-TAB* de nuevo para mostrar *todos* los títulos o
180 cabeceras, incluyento ítems TODO:
181
182 file:../images/dto/tutorial-10.png
183
184 Pulsa de nuevo para mostrar una vista normal del documento, con los
185 cuerpos de cada sección:
186
187 file:../images/dto/tutorial-11.png
188
189 ** Añadiendo notas a una tarea
190
191 Se puede poner tanto texto como se quiera bajo una cabecera de un ítem
192 TODO. De hecho, se puede tener incluso subcabecera bajo un TODO, ¡y
193 TODOs con TODOs!
194
195 Siendo capaz de anotar tareas hace fácil recoger enlaces relacionados
196 y pensamientos asociados a una tarea. Siendo capaz de anidar tarear es
197 bueno para modelar flujos de trabajo --- con bastante frecuencia, una
198 tarea larga is dividida en pequeñas subtareas que se pretende marchar
199 según se hagan.
200
201 * Saboreando funcionalidades avanzadas
202
203 Antes de finalizar, se verá brevemente las funcionalidades de org-mode
204 relativas a lista global de TODOs, planificación y agenda. Éstas son
205 usadas para combinar ítems TODO desde diferentes ficheros org
206 mostrándose de un modo priorizado y cronológico. También puede usarse
207 para ver qué tareas se completaron y cuando.
208
209 ** Configuración
210
211 Primero debe asignarse la variable *org-agenda-files* de tal modo que
212 org-mode conocerá qué ficheros buscar para TODOs e ítems planificados
213
214 Imagínese que ya tiene varios ficheros org ---por ejemplo, uno para
215 trabajar, uno para casa y uno para clase.
216
217 En tal caso, se añadiría lo siguiente al fichero de inicialización de
218 emacs: 
219
220 : (setq org-agenda-files (list "~/org/trabajo.org"
221 :                              "~/org/clase.org" 
222 :                              "~/org/casa.org"))
223
224 ** La lista TODO global
225
226 Presione *C-c a t* para introducir la lista global todo. Org-mode
227 escaneará los ficheros en *org-agenda-files* y presentará un listado
228 de todas los ítems TODO abiertos:
229
230 file:../images/dto/tutorial-16.png
231
232 Se puede mover el cursor alrededor de diferentes ítems todo, y púlsese
233 "t" para marcar un ítem como DONE (/hecho/), o pulse *RET* para saltar
234 al fichero fuente donde el TODO está localizado.
235
236 ** Planificando tareas y usando la agenda
237
238 Imagine que se quiere planificar "Finish document" (/Finalizar
239 documento/) para hoy. Entonces, se mueve el cursor a la línea de
240 después del ítem TODO llamado "Finish document" y se pulsa *C-c C-s*
241 para ejecutar *org-schedule*. El calendario aparece, y se puede
242 introducir o hacer click en la fecha deseada:
243
244 file:../images/dto/tutorial-12.png
245
246 Una vez se selecciona la fecha, org-mode inserta una marca de fecha
247 planificada después del ítem TODO:
248
249 file:../images/dto/tutorial-13.png
250
251 Ahora se guarda el fichero y se pulsa *C-c a a* para *org-agenda*. Se
252 mostrará una vista de los ítems planificados para esa semana:
253
254 file:../images/dto/tutorial-14.png
255
256 Ahora presione "l" (minúscula L) para activar la vista de log. Esto
257 muestra por pantalla todas las tareas finalizadas y sus fechas de
258 terminación.
259
260 file:../images/dto/tutorial-15.png
261
262 * Despedida
263
264 Éste ha sido solo un breve paseo por org-mode. Más excitantes
265 funcionalidades aguardan en el [[http://orgmode.org/manual/index.html][manual online de org-mode]].