This manual is for Org version 8.3.1 (release_8.3.1-90-g80a626).
Copyright © 2004–2015 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, with the Front-Cover Texts being “A GNU Manual,” and with the Back-Cover Texts as in (a) below. A copy of the license is included in the section entitled “GNU Free Documentation License.”
(a) The FSF’s Back-Cover Text is: “You have the freedom to copy and modify this GNU manual.”
• Resumen: | Breve resumen de lo que hace Org |
• Instalación: | Instalando Org |
• Activación: | Cómo activar Org para ciertos buffers |
• Retroalimentación: | informes de errores, ideas, parches, etc. |
• Convenciones: | Convenciones de tipografía en el manual |
Org es un modo para tomar notas, mantener listas de tareas pendientes, y planificación de proyectos con un sistema rápido y eficaz de texto plano. Es también una sistema de creación con un soporte unico para programacion e investigación reproducible.
Org se implementa en la parte superior del modo Outline, que hace posible mantener estructurado el contenido de archivos de gran tamaño. Tiene visibilidad ciclica y una estructura editable que ayuda a trabajar con el árbol. Las tablas se crean fácilmente con un editor de tablas incorporado. Enlaces de texto plano al estilo URL, que conectan a páginas web, correos electrónicos, mensajes Usenet, entradas BBDB y todos los archivos relacionados a los proyectos.
Org desarrolla tareas de organización en torno a notas de archivos que contengan listas o información sobre proyectos como texto sin formato. La planificación de proyectos y gestión de tareas hacen uso de metadatos que han pasado de un nodo de esquema. Basándose en estos datos, entradas específicas se pueden extraer mediante consultas y crear vistas dinámicas de agenda que también integran el calendario y el diario de Emacs. Org se puede utilizar para poner en práctica muchos diferentes esquemas de planificación de proyectos, tales como el sistema GTD (Getting Things Done) de David Allen`s.
Los archivos Org pueden servir como un único sistema fuente de creación con exportación a muchos otros formatos diferentes, tales como HTML, LaTeX, Open Document, y Markdown. Nuevos backends de exportación se pueden derivar de los ya existentes, o definir a partir de cero.
Los archivos Org pueden incluir bloques de código fuente, lo que hace conveniente a Org para la creación de documentos técnicos con ejemplos de código. Los bloques de código fuente de Org son completamente funcionales; pueden ser evaluados en su sitio y sus resultados pueden ser capturados en el archivo. Esto hace posible crear un compendio de investigación reproducible en un unico archivo.
Org mantiene las cosas sencillas sencillas. Cuando salga disparado, debe sentir un avance directo, usar esquemas es fácil. La complejidad no es inpuesta, pero una gran cantidad de funcionalidades están disponibles para cuando sea necesario. Org es una caja de herramientas. Muchos usuarios en realidad sólo ejecutan una (muy personal) fracción de capacidades de Org, y sabrá que hay más siempre que lo necesite.
Todo esto se consigue estrictamente con archivos de texto plano, el formato de archivo más portátil y preparada para el futuro. Org funciona en Emacs. Emacs es Uno de los programas más ampliamente portado, por lo que el modo Org esta disponible en todas las plataformas principales.
Hay un sitio web para la Org, que ofrece enlaces a la más nueva versión de Org, así como información adicional, preguntas frecuencia (FAQ), enlaces a tutoriales, etc. Esta página se encuentra en http://orgmode.org.
Una versión anterior (7.3) de este manual está disponible como libro impreso por Network Theory Ltd.
Org es parte de las distribuciones de GNU Emacs recientes, por lo que normalmente No es necesario instalarlo. Si, por una razón u otra, desea Instalar la mas reciente versión pre-enpaquetada de Org, hay tres Maneras de hacerlo:
- Utilizando el sistema de paquetes de Emacs.
- Descargando Org como un archivo.
- Mediante el uso del repositorio git de Org.
Nosotros Recomendamos ceñirse a un unico método de instalación.
Recientes distribuciones de Emacs incluyen un sistema de
enpaquetado que permite Instalar bibliotecas Elisp. Puede instalar
Org con M-x package-install RET org
.
Importante: necesita hacer esto en una sesión donde no se ha
visitado ningun archivo .org
, es decir, donde ninguna función
Org incorporada, ha sido cargada. De lo contrario las funciones
Org que han sido cargas automáticamente hacen un lío la
Instalación.
A continuación, para asegurarse de que su configuración de Org se
tiene en cuenta, inicialice el sistema de paquetes con
(package-initialize)
en su .emacs Antes de establecer
cualquier opción de Org. Si desea utilizar Org del Repositorio de
paquetes, visita Org ELPA page.
Puede descargar la última versión de Org del sitio web de Org. En esto caso, asegúrese de configurar la ruta de carga correctamente en su .emacs:
(add-to-list 'load-path "~/path/to/orgdir/lisp")
El archivo descargado contiene bibliotecas adicianales que no son incluidas en Emacs. Si desea utilizarlas, añada el directorio contrib a su load-path:
(add-to-list 'load-path "~/path/to/orgdir/contrib/lisp" t)
Opcionalmente, puede compilar los archivos y/o instalarlos en su
sistema. Ejecute make help
para mostrar las opciones de
compilación e instalación.
Se puede clonar el repositorio e instalar Org así:
$ cd ~/src/ $ git clone git://orgmode.org/org-mode.git $ make autoloads
Tenga en cuenta que en este caso, make autoloads
es obligatorio
define la versión de Org en org-version.el
y autoloads de Org en
org-loaddefs.el
.
Recuerde agregar la ruta de carga correcta como se describe en el método arriba.
También se puede compilar con make
, generar la documentación con
make doc
, crear una configuración local con make config
e
instalar Org con make install
. Por favor, ejecute make help
para obtener la lista de opciones de compilación/instalación.
Para explicaciones más detalladas sobre el sistema de construcción de Org, por favor revise La página del sistema de construcción Org en Worg.
Desde Emacs 22.2, archivos con la extensión .org
utilizan el modo
Org por defecto. Si está utilizando una versión anterior de Emacs,
agregue esta línea a su archivo .emacs
:
(add-to-list 'auto-mode-alist '("\\.org\\'" . org-mode))
Los buffers del modo Org necesitan font-lock para ser activados: esto viene predeterminado en Emacs[fn:1].
Hay problemas de compatibilidad entre el modo Org y algunos otros paquetes Elisp, por favor tome el tiempo para ver la lista (ver Conflicto).
Los cuatro comandos Org org-store-link
, org-capture
,
org-agenda
, y org-iswitchb
deben ser accesibles a través de
teclas globales (es decir , en cualquier lugar en Emacs, no sólo en
buffers Org). Aquí se sugieren combinaciones para estos comandos,
modifique las teclas a su propio gusto.
(global-set-key "\C-cl" 'org-store-link)
(global-set-key "\C-ca" 'org-agenda)
(global-set-key "\C-cc" 'org-capture)
(global-set-key "\C-cb" 'org-iswitchb)
Para activar el modo Org en un archivo que no tiene la extensión
.org
, Haga que la primera línea del archivo sea de la siguiente
manera:
MY PROJECTS -*- mode: org; -*-
Esto selecciona el modo Org para este búffer, no importa el nombre
de archivo que tenga. Véa también la variable
org-insert-mode-line-in-empty-file
.
Muchos comandos trabajan con regiones en Org si la región se
encuentra activa. Para hacer uso de esto, es necesario tener
transient-mark-mode
(zmacs-regions
en XEmacs) encendido. en
Emacs 23 es el valor predeterminado, en Emacs 22 necesita hacer
esto usted mismo con
(transient-mark-mode 1)
Si no le gusta transient-mark-mode
, puede crear una región activa
utilizando el ratón para seleccionar una región, o presionando
C-SPC
dos veces antes de mover el cursor.
Si encuentra problemas en Org, o si tiene preguntas, comentarios, o ideas al respecto, por favor enviar por correo a la lista de correo Org [email protected]. Usted puede suscribirse a la lista de correo en esta pagina web. Si usted no es un miembro de la lista de correo , su correo sera pasado a la lista después de que un moderador lo alla aprobado[fn:2].
Para informes de errores, por favor, primero trate de reproducir el
error con la versión más reciente de Org disponible – si está
ejecutando una versión obsoleta, es muy posible que el error ya se
haya corregido. Si el error persiste, prepare un informe y
proporcione la mayor cantidad de Información que sea posible,
incluyendo la información de versión de Emacs (M-x emacs-version
RET
) y Org (M-x org-version RET
), así como la configuración
relacionada con Org en .emacs
. La forma más fácil de hacer esto
es utilizar el comando
M-x org-submit-bug-report RET
Que pondrá toda esta información en un búfer de correo Emacs al que sólo tiene que añadir su descripción. Si usted no está enviando el Email desde Emacs, por favor, copie y pege el contenido en su programa de correo electrónico .
Algunas veces usted puede hacer frente a un problema debido a un error en su configuración de Emacs o del modo Org. Antes de informar de un error, es muy útil iniciar Emacs con personalizaciones mínimas y reproducir el problema. Antes de pedir ayuda determine si el problema es debido a su personalización o al modo Org en sí . Puede iniciar una sesión mínima típica con un comando como el siguiente.
$ emacs -Q -l /path/to/minimal-org.el
Sin embargo, si está utilizando el modo Org como se distribuye con
Emacs, una configuración mínima no es necesaria. En ese caso, es
suficiente iniciar Emacs como emacs -Q
. La configuracion minima
para Org minimal-org.el
puede ser la que se muestra a
continuación.
;;; Minimal setup to load latest 'org-mode'
;; activate debugging
(setq debug-on-error t
debug-on-signal nil
debug-on-quit nil)
;; add latest org-mode to load path
(add-to-list 'load-path (expand-file-name "/path/to/org-mode/lisp"))
(add-to-list 'load-path (expand-file-name "/path/to/org-mode/contrib/lisp" t))
Si se produce un error , una traza inversa puede ser muy útil (véase más adelante sobre la manera de crer una). A menudo, un pequeño archivo de ejemplo ayuda, junto con información clara sobre:
- ¿Qué hizo exactamente?
- ¿Qué espera que suceda?
- ¿Qué pasó en su lugar?
Gracias por ayudarnos a mejorar este programa .
Si al trabajar con Org se produce un error con un mensaje que no entiende, es posible que haya chocado con un error. La mejor manera de informar de esto es proporcionando, además de lo que se ha mencionado anteriormente, una traza. Esta es la información del depurador integrado, sobre dónde y cómo se produjo el error. Estos son los pasos para producir una útil traza inversa:
- Actualizar sin compilar versiones de todos los archivos Lisp
del modo Org. La traza contiene mucha más información si se
produce con código sin compilar. Para ello, ejecute
C-u M-x org-reload RET
o seleccione Org -> Refresh/Reload -> Reload Org uncompiled
desde el menú.
- Del menú vaya a
Options
y seleccioneEnter Debugger on Error
(XEmacs tiene esta opción en el sub-menúTroubleshooting
). - Haga lo que tengas que hacer para reproducir el error. No se olvide de documentar los pasos que da.
- Al ocurrir el error, el búfer Backtrace aparecerá en la
pantalla. Guarde este búfer en un archivo (por ejemplo,
utilizando
C-x C-w
) y adjuntelo a su informe de error.
Org utiliza principalmente tres tipos de palabras clave: palabras clave TODO, tags (etiquetas) y nombres de propiedad. En este manual se utilizan los siguientes convenios:
TODO
WAITING
La palabra clave TODO se escribe en mayusculas, incluso si es definida por el usuario.
boss
ARCHIVE
las etiquetas definidas por el usuario se escriben en minúsculas; las etiquetas integradas con significado especial se escriben en mayusculas.
Release
PRIORITY
las propiedades definidas por el usuario se escriben capitalizadas; Las propiedades incorporadas con significado especial se escriben con mayúsculas.
Además, Org utiliza palabras clave opcionales (como #+TITLE
para establecer el título) y palabras clave de entorno (como
#+BEGIN_HTML
para iniciar un entorno HTML
). Están escritas en
mayúsculas en el manual para mejorar su legibilidad, pero puede
utilizar minúsculas en sus Archivos Org[fn:3].
Este manual sugiere algunas combinaciones de teclas globales, en
particular, C-c a
para org-agenda
y C-c c
para
org-capture
. Estas son sólo sugerencias, pero el resto del
manual asume éstas combinaciones de teclas como comandos de
acceso.
El modo Org utiliza a menudo la misma combinacion para diferentes
funciones, dependiendo del contexto. Los comandos que están
ligados a dichas combinaciones tiene un nombre genérico, como
org-metaright
. En el manual nosotros, siempre que sea posible,
daremos la función que es internamente llamada por el comando
genérico. por Ejemplo, en el capítulo sobre la estructura de
documentos, M-right
llamara a org-do-demote
, mientras que en
el capítulo sobre tablas, será listada para llamar a
org-table-move-column-right
. Si prefiere, puede compilar el
manual sin los nombres de los comandos demarcando la bandera
cmdnames
en org.texi.
Org se basa en el modo Outline y proporciona comandos flexibles para editar la estructura del documento.
• Esquemas: | Org se basa en el modo Outline |
• Encabezados: | Cómo establecer encabezados del árbol de esquema Org |
• Visibilidad ciclica: | Mostrar y ocultar, simplifica mucho |
• Movimiento: | Saltar a otros titulares |
• Editar estructura: | Cambiar secuencia y nivel de titulares |
• Árboles poco densos: | Coincidencias embebidas en contexto |
• Listas Planas: | Estructura adicional dentro de una entrada |
• Cajones: | Guardando cosas lejos |
• Bloques: | Bloques plegables |
• Notas: | Cómo se definen las notas al pie en la sintaxis de Org |
• Modo Orgstruct: | Edición de estructura exterior Org |
• Sintaxis Org: | Descripción formal de la sintaxis de Org |
Org se implementa en la parte superior de modo Outline. Outline
permite que un documento que se organiza en una estructura
jerárquica, que (al menos para mí) es la mejor forma de representar
notas y pensamientos. Un visión glabal de esta estructura se
consigue mediante el plegado (ocultacion) de grandes partes del
documento, para mostrar sólo la estructura global del documento Y
la zona de trabajo actual. Org simplifica enormemente todo el uso
de esquemas mediante la funcionalidad mostrar/ocultar en un solo
comando, org-cycle
, que está ligado a la tecla TAB
.
Los encabezados definen la estructura del arbol de esquema. Los encabezados en Org comienzan con uno o más asteriscos, en el margen izquierdo[fn:4] [fn:5]. Por ejemplo:
#
* Encabezado principal ** Segundo nivel *** 3er. nivel algo de texto *** 3er. nivel mas texto * Otro encabezado principal
Tenga en cuenta que un encabezado nombrado después de
org-footnote-section
, que por defecto es ‘Footnotes’, es
considerado como especial. Un subárbol de este encabezado será
silenciosamente ignorado por las funciones de exportación.
Algunas personas encuentran tantos asteriscos demasiado molestos y prefieren encabezado que comiencen por espacios en blanco seguidos por una sola estrella. En Vista limpia, se describe la configuración para realizar esto.
Una línea vacía al final de un subárbol se considera parte de este
y se oculta cuando se oculta el subárbol. Sin embargo , si usted
deja al menos dos líneas en blanco, una línea vacía permanecerá
visible después de ocultar el subárbol, con el fin de estructurar
la vista oculta. Vea las variables org-cycle-separator-lines
para
modificar este comportamiento.
• Rotacion global y local: | Rotacion a través de varios estados de visibilidad |
• Visibilidad inicial: | Establecer el estado de visibilidad inicial |
• Capturar modificaciones invisibles: | Prevención de errores al editar partes invisibles |
Los esquemas hacen posible ocultar partes del texto en el
bufer. Org utiliza sólo dos comandos, ligados a TAB
y S-TAB
para cambiar la visibilidad en el búfer.
TAB
(org-cycle
)Subtree cycling : Alterne entre entre estados del subarbol actual
,-> PLEGADO -> HIJOS -> SUBARBOL --. '----------------------------------'
El cursor debe estar en un encabezade para que esto
funcione[fn:6]. Cuando el cursor se encuentra al comienzo
del búfer y la primera línea no es un encabezado, entonces
TAB
ejecuta la rotacion global (véase más adelante
)[fn:7]. También cuando llama con el argumento prefijo
(C-u TAB
) , se invoca la rotacion global.
S-TAB
(org-global-cycle
)C-u TAB
Global cycling : Rotar entre los estados de todo el bufer
,-> VISIÓN GENERAL -> CONTENIDOS -> MOSTRAR TODO --. '--------------------------------------------------'
Cuando S-TAB
se llama con un argumento prefijo numérico N
,
los CONTENIDOS se mostraran hasta el encabezado de nivel N
.
Tenga en cuenta que dentro de tablas, S-TAB
salta al campo
anterior.
C-u C-u TAB
(org-set-startup-visibility
)
Vuelve a la visibilidad inicial del buffer (vea Visibilidad inicial).
C-u C-u C-u TAB
(show-all
)
Mostrar todo, incluidos los cajones.
C-c C-r
(org-reveal
)
Revelar contexto al rededor del punto, mostrando la entrada actual, el siguiente encabezado y la jerarquía superior. Útil para trabajar cerca de un lugar que ha sido expuesto por un comando de árbol escaso (Ver Sparse trees) o un comando de agenda ( ver Agenda commands). Con un argumento prefijo muestra, en cada nivel, todos los encabezados hermanos. Con un argumento doble prefijo, también muestran la totalidad del subárbol padre.
C-c C-k
(show-branches
)
Expone todas las cabeceras del sub-árbol, el CONTENIDO es visible sólo para un subárbol.
C-c TAB
(show-children
)
Exponga todos los hijos directos del sub-árbol. Con una
argumento prefijo numérico N
, expone todos los hijos debajo
hasta el nivel N
.
C-c C-x b
(org-tree-to-indirect-buffer
)
Muestra el subárbol actual en un búfer diferente[fn:8]. Con
Un argumento prefijo numérico N
, va hasta el nivel N
y
luego toma ese árbol. Si N
es negativo luego sube esa
cantidad de niveles. Con el prefijo C-u
, no retira los
distintos buffer utilizados anteriormente.
C-c C-x v
(org-copy-visible
)
Copia el texto visible de la región dentro del kill ring.
Cuando Emacs visita por primera un fichero Org, el estado global
se establece en VISIÓN GENERAL, es decir, sólo los titulares de
primer nivel son visibles[fn:9]. Esto se puede configurar a
través de la variable org-startup-folded
, o en función de cada
archivo mediante la adición de una de las siguientes líneas en
cualquier parte del búfer:
#+STARTUP: overview #+STARTUP: content #+STARTUP: showall #+STARTUP: showeverything
Las opciones de visibilidad inicial se ignoran cuando el archivo
es abierto por primera vez durante la generación de la agenda: si
desea que al agenda respete la visibilidad inicial, establesca
org-agenda-inhibit-startup
como nil
.
Además, todas las entradas con una propiedad ‘VISIBILITY’ (ver
Propiedades y columnas) conseguirá
adaptadar su visibilidad en consecuencia. Los valores permitidos
para esta propiedad son folded
, children
, content
, and
all
.
C-u C-u TAB
(org-set-startup-visibility
)
Volver a la visibilidad inicial del buffer, es decir, lo solicitado por las opciones de inicio y las propiedades ‘VISIBILITY’ en las entradas individuales.
A veces puede editar sin querer una parte invisible del buffer y
ser confuso conocer sobre lo que se ha editado y cómo deshacer el
error. Configurar org-catch-invisible-edits
distinto de nil
ayudara a prevenir esto. Vea la cadena de documentación de esta
opción sobre cómo Org tendria que tomar las ediciones invisibles y
procesarlas.
Los siguientes comandos saltan a otras cabeceras en el búfer.
C-c C-n
(outline-next-visible-heading
)
Encabezado siguiente.
C-c C-p
(outline-previous-visible-heading
)
Encabezado anterior.
C-c C-f
(org-forward-same-level
)
Encabezado siguiente del mismo nivel .
C-c C-b
(org-backward-same-level
)
Encabezado anterior del mismo nivel .
C-c C-u
(outline-up-heading
)
Ir hacia el anterior encabezado de mayor nivel.
C-c C-j
(org-goto
)
Ir a un lugar diferente sin cambiar el esquema actual de visibilidad. Muestra la estructura del documento en un buffer temporal, Donde se puede utilizar las siguientes teclas para encontrar su destino:
TAB | Visibilidad Ciclica. |
down / up | Siguiente/Anterior cabecera visible. |
RET | Seleccione esta ubicacion. |
/ | Haga una busqueda de arbol-escaso |
Las siguientes teclas funcionan si se desactiva
org-goto-auto-isearch
n / p | Siguiente/Anterior cabecera visible. |
f / b | Siguiente/Anterior cabecera del mismo nivel. |
u | Un nivel arriba. |
0-9 | Argumento de dígitos. |
q | Salir |
Véase también la opción org-goto-interface
.
M-RET
(org-insert-heading
)
Inserte una nuevo encabezado/elemento con el mismo nivel que el del punto.
Si el cursor se encuentra en un elemento de lista sin formato,
se crea un nuevo elemento (Ver Listas
Planas). Para evitar este comportamiento en las listas, llame
al Comando con un argumento prefijo. Cuando se usa este comando
en medio de una línea, la línea se divide y el resto de la línea
Se convierte en el nuevo artículo o cabecera. Si no desea
dividir línea, personalice org-M-RET-may-split-line
.
Si el comando se utiliza al comienzo de una línea, y si hay una encabezado o un elemento en el punto, el nuevo encabezado/elemento es creado antes de la línea actual. Si el comando se utiliza al final de un sub-árbol plegado (es decir, detrás de los puntos suspensivos al final del encabezado), a continuación, se inserta un encabezado después del final Del subárbol.
Llame a este comando con C-u C-u
si desea respetar el
contenido del encabezado y crear un nuevo elemento al final del
subárbol padre.
Si el punto está al inicio de una línea normal, convierte esta línea en un encabezado.
C-RET
(org-insert-heading-respect-content
)
Al igual que M-RET
, excepto que se añade un nuevo encabezado
por debajo del encabezado actual, el nuevo encabezado se coloca
después el cuerpo en lugar de antes. Este comando funciona desde
cualquier lugar de entrada.
M-S-RET
(org-insert-todo-heading
)
Inserta una nueva entrada TODO con el mismo nivel que el
encabezado actual. Vea también la variable
org-treat-insert-todo-heading-as-state-change
.
C-S-RET
(org-insert-todo-heading-respect-content
)
Inserta nueva entrada TODO con mismo nivel que el encabezado
actual. Como C-RET
, se insertará el nuevo encabezado después
del actual Subárbol.
TAB
(org-cycle
)
En una nueva entrada sin texto, el primer TAB
degrada la
entrada para convertirse en un hijo de la anterior. El siguiente
TAB
hace que sea uno de los padres, y así sucesivamente, hasta
llegar al nivel superior. Otra TAB
mas, y regresara de nuevo
al nivel inicial.
M-left
(org-do-promote
)
Promover encabezado actual en un nivel.
M-right
(org-do-demote
)
Degradar encabezado actual en un nivel.
M-S-left
(org-promote-subtree
)
Promover el subárbol actual en un nivel.
M-S-right
(org-demote-subtree
)
Degradar el subárbol actual en un nivel.
M-S-up
(org-move-subtree-up
)
Mover subárbol arriba (intercambia con subárbol anterior del mismo nivel).
M-S-down
(org-move-subtree-down
)
Mover subárbol abajo (intercambio con siguiente subárbol del mismo nivel).
M-h
(org-mark-element
)
Marque el elemento en el punto. Precionar repetidamente marcará
elementos subsiguientes del que acaba de ser marcado. Por
ejemplo, precionar M-h
en un párrafo lo marcará, otro M-h
marcara el parrafo siguiente.
C-c @
(org-mark-subtree
)
Marque el subárbol en el punto. Precionar repetidamente marcará subárboles posteriores del mismo nivel que el subárbol marcado.
C-c C-x C-w
(org-cut-subtree
)
Matar subárbol, es decir, removerlo del búfer pero guardarlo a salvo en el kill ring. Con un argumento prefijo numérico N, mata los N subárboles siguientes.
C-c C-x M-w
(org-copy-subtree
)
Copia subárbol al kill ring. Con un argumento prefijo numérico N, copia los N subárboles siguientes.
C-c C-x C-y
(org-paste-subtree
)
Traer subárbol del kill ring. Esto modifica el nivel del subárbol para adaptarlo a la posicion dentro del arbol. El nivel se puede especificar con un valor numérico dentro del argumento prefijo, o tirando después de marcador el encabezado como ‘****’.
C-y
(org-yank
)
Dependiendo de las opciones de org-yank-adjusted-subtrees
y
org-yank-folded-subtrees
, ambos, comandos internos yank
de
Org para traer subarboles plegados y de manera inteligente,
utilizando el mismo comando C-c C-x C-y
. Con la configuración
predeterminada, no se llevara a cabo el ajuste de nivel, pero el
árbol traido será plegado a menos que al hacerlo se pliegue
texto previamente visible. Cualquier argumento prefijo a este
comando forzará la ejecucion de un yank
normal. Una buena
manera de forzar un yank normal es C-u C-y
. Si utiliza
yank-pop
después de un yank, se traeran artículos, sin ajuste
ni plegado.
C-c C-x c
(org-clone-subtree-with-time-shift
)
Clonar un subárbol haciendo un numero de copias hermanas de
este. Se le solicitará el número de copias que desea hacer, y
tamien puede especificar si las marcas de tiempo de entrada
deben ser cambiadas. Esto puede ser útil, por ejemplo, para
crear una serie de tareas relacionadas con una serie de
conferencias. Para más detalles, ver la cadena de documentación
del comando org-clone-subtree-with-time-shift
.
C-c C-w
(org-refile
)
Colocar entrada o región en una ubicación diferente . Vér Colocacion y copia.
C-c ^
(org-sort
)
Ordenar entradas del mismo nivel. Cuando hay una región activa,
todas las entradas en la región serán ordenados. De lo
contrario, los hijos del encabezado actual están ordenados . El
comando solicita el método de clasificación, que puede ser orden
alfabético, numérico, por tiempo (primera marca de tiempo con el
tiempo preferido, tiempo de creacion, tiempo programado, hora
límite), por prioridad , por palabra clave TODO (la secuencia en
que las palabras clave se han definido en la configuración) o el
valor de una propiedad. La clasificación inversa tambien es
posible. También puede proporcionar su propia función para
extraer la clave de clasificación. Con el prefijo C-u
, la
clasificación será sensible a mayusculas y minusculas.
C-x n s
(org-narrow-to-subtree
)
Reducir buffer a subárbol actual.
C-x n b
(org-narrow-to-block
)
Reducir búfer a bloque actual.
C-x n w
(widen
)
Ampliar buffer para eliminar la reduccion.
C-c *
(org-toggle-heading
)
Convertir una línea normal o elemento del lista siple en un encabezado (a modo de subencabezado en esta ubicacion). También convierte un encabezado en una línea comun mediante la eliminación de los asteriscos. Si hay una región activa, convierte todas las líneas en la región en los encabezados. Si la primera línea en la región era un elemento, convierte sólo las líneas de elementos en encabezados. Por último, si la primera línea es un encabezado, retira los asteriscos de todos los encabezados de la región.
Cuando hay una región activa (modo Transient Mark), la promoción y el descenso de categoría trabaja en todos los encabezados de la región. Para seleccionar una región de encabezados, lo mejor es colocar tanto punto y la marca al comienzo de una línea, la marcar al comienzo del primer encabezado, y el punto en la línea justo después del último encabezado a cambiar. Tenga en cuenta que cuando el cursor se encuentra dentro de una tabla ( ver Tablas), las teclas del Meta-Cursor tienen una funcionalidad diferente.
Una característica importante del modo Org es la capacidad de construir árboles conpactos de información seleccionada en un árbol de esquema, por lo que todo el documento se plega tanto como sea posible, pero la información seleccionada se hace visible, junto con la estructura de encabezados por encima de ella[fn:10]. Haga la prueba y verá inmediatamente cómo trabaja.
El modo Org contiene varios comandos para la creación de este tipo de árboles, todos estos comandos se puede acceder mediante un despachador:
C-c /
(org-sparse-tree
)
Activa un prompt que pide una tecla extra para seleccionar un comando de creación árboles compactos.
C-c / r
(org-occur
)
Solicita una expresión regular y muestra un árbol compacto con
todas las coincidencias. Si la coincidencia está en un
encabezado, el encabezado se hace visible. Si la coincidencia
está en el cuerpo de una entrada, encabezado y cuerpo se hacen
visibles. Con el fin de proporcionar un contexto mínimo,
también se muestra la jerarquía completa de los encabezados
sobre la coincidencia, así como el encabezado tras la
coincidencia. Cada correspondencia es también resaltada; el
resaltado desaparece cuando se cambia el buffer con un comando
de edición[fn:11], o presionando C-c C-c
. Cuando se llama
con el argumento prefijo C-u
, el resaltado anterior se
mantiene, por lo que varias llamadas a este comando pueden ser
almacenadas.
M-g n
orM-g M-n
(next-error
)
Ir a la siguiente coincidencia dentro del árbol conpacto en este buffer.
M-g p
orM-g M-p
(previous-error
)
Ir a la anterior coincidencia dentro del árbol conpacto en este buffer.
Para uso frecuente de árboles conpactos o de cadenas de búsqueda
específicas, puede utilizar la opción org-agenda-custom-commands
para definir accesos rápidos de teclado a árboles compactos
específicos. Estos comandos serán accesibles a mediante el
despachador de agenda (véase Agenda dispatcher). Por ejemplo:
(setq org-agenda-custom-commands
'(("f" occur-tree "FIXME")))
Definirá la combicacion C-c a f
como un atajo para coincidencias
con la cadena ‘FIXME’ en un arbol compacto.
Los otros comandos de árbol conmacto seleccionan encabezados basados en palabras clave TODO, etiquetas o propiedades y se discutirá más adelante en este Manual.
Para imprimir un árbol compacto, puede utilizar el comando de Emacs
ps-print-buffer-with-faces
que no imprime las partes invisibles
del documento[fn:12]. O puede usar C-c C-e C-v
para sólo
exportar la parte visible del documento e imprimir el archivo
resultante.
En una entrada de árbol de esquema, las listas formateadas a mano puede proporcionar estruturacion adicional. También proporcionan una manera de crear listas de casillas ( ver Checkboxes). Org soporta la edición de tales Listas y todos los exportadores ( ver Exporting) puede analizar y dar formato ellos.
Org reconece listas ordenadas, listas desordenadas, y listas de descripción.
- Las listas de elementos desordenadas inician con ‘-‘, ‘+’ o ‘*’[fn:13].
- Las listas de elementos ordenadas inician con un número
seguido de un punto o un paréntesis derecho[fn:14], como
‘1.’ o ’ 1)’[fn:15]. Si desea que la lista inicie con un
valor diferente (por ejemplo, 20), se inicia el texto del
elemento con
[@20]
[fn:16]. Esas construcciones se pueden usar en cualquier elemento de la lista con el fin de aplicar una numeracion particular.
- Las listas de elementos de Descripción son listas de elementos sin ordenar, y contienen el separador ’ :: ’ para distinguir el termino de descripción de la descripción.
Los elementos que pertenecen a la misma lista deben tener la misma indentacion en la primera línea. En particular, si una lista ordenada alcanza el número ‘10’, entonces los números de 2–dígitos deben ser escritos alineados a la izquierda con los otros números de la lista. Un elemento termina antes de la siguiente línea con menor o igual indentado que su simbolo/número.
Una lista termina cuando todos los elementos han terminado, lo que significa antes de cualquier línea de menor o igual indentacion que el elemento de nivel superior. También termina Antes de dos líneas en blanco[fn:17]. En ese caso, todos los elementos son Cerrados. He aquí un ejemplo:
** Lord of the Rings Mis escenas favoritas son (en este orden) 1. El ataque de los Rohirrim 2. La lucha de Eowyn con el rey brujo + Esta ya era mi escena favorita en el libro. + Me gusta Miranda Otto. 3. Peter Jackson es baleado por Legolas - Sólo en DVD El hace una cara muy graciosa cuando sucede Pero al final, no hay escenas individuales importantes la película es un todo. Los actores importantes en esta película son: - Elijah Wood :: Él interpreta a Frodo - Sean Austin :: Él interpreta a Sam, amigo de Frodo. Todavía le recuerdo muy bien de su papel como Mikey Walsh en Los Goonies.
Org respalda estas listas con comandos de ajuste de llenado y
envoltura para tratar con ellos correctamente[fn:18] y
exportarlos de manera adecuada ( Ver Exporting). Desde la
indentacion se controla la estructura de estas listas, muchas
construcciones estructurales como los bloques #+BEGIN_...
pueden
ser indentados para indicar que pertenecen a un elemento
determinado.
Si usted encuentra que el uso de un simbolo diferente para una
sub-lista (que el usado para el actual nivel de lista) mejora la
legibilidad, personalizar La variable
org-list-demote-modify-bullet
. Para obtener una mayor diferencia
de indentacion entre los elementos y sus subtemas, Personalice
org-list-indent-offset
.
Los siguientes comandos actúan sobre elementos cuando el cursor
está en la primera Línea de un elemento (la línea con la viñeta o
el número). Algunos de ellos implican la aplicación de reglas
automáticas para mantener la estructura de la lista intacta. Si
algunas de estas acciones incomodan su uso, configure
org-list-automatic-rules
para desactivarlas de forma individual.
TAB
(org-cycle
)
Todos los elementos se pueden plegar al igual que los
encabezados. Normalmente esto funciona sólo si el cursor está en
un elemento de lista sin formato. Para más detalles, vea la
variable org-cycle-include-plain-lists
. Si esta variable se
establece en integrate
, elementos de la lista serán tratados
como encabezados de bajo nivel. El nivel de un elemento es dado
por la indentacion de la viñeta/número. Los elementos estan
siempre subordinados a los encabezados reales, sin embargo; las
jerarquías quedan completamente separadas. En un nuevo elemento
sin texto, sin embargo, el primer TAB
marca el elemento como a
un hijo del anterior. Posteriores TAB
’s mueven el elemento a
niveles significativos en la lista y, finalmente, regresa de
nuevo a su posición inicial.
M-RET
(org-insert-heading
)
Insertar elemento nuevo en nivel actual. Con el argumento prefijo, fuerza un nuevo encabezado (ver Structure editing). Si utiliza este comando en medio de un elemento, ese elemento se divide en dos, y la segunda parte se convierte en el nuevo elemento[fn:19]. Si este comando es ejecutado antes del cuerpo del elemento, se crea el nuevo elemento antes de el actual.
M-S-RET
Inserte un elemento nuevo con una casilla de verificación ( ver Checkboxes).
S-up
S-down
Saltar al anterior/siguiente elemento en la lista
actual[fn:20], pero sólo si org-support-shift-select
está
apagado. Si no, usted puede seguir utilizando los comandos de
salto de párrafo como C-up
y C-down
con un efecto bastante
similar.
M-up
M-down
Mueva el elemento incluidos subelementos arriba/abajo[fn:21] (intercambia con el elemento anterior/siguiente de la misma indentacion). Si la lista está ordenada, la renumeracion es automática.
M-left
M-right
Reducir/aumentar la indentacion de un elemento, dejando a los hijos solos.
M-S-left
M-S-right
Reducir/aumentar la indentacion del elemento, incluidos subelementos. Inicialmente, el árbol de elementos se selecciona en base a la indentación actual. Cuando estos comandos se ejecutan varias veces en sucesión directa, la región inicialmente seleccionada es usada, incluso si la nueva indentacion implica una jerarquía diferente. Para usar la nueva jerarquía, rompa la cadena de comando con un movimiento del cursor más o menos.
Como caso especial, el uso de este comando en el primer elemento
de una lista moverá la lista entera. Este comportamiento se
puede desactivar configurando org-list-automatic-rules
. La la
indentación global de una lista no tiene ninguna influencia
sobre el texto después de la lista.
C-c C-c
Si hay una casilla de verificación (ver Checkboxes) en la línea del elemento, cambio el estado de la casilla de verificación. En cualquier caso, verifica viñetas e indentacion consistente en la lista entera.
C-c -
Rotar el estilo de marcador de toda la lista (‘-‘, ‘+’, ‘*’,
‘1.’, ‘1)’) o un subconjunto de estos, dependiendo de
org-plain-list-ordered-item-terminator
, el tipo de lista, y su
indentacion. Con un argumento prefijo numérico N, seleccione el
N-enésimo marcador de esta lista. Si hay una región activa
cuando es llamado, el texto seleccionado se transforma en un
elemento. Con el argumento prefijo, todas las líneas se
convertirán a la lista de elementos. Si la primera línea ya era
un elemento de lista, cualquier marcador de elemento será
eliminado de la lista. Por último, incluso sin una región
activa, una línea normal se convierte en un elemento de lista .
C-c *
Convierte un elemento de la lista en un encabezado (de modo que se convierte en un subencabezado en su ubicacion). Vea Structure editing, para una explicación detallada.
C-c C-*
Convierte toda la lista en un subárbol del encabezado actual. Las casillas de verificación (ver Checkboxes) se convertirán en elementos TODO (respectivamente DONE cuando esten marcados).
S-left/right
Este comando también rota el estilo de marcador cuando el cursor
esta en el marcador o cualquier parte de una línea de elemento,
los detalles dependen de org-support-shift-select
.
C-c ^
Ordene la lista. Se le pedirá el metodo para la clasificación: numéricamente, por orden alfabético, por fecha, por estado de marcado para listas de control, o por una función personalizada.
A veces se desea mantener información asociada a una entrada, pero que normalmente no se quiere mostrar. Para ello, el modo Org tiene cajones. Pueden contener cualquier cosa menos un encabezado y otro cajón. Los cajones se ven así:
** Este en un encabezado Aun fuera del cajon :NOMBREDECAJON: Este es el interior del cajon. :END: Despues del cajon.
Se pueden insertar cajones en el punto de forma interactiva
llamando a org-insert-drawer
, que está ligado a C-c C-x d
. Con
una región activa, este comando pondrá la región dentro del
cajón. Con un Argumento prefijo, este comando llamara a
org-insert-property-drawer
y añadira un cajón de propiedad justo
debajo del encabezado actual. La terminacion de palablas clave
también es posible mediante el uso de M-TAB
.
La visibilidad ciclica (ver Visibility cycling) en el encabezado lo
hará ocultar y mostrar la entrada, pero mantendra el cajón
colapsado en sola linea. Con el fin de observar el interior del
cajón, necesita para mover el cursor a la línea del cajón y
presionar allí TAB
. El modo Org utiliza el cajon PROPERTIES
para almacenar las propiedades (ver Properties and columns), y
también se puede organizar para las notas de cambio de estado (ver
Tracking TODO state changes) y los tiempos de reloj (ver Clocking
work time) para almacenar en un cajón LOGBOOK
. Si desea guardar
un nota rápida en el cajón LOGBOOK
, de una manera similar a
declarar cambios, el uso es
C-c C-z
Añadir una nota con fecha y hora a el cajón LOGBOOK
.
Se puede seleccionar el nombre de los cajones que deben ser
exportados con org-export-with-drawers
. En ese caso, el contenido
del cajón aparecera en la salida exportada. Los cajones de
propiedad no son afectados por esta variable: en su lugar configure
org-export-with-properties
.
El modo Org utiliza bloques begin…end para diversos fines para
incluir ejemplos de código fuente (ver Literal examples) para
capturar información de la hora de registro (ver Clocking work
time). Estos bloques se pueden plegar y desplegar presionando TAB
en la línea de inicio. Puedes también obtener todos los bloques
plegados al arranque mediante la configuración de la opción
org-hide-block-startup
o por fichero utilizando
#+STARTUP: hideblocks #+STARTUP: nohideblocks
El modo Org soporta la creación de notas al pie. En contraste con
el paquete footnote.el
, las notas del modo Org están diseñadas
para trabajar en documentos más grandes, no sólo para documentos de
un solo uso, como mensajes de correo electrónico.
Una nota al pie se inicia con un marcador de nota entre corchetes en lo columna 0, la indentacion no esta permitida. Finaliza con la siguiente definición de nota al pie, encabezado, o después de dos líneas consecutivos en blanco. La referencia de nota es un simplemente marcador entre corchetes, dentro del texto. Por ejemplo:
La pagina de inicio de Org[fn:1] ahora se ve mucho mejor que de costumbre ... [fn:1] El enlace es: http://orgmode.org
El modo Org extiende la sintaxis basada en números a notas con nombre y definición opcional en la misma línea. El uso de números simples como marcadores (como hace footnote.el) es soportado por compatibilidad hacia atrás, pero no animado debido a posibles conflictos con fragmentos LaTeX (véase Embedded LaTeX). Aquí están las referencias válidas:
[1]
Un simple marcador numérico de la nota. Compatible con
footnote.el
, pero no es recomendable debido que algo como
[1]
podría ser fácilmente parte de un fragmento de código.
[fn:nombre]
Una nota con nombre como referencia, donde nombre
es una
etiqueta única, o, por simplicidad de la creación automática, un
número.
[fn:: Esta es una definicion de nota dentro de la linea]
Una nota anónima como en LaTeX donde se indica la definición directamente en el punto de referencia.
[fn:nombre: una definicion]
Una definición de nota dentro de línea, que también especifica
un nombre para la nota. Org permite múltiples referencias a la
misma nota, puede utilizar [fn:nombre]
para crear referencias
adicionales.
Las etiquetas de nota se pueden crear de forma automática, o puede
crear nombres usted mismo. Esto es manejado por la variable
org-footnote-auto-label
y su correspondiente palabra clave en
#+STARTUP
. Vea la cadena de documentación de esa variable para
obtener más información.
El siguiente comando se encarga de las notas:
C-c C-x f
El comando acciona nota al pie.
Cuando el cursor está en una referencia de nota, salta a la definición. Cuando se está en una definición, salta a la (primera) referencia.
De otro modo, crear una nota nueva. Dependiendo de la opción
org-footnote-define-inline
[fn:22], la definición será
colocado a la derecha en el texto como parte de la referencia, o
por separado en el lugar determinado por la opción
org-footnote-section
.
Cuando este comando se llama con el argumento prefijo, se ofrece un menú de opciones adicionales:
s
Ordena las definiciones de nota por secuencia de referencia
Durante la edicion, Org no hace ningun enfuerzo por ordenar las definiciones de nota en una secuencia en particular
Si desea el ordenamiento, utilice este comando, que lo hara deacuerdo con
org-footnote-section
.El ordenamiento automatico depues de cada insercion/eliminacion se puede configurar mediante la opcion
org-footnote-auto-adjust
.r
Renumerar referencias de notas simples
fn:N
La renumeracion automatica depues de cada insercion/eliminacion se puede configurar mediante la opcion
org-footnote-auto-adjust
.S
Ordenamiento primero
r
, luegos
.n
Normaliza las notas mediante la recopilacion de todas las definiciones (incluyendo las definiciones en linea) en una seccion especial, y a continuacion, se enumera por secuencia.
Las referencias pasaran entonces a ser numeros.
Esto esta destinado a ser el pasa final antes de terminar un documento (por ejemplo, el envio de un correo electronico).
d
Eliminar la nota en el punto, y todas las definiciones y referencias a esta.
Dependiendo de la variable org-footnote-auto-adjust
[fn:23],
la renumeración y clasificación de las notas puede ser
automática después de cada inserción o eliminacion.
C-c C-c
Si el cursor está en una referencia de nota, saltar a la
definición. Si se trata de una definición, salta de nuevo a la
referencia. Cuando se llama detro de una nota con el argumento
prefijo, ofrecen el mismo menú que C-c C-x f
.
C-c C-o or mouse-1/2
Las etiquetas de nota también son enlaces a la correspondiente definición/referencia, y puede utilizar los comandos habituales a seguir estos enlaces.
C-c '
Editar la definición nota correspondiente a la referencia en
punto en una ventana separada. Esto puede ser conveniente si
edita notas en un búfer estrecho. La ventana se puede cerrar
Presionando C-c '
.
Si le gusta la forma intuitiva en que el modo Org estructura la
edicion y el formato de trabajo listado, es posible que desee
utilizar estos comandos en otros modos como el modo texto o también
el modo de correo. El modo menor orgstruct-mode
lo hace
posible. Seleccione el modo con M-x orgstruct-mode RET
o
activelo por defecto, por ejemplo en modo Message, con uno
de:
(add-hook 'message-mode-hook 'turn-on-orgstruct)
(add-hook 'message-mode-hook 'turn-on-orgstruct++)
Cuando este modo está activo y el cursor está en una línea que se parece a un encabezado Org o a la primera línea de un elemento de lista, la mayoría de comandos de edición de la estructura va a funcionar, incluso si las mismas combinaciones normalmente tienen una funcionalidad diferente en el modo mayor que está usando. Si el cursor no está en una de esas líneas especiales, el modo Orgstruct acecha silenciosamente en las sombras.
Cuando se utiliza orgstruct++-mode
, Org también exporta la
indentacion Y ajustes de autocompletado en ese modo, y detecta el
contexto del elemento después la primera línea de un elemento.
También puede utilizar la edición de estructura de Org para plegar
y desplegar encabezados en cualquier archivo, siempre que haya
definido en orgstruct-heading-prefix-regexp
: la expresión regular
que debe coincidir con el prefijo local a utilizar antes de los
encabezados Org. Por ejemplo, Si establece esta variable a “;; ” en
los archivos de Emacs Lisp, sera capas de plegar y desplegar
encabezados en Emacs Lisp por líneas comentadas. Algunos comandos
como org-demote
se desactivan cuando el prefijo está establecido,
pero el plegado/desplegado funcionará correctamente.
Un documento de referencia que proporciona una descripción formal
de la sintaxis de Org está disponible como un borrador en Worg,
escrito y mantenido por Nicolás Goaziou. Define los principales
conceptos internos de Org como encabezados
, secciones
,
palabras clave asociadas
, (mayores) Elementos
y objetos
. Cada
parte de un fichero Org cae en una de las categorías anteriores.
Para explorar la estructura abstracta de un búfer Org, ejecute esto en un buffer:
M-: (org-element-parse-buffer) RET
Se dará salida a una lista con el contenido del buffer representado como una estructura abstracta. El motor de exportación se basa en la información almacenada en esta lista. La mayoría de los comandos interactivos (por ejemplo, para la edición de estructura) también se basan en el sentido sintáctico al rededor del contexto.
Puede verificar la sintaxis de sus documentos utilizando el comando
org-lint
.
Org viene con un editor de tablas rápido e intuitivo. Con calculos
como los de una hoja de cálculo soportados por el paquete Emacs
calc
(ver Calc en Gnu Emacs Calculator Manual).
• Editor de tablas incorporado: | Tablas sencillas |
• Ancho de columna y alineación: | Anular los ajustes automaticos |
• Grupos de columnas: | Agrupación para activar líneas verticales |
• Modo Orgtbl: | El editor de tablas como modo menor |
• La hoja de cálculo: | El editor de tablas tiene capacidades de hoja de cálculo |
• Org-Plot: | Graficos de las tablas org |
Org facilita la creacion de tablas en formato ASCII. Cualquier línea con ‘|’ como primer caracter no-blanco se considera parte de una tabla. ‘|’ es también el separador de columna[fn:24]. Una tabla podría parecerse a esto:
| Nombre | Teléfono | Edad | |--------+----------+------| | Peter | 1234 | 17 | | Anna | 4321 | 25 |
Una tabla se re-alinea automáticamente cada vez que se pulsa TAB
o RET
o C-c C-c
dentro de la tabla. TAB
también mueve el
punto al siguiente campo (RET
a la siguiente fila) y crea nuevas
filas al final de la tabla o antes de las líneas horizontales. La
indentacion de la tabla es establecida por la primera
línea. Cualquier línea que inicia con ‘|-’ es considerada como una
línea de separación horizontal y se ampliará en la próxima
re-alineacion a todo el ancho de la tabla. Por lo tanto, para crear
la tabla anterior, sólo tendría que escribir
| Nombre | Teléfono | Edad | |-
luego pulse TAB
para alinear la tabla y empezar a rellenar
campos. Seria aún más rápido escribir |Nombre|Teléfono|Edad
seguido por C-c RET
.
Al escribir texto en un campo, Org trata a DEL
, Backspace
y
todas las teclas de una forma especial, por lo que la inserción y
eliminación evita el cambio de otros campos. Además, al escribir
inmediatamente después de que el cursor se a movido a un nuevo
campo con =TAB=, =S-TAB= o =RET=, este es creado automaticamente
en blanco. Si este comportamiento es demasiado impredecible para
usted, configure las opciones org-enable-table-editor
y
org-table-auto-blank-field
.
C-c |
(org-table-create-or-convert-from-region
)Convierte la región activa a una tabla. Si cada línea contiene al menos un carácter
TAB
, la función asume la divicion por tabuladores. Si cada línea contiene una coma, los valores separados por comas (CSV
) son asumidos. Si no, las líneas estan separadas por los espacios en blanco en los campos. Puede utilizar un argumento prefijo para forzar un separador específico:C-u
fuerzaCSV
,C-u C-u
fuerzaTAB
,C-u C-u C-u
pedirá una expresión regular para que coincida con el separador, y un argumento numéricoN
indica almenosN
espacios consecutivos, o como alternativaTAB
será el separador.Si no hay una región activa, este comando crea una tabla Org vacía. Pero es más secillo sólo comenzar a escribir, como en
|Nombre|Teléfono|Edad RET |- TAB
.
C-c C-c
(org-table-align
)Re-alinear tabla y no pasar a otro campo.
C-c SPC
(org-table-blank-field
)Limpiar el campo en el punto.
<TAB>
(org-table-next-field
)Re-alinear, pasar al siguiente campo. Crea una nueva fila si es necesario.
S-TAB
(org-table-previous-field
)Re-alinear, pasar al campo anterior.
RET
(org-table-next-row
)Re-alinear y pasar a la fila siguiente. Crea una nueva fila si es necesario. Al inicio o al final de una línea,
RET
ejecutaNEWLINE
(nueva linea), por lo que se puede utilizar para dividir una tabla.M-a
(org-table-beginning-of-field
)Mover al inicio del campo actual, o si se esta hay ir al del campo anterior.
M-e
(org-table-end-of-field
)Mover al final del campo actual, o si se esta hay ir siguiente campo.
M-left
(org-table-move-column-left
)M-right
(org-table-move-column-right
)Mover la columna actual a la izquierda/derecha.
M-S-left
(org-table-delete-column
)Matar la columna actual.
M-S-right
(org-table-insert-column
)Insertar una nueva columna a la izquierda de la posición del cursor.
M-up
(org-table-move-row-up
)M-down (=org-table-move-row-down
)Mover la fila actual hacia arriba/abajo.
M-S-up
(org-table-kill-row
)Matar la fila actual o la línea horizontal.
M-S-down
(org-table-insert-row
)Insertar una nueva fila encima de la fila actual. Con el argumento prefijo, la línea se crea debajo de la actual.
C-c -
(org-table-insert-hline
)Insertar una línea horizontal debajo de la fila actual. Con un prefijo argumento, la línea se crea por encima de la línea actual.
C-c RET
(org-table-hline-and-move
)Insertar una línea horizontal debajo de la fila actual y mover el cursor a la fila debajo de esa línea.
C-c ^
(org-table-sort-lines
)Ordena las líneas de la tabla en la región. La posición de punto indica la columna para ser utilizado para la clasificación, y el rango de líneas es el rango entre el separador horizontal más cercano a las líneas, o toda la tabla. Si el punto está antes de la primera columna, se le pedirá la columna de la clasificación. Si hay una región activa, la marca especifica la primera línea y la columna de clasificación, mientras que el punto debe estar en la última línea que se incluirán en la ordenacion. El comando solicita el tipo de clasificación (alfabéticamente, numéricamente, o por tiempo). Usted puede ordenar en orden normal o inverso. También puede proporcionar su propia funcion de extracción y comparación. Cuando se llama con un prefijo argumento, la clasificación alfabética distinguira entre mayúsculas y minúsculas.
C-c C-x M-w
(org-table-copy-region
)Copiar una región rectangular de una tabla a un portapapeles especial. Punto y marca determinan campos dentro del margen del rectángulo. Si no hay una región activa, copia sólo el campo actual. El proceso ignora líneas de separación horizontales.
C-c C-x C-w
(org-table-cut-region
)Copiar una región rectangular de una tabla a un portapapeles especial, y vaciar todos los campos en el rectángulo. Así que esta es la operación “corte”.
C-c C-x C-y
(org-table-paste-rectangle
)Pegar una región rectangular en una tabla. La esquina superior izquierda termina en el campo actual. Todos los campos involucrados serán sobrescritos. Si el rectángulo no se ajusta a la actual tabla, la tabla se amplía según sea necesario. El proceso ignora líneas de separación horizontales.
M-RET
(org-table-wrap-region
)Dividir el campo actual en la posición del cursor y mover el resto a la línea de abajo. Si hay una región activa, y ambos punto y marca están en la misma columna, el texto de la columna es envuelto con ancho mínimo para el determinado número de líneas. Un argumento numérico prefijo se puede utilizar para cambiar el número de líneas deseadas. Si no hay ninguna región, pero se especifica un argumento prefijo, el campo actual se vacia, y su contenido es anexado al campo de arriba.
C-c +
(org-table-sum
)Suma los números en la columna actual, o en el rectángulo definido por la región activa. El resultado se muestra en el área de eco y se puede insertar con C-y.
S-RET
(org-table-copy-down
)Cuando el campo actual está vacío, copia del primer campo superior no vacío. Cuando no está vacío, copia el campo actual a la siguiente fila y moeve el cursor junto con él. Dependiendo de la opción
org-table-copy-increment
, un valor entero dentro del campo será incrementado durante la copia. Los valores enteros que son demasiado grandes no serán incrementados. También, un argumento prefijo0
deshabilita temporalmente el incremento. Esta combinacion también se utiliza para el cambio de seleccion y modos relacionados (ver [[Conflicts] [Conflicto]]).
C-c `
(org-table-edit-field
)Edita el campo actual en una ventana separada. Esto es útil para campos que no son completamente visibles (véase Column width and alignment). Cuando se llama con el prefijo
C-u
, el campa es visible por completo, de modo que pueda ser editado en su posicion. Cuando se llama con dos prefijosC-u
, hace que la ventana del editor siga al cursor a través de la tabla y siempre muestre el campo actual. El modo de seguimiento finaliza automáticamente cuando el cursor sale de la tabla, o repitiendo este comando conC-u C-u C-c `
.M-x org-table-import RET
Importar un archivo como una tabla. La tabla debe tener separadores
TAB
o espacios en blanco. Utilice, por ejemplo, para importar una hoja de cálculo o una tabla de datos de una base de datos, debido a que estos programas en general, escriben archivos de texto separados por tabuladores. Este comando funciona mediante la inserción del archivo en el buffer y luego la conversión de la región a una tabla. Cualquier argumento prefijo se pasa al convertidor, que lo utiliza para determinar el separador.C-c |
(org-table-create-or-convert-from-region
)Las tablas también pueden ser importados con pegado de texto tabular dentro del buffer Org, seleccionando el texto pegado con
C-x C-x
y luego utilizando el comandoC-C |
(ver arriba debajo de Creacion y conversion).M-x org-table-export RET
Exportar la tabla, por defecto como un archivo con separadores
TAB
. Empleado para intercambio de datos con, por ejemplo, una hoja de cálculo o un programa de base de datos. El formato utilizado para exportar el archivo se puede configurar en la opciónorg-table-export-default-format
. Usted ademas puede tener propiedadesTABLE_EXPORT_FILE
yTABLE_EXPORT_FORMAT
para especificar el nombre del archivo y el formato de exportación de tabla en un subárbol. Org es compatible con formatos bastante generales para la exportación de tablas. El formato exportador es el mismo que el formato utilizado por tablas de radio Orgtbl, ver Translator functions, para una detallada descripción.
Si no le gusta el editor de tablas automático porque obstaculiza el manejo en líneas que le gustaría iniciar con ‘|’, puede apagarlo con
(setq org-enable-table-editor nil)
En ese momento el único comando de tabla que aun funciona es C-c
C-c
para realizar un re-alineamiento manual.
El ancho de las columnas se determina automáticamente por el editor de tablas. Y también se determina la alineación de una columna automáticamente por la fracción de campos como numeros contra las columnas con campos no numericos.
En ocaciones, un unico campo o algunos campos necesitan llevar más
texto, que conducen a columnas de un ancho inconveniente. Quizás
desea crear una tabla con varias columnas con anchura fija,
independientemente de contenido. Para configurar[fn:25] el ancho de
una columna, un campo en cualquier lugar de la columna puede
contener sólo la cadena ’<N>
’ donde ’N
’ es un número entero que
especifica la anchura de la columna en caracteres. La próxima
re-alineacion establece el ancho de esta columna a este valor.
|---+------------------------------| |---+--------| | | | | | <6> | | 1 | one | | 1 | one | | 2 | two | ----\ | 2 | two | | 3 | This is a long chunk of text | ----/ | 3 | This=> | | 4 | four | | 4 | four | |---+------------------------------| |---+--------|
Los campos que son más anchos quedan recortados y terminan con la
cadena ’=>
’. Tenga en cuenta que el texto completo se encuentra
aun en el buffer, pero esta oculto. Para ver el texto completo,
mantenga el puntero del ratón sobre el campo – una ventana
informacion mostrará el contenido completo. Para editar este campo,
utilice el comando C-c `
(es decir C-c
seguido del acento
grave). Esto abrirá una nueva ventana con el campo
completo. Editelo y finalice con C-c C-c
.
Cuando visite a un archivo que contiene una tabla con columnas
estrechas, el carácter de ocultacion no estara presente, y sera
necesario re-alinear la tabla para que se muestre
correctamente. Configure la opción org-startup-align-all-tables
si desea realinear todas las tablas en un archivo al visitarlo,
pero esto puede reducir la velocidad de arranque. También puede
establecer esta opción en función de cada archivo con:
#+STARTUP: align #+STARTUP: noalign
Si desea hacer caso omiso de la alineación automática a la derecha
de columnas con muchos campos numericos y a la izquierda de
columnas con campos de texto, puede usar ’<r>
’, ’<c>
‘[fn:26] o
’<l>
’ de maneras similares. También puede combinar la alineación
y el ancho de campo de esta manera: ’<R10>
’.
Las líneas que sólo contienen estas cookies de formato serán eliminadas automáticamente al exportar el documento.
Cuando Org exporta tablas, lo hace de forma predeterminada sin
líneas verticales ya que es visualmente más satisfactorio en
general. Ocasionalmente, sin embargo, las líneas verticales pueden
ser útiles para estructurar una tabla en grupos de columnas, de
igual forma las líneas horizontal pueden formar grupos de
filas. Con el fin de especificar los grupos de columnas, puede
utilizar una fila especial donde el primer campo contiene sólo
’/
’. Los otros campos pueden contener bien ’<
’ para indicar que
esta columna debe comenzar un grupo, ’>
’ para indicar el final de
una columna o ’<>
’ (sin espacio entre ’<
’ y ’>
’) para hacer
de una columna su propio grupo. Los límites entre los grupos de
columnas son marcados con líneas verticales durante la
exportación. Aquí hay un ejemplo:
| N | N^2 | N^3 | N^4 | ~sqrt(n)~ | ~sqrt[4](N)~ | |---+-----+-----+-----+-----------+--------------| | / | < | | > | < | > | | 1 | 1 | 1 | 1 | 1 | 1 | | 2 | 4 | 8 | 16 | 1.4142 | 1.1892 | | 3 | 9 | 27 | 81 | 1.7321 | 1.3161 | |---+-----+-----+-----+-----------+--------------| #+TBLFM: $2=$1^2::$3=$1^3::$4=$1^4::$5=sqrt($1)::$6=sqrt(sqrt(($1)))
También es suficiente para solo colocar el inicio del grupo de columnas después de cada línea vertical que le gustaría tener:
| N | N^2 | N^3 | N^4 | sqrt(n) | sqrt[4](N) | |----+-----+-----+-----+---------+------------| | / | < | | | < | |
Si te gusta la forma intuitiva en que funciona el editor de tablas
de Org, es posible que También quiera utilizarlo en otros modos
como el modo texto o en modo Mail. El modo menor Orgtbl lo hace
posible. Siempre se puede activar con M-x orgtbl-mode RET
. Para
activarlo de forma predeterminada, para ejemplo en el modo de
mensaje, utilice
(add-hook 'message-mode-hook 'turn-on-orgtbl)
Ademas, con un poco de configuración especial, es posible manejar tablas de sintaxis arbitraria con el modo Orgtbl. Por ejemplo, es posible construir tablas LaTeX con la comodidad y poder del modo Orgtbl, incluyendo capacidades de hoja de cálculo. Para mas detalles, ver Tables in arbitrary syntax.
El editor de tablas hace uso del paquete calc
de Emacs para
implementar capacidades de hoja de cálculo. También puede evaluar
formulas Emacs Lisp para derivar campos de otros campos. Si bien
todas las funciones, que Org implementa no son idénticas a otras
hojas de cálculo. Por ejemplo, Org conoce el concepto de una
fórmula en columna que será aplicada a todos los campos de una
columna exeptuando la cabecera sin tener que copiar la fórmula para
cada campo correspondiente. También hay un depurador y un editor de
fórmulas con las características para destacar campos de la tabla
correspondiente a las referencias en el punto en la fórmula,
moviéndose estas referencias por las teclas de flecha
• Referencias: | Camo hacer referencia a otro campa o rango |
• Sintaxis de formula para calc: | Usando Calc para calcular cosas |
• Sintaxis de formula para Lisp: | Escribir fórmulas en Emacs Lisp |
• Valores de duracion y tiempo: | Cómo calcular valores de duraciones y tiempo |
• Campos y rangos de formulas: | Fórmula para (rangos de) campos específicos |
• Formulas de columna: | Fórmulas válidas para una columna completa |
• Funciones de busqueda: | Funciones de búsqueda para buscar en tablas |
• Edicion y depuracion de formulas: | Correcion de fórmulas |
• Actualizacion de la tabla: | Recalcular todos los campos dependientes |
• Funciones avanzadas: | Nombres de campo y columna, parámetros y recálculo automático |
Para calcular campos de la tabla apartir de otros campos, las
fórmulas deben referencia a otros campos o rangos. En Org, los
campos pueden ser referenciados por nombre, por coordenadas
absolutas, y por coordenadas relativas. Para averiguar las
coordenadas de un campo, en dicho campo pulse C-c ?
, o pulse
C-c }
para alternar la visualización de cuadrícula.
Las fórmulas pueden hacer referencia al valor de otro campo de
dos formas. Al igual que en cualquier otra hoja de cálculo, puede
hacer referencia a los campos con una combinacion de letra/número
como B3
, es decir, el segundo campo en la tercera fila. Sin
embargo, Org da prioridad[fn:27] a otra, representación más
general que tiene para tal aspecto:
@row$column
La especificacion column (columna) puede ser absoluta como $1
,
$2
,… $N
, o con relación a la columna actual (es decir, la
columna del campo que está siendo calculado) como $+1
o
$-2
. $<
y $>
son referencias inmutables a la primera y la
última columna, respectivamente, y se puede usar $>>>
para
indicar la tercera columna de la derecha.
La especificación row (fila) sólo cuenta las líneas con datos e
ignora líneas de separación horizontales (hlines). Al igual que
con las columnas, puede utilizar números de fila absolutos @1
,
@2
,… @N
y números de fila con respecto a la fila actual
como @+3
o @-1
. @<
y @>
son referencias inmutables la
primera y última[fn:28] fila de la tabla, respectivamente.
También puede especificar la fila relativa a uno de los hlines:
@I
se refiere al primera hline, @II
al segundo, etc. @-I
se
refiere a la primera línea por encima de la línea actual, @+I
a
la primera línea debajo de la línea actual. También puede
escribir @III+2
que es la segunda línea de datos después de la
tercera hline en la tabla.
@0
y $0
hacen referencia a la fila y columna actual,
respectivamente, es decir, a la fila/columna para el campo que
esta siendo calculado. Además, si omite la parte de la referencia
o bien a la columna o a la fila, esta implicita la fila/columna
actual.
Las referencias Org con números sin signo son referencias fijas en el sentido de que si se utiliza la misma referencia en la fórmula en dos campos diferentes, se hará referencia a un mismo campo cada ocacion. Las Referencias Org con números con signo son referencias flotantes ya que el mismo operador de referencia puede hacer referencia a diferentes campos dependiendo del campo que esta siendo calculado por la fórmula.
Aquí están algunos ejemplos:
@2$3 segunda fila, tercera columna (igual que C2) $5 columna 5 de la fila actual (igual que E&) @2 columna actual, fila 2 @-1$-3 el campo una fila hacia arriba, tres columnas a la izquierda @-I$2 campo debajo del hline encima de la fila actual, la columna 2 @>$5 campo en la última fila, en la columna 5
Usted puede hacer referencia a un rango rectangular de campos
mediante la especificación de dos referencias de campo conectadas
por dos puntos ’..
’. Si ambos campos se encuentran en la fila
actual, puede usar simplemente ’$2..$7
’, pero si al menos un
campo se encuentra en una fila diferente, es necesario utilizar
el formato general @fila$columna
al menos para el primer campo
(es decir, la referencia debe comenzar con ’@
’ para ser
interpretado correctamente). Ejemplos:
Los rangos de referencias devuelven un vector de valores que
pueden alimentar funciones vectoriales detro de Calc. Dentro de
un rango los campos vacíos son normalmente suprimidos, de modo
que el vector contiene sólo los campos no-vacíos. Para otras
opciones con el modo alterno ’E
’, ’N
’ y ejemplos vea Formula
syntax for Calc.
Una de las primeras acciones durante la evaluación de fórmulas
Calc y fórmulas Lisp es sustituir @#
y $#
en la fórmula con
el número de fila o columna del campo donde ira el resultado. Los
tradicionales equivalentes de fórmulas Lisp son
org-table-current-dline
y org-table-current-column
.
Ejemplos:
if(@# % 2, $#, string(""))
Insertar el número de columna en las filas impares, establecer campo como vacio en todas las filas iguales.
$2 = '(identity remote(FOO, @@#$1))
Copiar texto o valores de cada fila de la columna 1 de la tabla denominada
FOO
en la columna 2 de la tabla actual.@3 = 2 * remote(FOO, @1$$#)
Inserta el valor duplicado de cada columna de la fila 1 de la tabla llamada
FOO
en la fila 3 de la tabla actual.
Para el segundo/tercer ejemplo, la tabla denominada FOO
debe
tener al menos tantas filas/columnas como la tabla actual. Tenga
en cuenta que esto es ineficiente[fn:29] para gran número de
filas/columnas.
‘$nombre
’ se interpreta como el nombre de una columna,
parametro o constante. Las constantes se definen a nivel global a
traves de la opcion org-table-formula-costants
, y localmente
(para el archivo) a traves de una linea como
#+CONSTANTS: c=299792458. pi=3.14 eps=2.4e-6
Las propiedades también (ver Properties and columns) se pueden
utilizar como constantes en fórmulas de tabla: para una propiedad
’:Xyz:
’ utilice el nombre $PROP_Xyz
, y la propiedad se
buscará en la la entrada de esquema actual y en la jerarquía por
encima de ella. Si usted tiene el paquete constants.el
, también
se utilizará para resolver constantes, incluyendo las constantes
naturales como ’$h
’ de la constante de Planck, y unidades como
’$km
’ de kilómetros[fn:30]. Los nombres de columna y parámetros
se pueden especificar en líneas de tabla especiales. Estos son se
describe a continuación, vea Advanced features. Todos los nombres
deben empezar con una letra, y componerse de letras y números
adicionales.
También puede hacer referencia a constantes, campos y rangos de una tabla distinta, ya sea en el archivo actual o incluso en archivos diferentes. La sintaxis es
remote(NOMBRE-O-ID,REF)
donde NOMBRE puede ser el nombre de una tabla en el archivo
actual establecida con una linea #+NAME: Nombre
antes de la
tabla. También puede ser la ID de una entrada, incluso de un
archivo diferente, y la referencia a continuación, se refiere a
la primera tabla en esa entrada. REF es un campo absoluto o
referencia de rango como se ha descrito anteriormente para el
ejemplo @3$3
o $algunnombre
, válido en la tabla referenciada.
Indirección de NOMBRE-O-ID: Cuando NOMBRE-O-ID tiene el formato
@FILA$COLUMNA
será sustituido por el nombre o ID encontrado en
dicho campo de la tabla actual. Por ejemplo remote($1, @>$2)
>
=remote(year_2013, @>$1)
. El formato B3
no es compatible
porque no se puede distinguir de un nombre simple de tabla o ID.
Una fórmula puede ser cualquier expresión algebraica entendida por
el paquete Calc de Emacs. Tenga en cuenta que calc tiene la
convención no estándar que ’/
’ tiene precedencia más baja que
’*
’, por lo que ’a/b*c
‘se interpreta como ’a/(b*c)
’. Antes
de la evaluación por calc-eval
(véase Calling Calc from Your
Lisp Programs en el manual de GNU Emacs Calc), la sustitución de
variables se lleva a cabo de acuerdo a las reglas descritas
arriba. Los vectores de rango pueden ser alimentados directamente
en el vector de funciones Calc como ’vmean
’ y ’vsum
’.
Una fórmula de modo opcional puede contener una cadena después de
un punto y coma. Esta cadena se compone de banderas para influir
en Calc y otros modos durante la ejecución. De forma
predeterminada, Org utiliza los modos estándar de Calc (precisión
12, unidades de grados angulares, fracciones y modos simbólicos
desactivados). El formato de visualización, sin embargo, se ha
cambiado a (float 8)
para mantener tablas compactas. Los ajustes
por defecto pueden ser configurados mediante la opción
org-calc-default-modes
.
Lista de modos:
p20
Ajusta el cálculo interno Calc a 20 dígitos de precisión.
n3
,s3
,e2
,f4
Resultado de Calc pasado de nuevo a Org normal, científico, ingeniería o de formato fijo. El formato Calc es de precisión ilimitada, siempre y cuando la precisión de cálculo Calc sea mayor.
D
,R
Modos de angulo de Calc, grados y radianes.
F
,S
Fracción y modos simbólicos de Calc.
T
,t
Duración de cálculos en Calc o Lisp, ver Durations and time values.
E
Si y cómo considerar los campos vacíos. Sin ’
E
’ los campos vacíos en el rango de referencias se suprimen de manera que el vector Calc o la lista Lisp contiene sólo los campos no vacíos. Con ’E
’ los campos vacíos se mantienen. Para los campos vacíos en rangos o referencias de campo el valor ’nan
’ (not a number) se utiliza en fórmulas Calc y la cadena vacía se utiliza para las fórmulas de Lisp. Añadir ’N
’ para usar 0 en ambos tipos de fórmula. Para el valor de un de campo el modo ’N
’ tiene mayor precedencia que ’E
’.N
Interpretar todos los campos como números, utilice 0 para los no números. Vea la siguiente sección para ver cómo esto es esencial para cálculos con Fórmulas Lisp. En las fórmulas Calc se usa sólo ocasionalmente debido a que hay cadenas de números que ya se interpretan como números sin ’
N
’.L
Literal, solamente para fórmulas Lisp. Consulte la siguiente sección.
A menos que utilice números enteros grandes o de alta precisión de
cálculo y -display para los números de punto flotante puede,
proporcionar, alternativamente un especificador de formato
’printf
’ para reformatear el resultado Calc después de que se ha
pasado de nuevo a Org en lugar de dejar a Calc hacer el
formato[fn:31]. Algunos ejemplos:
$1+$2 Suma del primer y segundo campo $1+$2;%.2f Igual, formato de resultado a dos decimales exp($2)+exp($1) Se pueden utilizar funciones matemáticas $0;%.1f Reformatear celda actual a 1 decimal ($3-32)*5/9 Grados F -> conversión a C $c/$1/$cm Hz -> conversión a cm, utilizando constants.el tan($1);Dp3s1 Calcular en grados, precisión 3, mostrar SCI 1 sin($1);Dp3%.1e Igual, pero usar el especificador printf para desplegar taylor($3,x=7,2) Serie de Taylor de $3, para x=7, segundo grado
Calc también contiene un conjunto completo de operaciones lógicas, (ver Logical Operations en GNU Emacs Calc Manual). Por ejemplo
if($1 < 20, teen, string(""))
“teen” si la edad
$1
es inferior a 20, de lo contrario el resultado de campo de la tabla Org se establece en vacio con la cadena vacía.if("$1" == "nan" || "$2" == "nan", string(""), $1 + $2); E f-1
Suma de las dos primeras columnas. Cuando al menos uno de los campos de entrada está vacío el campo de resultado de la tabla Org se establece en vacío. ’
E
’ se requiere para no convertir los campos vacíos a 0. ’f-1
’ es un cadena opcional de formato Calc similar a ’%.1f
’ pero deja vacío el resultado.if(typeof(vmean($1..$7)) == 12, string(""), vmean($1..$7); E
Valor medio de un rango a menos que haya algun campo vacío. Cada campo en el rango que está vacío se sustituye por ’
nan
’ que permite a ’vmean
’ dar por resultado ’nan
’. Despues ’typeof == 12
’ detecta el ’nan
’ de ’vmean
’ y el campo de resultado se establece como vacío. Utilice esto cuando se espera que el conjunto de muestras no tienen valores faltantes.if("$1..$7" == "[]", string(""), vmean($1..$7))
Valor medio de un rango con omicion de campos vacios. Cada campo en el rango que está vacío se salta. Cuando todos los campos en el rango están vacíos el valor medio no está definido y el campo de resultado se establece en vacío. Utilice esto cuando el conjunto de muestras puede tener un tamaño variable.
vmean($1..$7); EN
Para completar el ejemplo anterior: El valor medio de un rango con campos vacíos contandos como muestras con valor 0. Utilice esto sólo cuando grupos de muestras incompletas deban ser rellenados con 0 para muestra de tamaño completo.
Usted puede agregar sus propias funciones de Calc definidas en
Emacs Lisp con defmath
y utilizarlas en la sintaxis de fórmula
para Calc.
También es posible escribir una fórmula en Emacs Lisp. Esto puede ser útil para manipulación de cadenas y estructuras de control, si la funcionalidad de Calc no es suficiente.
Si una fórmula comienza con un apóstrofe seguido por un paréntesis de abertura, a continuación, se evalúa como una forma Lisp. La evaluación debe devolver una cadena o un número. Al igual que con calc fórmulas, puede especificar los modos y el formato de printf después de una punto y coma.
Con formato Emacs Lisp, usted necesita ser consciente de la manera
en que las referencias de campo son interpoladas en una cadena
Lisp. Por defecto, un referencia se interpola como una cadena Lisp
(entre comillas dobles) que contiene el campo. Si usted
proporciona el interruptor de modo ’N
’, todos los elementos
referenciados serán números (campos no numéricos serán cero) e
interpoladados como números de Lisp, sin las comillas. si
proporciona la bandera ’L
’, todos los campos se interpolan,
literalmente, sin las comillas. Es decir, si quiere que una
referencia sea interpretada como una cadena en formato Lisp,
encierra el propio operador de referencia entre comillas dobles,
como ”$3
”. Los rangos se insertan separados por campos de
espacio, por lo que se puede incrustar en sintaxis de lista o
vector.
Aquí hay algunos ejemplos – observe cómo se utiliza el modo ’N
’
cuando se hacen cálculos en Lisp:
'(concat (substring $1 1 2) (substring $1 0 1) (substring $1 2))
Cambia los dos primeros caracteres del contenido de la columna 1.
'(+ $1 $2);N
Sumar columnas 1 y 2, el equivale para Calc es
$1+$2
.'(apply '+ '($1..$4));N
Calcula la suma de las columnas 1 a 4, en Calc es
vsum($1..$4)
.
Si desea calcular valores de tiempo utilice la bandera T
, ya sea
en fórmulas Calc o Elisp:
| Tarea 1 | Tarea 2 | Total | |---------+----------+----------| | 2:12 | 1:47 | 03:59:00 | | 3:02:20 | -2:07:00 | 0.92 | #+TBLFM: @2$3=$1+$2;T::@3$3=$1+$2;t
Los valores de duración necesitan tener el formato HH:MM[:SS]
,
los segundos son opcionales. Con la bandera T
, las duraciones
calculadas se despliegan como HH:MM:SS
(vér la primera fórmula
en el ejemplo anterior). Con la bandera t
, las duraciones
calculadas se despliegan de acuerdo con el valor de la opción
org-table-duration-custom-format
, que por defecto es 'hours
y
mostrará el resultado como una fracción de hora (ver la segunda
fórmula en el ejemplo anterior).
Tambien pueden ser manipulados valores de duración negativos, los números enteros son considerados como segundos en la suma y resta.
Para asignar una fórmula a un campo determinado, escriba
directamente en el campo, precedido por ’:=
’, por ejemplo
’:=vsum(@II..III)
’. Cuando pulsa TAB
o RET
o C-c C-c
con
el cursor aun en el campo, la fórmula se almacena como la fórmula
para este campo, tras evaluar, y el campo actual será reemplazado
por el resultado.
Las fórmulas se almacenan en una línea especial que empiezan con
’#+TBLFM:
’ directamente debajo de la tabla. Si escribe la
ecuación en el cuarto campo de la tercer línea de datos en la
tabla, la fórmula se verá como ’@3$4=$1+$2
’. Al
insertar/borrar/intercambiar columnas y filas con los comandos
apropiados, referencias absolutas (pero no las relativas) las
fórmulas almacenadas se modifican con el fin de todavía hacer
referencia al mismo campo. Para anular esto, en particular en
referencias de rangos, rangos sujetos en los bordes de la tabla
(utilizando @<
, @>
, $<
, $>
), o a hlines utilizando la
notación @I
. La adaptación automática de referencias de campo,
por supuesto, no sucede si edita la estructura de la tabla con los
comandos normales de edición – entonces debe fijar las ecuaciones
a usted mismo.
En lugar de escribir una ecuación en el campo, también puede utilizar el siguiente comando
C-u C-c =
(org-table-eval-formula
)Poner una nueva fórmula para el campo actual. El comando pide una fórmula, la formula se aplica al campo actual, y se almacena en la linea predeterminada ’
#+TBLFM:
’.
El lado izquierdo de una fórmula también puede ser una expresión
especial con el fin de asignar la fórmula a un número de campos
diferentes. No hay una combinacion de teclado para ingresar dicho
rango fórmulas. Para agregarlos, utilice el editor de fórmulas
(ver Editing and debugging formulas) o edite directamente la linea
#+TBLFM:
.
$2=
Fórmula de columna, válida para toda la columna. Esto es tan común que Org trata a estas fórmulas de una manera especial, ver Column formulas.
@3=
Fórmula de fila, se aplica a todos los campos de la fila especificada.
@>=
significa la última fila.@1$2..@4$3=
Fórmula de rango, se aplica a todos los campos en el rango rectangular dado. Esto también puede utilizarse para asignar una fórmula a algunos, pero no todos los campos en una fila.
$name=
Nombre de campo, ver Advanced features.
Al asignar una fórmula a una referencia de columna como $3=
, la
misma fórmula se utilizará en todos los campos de esa columna, con
las muy convenientes excepciones siguientes: (i) Si la tabla
contiene separadores horizontales hlines con filas arriba y abajo,
todo antes de la primera de esas hline se considera parte del
encabezado de tabla y no será modificado por las formulas de
columna. Por lo tanto es obligatorio un encabezado cuando se
utilizan fórmulas de columna y se desea agregar hlines a las filas
del grupo, como por ejemplo para separar una fila total al final
con la suma de las filas de arriba. (ii) Los campos que ya reciben
un valor de una formula de campo/rango son abandonados por las
fórmulas de columna. Estas condiciones hacen muy fácil usar
fórmulas de columna.
Para asignar una fórmula a una columna, escriba directamente en
cualquier campo en la columna, precedido por un signo igual, como
’=$1+$2
’. Cuando pulse TAB
o RET
o C-c C-c
con el cursor
aun en el campo, la fórmula se almacena como la fórmula para la
columna actual, luego se evalua y el campo actual es reemplazado
con el resultado. Si el campo contiene sólo ‘=’, la formula
previamente almacenada se utiliza para esta columna. Para cada
columna, Org sólo tiene presente la fórmula más recientemente
utilizada. En la linea ’#+TBLFM:
’, las fórmulas de columna se
verán como ’$4=$1+$2
’. El lado izquierdo de un fórmula de
columna no puede ser el nombre de la columna, debe ser la
referencia numérica de columna o $>
.
En lugar de escribir una ecuación dentro del campo, también puede utilizar el siguiente comando:
C-c =
(org-table-eval-formula
)Pone una nueva fórmula para la columna actual y reemplaza el campo actual con el resultado de la fórmula. El comando solicita un fórmula, con un valor predeterminado tomado de la línea ’
#+TBLFM
’, lo aplica al campo actual y lo almacena. Con un argumento prefijo numérico (por ejemplo,C-5 C-c =
) el comando se aplicará a los campos consecutivos en la columna actual.
Org tiene tres funciones Emacs Lisp predefinidas para búsquedas en tablas.
- (org-lookup-first VAL S-LIST R-LIST &optional PREDICATE)
Busca el primer elemento
S
en la listaS-LIST
para los que(PREDICATE VAL S)
es
t
; devuelve el valor de la posición correspondiente en la listaR-LIST
.PREDICATE
por defecto esequal
. Tenga en cuenta que los parámetrosVAL
yS
se pasan aPREDICATE
en el mismo orden que los parámetros correspondientes están en la llamada aorg-lookup-first
, dondeVAL
precede aS-LIST
. SiR-LIST
esnil
, el elemento coincidenteS
deS-LIST
se devuelve. - (org-lookup-last VAL S-LIST R-LIST &optional PREDICATE)=
Similar al anterior
org-lookup-first
, pero busca para el ultimo elemento para el quePREDICATE
est
. - (org-lookup-all VAL S-LIST R-LIST &optional PREDICATE)=
Similar a
org-lookup-firts
, pero busca todos los elementos para los quePREDICATE
est
y devuelve todos los valores correspondientes. Esta función puede utilizarse por sí misma en una fórmula, porque devuelve una lista de valores. Sin embargo, las búsquedas potentes se puede construir cuando esta función se combina con otras Funciones Emacs Lisp.
Si los rangos utilizados en estas funciones contienen campos
vacíos, el modo E
para la fórmula debe ser especificado de otra
manera los campos vacíos no se incluirán en S-LIST
y/o R-LIST
que puede, por ejemplo, dar lugar a una asignación incorrecta de
una elemento S-LIST
al elemento correspondiente de R-LIST
.
Estas tres funciones se pueden utilizar para implementar matrices asociativas, conteo de celldas coincidentes, resultados de rango, datos de grupo etc. Para ejemplos prácticos vea este tutorial en Worg.
Puede editar fórmulas individuales en el minibúfer o directamente
en el campo. Org también puede preparar un buffer especial con
todas las formulas activas de una tabla. Cuando ofrece una fórmula
para la edición, Org convierte las referencias al formato estándar
(como B3
o D&
) si es posible. Si prefiere sólo trabajar con el
formato interno (como @3$2
o $4
), configure la opción
org-table-use-standard-references
.
C-c =
orC-u C-c =
(org-table-eval-formula
)Editar la fórmula asociada a la columna/campo actual en el minibúfer. Véase Column formulas, y Field and range formulas.
C-u C-u C-c =
(org-table-eval-formula
)Reinsertar la fórmula activa (ya sea una fórmula de campo, o una fórmula de columna) en el campo actual, de modo que usted puede editarla directamente en el campo. La ventaja sobre la edición en el minibúfer es que se puede utilizar el comando
C-c ?
.C-c ?
(org-table-field-info
)Mientras edita una fórmula en un campo de la tabla, resalta el campo(s) referenciado por la formula que se encuentra en la posición del cursor.
C-c }
Cambiar la visualización de numeros en fila y columna para una tabla, utilizando una capa superpuesta (
org-table-toggle-coordinate-overlays
). Esta es actualizada cada vez que la tabla se alinea; puede forzarse conC-c C-c
.C-c {
Alterna el depurador de fórmulas entre encendido y apagado (
org-table-toggle-formula-debugger
). Mirar abajo.C-c '
(org-table-edit-formulas
)Edite todas las fórmulas de la tabla actual en un búfer especial, se mostrará una formula por línea. Si el campo actual tiene una fórmula activa, el cursor lo marcara en el editor de fórmulas. Mientras esta dentro del buffer especial, Org resaltara automáticamente cualquier campo o referencia de rango sobre la posición del cursor. Puede editar, eliminar y añadir fórmulas. Puede utilizar los siguientes comandos:
C-c C-c
orC-x C-s
(org-table-fedit-finish
)Salir del editor de fórmulas y almacenar las fórmulas modificadas. Con el prefijo
C-u
, también se aplican las nuevas fórmulas para toda la tabla.C-c C-q
(org-table-fedit-abort
)Salir del editor de fórmulas sin instalar cambios.
C-c C-r
(org-table-fedit-toggle-ref-type
)Cambia todas las referencias en el editor entre formato estándar (como
B3
) e interno (como@3$2
).TAB
(org-table-fedit-lisp-indent
)Impresion bonita o indentado de fórmula Lisp en el punto. Cuando una línea contiene una fórmula Lisp, formatea la fórmula de acuerdo a las normas de Emacs Lisp. Otro
TAB
colapsa nuevamente la fórmula. En una fórmula abierta,TAB
re-indenta como en el modo Emacs Lisp.M-TAB
(lisp-complete-symbol
)Completar símbolos Lisp, igual que en el modo Emacs Lisp.
S-up/down/left/right
Cambie la referencia en el punto. Por ejemplo, si la referencia es
B3
y pulsaS-derecha
, se convertirá enC3
. Esto también funciona en referencias relativas y referencias hline.M-S-up
(org-table-fedit-line-up
)M-S-down
(org-table-fedit-line-down
)Para las fórmulas de columna mueve arriba y abajo la línea de prueba en el búfer Org.
M-up
(org-table-fedit-scroll-down
)M-down
(org-table-fedit-scroll-up
)Desplazar la ventana que muestra la tabla.
C-c }
Alterna la regilla de condenadas de tabla entre encendido y apagado.
Hacier vacio un campo de la tabla no elimina la fórmula asociada a
dicho campo, debido a que se almacena en una línea diferente (la
linea ’#+TBLFM
’) – el próximo cálculo rellenara el campo de
nuevo. Para eliminar una fórmula, tiene que dar una respuesta
vacía cuando se le solicite la fórmula, o editar el Línea
’#+TBLFM
’.
Usted puede editar directamente la linea ’#+TBLFM
’ y volver a
aplicar las ecuaciones modificadas con C-c C-c
en dicha línea o
con los comandos habituales de cálculo en la tabla.
Usted puede aplicar una fórmula temporalmente. Esto es útil al
cambiar la fórmula. Coloque múltiples lineas ’#+TBLFM
’ justo
después la tabla y, a continuación, pulse C-c C-c
en la fórmula
a aplicar. Aquí un ejemplo:
| x | y | |---+---| | 1 | | | 2 | | #+TBLFM: $2=$1*1 #+TBLFM: $2=$1*2
Presionar C-c C-c
en la línea ’#+TBLFM: $2=$1*2
’ produce:
| x | y | |---+---| | 1 | 2 | | 2 | 4 | #+TBLFM: $2=$1*1 #+TBLFM: $2=$1*2
Nota: Si vuelve a calcular esta tabla (con C-u C-c *
, por
ejemplo), obtendrá el resultado de aplicar sólo la primera línea
’#+TBLFM
’.
| x | y | |---+---| | 1 | 1 | | 2 | 2 | #+TBLFM: $2=$1*1 #+TBLFM: $2=$1*2
Cuando la evaluación de una fórmula conduce a un error, el
contenido de campo se convierte en la cadena ’#ERROR
’. Si
quiere ver lo que que está pasando durante la sustitución de
variables y el cálculo con el fin para encontrar un error,
encienda la depuración de fórmulas en el menu Tbl
o mediante
C-c {
y repita el cálculo, por ejemplo presionando en un campo
C-u C-u C-c = RET
. Se mostrará la información detallada.
El cálculo de una tabla normalmente no es automático, sino que necesita ser activado por un comando. Véa Advanced features, para una manera de hacer el cálculo al menos semi-automático.
Con el fin de calcular una línea de la tabla o la tabla entera, utilice los siguientes comandos:
C-c *
(org-table-recalculate
)Recalcular la fila actual aplicando primero las fórmulas de columna almacenadas de izquierda a derecha, y todas las fórmulas de campo/rango en la fila actual.
C-u C-c *
C-u C-c C-c
Recalcular la tabla entera, línea por línea. Cualquier línea antes del primer hline se descarta, asumiendo que es parte de la cabecera de la tabla.
C-u C-u C-c *
orC-u C-u C-c C-c
(org-table-iterate
)Iterar la tabla recalculando hasta que no ocurran más cambios. Esto puede ser necesario si algunos campos utilizan el valor de otros que se calculan despues en la secuencia de cálculo.
M-x org-table-recalculate-buffer-tables RET
Recalcular todas las tablas en el búfer.
M-x org-table-iterate-buffer-tables RET
Iterar todas las tablas en el búfer, con el fin de converger las dependencias tabla a tabla.
Si desea que el cálculo de campos suceda de forma automática, o si quiere ser capaz de asignar nombres [fn:32] a los campos y columnas, es necesario reservar la primera columna de la tabla para caracteres de marcado especiales.
C-#
(org-table-rotate-recalc-marks
)
Rotar la marca de cálculo en la primera columna a través de los
estados ’ ‘, ’#
’, ’*
’, ’!
’, ’$
’. Cuando hay una región
activa, cambia todas las marcas de la región.
He aquí como ejemplo una tabla que recoge los resultados del examen de estudiantes y hace uso de estas características:
|---+---------+--------+--------+--------+-------+------| | | Student | Prob 1 | Prob 2 | Prob 3 | Total | Note | |---+---------+--------+--------+--------+-------+------| | ! | | P1 | P2 | P3 | Tot | | | # | Maximum | 10 | 15 | 25 | 50 | 10.0 | | ^ | | m1 | m2 | m3 | mt | | |---+---------+--------+--------+--------+-------+------| | # | Peter | 10 | 8 | 23 | 41 | 8.2 | | # | Sam | 2 | 4 | 3 | 9 | 1.8 | |---+---------+--------+--------+--------+-------+------| | | Average | | | | 25.0 | | | ^ | | | | | at | | | $ | max=50 | | | | | | |---+---------+--------+--------+--------+-------+------| #+TBLFM: $6=vsum($P1..$P3)::$7=10*$Tot/$max;%.1f::$at=vmean(@-II..@-I);%.1f
Importante: tenga en cuenta que para estas tablas especiales,
recalcular la tabla con C-u C-c *
sólo afectará a filas que
están marcadas ’#
’ o ’*
’, y a los campos que tienen una
fórmula asignada al campo. Las fórmulas de columna no se aplican
en filas con el primer campo vacio.
Los caracteres de marcado tienen el siguiente significado:
- ‘
!
’Los campos de esta línea definen los nombres de las columnas, de modo que puede referirse a una columna como ’
$Tot
’ en lugar de ’$6
’. - ‘
^
’Esta fila define los nombres de los campos de la fila superior. Con tal definición, cualquier fórmula en la tabla puede usar ’
$m1
’ para referirse a el valor ‘10’. También, si asigna una fórmula a un nombre de campo, se almacenara como ’$name=...
’. - ‘
_
’Al igual a ’
^
’, pero define los nombres de los campos de la fila inferior. - ‘
$
’Los campos de esta fila pueden definir parámetros para las fórmulas. Por ejemplo, si un campo en la fila ’
$
’ contiene ’max=50
’, las fórmulas en esta tabla pueden hacer referencia al valor 50 usando ’$max
’. Los parámetros funcionan exactamente igual que las constantes, sólo que puede definirse en función de cada tabla. - ‘
#
’Los campos de esta fila se recalculan automáticamente al pulsar
TAB
,RET
oS-TAB
en esta fila. Además, esta fila es seleccionada para un nuevo cálculo global conC-u C-c *
. Las lineas no marcadas seran ignoradas por este comando. - ‘
*
’Selecciona esta línea para un nuevo cálculo global con
C-u C-c *
, pero no para el cálculo automático. Utilice esto cuando el cálculo automático ralentice demasiado la edición. - ’ ’
Las líneas sin marcar están exentas de un nuevo cálculo con
C-u C-c *
. Todas las líneas que deban ser recalculadas deben estar marcadas con ’#
’ o ’*
’. - ‘
/
’
No exportar esta línea. Útil para las líneas que contienen los
marcadores de reduccion ’<N>
’ o marcadores de grupo de
columnas.
Por último, sólo para abrir el apetito sobre lo que se puede hacer
con el fantástico paquete calc.el
, aquí hay una tabla que
calcula la serie de Taylor de grado n
en la ubicación x
para
un par de funciones.
|---+-------------+---+-----+--------------------------------------| | | Func | n | x | Result | |---+-------------+---+-----+--------------------------------------| | # | exp(x) | 1 | x | 1 + x | | # | exp(x) | 2 | x | 1 + x + x^2 / 2 | | # | exp(x) | 3 | x | 1 + x + x^2 / 2 + x^3 / 6 | | # | x^2+sqrt(x) | 2 | x=0 | x*(0.5 / 0) + x^2 (2 - 0.25 / 0) / 2 | | # | x^2+sqrt(x) | 2 | x=1 | 2 + 2.5 x - 2.5 + 0.875 (x - 1)^2 | | * | tan(x) | 3 | x | 0.0175 x + 1.77e-6 x^3 | |---+-------------+---+-----+--------------------------------------| #+TBLFM: $5=taylor($2,$4,$3);n3
Org-Plot puede producir gráficos de la información almacenada en tablas org, ya sea gráficamente o en ASCII-art.
Org-Plot produce gráficos 2D y 3D utilizando Gnuplot
http://www.gnuplot.info/ y gnuplot-mode
http://xafs.org/BruceRavel/GnuplotMode. Para ver esto en acción,
asegúrese de tener instalado en su sistema tanto Gnuplot como el
modo Gnuplot, a continuación, invoquelo en la siguiente tabla con
C-c " g
o M-x org-plot/gnuplot RET
.
#+PLOT: title:"Citas" ind:1 deps:(3) type:2d with:histograms set:"yrange [0:]" | Sede | Max cites | H-index | |-----------+-----------+---------| | Chile | 257.72 | 21.39 | | Leeds | 165.77 | 19.68 | | Sao Paolo | 71.00 | 11.50 | | Stockholm | 134.19 | 14.33 | | Morelia | 257.56 | 17.67 |
Observe que Org Plot es lo suficientemente inteligente como para
aplicar las cabeceras de la tabla como etiquetas. Puede ejercerse
más control sobre etiquetas, tipos, contenido y aspecto del
grafico a través de las lineas #+PLOT:
que preceden a una
tabla. Vera a continuación una lista completa de opciones para
Org-Plot. Las líneas #+PLOT
son opcionales. Para más información
y ejemplos vea el tutorial Org-Plot en
http://orgmode.org/worg/org-tutorials/org-plot.html.
set
Especifique cualquier opción
gnuplot
a establecer en la represetacion grafica.title
Especifica el título del grafico.
ind
Especifica qué columna de la tabla se utiliza como eje
x
.deps
Especifica las columnas a gráficar como una lista de estilos Lisp, rodeado entre paréntesis y separado por espacios, por ejemplo
dep:(3 4)
para graficar la tercera y cuarta columnas (por defecto gráfica todas las otras columnas ademas de la columnaind
).type
Especifique si el grafico será
2d
,3d
, ogrid
.with
Especifica la opcion
with
a insertar en cada columna graficada (por ejemplo,lines
,points
,boxes
,impulses
, etc…). Por defecto eslines
.file
Si desea el grafico en un fichero, especifique “ruta/al/archivo-de-salido/deseado”.
labels
Lista de etiquetas a utilizar para los
deps
(por defecto en los encabezados de columna si existen).line
Especifica una línea completa para insertarse en el script Gnuplot.
map
Al graficar en tipos
3d
ogrid
, ajústelo at
para graficar un mapeo plano en lugar de un3d
inclinado.timefmt
Especifica el formato de las marcas de tiempo Org que serán analizados por Gnuplot. Por defecto como ‘%Y-%m-%d-%H:%M:%S’.
script
Si busca un control total, puede especificar un archivo de comandos (coloque el nombre de archivo entre comillas dobles), que se utiliza para el gráfico. Antes de trazar, cada instancia de
$datafile
en el script especificado será reemplazado con la ruta de acceso al fichero de datos generado. Nota: incluso si se establece esta opción, todavía puede especificar el tipo de grafico, ya que puede afectar el contenido del archivo de datos.
Con el cursor sobre una columna, pulse C-c "
o un M-x
orgtbl-ascii-plot RET
para crear una nueva columna que contiene
un grafico de barrar ASCII-art. El grafico se implementa a través
de una columna regular. Cuando la columna de origen cambia, el
grafico de barras puede ser actualizado refrescando la tabla, por
ejemplo pulsando C-u C-c *
.
| Sede | Max cites | | |---------------+-----------+--------------| | Chile | 257.72 | WWWWWWWWWWWW | | Leeds | 165.77 | WWWWWWWh | | Sao Paolo | 71.00 | WWW; | | Stockholm | 134.19 | WWWWWW: | | Morelia | 257.56 | WWWWWWWWWWWH | | Rochefourchat | 0.00 | | #+TBLFM: $3='(orgtbl-ascii-draw $2 0.0 257.72 12)
La fórmula es una llamada elisp:
(orgtbl-ascii-draw COLUMN MIN MAX WIDTH)
COLUMN
es una referencia a la columna de la fuente.
MIN MAX
son los valores mínimos y máximos a mostrar. Los valores fuente fuera de este rango se muestran como ’
too small
’ o o ’too large
’.WIDTH
es el ancho en caracteres del grafico de barras. Su valor predeterminado es ’
12
’.
Al igual que HTML, Org ofrece enlaces dentro de un archivo, enlaces externos a otros archivos, artículos de Usenet, correos electrónicos y mucho más.
• Formato de enlace: | Cual es el formato de enlaces en Org |
• Enlaces internos: | Enlaces a otros sitios en el archivo actual |
• Enlaces externos: | Enlaces a el mundo estilo URL |
• Manejo de enlaces: | Creación, inserción y seguimiento |
• Uso de enlaces externos a Org: | Enlazar con mi codigo en C? |
• Abreviacion de enlaces: | Atajos para escribir enlaces complejos |
• Opciones de buesqueda: | Enlazar a una ubicación específica |
• Busquedas personalizadas: | Cuando la búsqueda por defecto no es suficiente |
Org reconoce enlaces simples estilo URL y los activa como enlaces en los que puede hacer clic. Sin embargo, el formato general de enlace, se ve así:
[[enlace][descripcion]] o alternativamente [[enlace]
Una vez que el enlace en el buffer es terminado[ (todos los corchetes presentes), Org modificara la visualizacion para mostrar solamente la ‘Descripción’
[[enlace][descripción]]
y ‘enlace’ se muestra en lugar de
[[enlace]]
Los enlaces son resaltados con el aspecto org-link
, que por
defecto es subrayado. Usted puede editar la parte visible de un
enlace directamente. Tenga en cuenta que esto puede ser o bien la
parte ‘enlace’ (si no hay descripción) o la ‘descripción’. Para
editar la parte invisible ‘enlace’, Pulse C-c C-l
con el cursor
sobre el enlace.
Si coloca el cursor al inicio o exactamente detrás del final de el
texto mostrado y preciona BACKSPACE
, removera el corchete
(invisible) en esa ubicación. Esto vuelve incompleto el enlace y el
contenido se muestra nuevamente como texto plano. Insertar el
corchete perdido oculta los enlaces internos de nuevo. Para mostrar
la estructura interna de todos los enlaces, use el menú
Org->Hyperlinks->Literal links
.
Si el enlace no se ve como una URL, se considera que es interno al archivo actual. El caso más importante es un enlace como
[[#mi-identificador-perzonalizado]]
que sera enlazado a la entrada CUSTOM_ID
con la propiedad
‘mi-identificador-personalizado’. Usted es responsable de asegurar
que los identificadores personalizados son únicos en un archivo.
Enlaces tales como
[[Mi objetivo]]
o
[[Mi objetivo][Localiza mi objetivo]]
inica una búsqueda de texto en el archivo actual.
Puede seguir el enlace con C-c C-o
cuando el cursor está sobre
el, o con un clic del ratón (vea Handling links). Los enlaces a
identificadores perzonalizados señalarán el encabezado
correspondiente. Se da prioridad de busqueda a enlaces de texto con
un objetivo dedicado: la misma cadena dentro de corchetes
angulares, como
<<Mi Objetivo>>
Si no existe ningún objetivo específico, a continuación el enlace,
tratar de coincidir con el nombre exacto de un elemento dentro del
buffer. El nombramiento se hace con la palabra clave #+NAME
, que
tiene que ser colocada en la línea anterior del elemento al que se
refiere, como en el ejemplo siguiente
#+NAME: Mi blanco | a | tabla | |----+---------------| | of | cuatro celdas |
Si ninguna de las anteriores tiene éxito, Org buscará un encabezado que sea exacto al texto del enlace, también puede incluir palabras clave TODO y etiquetas[fn:33].
Durante la exportación, los enlaces internos se utilizan para marcar los objetos y asignarles un número. Entonces los objetos marcados serán referenciados por los enlaces que apuntan a ellos. En particular, los enlaces sin una descripción aparecerán como el número asignado a la marca del objeto[fn:34]. En el siguiente extracto de un búfer Org
- one item - <<target>>another item Here we refer to item [[target]].
- un elemento - <<objetivo>> otro elemento Aquí nos referimos al elemento [[objetivo]].
La última frase aparecerá como ‘Aquí nos referimos al elemento 2’ al ser exportado.
En los archivos no Org, se buscaran las palabras en el enlace de texto. En el ejemplo anterior la búsqueda sería ‘objetivo’.
Al seguir un enlace se coloca una marca en propio anillo de marcas
de Org. Puede volver a la posición anterior con C-c &
. Utilizar
este comando sucesivamente llevara a la posicion previa mas
reciente.
• Radio objetivos: | Crear objetivos accionados por enlaces en texto plano |
Org puede convertir automáticamente cualquier aparicion de ciertos nombres en texto normal en un enlace. Así que, sin crear una vinculación expresa, el texto se conecta al radio objetivo. Los Radio objetivos están encerrados por paréntesis angulares triples. Por ejemplo, una objetivo
'<<<Mi objetivo>>>'
hace que cada aparición de ‘mi objetivo’ en texto normal se
convierta en un enlace activo. El archivo Org se explora
automáticamente por radio objetivos sólo al ser cargado por
primera vez en Emacs. Para actualizar la lista de objetivos
durante la edición, pulse C-c C-c
con el cursor sobre o en un
objetivo.
Org soporta enlaces a archivos, páginas web, Usenet y mensajes de correo electrónico, Entradas de bases de datos BBDB y enlaces a las conversaciones de IRC y su registros. Los enlaces externos son localizadores similares a URL. Inician con un pequeño identificador seguido de dos puntos. No puede haber ningún espacio después de los dos puntos. La siguiente lista muestra ejemplos para cada tipo de enlace.
Además de estos tipos de enlace incorporados, algunos están
disponibles a través del directorio contrib/
(ver
Installation). Por ejemplo, estos enlaces a mensajes VM o
Wanderlust están disponibles cuando se cargan las correspondientes
bibliotecas del directorio contrib/
correspondiente:
vm:folder enlace a folder VM vm:folder#id enlace a mensage VM vm://[email protected]/folder#id VM en maquina remota vm-imap:account:folder enlace a forder VM IMAP vm-imap:account:folder#id enlace a mensage VM IMAP wl:folder enlace a folder WANDERLUST wl:folder#id enlace a mesage WANDERLUST
Para personalizar Org para añadir nuevos tipos de enlace vea Adding hyperlink types.
Un enlace debe ir entre corchetes dobles y puede contener un texto descriptivo que se mostrará en lugar de la URL (véase Link format), por ejemplo:
[[http://www.gnu.org/software/emacs/][GNU Emacs]]
Si la descripción es un nombre de archivo o una URL que apunta a una imagen, La exportación a HTML (ver HTML export) incluye a la imagen como un boton clickable. Si no hay descripción en absoluto y el enlace apunta a una imagen, esa imagen se incluye en el archivo HTML exportado.
Org también localiza enlaces externos en el texto normal y los
activa como enlaces. Si los espacios deben ser parte del enlace
(por ejemplo, en bbdb:Richard Stallman
), o si los necesita para
eliminar ambigüedades sobre el fin del enlace, encierrelo dentro de
corchetes.
Org proporciona métodos para crear un enlace con la sintaxis apropiada, para insertarlo en un archivo Org, y seguir el enlace.
C-c l
(org-store-link
)Guarda un enlace a la ubicación actual. Este es un comando global (debe crear la clave de unión usted mismo) puede ser utilizado en cualquier buffer para crear un enlace. El enlace se almacena para la posterior inserción en un buffor Org (vea más abajo). El tipo de enlace que se creara dependera del búfer:
- Buffers modo Org
Para los archivos org, si hay un
<<objetivo>>
en el cursor, el enlace apunta al objetivo. De lo contrario, apunta al encabezado actual, que también será la descripción[fn:37].
Si el encabezado tiene una propiedad
CUSTOM_ID
, un enlace a este ID personalizado se almacenará. Adicional o alternativamente(en función del valor de
org-id-link-to-org-use-id
), una propiedadID
global unica se creara y/o sera usada para construir un enlace[fn:38]. Así que usando este comando en buffers Org potencialmente creara dos enlaces: uno legible por humanos con el ID personalizado, y otro que es único en el mundo y funciona incluso si la entrada se mueve de un archivo a otro. Más tarde, cuando inserte un enlace, necesitara decidir cuál usar.
- Clientes de Email/Noticias: VM, Rmail, Wanderlust, MH-E, Gnus
Prácticamente se admiten todos los clientes de correo de Emacs. El enlace apuntara el artículo actual, o, en algunos buffers GNUs, a el grupo. La descripción se construye a partir del autor y el sujeto.
- Navegadores Web: W3 y W3M
Aquí el enlace será la URL actual, con el título de la página como descripción.
- Contactos: BBDB
Enlaces creados en un buffer BBDB apuntarán a la entrada actual.
- Chat: IRC
Para los enlaces de IRC, si establece la opción
org-irc-link-to-logs
at
, se creara un enlace estilo ’file:/
’ apuntando a un punto relevante en los registros de la conversacion actual. De lo contrario se almacena un enlace estilo ’irc:/
’ para el usuario/canal/servidor.
- Otros archivos
Para cualquier otro archivo, el enlace apuntará al archivo, con una cadena de búsqueda (ver Search options) apuntando al contenido de la línea actual. Si hay una región activa, se seleccionan las balabras base de la cadena de busqueda. Si el enlace creado automáticamente no funciona correctamente o con suficiente precisión, puede escribir funciones personalizadas para seleccionar el cadena de búsqueda y hacer la búsqueda por tipos de archivos – ver Custom searches. La combinacion
C-c l
es sólo una sugerencia - ver Installation.
- Vista de Agenda
Cuando el cursor se encuentra en una vista de agenda, los puntos de enlace creados hacen referencia a la entrada de linea actual.
- Buffers modo Org
C-c C-l
(org-insert-link
)Inserte un enlace[fn:39]. Esto solicita un enlace para insertar en la buffer. Usted puede escribir solo un enlace, usando el texto para un enlace interno, o uno prefijos para los tipos de enlace mencionados en los ejemplos arriba. El enlace se inserta en el buffer[fn:40], a lo largo con un texto descriptivo. Si se ha seleccionado algún texto cuando este comando se llama, el texto seleccionado se convierte en el valor de descripción predeterminado.
- Insertar enlaces almacenados
Todos los enlaces almacenados durante la sesión actual son parte del historial de este prompt, puede acceder a ellos con arriba y abajo (o
M-p/n
).
- Soporte de autocompletado
TAB
le ayudará a completar prefijos de enlace válidos como ’http:
’ o ’ftp:
’, incluyendo los prefijos definidos a través de enlaces abreviados (ver Link abbreviations). Si presionaRET
después de insertar sólo el prefijo, Org ofrecerá apoyo para la terminación específica de algunos tipos de enlace[fn:41]. Por ejemplo, si escribe file seguido deRET
, se ofrecera terminación de nombre de archivo (acceso alternativo:C-u C-c C-l
, véase más adelante), y después de bbdbRET
puede completar nombres de contacto.
- Insertar enlaces almacenados
C-u C-c C-l
Cuando se llama a
C-c C-l
con un argumento prefijoC-u
, se insertara un enlace a un archivo y se puede utilizar la terminación de nombre de archivo para seleccionar el nombre del archivo. Se inserta la ruta al archivo relativa al directorio del actual archivo Org, si el archivo enlazado está en el directorio actual o en un subdirectorio del mismo, o si la ruta escrita es relativa al directorio actual utilizando ’../
’. De lo contrario, se utiliza una ruta absoluta, si es posible con ’~/
’ para su directorio personal. Puede forzar una ruta absoluta con de dosC-u
prefijos.
C-C C-l
(con el cursor sobre un vínculo existente)Cuando el cursor está en un vínculo existente,
C-c C-l
le permite editar los enlaces y la descripción.C-C C-o
(org-open-at-point
)Abrir el enlace en el punto. Esto abrirá un navegador web para las direcciones URL (usando
browse-url-at-point
) ejecuta VM/MH-E/Wanderlust/Rmail/Gnus/BBDB para los enlaces correspondientes, y ejecuta el comando en un enlace de shell. Cuando el cursor se encuentra en una enlace interno, este comando ejecuta la búsqueda correspondiente. Cuando el cursor se encuentra en una lista TAG en un encabezado, se crean los correspondientes vistas TAGS. Si el cursor está en una marca de tiempo, se compila la agenda para esa fecha. Además, en enlaces ’file:
’ se visitará el texto y archivos remotos con Emacs y una aplicacion adecuada para archivos locales que no son de texto. La clasificación de archivos se basa sólo en la extensión de archivo. Ver la opciónorg-file-apps
. Si desea anular la aplicación por defecto y visitar el archivo con Emacs, utilice unC-u
prefijo. Para evitar la apertura en Emacs, conC-u C-u
prefijo.Si el cursor está en un encabezado, pero no en un enlace, se ofrecen todos los enlaces en el encabezado y entradas de texto. Si desea establecer el marco de configuración para el seguimiento de enlaces, personalice
org-link-frame-setup
.RET
Cuando se establece
org-return-follows-link
,RET
también sigue el enlace en el punto.mouse-2
mouse-1
En los enlaces,
mouse-2
abrirá el enlace al igual que hariaC-c C-o
. Bajo Emacs 22 y posteriores, elmouse-1
también seguirá un enlace.mouse-3
Como
mouse-3
, pero se fuerza la apertura de enlaces con Emacs, y los enlaces internos se mostrarán en otra ventana[fn:42].C-c C-x C-v
(org-toggle-inline-images
)Cambiar la visualización en línea de imágenes vinculadas. Normalmente hará esto en imagenes en lines no tienen una descripción en el enlace, es decir, imágenes que tambien son colocadas en linea durante la exportación. Cuando se llama con un argumento prefijo, también mostrara imágenes que sí tienen una descripción en el enlace. Puede solicitar que las las imágenes se muestren en línea al inicio configurando la variable
org-startup-with-inline-images
[fn:43].C-c %
(org-mark-ring-push
)Colocar la posición actual en el anillo de la marcas, para poder volver fácilmente. Seguir un enlace interno hacen esto automáticamente.
C-c &
(org-mark-ring-goto
)Ir de nuevo a la posición registrada. Una posición es registrada por los comandos que siguen enlaces internos, y por
C-c %
. El uso de este comando varias veces consecutivas lo trasladara por las posiciones registradas anteriormente en el anillo.C-c C-x C-n
(org-next-link
)C-c C-x C-p
(org-previous-link
)Desplazar al siguiente/anterior enlace en el buffer. En el límite del buffer, la búsqueda falla una vez, y luego volvera alrededor. Los atajos de teclado para esto son realmente demasiado largos; quisa le interese vincularlos a
C-n
yC-p
(add-hook 'org-load-hook (lambda () (define-key org-mode-map "\C-n" 'org-next-link) (define-key org-mode-map "\C-p" 'org-previous-link)))
Puede insertar y seguir enlaces con sintaxis Org no sólo en Org, sino que en cualquier buffer Emacs. Para ello, debe crear dos comandos globales, como los siguientes (por favor seleccione teclas globales adecuadas):
(global-set-key "\C-c L" 'org-insert-link-global)
(global-set-key "\C-c o" 'org-open-at-point-global)
Los URL largos son incomodos de escribir, a menudo se necesitan muchos enlaces similares en un documento. En estos casos puede usar abreviaturas de enlace. Un enlace abreviado se ve así
[[linkword:etiqueta][descripcion]]
donde la etiqueta es opcional. El linkword debe ser una palabra,
que inicia con una letra, seguida por letras, números, ’-
’, y
’_
’. Las abreviaciones se resuelven de acuerdo con la
información en la variable org-link-abbrev-alist
que relaciona
los linkwords a texto de reemplazo. Aquí hay un ejemplo:
(setq org-link-abbrev-alist '(("bugzilla" . "http://10.1.2.9/bugzilla/show_bug.cgi?id=") ("url-to-ja" . "http://translate.google.fr/translate?sl=en&tl=ja&u=%h") ("google" . "http://www.google.com/search?q=") ("gmap" . "http://maps.google.com/maps?q=%s") ("omap" . "http://nominatim.openstreetmap.org/search?q=%s&polygon=1") ("ads" . "http://adsabs.harvard.edu/cgi-bin/nph-abs_connect?author=%s&db_key=AST")))
Si el texto de reemplazo contiene la cadena ’%s
’, será sustituido
por la etiqueta. El uso de ’%h
’ en lugar de ’%s
’ se codifica en
el url la etiqueta (vea el ejemplo anterior, en el que necesitamos
codificar el parámetro URL.) El uso de ’%(mi-función)
’ pasará la
etiqueta a una función personalizada, y se sustituira por la cadena
resultante.
Si el texto de reemplazo no contiene ningún especificador, simplemente se anexa a la cadena con el fin de crear el enlace.
En lugar de una cadena, también puede especificar una función que será llamada con la etiqueta como el único argumento para crear el enlace.
Con la configuracion anterior, puede vincular a un error específico
con [[bugzilla:129]]
, buscar ‘OrgMode’ en la web con
[[Google:OrgMode]]
, mostrar la ubicacion de la Free Software
Fundation con [[gmap:51 Franklin Street, Boston]]
o de la oficina de
Carsten [[omap:Science Park 904, Amsterdam, The Netherlands]]
y
averiguar lo que el autor Org está haciendo además hackear Emacs
con [[ads:Dominik,C]]
.
Si necesita abreviaturas particulares para un único búfer Org, puede definirlas en el archivo con
#+LINK: bugzilla http://10.1.2.9/bugzilla/show_bug.cgi?id= #+LINK: google http://www.google.com/search?q=%s
Puede utilzar la terminacion dentro del buffer (véase Completion)
después de ‘[’ para completar abreviaturas de enlace. También puede
definir una función org-PREFIX-complete-link
par implementar
soporte especial (por ejemplo, terminacion) a la inserción de un
enlace con C-c C-l
. Tal función no deberia aceptar ningún
argumento, y devolver el enlace completo con prefijo.
Los enlaces a archivos pueden contener información adicional para
hacer que Emacs salte a un lugar determinado en el archivo cuando
se sigua un enlace. Esta puede ser un número de línea o una opción
de búsqueda después de dos doble punto[fn:44]. Por ejemplo, cuando
crea un enlace a un archivo con el comando C-c l
(ver Handling
links), se codifican las palabras en la línea actual como una
cadena de búsqueda que se puede utilizar para encontrar esta línea
de nuevo al seguir el enlace con C-c C-o
.
Aquí esta la sintaxis de las diferentes formas de adjuntar una búsqueda a un enlace de archivos, junto con una explicación:
[[file:~/code/main.c::255]] [[file:~/xx.org::Mi Objetivo]] [[file:~/xx.org::*Mi Objetivo]] [[file:~/xx.org::#mi-id-personaliza]] [[file:~/xx.org::/regexp/]]
255
-
Saltar a la línea 255.
Mi Objetivo
-
Buscar un vinculo destino
<<Mi Objetivo>>
, o hace una búsqueda de texto para ‘mi objetivo’, similar a la búsqueda de enlaces internos, consulte Internal links. En la exportación HTML (ver HTML export), tal enlace a archivo se convertira en una referencia HTML a el correspondiente nobre ancla en el archivo enlazado.
*Mi Objetivo
-
En un archivo de Org, restringe la búsqueda a los encabezados.
#Mi-id-personalizado
-
Enlace a un encabezado con una propiedad
CUSTOM_ID
/regexp/
-
Hace una búsqueda de expresiones regulares para
regexp
. Este utiliza el comandooccur
de Emac para= listar todas las coincidencias en una ventana separada. Si el archivo destino está en modo Org,org-ocurr
se utiliza para crear una árbol compacto con las coincidencias.
Un enlace de archivo con un nombre de archivo vacío puede ser usado
para buscar en el archivo actual. Por ejemplo, [[file:::encuentrame]]
hace una búsqueda de ‘encuentrame’ en el archivo actual, al igual
que haria
[[encuentrame]]
El mecanismo por defecto para la creación de cadenas de búsqueda y para hacer la búsqueda relacionada con un enlace de archivos no funciona correctamente en todos los casos. Por ejemplo, las bases de datos BibTeX tienen muchas entradas como ‘year=”1993”’ que dan lugar a buenas cadenas de búsqueda, porque la única identificación única para una entrada BibTeX es la clave de la citación.
Si se encuentra con un problema, puede escribir funciones
personalizadas para establecer la cadena de búsqueda adecuada para
un determinado tipo de archivo, y para hacer la búsqueda de la
cadena en el archivo. Usando add-hook
, éstas funciones necesitan
añadise a las variables de gancho
org-create-file-search-functions
y
org-execute-file-search-functions
. Consulte la cadena de
documentación para éstas variables para más información. En
realidad Org utiliza este mecanismo para los archivos de base de
datos BibTeX, y puede utilizar el código correspondiente como un
ejemplo de implementación. Vea el archivo org-bibtex.el
.
[fn:1] Si no se utiliza font-lock a nivel glabal, debe activarlo en el
buffer Org con (add-hook 'org-mode-hook 'turn-on-font-lock)
[fn:2] Por favor considere suscribirse a la lista de correo, con el fin de reducir el trabajo que los moderadores de correo tienen que hacer.
[fn:3] Las plantillas insertan fácilmente palabras clave minúsculas y
Babel inserta de forma dinámica #+results
.
[fn:4] Vea las variables org-special-ctrl-a/e
, org-special-ctrl-k
,
y org-ctrl-k-protect-subtree
para configurar el comportamiento
especial de C-a
, C-e
, y C-k
en los encabezados.
[fn:5] Clocking sólo funciona con encabezados con menos de 30 asteriscos de indentacion.
[fn:6] Sin embargo, vea, la opción org-cycle-emulate-tab
.
[fn:7] Vea la opción org-cycle-global-at-bob
.
[fn:8] El búfer indirecto (vea Indirect Buffers en el Manual de GNU Emacs) contiene todo el buffer, pero se redujo al árbol actual. La edición del búfer indirecto también cambiará el buffer original, pero sin afectar la visibilidad en ese búfer.
[fn:9] Cuando org-agenda-inhibit-startup
no es nil
, Org no respeta
el estado de visibilidad por defecto al abrir un archivo por primera
vez para la agenda ( Ver Speeding up your
agendas).
[fn:10] Véa también la variable org-show-context-detail
para
determinar cuánto contexto es muestrado alrededor de cada resultado.
[fn:11] Esto depende de la opcion org-remove-highlights-with-change
[fn:12] Esto no funciona en XEmacs, porque XEmacs utiliza pantalla selectiva para esquematizar, no propiedades de texto.
[fn:13] Al usar ‘*’ como para listas, las líneas deben tener una indentacion o serán vistas como encabezados de primer nivel. Además, cuando usted utiliza el modo de esquema limpio (ocultando estrellas), los elementos de lista de una estrella pueden ser difícil de distinguir de los verdaderos encabezados. En resumen: a pesar de que ‘*’ esta soportado, puede ser mejor no utilizarlo para elementos de lista sin formato.
[fn:14] Puedes filtrar cualquiera de ellos configurando
org-plain-list-ordered-item-terminator
.
[fn:15] Tambien puede obtener ‘a.’, ‘A.’, ‘a)’ y ‘A)’ configurando
org-list-allow-alphabetical
. Para minimizar la confucion con texto
normal, limite su uso a solo un caracter. Mas alla de ese limite, las
balas se repliegan automaticamente a numeros.
[fn:16] Si hay una casilla de verificacion en el elemento, la cookie
se debe colocar antes de la casilla de verificacion. Si ha activado
las listas alfabeticas, tambien puede utilizar contadares como [@b]
.
[fn:17] Vea tambien org-list-empty-line-terminates-plain-lists
.
[fn:18] Org solo cambia la configuracion de llenado para Emacs. Para
XEmacs, debe utilizar filladapt.el
de Kyle E. Jones. Para habilitar
esta funcion agregue en .emacs
: (require 'filladapt)
[fn:19] Si no desea que el elemento se divida, persanalice la variable
org-M-RET-may-split-line
.
[fn:20] Si quiere el ciclo alrededor de los elementos de esa manera,
puede personalizar org-list-use-circular-motion
.
[fn:21] Vea org-list-use-circular-motion
para un comportamiento
ciclico.
[fn:22] La correspondiente configuracion por buffer es: #+STARTUP:
fninline
o #+STARTUP: nofninline
[fn:23] Las correspondientes opcciones por buffer son fnadjust
y
nofnadjust
.
[fn:24] Para insertar una barra vertical en un campo de tabla, utilice
\vert
o, detro de una palabra \vert{}
como en abc\vert{}def
[fn:25] Esta caracteristica no funciano en XEmacs
[fn:26] El centrado no funciona dentro de Emacs, pero si tiene un efecto cuando exporta a HTML.
[fn:27] Org entendera referencias introducidas por el usuario como
’B4
’, pero no haga uso de esta sintaxis al ofrecer una formula para
edicion. Pude persanalizar este comportamiento usando la opcion
org-table-use-standard-references
.
[fn:28] Por compativilidad con versiones anteriores tambien puede
utilizar nombres especiales como LR5
y LR12
para referirse de
manera permanete a la quinto y doceavo campo en la última fila de la
tabla. Sin embargo, esta sintaxis está obsoleta, no debería utilizarán
para los nuevos documentos. En su lugar utilice @>$
.
[fn:29] Las escalas de tiempo de calculo son O(N\^2) ya que la tabla,
denominada FOO
es analizada para cada campo a ser leido.
[fn:30] constants.el
puede suministrar los valores de las constantes
en dos sistemas de unidades difirentes, SI
y cgs
. Cual se utiliza
depende del valor de la varible constants-unit-system
. Puede
utilizar #+STARTUP
con la opcion constSI
y constcgs
para
establecer este valor para el bufer en uso.
[fn:31] El cambio de formato ’printf
’ está limitado en la precisión
ya que el valor que se pasa se convierte a un ‘entero’ o ‘doble’. El
‘entero’ es limitado en tamaño por truncamiento al valor con signo de
32 bits. los ‘doble’ se limitan en precisión a 64 bits en general que
deja aproximadamente 16 dígitos decimales significativos.
[fn:32] Estos nombres deben empezar por un caracter alfabetico y utilizar solo caracteres alfanumecos/guion bajo.
[fn:33] Para insertar un enlace apuntando a un encabezado, puede
utilizar el autocompletado. Dentro del buffer sólo tiene que escribir
un asterisco seguido de unas cuantas letras opcionales y presionar
M-TAB
. Se ofreceran todos los encabezados en el búfer actual como
autocompletado.
[fn:34] Cuando apunta a la palabra clave #+NAME
, la palabra clave
#+CAPTION
es obligatoria a fin de optener una numeracion apropiada
(vea Images and tables).
[fn:35] Eur comportamiento real de la busqueda dependera del valor de
la opcion org-link-search-must-match-exact-headline
. Si su valor es
nil
, se hara una busqueda de texto difusa. Si es t
, solo se
buscara un encabezado que coincida exactamente, ignorando espacios y
cookies. Si el valor es query-to-create
, se buscara un encabezado
exacto; si ne se encuentra, entonces se preguntara al usuario si desea
crear un objetivo.
[fn:36] En las busquedas por encabezado el texto coincide exactamente,
se ignoran los espacios en blanco y cookies. Si el encabezado no se
encuentra el valor de la opcion
org-link-search-must-match-exact-headline
es query-to-create
,
luego se precunta al usuaria sobre si desea crear un objetivo.
[fn:37] Si el encabezado contiene una marca de tiempo, esta se remueve del enlace y el resultado es un enlace incorrecto – debe evitar colocar marcas de tiempo en encabezados.
[fn:38] Primero debe cargar la libreria org-id.el
, yo sea a travez
de org-customize
habilitando org-id
en org-modules
, o añadiendo
(require 'org-id)
en su .emacs
.
[fn:39] Tenga en cuenta que usted no tiene que utilizar este comando para insertar un enlace. Los enlaces en Org son texto plano, y puede escribirlos o pegarlos directamente dentro del buffer. Mediante el uso de este comando, los enlaces son encerrados automaticamente entre corchetes dobles, y se le pedira opcionalmente un texto de descripcion.
[fn:40] Despues de la insercion de un enlace almacenado, el enlace
sera retirado de la listo de enlaces almacenados. Para mantenerlo en
la lista de uso posterior, utilice un triple argumento prefijo C-u
a
C-c C-l
o configure la opcion
org-keep-stored-link-after-insertion
.
[fn:41] Esto funciona con una llamada especial a la funcion
org-PREFIX-complete-link
.
[fn:42] Vea la opcion org-display-internal-link-with-indirect-buffer
[fn:43] con la correspondiente palabra clave inlineimages
y
noinlineimages
para #+STARTUP
[fn:44] Por compativilidad con versiones anteriores, los numeros de linea tambien pueden segir despues de un signo doble punto.
[fn:45]
[fn:46]
[fn:47]
[fn:48]
[fn:49]
[fn:50]
[fn:51]
[fn:52]
[fn:53]
[fn:54]
[fn:55]
[fn:56]
[fn:57]
[fn:58]
[fn:59]
[fn:60]
[fn:61]
[fn:62]
[fn:63]
[fn:64]
[fn:65]
[fn:66]
[fn:67]
[fn:68]
[fn:69]
[fn:70]
[fn:71]
[fn:72]
[fn:73]
[fn:74]
[fn:75]
[fn:76]
[fn:77]
[fn:78]
[fn:79]
[fn:80]
[fn:81]
[fn:82]
[fn:83]
[fn:84]
[fn:85]
[fn:86]
[fn:87]
[fn:88]
[fn:89]
[fn:90]
[fn:91]
[fn:92]
[fn:93]
[fn:94]
[fn:95]
[fn:96]
[fn:97]
[fn:98]
[fn:99]
[fn:100]
[fn:101]
[fn:102]
[fn:103]
[fn:104]
[fn:105]
[fn:106]
[fn:107]
[fn:108]
[fn:109]
[fn:110]
[fn:111]
[fn:112]
[fn:113]
[fn:114]
[fn:115]
[fn:116]
[fn:117]
[fn:118]
[fn:119]
[fn:120]
[fn:121]
[fn:122]
[fn:123]
[fn:124]
[fn:125]
[fn:126]
[fn:127]
[fn:128]
[fn:129]
[fn:130]
[fn:131]
[fn:132]
[fn:133]
[fn:134]
[fn:135]
[fn:136]
[fn:137]
[fn:138]
[fn:139]
[fn:140]
[fn:141]
[fn:142]
[fn:143]
[fn:144]
[fn:145]
[fn:146]
[fn:147]
[fn:148]
[fn:149]
[fn:150]
[fn:151]
[fn:152]
[fn:153]
[fn:154]
[fn:155] OpenDocument-v1.2 Specification
[fn:156]
[fn:157]
[fn:158]
[fn:159]
[fn:160]
[fn:161]
[fn:162]
[fn:163]
[fn:164]
[fn:165]
[fn:166]
[fn:167]
[fn:168]
[fn:169]
[fn:170]
[fn:171]
[fn:172]
[fn:173]
[fn:174]
[fn:175]
[fn:176]
[fn:177]
[fn:178]
[fn:179]
[fn:180]
[fn:181]
[fn:182]
[fn:183]
[fn:184]
[fn:185]
[fn:186]
[fn:187]
[fn:188]
[fn:189]