EEditor

1. Primeros pasos

Cuando inicies EEditor por primera vez, verás un editor vacío con una barra lateral. Para empezar a trabajar:

1. Abre una carpeta — pulsa ⌘O o toca el icono de carpeta en la barra lateral para elegir un directorio. EEditor lo escaneará y mostrará todos los archivos en el árbol de la barra lateral.
2. Selecciona un archivo — haz clic en cualquier archivo de la barra lateral para abrirlo en el editor. El archivo se abre en una nueva pestaña.
3. Comienza a escribir — las ediciones se guardan automáticamente tras 1 segundo de inactividad. También puedes pulsar ⌘S para guardar inmediatamente.

2. El editor

EEditor proporciona un entorno de escritura sin distracciones con resaltado de sintaxis en tiempo real.

• Resaltado de sintaxis — encabezados, negrita, cursiva, bloques de código, enlaces y más se colorean en tiempo real para Markdown. Para archivos de código, las palabras clave, tipos, cadenas, números y comentarios se resaltan en más de 24 lenguajes.
• Buscar y reemplazar — pulsa ⌘F para abrir la barra de búsqueda. Escribe para buscar, usa el campo de reemplazo para sustituir coincidencias.
• Insertar marca de tiempo — pulsa ⌘I para insertar la fecha y hora actual (YYYY-MM-DD HH:mm) en la posición del cursor.
• Deshacer / Rehacer — ⌘Z para deshacer, ⌘⇧Z para rehacer.
• Indicador de lenguaje — el lenguaje detectado se muestra en la esquina inferior derecha del editor.

3. Barra lateral y árbol de archivos

La barra lateral muestra una vista jerárquica de tu carpeta. Los directorios se ordenan primero, luego los archivos alfabéticamente.

• Expandir/contraer carpetas haciendo clic en el triángulo de apertura.
• Crear un nuevo archivo — pulsa ⌘N o usa el botón +. Puedes escribir una ruta como subcarpeta/archivo.md para crear archivos anidados.
• Crear una nueva carpeta — usa el botón + de carpeta en la barra de herramientas de la barra lateral.
• Eliminar — haz clic derecho (o mantén pulsado en iOS) y selecciona Eliminar. En macOS, los archivos se mueven a la Papelera.
• Renombrar — usa el menú contextual para renombrar archivos o carpetas.
• Actualizar — pulsa ⌘⇧R para reescanear el directorio.
• Indicador de cambios — aparece un pequeño punto junto a los archivos con cambios sin guardar.

La barra lateral tiene tres modos accesibles mediante el control segmentado en la parte superior: Archivos (árbol de archivos), Calendario (ver sección 8) y Agenda (ver sección 8b).

4. Pestañas y archivos fijados

Cada archivo que abres aparece como una pestaña en la parte superior del área del editor.

• Cambiar de pestaña — haz clic en una pestaña, o usa ⌘⌥→ (siguiente) y ⌘⌥← (anterior). La navegación es circular.
• Cerrar una pestaña — haz clic en el botón × de la pestaña o pulsa ⌘W. Los cambios sin guardar se guardan automáticamente antes de cerrar.
• Cerrar todas las no fijadas — pulsa ⌘⌥W para cerrar todas las pestañas excepto las fijadas.
• Fijar una pestaña — pulsa ⌘⇧K o haz clic derecho en la pestaña y selecciona Fijar. Las pestañas fijadas muestran un icono de chincheta y no se pueden cerrar (desfija primero). Las pestañas fijadas se restauran al reiniciar la aplicación.

5. Búsqueda y apertura rápida

Búsqueda de texto completo (⌘⇧F) busca en todos los archivos de tu espacio de trabajo:

• Los resultados muestran nombre de archivo, número de línea, conteo de coincidencias y contexto (las líneas alrededor de cada coincidencia).
• Activa el modo distinguir mayúsculas con el botón Aa.
• Haz clic en cualquier resultado para abrir el archivo en esa ubicación.

Apertura rápida (⌘P) es un buscador difuso de archivos:

• Comienza a escribir un nombre de archivo — los resultados se actualizan al instante.
• Usa las teclas de flecha para navegar, Enter para abrir, Escape para cancelar.
• Las coincidencias de prefijo se clasifican más alto. Los nombres más cortos aparecen primero entre empates.
• Prerrellenado de selección: si tienes texto seleccionado en el editor, al pulsar ⌘P se prerrellena la búsqueda con tu selección.

Wiki-links (⌘O): coloca el cursor sobre un enlace [[nombre_archivo]] y pulsa ⌘O para abrir ese archivo directamente. Si no se detecta un wiki-link, aparece el diálogo estándar de Abrir carpeta.

6. Vista previa y exportación a PDF

Vista previa de Markdown (⌘⇧P) renderiza tu documento como HTML con estilo:

• Soporta encabezados, listas, bloques de código, enlaces, imágenes, citas y tablas.
• Se adapta al modo oscuro o claro de tu sistema.
• En macOS, la vista previa se abre en un marco. En iOS, aparece como una hoja.

Exportación a PDF (⌘⇧E) genera un documento listo para imprimir:

• Tamaño de página A4 (595 × 842 puntos) con tipografía limpia.
• En macOS, aparece un diálogo de guardado con un nombre de archivo sugerido.
• En iOS/iPadOS, el PDF se presenta a través de la hoja del sistema para compartir.

7. Notas diarias y planificador semanal

Nota diaria (⌘D):

• Crea un archivo llamado YYYY-MM-DD.md (p. ej., 2026-02-19.md) en tu carpeta raíz.
• Prerrellenado con un encabezado: # 2026-02-19.
• Si el archivo ya existe, simplemente lo abre.

Planificador semanal (⌘⇧W):

• Crea un archivo llamado YYYY-WEEK-WW.md (p. ej., 2026-WEEK-08.md) usando la numeración de semanas ISO 8601.
• Prerrellenado con una plantilla estructurada:

  # Week 08 — 2026
  
  ## Monday
  ### Morning
  -
  ### Afternoon
  -
  ### Evening
  -
  
  ## Tuesday
  ...through Sunday

• Si el archivo ya existe, simplemente lo abre.

8. Vista de calendario

Cambia la barra lateral al modo Calendario usando el control segmentado (iconos de carpeta / calendario / agenda) en la parte superior de la barra lateral.

• Una cuadrícula mensual muestra el mes actual con el lunes como primer día de la semana (ISO 8601).
• Indicadores de doble punto aparecen en cada día: un punto azul para actividad de archivos y un punto naranja para elementos de agenda programados en esa fecha.
• Usa los botones < y > para navegar entre meses. El botón Hoy vuelve al mes actual.
• Haz clic en un día para ver los archivos modificados ese día y los elementos de agenda programados para esa fecha, organizados en secciones separadas.
• Haz clic en un archivo en la lista del día para abrirlo en el editor.

8b. Barra lateral de agenda

Cambia la barra lateral al modo Agenda usando el icono de portapapeles en el control segmentado. El panel de agenda proporciona una vista general de tu programación:

• Atrasados — elementos con una fecha :when anterior a hoy, mostrados con un encabezado de sección rojo.
• Hoy — elementos programados para hoy.
• Próximos 7 días — elementos próximos dentro de la siguiente semana.
• Cada elemento muestra su punto de prioridad (rojo = urgente, naranja = alta, amarillo = media, gris = normal), texto, categorías y fecha formateada.
• Usa el botón de actualizar para recargar datos después de añadir elementos en el REPL.

9. REPL EELisp

EEditor incluye un intérprete Lisp integrado llamado EELisp — diseñado para la gestión de datos personales.

Abrir el REPL:

• Pulsa ⌘⇧L para alternar la barra lateral del REPL, o toca el icono de terminal en la barra de herramientas.
• Si tienes texto seleccionado en el editor, ⌘⇧L lo envía al campo de entrada del REPL automáticamente.
• El REPL se abre como un panel lateral derecho que permanece abierto mientras cambias entre archivos y pestañas.

Usar el REPL:

• Escribe una expresión en el prompt > y pulsa ⌘Return para evaluarla.
• Entrada multilínea — si tu expresión tiene paréntesis desbalanceados, el prompt cambia a .. y espera más entrada. Una barra de indicación muestra ⌘↩ para ejecutar · ⎋ para cancelar.
• Historial — pulsa flecha arriba/abajo para navegar por comandos anteriores. El historial se conserva entre sesiones (hasta 100 entradas).
• Seleccionar texto — haz clic y arrastra sobre cualquier entrada de salida para seleccionar y copiar texto.

Comportamiento de la barra lateral:

• La barra lateral del REPL permanece abierta mientras cambias entre archivos, abres nuevas pestañas y navegas — no se cierra.
• El estado de la barra lateral se conserva entre sesiones. Si cierras y reabres la aplicación, la barra lateral del REPL reaparece si estaba abierta.
• Pulsa ⌘⇧L o haz clic en el botón × en la cabecera del REPL para cerrarlo.

Comandos de base de datos:

EELisp incluye comandos integrados para la gestión de bases de datos:

• (tables) — listar todas las tablas en la base de datos actual
• (describe tablename) — mostrar el esquema de una tabla
• (drop-table tablename) — eliminar una tabla
• :db — mostrar la ruta de la base de datos actual
• :db <path> — cambiar a un archivo de base de datos diferente
• :db new <name> — crear un nuevo archivo de base de datos en la carpeta actual
• :db memory — cambiar a una base de datos en memoria

Ejecutar bloques EELisp en el editor:

• Inserta bloques de código ```eelisp en cualquier archivo Markdown.
• Coloca el cursor dentro del bloque y pulsa ⌘⇧Return para ejecutarlo.
• El resultado se inserta como texto plano en la siguiente línea después de la cerca de cierre, auto-seleccionado para facilitar la copia.
• Si el resultado es un formulario (edit, defform) o tabla (browse), se abre como un panel lateral interactivo junto al editor.

10. Comandos de base de datos

El REPL incluye un motor de base de datos SQLite. Por defecto usa una base de datos en memoria. Cuando abres una carpeta que contiene un archivo eelisp.db, el REPL se conecta automáticamente para almacenamiento persistente (ver Gestión de base de datos). Los nombres de tablas y definiciones de campos se escriben como símbolos sin comillas.

Definir una tabla:

(deftable tasks (title:string priority:number done:bool due:date))

Tipos de campo: string, number, bool, date, memo.

Insertar registros:

(insert tasks {:title "Write docs" :priority 1 :done false})

Consultar registros:

;; Todos los registros
(query tasks)

;; Con filtros
(query tasks :where "priority <= ?" :params (list 2))

;; Ordenados, limitados
(query tasks :order "priority" :limit 5)

;; Seleccionar columnas específicas
(query tasks :select "title, done")

Los resultados de consulta se muestran como tablas ASCII formateadas.

Formularios interactivos (browse):

;; Abrir un formulario para navegar, editar y gestionar registros
(browse tasks)

;; Navegar con filtros y ordenación
(browse tasks :where "done = ?" :params (list false) :order "priority")

El formulario muestra un registro a la vez con navegación Anterior/Siguiente, edición en línea, y botones Guardar, Nuevo y Eliminar.

Actualizar y eliminar:

;; Actualizar registro por ID
(update tasks 1 {:done true})

;; Eliminación suave (estilo dBASE)
(delete tasks 1)

;; Purgar registros eliminados
(pack tasks)

Otros comandos:

Comando	Descripción
(tables)	Listar todos los nombres de tablas
(describe tasks)	Mostrar esquema de la tabla
(count-records tasks)	Contar registros (con :where opcional)
(drop-table tasks)	Eliminar una tabla
(field-get record :name)	Obtener un campo de un registro
(record-id record)	Obtener el ID del registro
(records result-set)	Extraer lista de registros de los resultados de consulta
(browse table)	Abrir una vista de tabla/cuadrícula navegable
(edit table)	Abrir un formulario CRUD interactivo
(defform name (fields) :computed ...)	Crear un formulario calculadora con campos calculados

11. Gestión de base de datos

EELisp soporta tanto bases de datos SQLite en memoria como persistentes.

Conexión automática:

• Cuando abres una carpeta, si existe un archivo eelisp.db en la raíz, el REPL se conecta automáticamente.
• Los datos que crees con deftable e insert se persisten en disco.
• Si no existe archivo de base de datos, el REPL usa una base de datos en memoria (los datos se pierden al cerrar la aplicación).

Comandos de base de datos del REPL:

Comando	Descripción
:db	Mostrar la ruta de la base de datos actual
:db <path>	Cambiar a un archivo de base de datos diferente
:db new <name>	Crear un nuevo archivo de base de datos en la carpeta actual
:db memory	Cambiar a una base de datos en memoria

12. Agenda: Elementos, categorías, reglas y vistas

EELisp incluye un gestor de información personal inspirado en Lotus Agenda. Añade elementos de texto libre, categoriza automáticamente con reglas, define vistas dinámicas, organiza con categorías jerárquicas y consulta con filtros — todo almacenado en SQLite.

Añadir elementos:

;; Texto primero — simplemente escribe lo que tienes en mente
(add-item "Finish quarterly report for Sarah")

;; Con metadatos
(add-item "Call dentist" :when "2026-03-01" :priority 2)
(add-item "Buy groceries" :category "personal" :notes "milk, eggs, bread")

Consultar elementos:

;; Navegar todos los elementos (tabla interactiva)
(items)

;; Filtrar por categoría, texto, prioridad o fecha
(items :category "work")
(items :search "quarterly")
(items :priority 1)
(items :when-before "2026-03-01")

Gestionar elementos:

Comando	Descripción
(add-item text :when :priority :category :notes)	Crear un nuevo elemento
(items :category :search :priority :when-before :when-after)	Consultar elementos con filtros (vista de tabla)
(item-get id)	Obtener un solo elemento por ID
(item-edit id)	Abrir elemento en vista de formulario para editar
(item-set id :field val ...)	Actualizar propiedades del elemento
(item-done id)	Marcar elemento como completado (eliminación suave)
(item-count :category cat)	Contar elementos con filtro opcional

Categorías:

Las categorías son jerárquicas (usan separadores /) y pueden ser mutuamente excluyentes:

;; Categorías jerárquicas
(defcategory work)
(defcategory work/projects)
(defcategory work/meetings)
(defcategory personal)
(defcategory personal/errands)

;; Categorías exclusivas (un elemento solo puede estar en un hijo)
(defcategory priority :exclusive true
  :children (high medium low))

;; Asignar / desasignar
(assign 1 "work/projects")
(assign 1 "priority/high")
(unassign 1 "personal")

;; Ver el árbol de categorías
(categories)

Reglas de autocategorización:

Define reglas que categorizan automáticamente los elementos según su contenido — la magia de Lotus Agenda:

;; Reglas de coincidencia de texto
(defrule urgent-flag
  :when (str-contains text "URGENT")
  :assign "priority/high")

(defrule meeting-detect
  :when (or (str-contains text "meeting")
            (str-contains text "call with"))
  :assign "work/meetings")

;; Extracción de fecha por regex
(defrule date-extract
  :when (str-matches text "\\b(\\d{4}-\\d{2}-\\d{2})\\b")
  :action (item-set id :when (match 1)))

;; Aplicar reglas
(apply-rules)            ;; aplicar en lote a todos los elementos
(apply-rules 42)         ;; aplicar al elemento #42
(auto-categorize true)   ;; aplicar automáticamente en cada add-item

Gestión de reglas:

Comando	Descripción
(defrule name :when cond :assign cat)	Definir una regla de categorización
(defrule name :when cond :action expr)	Definir una regla con acción personalizada
(apply-rules)	Aplicar todas las reglas a todos los elementos
(apply-rules id)	Aplicar todas las reglas a un elemento específico
(auto-categorize true/false)	Alternar aplicación automática al insertar
(rules)	Listar todas las reglas definidas
(drop-rule name)	Eliminar una regla

Vistas — Perspectivas dinámicas:

Define consultas guardadas que filtran, ordenan y agrupan elementos. Muestra una vista en cualquier momento para ver los últimos elementos coincidentes:

;; Definir vistas con expresiones de filtro
(defview work-board
  :source items
  :filter (has-category "work")
  :group-by category
  :sort-by when)

(defview urgent
  :source items
  :filter (= priority "1")
  :sort-by when)

(defview inbox
  :source items
  :filter (= (length categories) 0))

;; Mostrar una vista
(show work-board)
;; → agrupada por categoría con conteo de elementos

(show urgent)
;; → elementos filtrados y ordenados

Gestión de vistas:

Comando	Descripción
(defview name :source :filter :group-by :sort-by)	Definir una vista guardada con expresión de filtro
(show view-name)	Mostrar los elementos coincidentes de una vista
(views)	Listar todas las vistas definidas
(drop-view name)	Eliminar una vista

Funciones auxiliares de fecha:

Comando	Descripción
(today)	Devuelve la fecha de hoy como cadena ISO (p. ej., "2026-02-21")
(date-add date n :days/:weeks/:months)	Añadir días, semanas o meses a una fecha
(date-diff date1 date2)	Diferencia en días entre dos fechas

Integración con calendario:

Visualiza elementos por fecha y añade rápidamente elementos para hoy:

;; Ver elementos para una fecha específica
(items-on "2026-02-24")

;; Ver elementos en un rango de fechas
(items-between "2026-02-24" "2026-02-28")

;; Añadir rápidamente con la fecha de hoy auto-rellenada
(add-item-today "Review pull requests" :priority 1)
(add-item-today "Quick grocery run" :notes "milk, bread")

;; Combinar con funciones auxiliares de fecha
(items-on (today))
(items-between (today) (date-add (today) 7 :days))

Comando	Descripción
(items-on "date")	Mostrar elementos programados para una fecha específica
(items-between "start" "end")	Mostrar elementos en un rango de fechas (inclusivo)
(add-item-today text :priority :category :notes)	Añadir elemento con la fecha de hoy auto-rellenada

Entrada inteligente:

El comando add analiza lenguaje natural para extraer fechas, prioridades y personas automáticamente:

;; Creación de elementos con lenguaje natural
(add "Meet Alice tomorrow for coffee !!")
;; → Elemento con :when = tomorrow, :priority 2, :who "Alice"

(add "Call Bob next Monday about the project")
;; → Elemento con :when = next Monday, :who "Bob"

(add "URGENT fix server crash")
;; → Elemento con :priority 1

;; Previsualizar sin crear un elemento
(smart-parse "email Sarah March 15 about renewal !!")
;; → {:text "email Sarah about renewal" :when "2026-03-15" :priority 2 :who ("Sarah")}

Comando	Descripción
(add "text")	Añadir inteligente: analizar lenguaje natural, extraer metadatos, crear elemento
(smart-parse "text")	Previsualizar extracción sin crear un elemento

HTTP y JSON:

Cliente HTTP genérico y funciones integradas de JSON para integración con APIs:

Comando	Descripción
(http-get url)	Petición GET, devuelve {:status N :body "..."}
(http-post url body :content-type "...")	Petición POST con cuerpo
(json-parse string)	Analizar cadena JSON a dict/lista de EELisp
(json-stringify value)	Convertir valor de EELisp a cadena JSON

Elementos recurrentes y plantillas:

Los elementos con patrones de recurrencia crean automáticamente la siguiente ocurrencia al marcarlos como completados. Las plantillas definen modelos de elementos reutilizables:

Comando	Descripción
(add-item text :recur :weekly)	Crear un elemento recurrente (:daily, :weekly, :monthly)
(every N :unit)	Intervalo personalizado, p. ej. (every 3 :months)
(item-done id)	Marcar como completado; crea el siguiente automáticamente si es recurrente
(deftemplate name :text "..." :category "..." :priority N)	Definir una plantilla de elemento reutilizable
(from-template name :when "..." ...)	Crear elemento desde plantilla con modificaciones
(templates)	Listar todas las plantillas definidas
(drop-template name)	Eliminar una plantilla

Múltiples agendas:

Abre, cambia entre y gestiona múltiples bases de datos de agenda. Exporta e importa para copia de seguridad o migración:

Comando	Descripción
(open-agenda "path/to/file.db")	Abrir una nueva base de datos de agenda y cambiar a ella
(use-agenda name)	Cambiar a una agenda ya abierta
(agendas)	Listar todas las agendas abiertas con marcador activo
(close-agenda name)	Cerrar y eliminar una agenda del registro
(export-agenda name :format :json :path "file.json")	Exportar todas las tablas de agenda a JSON
(import-agenda "file.json")	Importar registros desde una exportación JSON

13. Referencia rápida de EELisp

Variables y funciones:

(def x 42)
(defn square (x) (* x x))
(square 5)   ; → 25

;; Funciones anónimas
(map (fn (x) (* x x)) '(1 2 3))   ; → (1 4 9)

;; Parámetros rest
(defn sum (first . rest)
  (reduce + first rest))

Condicionales y bucles:

(if (> x 0) "positive" "non-positive")

(cond
  (< x 0)  "negative"
  (= x 0)  "zero"
  else      "positive")

(let ((x 1) (y 2)) (+ x y))   ; → 3

;; Bucle con estilo named-let
(loop ((i 0) (acc 0))
  (> i 10)
  (recur (+ i 1) (+ acc i)))   ; → 55

Cadenas:

(str "hello" ", " "world")          ; → "hello, world"
(str-split "a,b,c" ",")            ; → ("a" "b" "c")
(str-join '("a" "b" "c") "-")      ; → "a-b-c"
(str-upper "hello")                 ; → "HELLO"

Listas:

(list 1 2 3)                        ; → (1 2 3)
(cons 0 '(1 2))                     ; → (0 1 2)
(map inc (range 1 6))               ; → (2 3 4 5 6)
(filter even? (range 1 11))         ; → (2 4 6 8 10)
(reduce + 0 '(1 2 3 4 5))          ; → 15
(sort-by id '(3 1 4 1 5))          ; → (1 1 3 4 5)

Diccionarios:

(def d {:name "Alice" :age 30})
(dict-get d :name)                  ; → "Alice"
(dict-set d :age 31)                ; → {:name "Alice" :age 31}
(dict-keys d)                       ; → (:name :age)

Funciones del preludio:

Función	Descripción
inc / dec	Incrementar / decrementar en 1
even? / odd?	Comprobaciones de paridad
zero? / pos? / neg?	Comprobaciones de signo
first / second / third / last	Acceso a listas
take / drop	Tomar/descartar los primeros n elementos
some? / every?	Alguno/todos coinciden con el predicado
pipe	Macro de encadenamiento: (pipe 5 inc inc square)
compose	Composición de funciones
partial	Aplicación parcial

14. Consejos para iOS e iPadOS

• Barra de acciones rápidas — una barra de herramientas horizontal aparece sobre el editor con botones para Marca de tiempo, Buscar, Diario, Semanal, Búsqueda, Abrir, Vista previa, PDF, REPL y Atajos. Toca cualquier botón para acceso instantáneo.
• Barra de herramientas del REPL — cuando el REPL está activo, una barra de herramientas aparece sobre el teclado con navegación de historial (arriba/abajo), fragmentos rápidos (query, deftable, defn) y un botón de limpiar.
• Teclado externo — todos los atajos de teclado funcionan cuando conectas un teclado físico a tu iPad.
• Menús contextuales — mantén pulsado sobre archivos en la barra lateral o pestañas para acceder a renombrar, eliminar, fijar y otras acciones.
• Split View — EEditor funciona en los modos Split View y Slide Over de iPadOS.