Taller de Documentación con Tecnologías Libres:

Org Mode Básico

David Pineda Osorio

28 de junio de 2019

Índice
1. ¿Qué es Org-mode? 3

2. El editor de texto: Emacs 5

2.1. Emacs simple . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.2. Emacs con Spacemacs . . . . . . . . . . . . . . . . . . . . . . 6

3. Uso del Teclado 8

3.1. El layout latinoamericano . . . . . . . . . . . . . . . . . . . . 9
3.1.1. Ejercicio . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3.2. Atajos de teclado . . . . . . . . . . . . . . . . . . . . . . . . . 9

4. Etiquetas principales 10
4.1. Título Principal . . . . . . . . . . . . . . . . . . . . . . . . . . 10
4.2. Autor/a . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
4.3. Fecha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
4.4. Idioma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
4.5. Nombre de tabla o figura . . . . . . . . . . . . . . . . . . . . . 10

5. Crear Títulos y Secciones 10

6. Titulo 11
6.1. Sección de segundo nivel . . . . . . . . . . . . . . . . . . . . . 11
6.1.1. Sección de tercer nivel . . . . . . . . . . . . . . . . . . 11
6.2. Ejercicio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

7. Texto en negritas 11

1
8. Texto en italicas 11

9. Texto subrayado 11

10.Crear Tablas 11
10.1. Crear una tabla . . . . . . . . . . . . . . . . . . . . . . . . . . 12
10.1.1. A partir de información . . . . . . . . . . . . . . . . . 12
10.1.2. Desde cero . . . . . . . . . . . . . . . . . . . . . . . . 12
10.2. Navegar en una tabla . . . . . . . . . . . . . . . . . . . . . . . 12
10.3. Reajustar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
10.4. Mover filas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
10.5. Añadir y quitar filas . . . . . . . . . . . . . . . . . . . . . . . 13
10.6. Mover columnas . . . . . . . . . . . . . . . . . . . . . . . . . . 14
10.7. Añadir y quitar columnas . . . . . . . . . . . . . . . . . . . . 14
10.8. Poner separador . . . . . . . . . . . . . . . . . . . . . . . . . . 14
10.9. Definir ancho de columna . . . . . . . . . . . . . . . . . . . . 15
10.10.Ordenar según columna . . . . . . . . . . . . . . . . . . . . . 15
10.11.Tablas con bordes . . . . . . . . . . . . . . . . . . . . . . . . . 16

11.Insertar Figuras 17
11.1. Definir tamaño de figura . . . . . . . . . . . . . . . . . . . . . 18

12.Definir Nombre y Caption de la figura o tabla 19

13.Insertar Enlaces 20

14.Insertar Pies de Página 20

15.Crear listas 20
15.1. No numeradas . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
15.2. Numeradas . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
15.3. Definiciones . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

16.Insertar citas 22

17.Insertar poemas 22
17.1. Centrar un texto . . . . . . . . . . . . . . . . . . . . . . . . . 23
17.2. Otras etiquetas . . . . . . . . . . . . . . . . . . . . . . . . . . 24

2
18.Salto de página 24
18.1. Solo cuando sea exportar a LATEX . . . . . . . . . . . . . . . . 24
18.2. Solo exportar a ODT (writer) . . . . . . . . . . . . . . . . . . 24

19.Exportar a otros formatos (de presentación) 24

20.Referencias Interesantes 26
20.1. Manual Oficial . . . . . . . . . . . . . . . . . . . . . . . . . . 26
20.2. Guías . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
20.3. Ejemplos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

21.Consultar Ayuda 26
21.1. Escribir Email . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
21.2. Chats de Telegram . . . . . . . . . . . . . . . . . . . . . . . . 26

1. ¿Qué es Org-mode?
En pocas, poquísimas palabras, es solo TEXTO.
Son archivos de texto plano que, en vez de la extensión txt se les pone
la extensión org.

Ahora, la diferencia estará en la herramienta que interpreta este

TEXTO. Si usamos un lector de archivos de texto para un archivo org
veremos que efectivamente es TEXTO.
Ahora bien, si usamos el editor Emacs, veremos que destaca ciertas
características especiales que hemos marcado con algunos signos.

3
 Org-mode, por lo tanto, es la sabia combinación entre una forma especial
de marcar texto para que el editor lo inteprete y lo visualice de manera
adecuada.
¡Es maravilloso! Pues es liviano, compacto y nos permitirá hacer docu-
mentos de todo tipo. En su logo podemos ver a un unicornio.

Este sistema de creación de textos y documentos (proyectos y etc) fue

realizado desde el mundo de las ciencias por el profesor de astronomía Cars-
ten Dominik (su web), con el fin de organizar de mejor manera sus proyectos
y documentos.

4
2. El editor de texto: Emacs
Emacs es un editor universal, es software libre, creado por quien inició
el movimiento Richard Stallman (su web).
Permite crear software, revisar correos electrónicos, visitar páginas web
y crear documentos de diverso tipo, entre otras actividades.
Está creado utilizando el lenguaje de programación Lisp, lo que permite
a quien lo aprenda extender los usos y aplicaciones. Como sucedió con la
creación de Org-mode.

2.1. Emacs simple

Con solo instalarlo desde la terminal o el gestor de paquetes, podrán
acceder a uno de los más potentes editores de textos que existen.

sudo apt install emacs

Al iniciarlo verán una ventana con una zona blanca y un par de menús.
Tiene un diseño minimalista que se basa en no usar mouse, sino que en
usar mucho el teclado.

5
 En este taller aprenderemos los usos principales de Emacs con sus atajos
de teclado.

2.2. Emacs con Spacemacs

Es una interfaz especial que facilita el uso de Emacs en diversos aspectos,
además de tener una visualización más agradable de los contenidos (por
defecto).

6
 Para descargar Spacemacs desde la web, tal como lo indica, basta con
clonar el proyecto, ejecutando el siguiente comando desde la terminal

git clone https://github.com/syl20bnr/spacemacs ~/.emacs.d

Luego de un tiempo descargando, podrás acceder a usar emacs con una

visualización al estilo spacemacs.

7
 Una vez inicias emacs tendrás que escoger las opciones de configuración
base, recomendadas:

emacs

spacemacs

helm

Estas se pueden escoger moviendo las teclas de flecha y apretando enter,

3. Uso del Teclado

En este taller el uso del teclado se torna primordial, por eso será necesario
que sepamos reconocer nuestra interfaz mediante la cual podemos ingresar
información al computador.

8
3.1. El layout latinoamericano
Dentro de todas las distintas configuraciones y posiciones de teclado, la
más usual en nuestro país y América del Sur es el teclado layout latinoa-
mericano,

3.1.1. Ejercicio
Ubicar las teclas de importancia para y conocer el nombre y la identifi-
cación que tiene emacs para cada una de ellas.

3.2. Atajos de teclado

Es importante considerar que los siguientes atajos de teclado toman las
letras mayúsculas como aquellas teclas de control (las primera a segundas)
y luego las minúsculas como aquellas que son caracteres alfabéticos.

(->) flecha a la derecha

(<-) flecha a la izquierda

(|ˆ) flecha arriba

(|v) flecha abajo

copiar M+w

cortar C+w

pegar C+y

deshacer C+S+-

rehacer M+S+-

9
guardar C+x+s
abrir C+x+f
número de línea M+x linum-mode
ancho de párrafo M+x autofill-mode
seleccionar grupo de líneas C+SPS
indentar Se selecciona grupo de línea y C+x+TAB, luego S+(->) o S+(<-)
buscar Se busca la coincidencia con M+s y w, escribir texto y luego C+s.
buscar y reemplazar M+x replace-regex ->[lo que se busca] RTR ->[lo
que se reemplazará] RTR. También funciona sobre una selección de
líneas.

4. Etiquetas principales
En general las etiquetas en org-mode se caracterizan por estar com-
puestas de dos caracteres #+ y una palabra en inglés relacionada a lo que
hace.

4.1. Título Principal

Se debe colocar al principio del documento.
#+TITLE: Esto es un título o nombre de documento

4.2. Autor/a
Se debe colocar al principio del documento, luego de TITLE.
#+AUTHOR: Juana Pérez, Eusebio Lillo

4.3. Fecha
4.4. Idioma
4.5. Nombre de tabla o figura

5. Crear Títulos y Secciones

Es algo muy usual y se consigue con solo poner "\*"(asteríscos)
#+BEGINEXAMPLE

10
6. Titulo
6.1. Sección de segundo nivel
6.1.1. Sección de tercer nivel
#+ENDEXAMPLE
Luego, al momento de crear el documento (y si se necesita el índice),
aparecerá de manera automática.

6.2. Ejercicio.
Crear un texto de tres niveles y exportarlo a pdf o html

7. Texto en negritas
Solo basta con poner asterisco antes y después del texto objetivo.

*texto en negrita*

8. Texto en italicas
De la misma manera, pero poniendo slash o /, se tiene texto en itálicas.

/texto en itálicas/

9. Texto subrayado
De la misma manera, pero poniendo guión bajo o _, se tiene texto
subrayado.

_texto subrayado_

10. Crear Tablas

En Org-mode las tablas consisten en un apartado muy interesante.
Ya que, además de exponer información de manera ordenada, podemos en
niveles avanzados realizar cálculos con esa información tal como si fuera una
planilla de cálculo.

11
10.1. Crear una tabla
10.1.1. A partir de información
Si se tiene cierto contenido ordenado

nombre apellido
David Pineda
Juan Zepeda
Esteban Paredes
María Quiñones
Luisa Nuñez

Se seleccionan las líneas y luego se presiona C+c+| y se construye una

tabla sencilla, para iniciar la edición de la tabla.
El editor emacs, de manera automática detecta el separador y establece
las columnas sobre la información.

nombre apellido
David Pineda
Juan Zepeda
Esteban Paredes
María Quiñones
Luisa Nuñez

10.1.2. Desde cero

De otra manera, deseamos una tabla de 5 filas y 3 colunnas, podemos
crearla de manera análoga con C+c+|, se abre un dialogo (en la parte
inferior del editor), en que se pone 3x5.

nombre apellido edad

David Pineda 35
Camilo Carrasco 27
Eduardo Urbina 25
Pamela Soto 33

10.2. Navegar en una tabla

Para navegar entre cada celda de la tabla

avanzar basta con usar TAB

12
retroceder Para devolverse basta con S+TAB (retroceso).

moverse las flechas.

al final de celda M+e

al inicio de celda M+a

10.3. Reajustar
Basta con apretar C+c+c y la tabla se ajusta adecuadamente.

10.4. Mover filas

Basta con apretar M+(|ˆ) para mover arriba o M+(|v) para mover
abajo.

10.5. Añadir y quitar filas

Tomando el ejemplo sencillo

nombre apellido

Daniela Martinez
David Pineda
Juan Zepeda
Esteban Paredes
María Quiñones
Luisa Nuñez

Deseamos agregar dos líneas, entonces apretamos M+S+(|v) dos veces.

Agregamos la información que deseamos.
Para borrar una línea específica, nos ubicamos en la fila y M+S+(|ˆ),
por ejemplo, si deseamos borrar a María Quiñones.

nombre apellido

Daniela Martinez
David Pineda
Juan Zepeda
Esteban Paredes
Luisa Nuñez

13
10.6. Mover columnas
Basta con apretar M+(->) para mover a la derecha o M+(<-) para
mover a la izquierda.

10.7. Añadir y quitar columnas

De manera análoga a añadir o quitar filas, para las columnas se usan.
Si queremos añadir la columna edad

nombre apellido edad

Daniela Martinez 34
David Pineda 35
Juan Zepeda 22
Esteban Paredes 21
Luisa Nuñez 67

10.8. Poner separador

A manera de ajustar estéticamente la tabla, como por ejemplo los enca-
bezados de la información, se pueden poner líneas separadoras de contenidos.
Usando C+c+- sobre la fila que se desea separar.

nombre apellido edad

Daniela Martinez 34
David Pineda 35
Juan Zepeda 22
Esteban Paredes 21
Luisa Nuñez 67

Luego de poner separador:

nombre apellido edad

Daniela Martinez 34
David Pineda 35
Juan Zepeda 22
Esteban Paredes 21
Luisa Nuñez 67

14
 Borrando la línea en blanco

nombre apellido edad

Daniela Martinez 34
David Pineda 35
Juan Zepeda 22
Esteban Paredes 21
Luisa Nuñez 67

10.9. Definir ancho de columna

Para el uso en el mismo editor de la tabla, es posible definir el ancho en
caracteres de cada columna. Así en caso de tener textos extensos es posible
visualizarlos.

| nombre | apellido | edad |

| <10> | <25> | <5> |
|------------+---------------------------+-------|
| Daniela | Martinez | 34 |
| David | Pineda | 35 |
| Juan | Zepeda | 22 |
| Esteban | Paredes | 21 |
| Luisa | Nuñez | 67 |

Se tiene, ajustada a lo especificado.

nombre apellido edad

Daniela Martinez 34
David Pineda 35
Juan Zepeda 22
Esteban Paredes 21
Luisa Nuñez 67

10.10. Ordenar según columna

A veces puede ser necesario ordenar las columnas. Para eso se usa ˆ, que
se encuentra apretando M(derecho)+ˆ (la tecla al lado derecho de la ñ)
Luego, se debe entregar el tipo de orden que se desea realizar (alfabético,
numérico, tiempo)

ordenar según apellido

15
 nombre apellido edad
Daniela Martínez 34
Luisa Nuñez 67
Esteban Paredes 21
David Pineda 35
Juan Zepeda 22

ordenar según edad

nombre apellido edad

Esteban Paredes 21
Juan Zepeda 22
Daniela Martínez 34
David Pineda 35
Luisa Nuñez 67

10.11. Tablas con bordes

Es suficiente con colocar líneas horizontales arriba y abajo.

|------------+---------------------------+-------|
| nombre | apellido | edad |
| <10> | <25> | <5> |
|------------+---------------------------+-------|
| Esteban | Paredes | 21 |
| Juan | Zepeda | 22 |
| Daniela | Martínez | 34 |
| David | Pineda | 35 |
| Luisa | Nuñez | 67 |
|------------+---------------------------+-------|

Se obtiene una tabla así:

nombre apellido edad

Esteban Paredes 21
Juan Zepeda 22
Daniela Martínez 34
David Pineda 35
Luisa Nuñez 67

16
11. Insertar Figuras
Para insertar figuras es importante que el archivo de la figura esté en
el mismo directorio o bien en un directorio que pertenezca al proyecto. De
esa manera nos evitaremos problemas.
Por ejemplo, para la figura ubicada en la ruta ./imagenes/imagen.png

[[file:./imagenes/imagen.png]]

Se tendrá, finalmente:

17
11.1. Definir tamaño de figura
#+ATTR_HTML: width="100px"
#+attr_html: :width 100px
#+attr_latex: :width 100px
[[file:./imagenes/imagen.png]]

ancho

Muchas veces será necesario ajustar adecuadamente el tamaño de la ima-

gen para que se vea de manera decente. Por ejemplo, a un tamaño de ancho
"100px"
Se tiene

alto

Para definir el alto de la figura, de manera análoga, se usa :height

#+ATTR_org: :height 200px

#+attr_html: :height 200px
#+attr_latex: :height 200px
file:./imagenes/imagen.png

Se tiene, la siguiente imagen.

18
12. Definir Nombre y Caption de la figura o tabla
En documentos formales, toda imagen o tabla debe tener incluida su
identificación, de manera que pueda ser citada o referenciada adecuadamente
desde cualquier parte del texto.
Por ejemplo, si en un párrafo estamos hablando sobre el análisis de ciertos
datos, pero hacemos referencia a dos tablas distintas. ¿Cómo se podría hacer?
Los pasos a seguir son los siguientes:
1. Identificar la tabla o figura con alguna etiquetas
#+CAPTION: Este es el texto asociado a la figura o tabla
#+NAME: fig:etiqueta
1. Referenciar la tabla o figura utilizando esa etiqueta
Ese día, pudimos ver en la imagen [[fig:etiqueta]] que
ninguno de nosotros nos habíamos percatado de la presencia de ...
En tabla
Se recomiendo usar en su etiqueta table:nombre o tabla:nombre
En imagen
Se recomienda usar en su etiqueta img:nombre o diagrama:nombre,
según el caso.

19
13. Insertar Enlaces
En los documentos modernos, sobretodo aquellos que se visualizan elec-
trónicamente como pdf o html es posible colocar trozos de textos que estén
enlazados a un sitio web específico.
La estructura es la siguiente

[[url][TEXTO WEB]]
[[https://cursoprogramacionoocc.wordpress.com/]
[Curso de Programación para Organizaciones Comunitarias]]

Para el Curso de Programación se tendrá: Curso de Programación

para Organizaciones Comunitarias

14. Insertar Pies de Página

Las notas al pie de página son elementos que algunos textos contienen y se
consideran usualmente en textos impresos. Son textos menores, referenciales
que explican o dan mayor contenido a lo que se expone.
La guía de footnotes nos explica lo siguiente.
Por ejemplo, si deseamos mostrar que existe la Guía de Org-mode en
español, a un enlace 1 escribimos de la manera siguiente.

Por ejemplo, si deseamos mostrar que existe la *Guía de Org-mode* en español, a

un enlace [fn:enlace-footnote] escribimos de la manera siguiente.

(al final de la sección)

[fn:enlace-footnote] El enlace al manual de
org mode compacto es: https://www.davidam.com/docu/orgguide.es.html

15. Crear listas

En Org mode crear listas es la manera más simple del universo, ya que
es literal a como lo hacemos en un cuaderno.
1
El enlace al manual de org mode compacto es: https://www.davidam.com/docu/
orgguide.es.html

20
15.1. No numeradas
Se ponen guiones

- Auto

- Camión

- Camioneta

Auto

Camión

Camioneta

15.2. Numeradas
Se ponen números

1. David
2. Paula
3. Pedro
4. Alejandra
5. Felipe
6. Elda

Los hermanos Pineda Osorio :)

1. David

2. Paula

3. Pedro

4. Alejandra

5. Felipe

6. Elda

21
15.3. Definiciones
Se utiliza listas y luego ::

Abrazar el acto de rodear con los brazos.

Pensar el acto de ejercer el pensamiento.

Robar el acto de apropiarse de lo ajeno.

16. Insertar citas

Para insertar textos, transcritos desde otra parte, basta con enmarcarlos
en la etiqueta QUOTE

#+BEGIN_QUOTE ... #+END_QUOTE

Por ejemplo, el concepto de bienes comunes visto desde comunes.org

Los bienes comunes, también llamados bienes comunales o pro-

común, son aquellos recursos que son de cualquier persona pero
que no son propiedad exclusiva de ninguna en particular. Por
ejemplo: las semillas, las calles, el software libre y la wikipedia.
De comunes.org

17. Insertar poemas

De manera análoga, para incluir un poema o texto en verso, es posible
ocupar la etiqueta VERSE

#+BEGIN_VERSE ... #+END_VERSE

Un poema, puede verse de la siguiente manera.

A esta edad

A esta edad
en que los huesos dejan de crecer
y comienza cambiar la escala
de colores de nuestro cabello,
a la vez que los afortunados
vuelven a encontrar el camino

22
 de la infancia olvidada
por la locura del despertar juvenil.
Es cuando podemos observar
la vejez de nuestros padres,
ver nuestro futuro en ellos
o crear nuevos destinos.

Pero ellos,
que han volcado todo su amor
a la vida de sus niños y niñas,
también se ven en nosotros
y desean una mejor fortuna
que vivir en un país de desalmados,
en medio de los despojos
de todas nuestras tragedias.

La última vejez de los viejos,

la legítima vejez,
antes de su despedida final
será una migración a los marginados
deambulando por los pasillos
de hospitales y gobernaciones,
con una salud y jubilación de mala clase,
sometidos a la burocracia eterna
y las sorpresas abrumadoras de lo nuevo.

A esta edad mediana

es que es necesario
darles todas las manos
y el corazón y la mente
porque son el camino de la memoria
que guarda la historia y el futuro
para volver a la comunidad
y desensamblar nuestra maquinaria.

17.1. Centrar un texto

Se utiliza la etiqueta CENTER

Todo este texto puede ir centrado o no todo depende de cuál etiqueta

terminemos utilizando en el mismo editor emacs

23
17.2. Otras etiquetas
Revisar en la documentación de Org-mode :
https://orgmode.org/manual/Easy-templates.html#Easy-templates

18. Salto de página

Considerando que podríamos necesitar nuestro documento para imprimir
en papel, definir una nueva página o salto de página podría ser de utilidad.

\pagebreak

18.1. Solo cuando sea exportar a LATEX

En caso de ser específicos.

#+Begin_Latex
\pagebreak
#+End_Latex

18.2. Solo exportar a ODT (writer)

Según el manual de opciones avanzadas.

#+ODT: <text:p text:style-name="PageBreak"/>

19. Exportar a otros formatos (de presentación)

Existen diversas opciones de entrega como formato final.
Todo parte apretando C+c+e, que nos permitirá seleccionar a un for-
mato a escoger.
Nos levanta un nuevo buffer con opciones a exportar, en general debemos
escoger dos letras 1.
Por ejemplo, si deseo un documento:

txt t+u

html h+h

odt o+o

pdf l+p

24
Figura 1: Esta es la interfaz a seleccionar el formato de salida.

25
20. Referencias Interesantes
20.1. Manual Oficial
Este manual el más completo (pero en inglés), contiene la información
oficial.
Manual Oficial (en inglés)
https://orgmode.org/manual/

20.2. Guías
La Guía Compacta
https://www.traficantes.net/libros/gu%C3%ADa-compacta-de-org-mode
Chuleta de Comandos
https://elbauldelprogramador.com/chuleta-org-mode/

20.3. Ejemplos
Insertar imágenes
https://ondahostil.wordpress.com/2017/12/26/lo-que-he-aprendido-imagenes-inline-en-org
Blog de Juan Maciel
https://diosas-nubes.blogspot.com/2018/10/la-odisea-y-org-mode.html
Curso de Programación para Organizaciones Comunitarias
https://gitlab.com/pineiden/curso_programacion

21. Consultar Ayuda

21.1. Escribir Email
A David Pineda
email dpineda@uchile.cl

21.2. Chats de Telegram

Desde el sistema de chat Telegram, ingresar a:
https://t.me/orgmode_paratodes

26