Agregando "insertar imágenes" a org-reference-guide-es. Corrigiendo errores.
authorChristian Giménez <cnngimenez@yahoo.com.ar>
Wed, 6 Mar 2013 19:43:28 +0000 (16:43 -0300)
committerChristian Giménez <cnngimenez@yahoo.com.ar>
Wed, 6 Mar 2013 19:43:50 +0000 (16:43 -0300)
org-tutorials/org-reference-guide-es.org

index 995a987..42ad9ef 100644 (file)
 [TABLE-OF-CONTENTS]
 
 * Introducción
-Esta guía de referencia no pretende ser completa ni abarcar todas las posibilidades de este fantástico modo para Emacs. Sin embargo, ¿quién lo diría? tal vez en un futuro, gracias a muchos colaboradores, las cosas sean distintas y esta guía abarque muchas cosas más. 
+Esta guía de referencia no pretende ser completa ni abarcar todas las posibilidades de este fantástico modo para Emacs. Sin embargo, ¿quién lo diría? tal vez en un futuro, gracias a muchos colaboradores, las cosas sean distintas y esta guía abarque mucho más. 
 
-Por el momento, me concentraré en generar una guía para las personas que quieren empezar a aprender. Iba a decir "principiantes", pero la verdad nunca me cayó bien esa palabra, con lo que evitaré usarla así como también sus sinónimos.
+Por el momento, me concentraré en escribir una guía para las personas que quieren aprender. Iba a decir "principiantes", pero la verdad nunca me cayó bien esa palabra con lo que evitaré usarla así como también sus sinónimos.
 
-Como podrás ver, tampoco me concentraré en hacerla en lenguaje demasiado formal. De hecho, todo lo contrario, seré informal, cual si estuviese hablando un compañero o un amigo.
+Como podrás ver, tampoco me concentraré en hacerla en un lenguaje demasiado formal. De hecho, todo lo contrario, seré informal cual si estuviese hablando con un compañer@ o con un amig@.
 
 
-Espero que esta guía te guste, te sirva mucho en este facinante mundo y la encuentres entretenida. ¿Y por qué no? ¡hasta podría ser que me quieras ayudar a mejorarla!
+Espero que esta guía te guste, te sirva mucho en este fascinante mundo y la encuentres entretenida. ¿Y por qué no? ¡hasta podría ser que me quieras ayudar a mejorarla!
 
 
 Saludos Cordiales.
@@ -39,14 +39,14 @@ Saludos Cordiales.
 
   Seguro estás sobre una hermosa computadora, con Emacs iniciado y te estás preguntando ¿y ahora qué? 
 
-  Primero, vas a sentir un escalosfríos cuando ves que está todo(¡sí todo!) en inglés. Dirás "esto no es lo mío" o "esto es difícil". Pues *no*, no te sientas intimidado. Lo mismo dije ¡y mirame!, con un par de canas verdes que otra ¡ahora uso Emacs para todo! (lo de las canas es un asunto meramente genético y no tiene nada que ver con Emacs).
+  Primero, vas a sentir un escalofríos cuando ves que está todo(¡sí todo!) en inglés. Dirás "esto no es lo mío" o "esto es difícil". Pues *no*, no te sientas intimidado. Lo mismo dije ¡y mirame!, con un par de canas verdes que otra ¡ahora uso Emacs para todo! (lo de las canas es un asunto meramente genético y no tiene nada que ver con Emacs).
 
 ** Las Teclas
 
   Bien, antes que nada te comentaré acerca de /las teclas/. Ya habrás visto en muchas páginas que hablan de Emacs que dicen "presioná M-x algo para hacer esto... ", "presioná 'M-x calendario' para saber en que día estás", etc. ¿Y qué es M-x? a eso vamos:
 
   Las teclas especiales, en cada computadora, pueden llamarse diferente: en algunos se llaman "Alt", Alternate, Alternar, en otros es un símbolo, ¡en otros ni siquiera hay una tecla "Alt"! Por eso se inventó la convención de llamar a la tecla Alt (o simbolito) como "Meta". Por eso, la "M" de "M-x" es de Meta-x. 
-  Bien, ¿y si no tengo una tecla "Alt"? se usa la tecla Escape. De forma que M-x es Escape-x. Algo bueno de la tecla Escape es que puedes presionarla y soltarla, no hace falta presonar Escape y x juntos.
+  Bien, ¿y si no tengo una tecla "Alt"? se usa la tecla Escape. De forma que M-x es Escape-x. Algo bueno de la tecla Escape es que puedes presionarla y soltarla, no hace falta presionar Escape y x juntos.
 
   Otra tecla es la "Ctrl" o mejor conocida por Control. Esta tecla se representa por "C", de forma que "C-x" es Control-x.
 
@@ -59,7 +59,7 @@ Saludos Cordiales.
   - Si tiene un guión, se presionan a la vez. ~C-x~ es Control con la tecla ~x~ a la vez.
   - Si están juntas, es en secuencia. ~8_a~ es ~8~, luego ~_~, luego ~a~.
 
-  ¡Hey! ¡Tranquilo! Típea despacio y con tranquilidad que Emacs te espera. Primero presioná ~C-x~, luego con todo el tiempo del mundo ~8~, ~_~ y finalmente ~a~. 
+  ¡Hey! ¡Tranquilo! Tipea despacio y con tranquilidad que Emacs te espera. Primero presioná ~C-x~, luego con todo el tiempo del mundo ~8~, ~_~ y finalmente ~a~. 
 
 *** Referencias
 
@@ -99,7 +99,7 @@ Y  así sucesivamente.
 #+END_SRC
 
 *** Teclas
-    Todas las teclas funcionan cuando el cursor está sobre el título. No lo intentes en otro lugar porque ¡tendrás un resultado desastrozo o te desepcionarás! 
+    Todas las teclas funcionan cuando el cursor está sobre el título. No lo intentes en otro lugar porque ¡tendrás un resultado desastroso o te decepcionaras! 
 
    - M-\rightarrow :: Aumentar la prioridad del título (de título tres a título dos, y así sucesivamente)
    - M-\leftarrow :: Disminuir la prioridad del título (de título uno a título dos, y así sucesivamente)
@@ -124,7 +124,7 @@ Y  así sucesivamente.
   
   ,Una variable o el nombre de una función puede escribirlo con símbolos de igual, por ejemplo: la variable =emacs-version= posee la versión de su Emacs.
   
-  ,Para decir cómo escribir algo, puede usar verbatim: para escribir una +frase cualquiera+ tachada debe hacerlo asi: ~una +frase cualquiera+ tachada~. 
+  ,Para decir cómo escribir algo, puede usar verbatim: para escribir una +frase cualquiera+ tachada debe hacerlo así: ~una +frase cualquiera+ tachada~. 
   
 #+END_SRC
 
@@ -134,7 +134,7 @@ Si desea tachar alguna cosa +con símbolos de suma+ puede hacerlo fácilmente.
 
 Una variable o el nombre de una función puede escribirlo con símbolos de igual, por ejemplo: la variable =emacs-version= posee la versión de su Emacs.
 
-Para decir cómo escribir algo, puede usar verbatim: para escribir una +frase cualquiera+ tachada debe hacerlo asi: ~una +frase cualquiera+ tachada~. 
+Para decir cómo escribir algo, puede usar verbatim: para escribir una +frase cualquiera+ tachada debe hacerlo así: ~una +frase cualquiera+ tachada~. 
                   
 ** Notas al Pié de Página
 
@@ -252,21 +252,75 @@ Para decir cómo escribir algo, puede usar verbatim: para escribir una +frase cu
   
 
 
-   La ~ubicación del archivo~ se dá en forma de URL   [fn:: URL son las siglas de Localizador Uniforme de Recursos. Es un texto utilizado para identificar y localizar recursos de Internet.].
+   La ~ubicación del archivo~ se da en forma de URL   [fn:: URL son las siglas de Localizador Uniforme de Recursos. Es un texto utilizado para identificar y localizar recursos de Internet.].
    
    Una URL comienza con los siguientes caracteres:
 
    - ~http://dirección_web~ :: Una página web. Ejemplo: http://orgmode.org
    - ~https://dirección_web~ :: Una página web de acceso seguro. Ejemplo: https://es.wikipedia.org
-   - ~file://ubicación_del_archivo~ :: Un archivo en tu máquina. Ejemplo: ~file://../mi\_imagen.png~ [fn:: El ".." significa que busca un directorio más arriba.] o ~file:///home/mi\_usuario/mi\_imagen.png~
+   - ~file://ubicación_del_archivo~ :: Un archivo en tu máquina. Ejemplo: ~file://../mi\_imagen.png~ [fn:subir_dir] o ~file:///home/mi\_usuario/mi\_imagen.png~
 
    Entre muchos otros tipos de accesos.
-   
+  
 *** Teclas    
     - C-c C-l :: Insertar un hipervínculo. Primero pide el tipo de hipervínculo, luego pide la ubicación y finalmente el texto.
-    - TAB :: Si está escribiendo la ubicación de un archivo puede presionar ~TAB~ para autocompletar el nombre(si la computadora puede deducirlo).
-    - TAB TAB :: Si está escribiendo la ubicación de un archivo puede presionar ~TAB~ una vez para autocopletar, si la computadora no puede deducirlo, puede presionar otra vez ~TAB~ para ver qué nombres similares hay.
-** Insertar Imágenes
+    - TAB :: Si está escribiendo la ubicación de un archivo puede presionar ~TAB~ para auto-completar el nombre(si la computadora puede deducirlo).
+    - TAB TAB :: Si está escribiendo la ubicación de un archivo puede presionar ~TAB~ una vez para auto-completar, si la computadora no puede deducirlo, puede presionar otra vez ~TAB~ para ver qué nombres similares hay.
+** Insertar Imágenes y Otros Archivos
+   Para insertar archivos en general debemos hacer un [[*Hipervínculos][hipervínculo]]. 
+
+   - Inserción directa :: Escribir la URL o la ubicación directamente. 
+   - Imágenes sin previsualización :: Sólo hacer un [[*%20Hiperv%C3%ADnculos][hipervínculo]] sin texto de descripción.
+   - Imágenes con previsualización :: Hacer un [[*%20Hiperv%C3%ADnculos][hipervínculo]] con un texto de descripción que empiece con ~file:~ o ~http:~.
+
+   Véase a continuación para más detalles.
+
+*** Insertar Imágenes 
+    Se debe escribir la ubicación del archivo entre dobles corchetes. La ubicación puede ser relativa en donde está el archivo Org o absoluta, incluso se aceptan URLs de una imagen en Internet.
+    
+    Por ejemplo:
+
+    Un archivo 
+
+    : [[file:../imagenes/mi_imagen.png]]
+    : [[../imagenes/mi_imagen.png]]
+
+    [fn:subir_dir]
+
+    Dando la URL:
+
+    : [[http://orgmode.org/img/org-mode-unicorn.jpg]]
+
+    [[http://orgmode.org/img/org-mode-unicorn.jpg]]
+    
+
+    Dependiendo de la versión de Org, pueden soportar diversos formatos. Los más comunes son los siguientes:
+    
+    - JPG
+    - PNG
+    - GIF
+
+*** Insertar PDFs
+    
+    PDFs pueden ser insertados de manera análoga a las imágenes:
+
+    Ejemplos:
+    
+#+BEGIN_SRC org
+  
+  ../mis_archivos/mi_pdf.pdf
+  [[../mis_archivos/mi_pdf.pdf]]
+  
+  file:../mis_archivos/mi_pdf.pdf
+  [[file:../mis_archivos/mi_pdf.pdf]]
+  
+  http://mi_pagina/mis_archivos/mi_pdf.pdf
+  [[http://mi_pagina/mis_archivos/mi_pdf.pdf]]
+  
+#+END_SRC
+
+
+
 ** Mis Cosas a Hacer
       
 * Exportación a Otros Formatos
@@ -278,3 +332,4 @@ Para decir cómo escribir algo, puede usar verbatim: para escribir una +frase cu
 * Footnotes
 
 [fn:1] ¡Modo Org te organiza la vida!
+[fn:subir_dir]  El ".." significa que busca un directorio más arriba.