org-tutorials/orgtutorial_dto-es.org

   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
  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 [[https://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 [[https://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)
  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)
  53
  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
  57
  58 Una cosa más ---es mejor definir un directorio separado dónde tus
  59 ficheros org se almacenarán. Yo recomiendo usar ~/org.
  60
  61 * Lo básico
  62
  63 Esta sección ilustra el uso básico de org-mode mostrando cómo yo usé
  64 org-mode para crear este documento.
  65
  66 ** Creando un nuevo fichero
  67
  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"
  71
  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.
  74
  75 ** Lista simple de tareas
  76
  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
  81
  82 Los títulos de primer nivel empiezan con una estrella; los de segundo
  83 nivel con dos estrellas, y así.
  84
  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/).
  88
  89 file:../images/dto/tutorial-1.png
  90
  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*.
  95
  96 Aquí está el resultado:
  97
  98 file:../images/dto/tutorial-2.png
  99
 100 Nótese cómo org-mode usa una marca de tiempo para grabar cuando un
 101 ítem TODO fué cerrado.
 102
 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.
 107
 108 file:../images/dto/tutorial-3.png
 109
 110
 111 ** Usando títulos para estructurar un documento
 112
 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.
 118
 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!
 122
 123 Aquí está lo que se ve después de hacer un esquema del documento:
 124
 125 file:../images/dto/tutorial-4.png
 126
 127 Nótese que se marcó "Outline document" (/Esquematizar el documento/)
 128 como DONE después de finalizar.
 129
 130 ** Rellenando secciones
 131
 132 Fácilmente se puede añadir texto un cuerpo de texto debajo de
 133 cualquier título.
 134
 135 file:../images/dto/tutorial-5.png
 136
 137 ** Enlaces a otros lugares
 138
 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:
 142
 143 : [[enlace][descripción]]
 144
 145 Observa cómo se escribió el enlace y descripción, dejando abierto el
 146 último corchete:
 147
 148 file:../images/dto/tutorial-6.png
 149
 150 Entonces cuando yo escribo el último corchete, el enlace "se encoge" y
 151 simplemente muestra la descripción.
 152
 153 file:../images/dto/tutorial-7.png
 154
 155 Pruebe a mover el cursor hasta el enlace y presione *C-c C-o* para
 156 *org-open-at-point* (/Abrir el enlace/),
 157
 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.
 163
 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.)
 168
 169 ** Visión de conjunto del documento
 170
 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*.
 174
 175 file:../images/dto/tutorial-9.png
 176
 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:
 180
 181 file:../images/dto/tutorial-10.png
 182
 183 Pulsa de nuevo para mostrar una vista normal del documento, con los
 184 cuerpos de cada sección:
 185
 186 file:../images/dto/tutorial-11.png
 187
 188 ** Añadiendo notas a una tarea
 189
 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!
 193
 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.
 199
 200 * Saboreando funcionalidades avanzadas
 201
 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.
 207
 208 ** Configuración
 209
 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
 212
 213 Imagínese que ya tiene varios ficheros org ---por ejemplo, uno para
 214 trabajar, uno para casa y uno para clase.
 215
 216 En tal caso, se añadiría lo siguiente al fichero de inicialización de
 217 emacs:
 218
 219 : (setq org-agenda-files (list "~/org/trabajo.org"
 220 :                              "~/org/clase.org"
 221 :                              "~/org/casa.org"))
 222
 223 ** La lista TODO global
 224
 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:
 228
 229 file:../images/dto/tutorial-16.png
 230
 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.
 234
 235 ** Planificando tareas y usando la agenda
 236
 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:
 242
 243 file:../images/dto/tutorial-12.png
 244
 245 Una vez se selecciona la fecha, org-mode inserta una marca de fecha
 246 planificada después del ítem TODO:
 247
 248 file:../images/dto/tutorial-13.png
 249
 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:
 252
 253 file:../images/dto/tutorial-14.png
 254
 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.
 258
 259 file:../images/dto/tutorial-15.png
 260
 261 * Despedida
 262
 263 Éste ha sido solo un breve paseo por org-mode. Más excitantes
 264 funcionalidades aguardan en el [[https://orgmode.org/manual/index.html][manual online de org-mode]].